聚水潭和用友U8接口打通对接实战接通系统：聚水潭聚水潭SaaSERP于2014年4月上线，目前累计超过2.5万商家注册使用，成为淘宝应用服务市场ERP类目商家数和商家月订单增速最快的ERP。2014年及2015年“双十一”当天，聚水潭SaaSERP平稳、安全、顺畅的处理了近千万订单，超过了淘宝对ERP系统吞吐量极限要求的16倍，成为行业里的新标杆。截止目前，聚水潭客户已超2.5万家，其中有南极人、POVOS奔腾，恒源祥，柚子美衣，洁丽雅，FLYCO飞科，波司登，满速，欧丝璐等，并与知名电商圈“老A电商学院”达成深度合作。对接系统：用友U8 请注意，不同的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架构。

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

冰皇HH

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

接通系统：聚水潭

聚水潭SaaSERP于2014年4月上线，目前累计超过2.5万商家注册使用，成为淘宝应用服务市场ERP类目商家数和商家月订单增速最快的ERP。2014年及2015年“双十一”当天，聚水潭SaaSERP平稳、安全、顺畅的处理了近千万订单，超过了淘宝对ERP系统吞吐量极限要求的16倍，成为行业里的新标杆。截止目前，聚水潭客户已超2.5万家，其中有南极人、POVOS奔腾，恒源祥，柚子美衣，洁丽雅，FLYCO飞科，波司登，满速，欧丝璐等，并与知名电商圈“老A电商学院”达成深度合作。

对接系统：用友U8

请注意，不同的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架构。