聚水潭和用友U8接口打通对接实战

聚水潭SaaSERP于2014年4月上线,目前累计超过2.5万商家注册使用,成为淘宝应用服务市场ERP类目商家数和商家月订单增速最快的ERP。2014年及2015年“双十一”当天,聚水潭SaaSERP平稳、安全、顺畅的处理了近千万订单,超过了淘宝对ERP系统吞吐量极限要求的16倍,成为行业里的新标杆。截止目前,聚水潭客户已超2.5万家,其中有南极人、POVOS奔腾,恒源祥,柚子美衣,洁丽雅,FLYCO飞科,波司登,满速,欧丝璐等,并与知名电商圈“老A电商学院”达成深度合作。
请注意,不同的Markdown编辑器对字号的显示方式可能会有所差异。上述代码在大多数Markdown解析器中应该能够正常工作。
用友U8是由用友软件开发的一款企业级管理软件,是用友软件旗下的核心产品之一。U8全称为“用友软件财务管理系统”,是一套集成化的企业资源规划(ERP)解决方案,适用于各行各业的中小型企业。用友U8提供了包括财务会计、成本管理、采购管理、销售管理、库存管理、生产制造、人力资源等多个模块,覆盖了企业经营管理的方方面面。通过集成这些功能模块,企业可以实现信息共享、流程优化和决策支持。其中,财务会计模块可以帮助企业进行日常会计核算和财务报表编制;成本管理模块可对企业成本进行有效控制和分析;采购和销售模块可以实现采购订单、销售订单等交易流程的自动化管理;库存和生产模块可帮助企业实现库存管控和生产调度等工作;人力资源模块则涵盖员工档案管理、薪酬福利计算等人事管理相关功能。
请注意,不同的Markdown编辑器对字号的显示方式可能会有所差异。上述代码在大多数Markdown解析器中应该能够正常工作。
通过轻易云系统数据集成平台新增创建集成方案,然后在数据源平台中选择对应的源平台为:聚水潭,并且选择对应的连接器(关于聚水潭的接口连接器如何配置可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息)。选择对应的销售出库查询接口作为数据对接来源。然后再通过写入目标平台配置目标系统为金蝶云星空,并且选择对应连接器。选择对应的销售出库新增接口作为数据写入动作,既可以完成第一步的数据对接配置;打破跨系统连接,让数据轻易互通成为现实。


聚水潭接口明细
调用接口:orders.out.simple.query
接口名称:销售出库查询
方法:POST
请求参数
| 字段 | 字段名称 | 类型 | 配置值 |
|---|---|---|---|
| shop_id | 店铺编码 | string | |
| is_offline_shop | shop_id为0且is_offline_shop为true查询线下店铺单据 | string | |
| status | 单据状态 | string | Confirmed |
| modified_begin | 修改开始时间 | string | {{LAST_SYNC_TIME datetime}} |
| modified_end | 修改结束时间 | string | {{CURRENT_TIME datetime}} |
| so_ids | 线上单号 | string | |
| page_index | 页数 | string | {{PAGINATION_START_PAGE}} |
| page_size | 每页行数 | string | {{PAGINATION_PAGE_SIZE}} |
响应参数
| 字段 | 字段名称 | 类型 | 配置值 |
|---|---|---|---|
| co_id | 公司编号 | string | |
| shop_id | 店铺编号 | string | |
| io_id | 出库单号 | string | |
| o_id | 内部单号 | string | |
| so_id | 线上单号 | string | |
| created | 创建时间 | string | |
| modified | 修改时间 | string | |
| status | 状态 | string | |
| order_type | 单据类型 | string | |
| invoice_title | 发票抬头 | string | |
| shop_buyer_id | 买家帐号 | string | |
| receiver_country 国家 string | |||
| receiver_state 省 string | |||
| receiver_city 市 string | |||
| receiver_district 区 string | |||
| receiver_town 街道 string | |||
| receiver_address 地址 string | |||
| receiver_name 收件人姓名 string | |||
| receiver_phone 收件人手机 string | |||
| receiver_mobile 收件人电话 string | |||
| buyer_message 买家留言 string | |||
| remark 备注 string | |||
| is_cod 是否货到付款 string | |||
| pay_amount 应付金额 string | |||
| l_id 物流单号 string | |||
| io_date 出库时间 string | |||
| lc_id 快递公司编码 string | |||
| stock_enabled 是否启用库存管理 string | |||
| drp_co_id_from 分销商编号 string | |||
| labels 标记 多标签 | |||
| paid_amount 实付金额 string | |||
| free_amount 优惠金额 string | |||
| freight 运费 string | |||
| weight 预估重量 string | |||
| f_weight 实称重量 string | |||
| merge_so_id 合并订单号 string | |||
| wms_co_id 分仓编号 string | |||
| business_staff 业务人员 string | |||
| currency 货币类型 string | |||
| items 商品集合 array | |||
| items.ioi_id 子单号 string | |||
| items.pic 图片 string | |||
| items.sku_id 商品编码 string | |||
| items.qty 数量 string | |||
| items.name 商品名称 string | |||
| items.properties_value 颜色规格 string | |||
| items.sale_price 单价 string | |||
| items.sale_amount 金额 | |||
| items.i_id 款式编码 | |||
| items.sale_base_price 原价 | |||
| items.batchs 批次集合 | |||
| items.batchs.batch_no 批次号 | |||
| items.batchs.sku_id 商品编码 | |||
| items.batchs.qty 数量 | |||
| items.batchs.product_date 批次日期 | |||
| items.batchs.supplier_id 供应商编号 | |||
| items.batchs.supplier_name 供应商名称 | |||
| items.batchs.expiration_date 有效期至 | |||
| items.batchs.sns 唯一码集合 | |||
| items.batchs.sns.sn 唯一码 | |||
| items.batchs.sns.pay_date 支付时间 | |||
| items.batchs.sns.code 错误码 | |||
| items.batchs.sns.issuccess true代表成功 | |||
| items.batchs.sns.msg 执行描述 |
用友U8接口明细
调用接口:SaleOut/Add
接口名称:销售出库新增
方法:POST
请求参数
请求头参数说明:
| 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 |
|---|---|---|---|---|
| Content-Type | application/json | String | 是 | 暂无描述 |
| Authorization | 6f62ca1f7d814d0489c5688e975ae7e7 | String | 是 | 暂无描述 |
请求体参数说明:
| 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 |
|---|---|---|---|---|
| Inum | SaleOut | String | 是 | 接口编码 |
| Data | Object | 是 | 单据体 | |
| Data.iHead | Object | 是 | 单据表头 | |
| Data.iHead.IsVerify | true | Boolean | 是 | 是否审核 |
| Data.iHead.cWhCode | 04 | String | 是 | 仓库编码 |
| Data.iHead.cRdCode | 22 | String | 是 | 出入库类别编码 |
| Data.iHead.cMemo | API生成 | String | 否 | 备注 |
| Data.iHead.cSource | 发货单 | String | 是 | 单据来源 |
| Data.iHead.cSTCode | 01 | String | 是 | 销售类型编码 |
| Data.iHead.DLCode | 0000000002 | String | 是 | 发货单号 |
| Data.iHead.dDate | 2022-06-12 | String | 否 | 单据日期(默认当前日期) |
| Data.iBody | Array | 是 | 暂无描述 | |
| Data.iBody.iRowNo | 1 | Integer | 是 | 行号必填且唯一 |
| Data.iBody.cInvCode | 010204 | String | 是 | 存货编码 |
| Data.iBody.cPosition | String | 否 | 货位编码 | |
| Data.iBody.cBatch | String | 否 | 批号 | |
| Data.iBody.iinvexchrate | 1 | Integer | 否 | 换算率 |
| Data.iBody.iQuantity | 1 | Integer | 是 | 数量 |
| Data.iBody.iNQuantity | 2 | Integer | 否 | 应收应发数量 |
| Data.iBody.iNum | 1 | Integer | 否 | 件数 |
| Data.iBody.iNNum | 2 | Integer | 否 | 应收应发辅计量数量 |
| Data.iBody.iDLsID | 1000000010 | Integer | 是 | 发货单子表iDLsID |
请求示例:
[
{
"Inum": "SaleOut",
"Data": {
"iHead": {
"IsVerify": true,
"cWhCode": "04",
"cRdCode": "22",
"cMemo": "API生成",
"cSource": "发货单",
"cSTCode": "01",
"DLCode": "0000000002",
"dDate": "2022-06-12"
},
"iBody": [
{
"iRowNo": 1,
"cInvCode": "010204",
"cPosition": "",
"cBatch": "",
"iinvexchrate": 1,
"iQuantity": 1,
"iNQuantity": 2,
"iNum": 1,
"iNNum": 2,
"iDLsID": 1000000010
}
]
}
}
]
{
"cSTCode": "01",
"DLCode": "0000000002",
"dDate": "2022-06-12",
"iBody": [
{
"iRowNo": 1,
"cInvCode": "010204",
"cPosition": "",
"cBatch": "",
"iinvexchrate": 1,
"iQuantity": 1,
"iNQuantity": 2,
"iNum": 1,
"iNNum": 2,
"iDLsID": 1000000010
}
]
}
返回参数说明:(200)成功
| 参数名 | 示例值 | 参数类型 | 参数描述 |
| ------------ | ------------------ | ------- | ------------------------------------------ |
| code | 0 | Number | api编码,0(成功),1(失败),>1(自定义编码) |
| msg | OK | String | 返回文字描述 |
| data | Object | | 返回数据 |
| data.VouchType | 销售出库单 | String | 单据名称 |
| data.VouchId | 1000000003 | Number | 单据ID |
| data.VouchCode | 0000000002 | String | 单据号 |
返回示例:(200)成功
```json
{
"code": 0,
"msg": "OK",
"data": [
{
"VouchType": "销售出库单",
"VouchId": 1000000003,
"VouchCode": "0000000002"
}
]
}
返回参数说明:(201)失败
| 参数名 | 示例值 | 参数类型 | 参数描述 |
|---|---|---|---|
| code | 1 | Number | api编码,0(成功),1(失败),>1(自定义编码) |
| msg | 新增销售出库单失败:[010204]超发货数量出库请检查选项,或者是否序列号管理的存货 | String | 返回文字描述 |
系统集成总览
从API层面解决企业烟囱式业务系统集成现状,实现深度的业务流程拉通聚水潭到用友U8之间数据集成;通过API连接各业务系统,复用已有的业务系统能力,让集成架构、服务关系更清晰。使用统一的API管理平台,对API进行显性化、可视化,使所有API服务成为企业的数字资产,提升复用率和价值。全面管控企业的API资产,梳理现有业务系统的API。实现API文档的统一管理,建立API的上线、下线、监控的统一管理体系及标准规范。已链接和打通主流SaaS系统超过100+,快速对接各种API接口,实现云上云下的互联互通。将SaaS和本地业务系统联接起来,打破时间与空间界限,打通原有核心数据及SaaS应用,构建可平滑演进的企业IT架构。

| 2023-09-26 19:42:11 | |
| 2022-05-18 10:23:31 | |
| 2021-12-24 10:54:15 | |
| 2021-07-01 10:18:34 | |
| 2022-03-26 06:39:04 | |
| 2021-11-23 21:57:46 | |
| 2021-04-27 06:48:00 | |
| 2022-02-17 22:36:45 | |
| 2022-10-31 21:34:31 | |
| 2023-08-18 16:06:55 | |
| 2023-10-01 03:08:41 | |
| 2022-12-03 21:02:39 | |
| 2021-11-20 10:07:39 | |
| 2022-09-30 16:25:32 | |
| 2023-04-04 06:19:32 | |
| 2023-01-31 08:34:29 | |
| 2021-04-08 20:12:44 | |
| 2022-01-28 21:46:04 | |
| 2023-07-08 17:46:44 | |
| 2023-07-12 03:35:51 | |
| 2024-02-21 01:55:51 | |
| 2024-02-21 01:26:09 | |
| 2024-02-20 16:25:55 | |
| 2024-02-20 16:22:55 | |
| 2024-02-20 14:19:57 |
何海波 18175716035
数据集成顾问 轻易云的技术专家,拥有丰富的数据集成规划经验。他能够为客户提供专业、全面的数据集成规划方案,熟练掌握多种集成技术和工具,帮助企业在数据集成领域得到长远发展。
卢剑航 13760755942
数据集成专家 拥有十多年丰富的经验,擅长ERP、MES、数据中台、营销云中台等集成。他能够根据客户需求,为其提供一站式集成解决方案,帮助企业快速实现各类系统数据集成服务。
胡秀丛 15813570600
数据集成顾问 项目总监 她以卓越的数据集成专长,精通ERP、MES系统,以及数据中台的构建与优化。通过创新的一站式解决方案,她助力企业实现数据的无缝对接,提升业务流程效率,确保信息流通无障碍,为企业的数字化转型提供强有力的支持。