聚水潭和金蝶云星空接口打通对接实战接入系统：聚水潭聚水潭SaaSERP于2014年4月上线，目前累计超过2.5万商家注册使用，成为淘宝应用服务市场ERP类目商家数和商家月订单增速最快的ERP。2014年及2015年“双十一”当天，聚水潭SaaSERP平稳、安全、顺畅的处理了近千万订单，超过了淘宝对ERP系统吞吐量极限要求的16倍，成为行业里的新标杆。截止目前，聚水潭客户已超2.5万家，其中有南极人、POVOS奔腾，恒源祥，柚子美衣，洁丽雅，FLYCO飞科，波司登，满速，欧丝璐等，并与知名电商圈“老A电商学院”达成深度合作。写入目标:金蝶云星空金蝶K/3Cloud结合当今先进管理理论和数十万家国内客户最佳应用实践，面向事业部制、多地点、多工厂等运营协同与管控型企业及集团公司，提供一个通用的ERP服务平台。K/3Cloud支持的协同应用包括但不限于：集中/分散销售、集中/分散采购、B2B电商管理、B2C电商中心、供应商协同、多工厂计划、跨工厂领料、跨工厂加工、工厂间调拨、内部交易及结算、集团财务管理、阿米巴经营等。数据接口配置数据集成平台对应的配置聚水潭与金蝶云星空的对接只要三步就能完成两个系统之间的数据对接。第一步根据聚水潭的接口参数要求记录在轻易云集成平台。第二步配置聚水潭与金蝶云星空之间的字段对应关系（更多方案可借鉴轻易云数据集成社区论坛中找到相关方案信息）第三步完成方案的检查参数设置：传递时间、重试次数、是否启动、前置条件等上线运行。聚水潭接口明细接口： /open/purchaseout/query 接口名称：采购退货查询接口方法： POST 请求参数字段名称类型描述 page_index 开始页码 string 第几页，从第一页开始，默认1 page_size 每页条数 string 每页多少条，默认30，最大50 modified_begin 修改开始时间 string 修改起始时间，和结束时间必须同时存在，时间间隔不能超过七天，与线上单号不能同时为空 modified_end 修改结束时间 string 修改结束时间，和起始时间必须同时存在，时间间隔不能超过七天，与线上单号不能同时为空 status 单据状态 string 单据状态，Confirmed=生效，WaitConfirm待审核，Creating=草拟，Archive=归档，Cancelled=作废响应参数字段名称类型描述 io_date 单据日期 string 单据日期 status 状态 string 状态，Confirmed=生效，WaitConfirm待审核，Creating=草拟，Archive=归档，Cancelled=作废 so_id 线上单号 string 线上单号 f_status 财务状态 string 财务状态，WaitConfirm=待审核，Confirmed=待审核 warehouse 仓库名 string 仓库名 receiver_name 收货人/供应商名称 string 收货人/供应商名称 receiver_mobile 收货电话 string 收货电话 receiver_state 收货状态 string 收货状态 receiver_city 市 string 市 receiver_district 区 string 区 receiver_address 地址 string 地址 wh_id 仓库编号 string 仓库编号，1=主仓，2=销退仓，3=进货仓，4=次品仓 modified 修改时间 string 修改时间 po_id 采购单号 string 采购单号 wms_co_id 分仓编号 string 分仓编号 seller_id 供应商ID string 供应商ID labels 标记多标签 string 标记多标签 logistics_company 物流公司 string 物流公司 lc_id 物流公司编号 string 物流公司编号 l_id 物流单号 string 物流单号 archived 财务审核日期 string 财务审核日期 creator_name 创建人 string 创建人 items 商品合集 array items.io_id 退货单号 string 退货单号 items.remark 备注 string 备注 items.ioi_id 明细id string 明细id items.sku_id 商品编码 string 商品编码 items.name 商品名称 string 商品名称 items.properties_value 属性 string 属性 items.qty 数量 string 数量 items.cost_price 单价 string 单价 items.cost_amount 金额 string 金额 items.i_id 款式编码 string 款式编码 items.co_id 公司编号 string 公司编号 items.batchs 批次集合 array items.batchs.batch_no 批次号 string 批次号 items.batchs.product_date 批次日期 string 批次日期 items.batchs.code 错误码，0代表成功 string 错误码，0代表成功 items.batchs.issuccess 是否成功，true代表成功 string 是否成功，true代表成功 items.batchs.msg 执行描述 string 执行描述 items.batchs.io_id 退货单号 string 金蝶云星空接口明细 API： batchSave NAME：采购退货新增 METHOD： POST 请求参数接口字段字段名称预设值描述 FBILLTYPEID 单据类型 TLD01_SYS FStockOrgId 退料组织 100 组织 FBillNo 单据编号 {{io_id}} 单据编号 FDate 退料日期 {{io_date}} 日期 FSupplierID 供应商 {{seller_id}} 基础资料 FMRTYPE 退料类型 B 下拉列表 FMRDeptId 退料部门基础资料 FDESCRIPTION 备注多行文本 FSettleOrgId 结算组织 100 组织 FSettleCurrId 结算币别 PRE001 基础资料 FPayOrgId 付款组织 100 组织 FOwnerTypeIdHead 货主类型 BD_OwnerOrg 多类别基础资料列表 FOwnerIdHead 货主 100 多类别基础资料 FPURMRBENTRY 明细信息 items 明细信息 FPURMRBENTRY.FMATERIALID 物料编码 {{items.i_id}} 基础资料 FPURMRBENTRY.FRMREALQTY 实退数量 {{items.qty}} 数量 FPURMRBENTRY.FSTOCKID 仓库 CK 基础资料 FPURMRBENTRY.FNOTE 备注文本 FPURMRBENTRY.FPrice 单价单价 FPURMRBENTRY.FGiveAway 是否赠品复选框 FPURMRBENTRY.FOWNERTYPEID 货主类型 BD_OwnerOrg 多类别基础资料列表 FPURMRBENTRY.FOWNERID 货主 100 多类别基础资料 FPURMRBENTRY.FENTRYTAXRATE 税率小数 FPURMRBENTRY.FTAXPRICE 含税单价 {{items.cost_price}} 单价 FPURMRBENTRY.FormId 业务对象表单Id PUR_MRB 必须填写金蝶的表单ID如😛UR_PurchaseOrder FPURMRBENTRY.Operation 执行的操作 batchSave FPURMRBENTRY.IsAutoSubmitAndAudit 提交并审核 true FPURMRBENTRY.IsVerifyBaseDataField 验证基础资料 false 是否验证所有的基础资料有效性，布尔类，默认false（非必录） FPURMRBENTRY.SubSystemId 系统模块 21 默认仓库模块系统打通概况当企业规模逐渐增大时，作为支撑业务运营的IT建设也变得越来越重要，不过往往企业的IT建设过程中会发现某一家软件供应商基本不能完全覆盖企业所有的业务运营流程，这样的结果就是，企业上的IT系统很多很全，从ERP到HR、CRM、PDM、OA等，貌似所有的业务都覆盖到了，但实际上因为这些系统的不集成，而形成了企业很多新的信息孤岛，非常不利于企业的后续的管理和战略发展。从现今和往后的发展趋势来看，也不可避免会遇到上述问题，毕竟企业经营的多样化，并不是所有的业务都能在一个系统中完成，所以我们必须在产品架构上支持更好的与外部系统进行协同。通过轻易云集成平台统一的API管理平台，对API进行显性化、可视化，使所有API服务成为企业的数字资产，提升API利用率，发挥业务系统价值，实现企业IT资产的可插拔、可复用、可组成。

聚水潭和金蝶云星空接口打通对接实战

关一帆qeasy

聚水潭和金蝶云星空接口打通对接实战

接入系统：聚水潭

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

写入目标:金蝶云星空

金蝶K/3Cloud结合当今先进管理理论和数十万家国内客户最佳应用实践，面向事业部制、多地点、多工厂等运营协同与管控型企业及集团公司，提供一个通用的ERP服务平台。K/3Cloud支持的协同应用包括但不限于：集中/分散销售、集中/分散采购、B2B电商管理、B2C电商中心、供应商协同、多工厂计划、跨工厂领料、跨工厂加工、工厂间调拨、内部交易及结算、集团财务管理、阿米巴经营等。

数据接口配置

数据集成平台对应的配置聚水潭与金蝶云星空的对接只要三步就能完成两个系统之间的数据对接。第一步根据聚水潭的接口参数要求记录在轻易云集成平台。第二步配置聚水潭与金蝶云星空之间的字段对应关系（更多方案可借鉴轻易云数据集成社区论坛中找到相关方案信息）第三步完成方案的检查参数设置：传递时间、重试次数、是否启动、前置条件等上线运行。

聚水潭接口明细

接口：/open/purchaseout/query
接口名称：采购退货查询
接口方法：POST

请求参数

字段	名称	类型	描述
page_index	开始页码	string	第几页，从第一页开始，默认1
page_size	每页条数	string	每页多少条，默认30，最大50
modified_begin	修改开始时间	string	修改起始时间，和结束时间必须同时存在，时间间隔不能超过七天，与线上单号不能同时为空
modified_end	修改结束时间	string	修改结束时间，和起始时间必须同时存在，时间间隔不能超过七天，与线上单号不能同时为空
status	单据状态	string	单据状态，Confirmed=生效，WaitConfirm待审核，Creating=草拟，Archive=归档，Cancelled=作废

响应参数

字段	名称	类型	描述
io_date	单据日期	string	单据日期
status	状态	string	状态，Confirmed=生效，WaitConfirm待审核，Creating=草拟，Archive=归档，Cancelled=作废
so_id	线上单号	string	线上单号
f_status	财务状态	string	财务状态，WaitConfirm=待审核，Confirmed=待审核
warehouse	仓库名	string	仓库名
receiver_name	收货人/供应商名称	string	收货人/供应商名称
receiver_mobile	收货电话	string	收货电话
receiver_state	收货状态	string	收货状态
receiver_city	市	string	市
receiver_district	区	string	区
receiver_address	地址	string	地址
wh_id	仓库编号	string	仓库编号，1=主仓，2=销退仓，3=进货仓，4=次品仓
modified	修改时间	string	修改时间
po_id	采购单号	string	采购单号
wms_co_id	分仓编号	string	分仓编号
seller_id	供应商ID	string	供应商ID
labels	标记	多标签	string	标记多标签
logistics_company	物流公司	string	物流公司
lc_id	物流公司编号	string	物流公司编号
l_id	物流单号	string	物流单号
archived	财务审核日期	string	财务审核日期
creator_name	创建人	string	创建人
items	商品合集	array
items.io_id	退货单号	string	退货单号
items.remark	备注	string	备注
items.ioi_id	明细id	string	明细id
items.sku_id	商品编码	string	商品编码
items.name	商品名称	string	商品名称
items.properties_value	属性	string	属性
items.qty	数量	string	数量
items.cost_price	单价	string	单价
items.cost_amount	金额	string	金额
items.i_id	款式编码	string	款式编码
items.co_id	公司编号	string	公司编号
items.batchs	批次集合	array
items.batchs.batch_no	批次号	string	批次号
items.batchs.product_date	批次日期	string	批次日期
items.batchs.code	错误码，0代表成功	string	错误码，0代表成功
items.batchs.issuccess	是否成功，true代表成功	string	是否成功，true代表成功
items.batchs.msg	执行描述	string	执行描述
items.batchs.io_id	退货单号	string

金蝶云星空接口明细

API：batchSave
NAME：采购退货新增
METHOD：POST

请求参数

接口字段	字段名称	预设值	描述
FBILLTYPEID	单据类型	TLD01_SYS
FStockOrgId	退料组织	100	组织
FBillNo	单据编号	{{io_id}}	单据编号
FDate	退料日期	{{io_date}}	日期
FSupplierID	供应商	{{seller_id}}	基础资料
FMRTYPE	退料类型	B	下拉列表
FMRDeptId	退料部门		基础资料
FDESCRIPTION	备注		多行文本
FSettleOrgId	结算组织	100	组织
FSettleCurrId	结算币别	PRE001	基础资料
FPayOrgId	付款组织	100	组织
FOwnerTypeIdHead	货主类型	BD_OwnerOrg	多类别基础资料列表
FOwnerIdHead	货主	100	多类别基础资料
FPURMRBENTRY	明细信息	items	明细信息
FPURMRBENTRY.FMATERIALID	物料编码	{{items.i_id}}	基础资料
FPURMRBENTRY.FRMREALQTY	实退数量	{{items.qty}}	数量
FPURMRBENTRY.FSTOCKID	仓库	CK	基础资料
FPURMRBENTRY.FNOTE	备注		文本
FPURMRBENTRY.FPrice	单价		单价
FPURMRBENTRY.FGiveAway	是否赠品		复选框
FPURMRBENTRY.FOWNERTYPEID	货主类型	BD_OwnerOrg	多类别基础资料列表
FPURMRBENTRY.FOWNERID	货主	100	多类别基础资料
FPURMRBENTRY.FENTRYTAXRATE	税率		小数
FPURMRBENTRY.FTAXPRICE	含税单价	{{items.cost_price}}	单价
FPURMRBENTRY.FormId	业务对象表单Id	PUR_MRB	必须填写金蝶的表单ID如😛UR_PurchaseOrder
FPURMRBENTRY.Operation	执行的操作	batchSave
FPURMRBENTRY.IsAutoSubmitAndAudit	提交并审核	true
FPURMRBENTRY.IsVerifyBaseDataField	验证基础资料	false	是否验证所有的基础资料有效性，布尔类，默认false（非必录）
FPURMRBENTRY.SubSystemId	系统模块	21	默认仓库模块

系统打通概况

当企业规模逐渐增大时，作为支撑业务运营的IT建设也变得越来越重要，不过往往企业的IT建设过程中会发现某一家软件供应商基本不能完全覆盖企业所有的业务运营流程，这样的结果就是，企业上的IT系统很多很全，从ERP到HR、CRM、PDM、OA等，貌似所有的业务都覆盖到了，但实际上因为这些系统的不集成，而形成了企业很多新的信息孤岛，非常不利于企业的后续的管理和战略发展。从现今和往后的发展趋势来看，也不可避免会遇到上述问题，毕竟企业经营的多样化，并不是所有的业务都能在一个系统中完成，所以我们必须在产品架构上支持更好的与外部系统进行协同。通过轻易云集成平台统一的API管理平台，对API进行显性化、可视化，使所有API服务成为企业的数字资产，提升API利用率，发挥业务系统价值，实现企业IT资产的可插拔、可复用、可组成。