聚水潭·奇门对接打通金蝶云星空订单查询接口与销售退货新增接口

对接源平台:聚水潭·奇门

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

目标系统:金蝶云星空

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

数据接口配置

通过轻易云系统数据集成平台新增创建集成方案，然后在数据源平台中选择对应的源平台为：聚水潭·奇门，并且选择对应的连接器（关于聚水潭·奇门的接口连接器如何配置可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息）。选择对应的订单查询接口作为数据对接来源。然后再通过写入目标平台配置目标系统为金蝶云星空，并且选择对应连接器。选择对应的销售退货新增接口作为数据写入动作，既可以完成第一步的数据对接配置；打破跨系统连接，让数据轻易互通成为现实。

 

聚水潭·奇门接口明细

• API：jushuitan.refund.list.query
• NAME：订单查询
• METHOD：POST

请求参数

接口字段	字段名称	预设值	描述
page_index	页码	1
page_size	页数	50
start_time	开始时间	{{LAST_SYNC_TIME datetime}}
end_time	结束时间	{{CURRENT_TIME datetime}}
modified_begin	开始时间
modified_end	结束时间

响应参数

接口字段	字段名称	预设值	描述
as_id	ERP售后单号		autoFillResponse
as_date	申请时间		_autoFillResponse
outer_as_id	平台退货退款单号		autoFillResponse
so_id	线上单号		_autoFillResponse
items	商品集合		autoFillResponse
items.amount	金额		_autoFillResponse
items.combine_sku_id	组合商品编码		autoFillResponse
items.sku_id	商品编码		_autoFillResponse
items.qty	数量		autoFillResponse
items.price	价格		_autoFillResponse
items.name	名称		autoFillResponse
items.r_qty	实际退货数量		_autoFillResponse
items.i_id	款式编码
items.receive_date	入仓日期
items.shop_name	店铺名称

金蝶云星空接口明细

• API：batchSave
• NAME：销售退货新增
• METHOD：POST

请求参数

接口字段	字段名称	预设值	描述
FBillTypeID	单据类型	XSTHD01_SYS	单据类型
FBillNo	单据编号	{{o_id}}	单据编号
FSaleOrgId	销售组织	100	组织
FDate	日期	{{confirm_date}}	日期
FStockOrgId	库存组织	100	组织
FRetcustId	退货客户	{{shop_id}}	基础资料
FHeadNote	备注		多行文本
FEntity	明细信息	items
FEntity.FMaterialId	物料编码	{{items.i_id}}	基础资料
FEntity.FUnitID	库存单位	findCollection find FBaseUnitId_FNumber from ba447323-fce6-3b19-a710-6c7355f22a00 where FNumber={{items.i_id}}	数量
FEntity.FPriceUnitId	计价单位	_findCollection find FBaseUnitId_FNumber from ba447323-fce6-3b19-a710-6c7355f22a00 where FNumber={{items.i_id}}	数量
FEntity.FTAXPRICE	含税单价	{{items.price}}	单价
FEntity.FLot	批号	_function case when '{{items.i_id}}' like '%A%' then '0' when '{{items.i_id}}' like '%G%' then '' end	单价
FEntity.FOwnerTypeId	货主类型	BD_OwnerOrg	多类别基础资料列表
FEntity.FOwnerId	货主	100	多类别基础资料
FEntity.FNote	备注		文本
FEntity.FRealQty	实退数量	{{items.qty}}	文本
FEntity.SubHeadEntity	财务信息
FEntity.SubHeadEntity.FSettleOrgId	结算组织	100	组织
FEntity.SubHeadEntity.FSettleCurrId	结算币别	PRE001	基础资料
FEntity.SubHeadEntity.FormId	业务对象表单Id	SAL_RETURNSTOCK	必须填写金蝶的表单ID如 UR_PurchaseOrder
FEntity.SubHeadEntity.Operation	执行的操作	Save
FEntity.SubHeadEntity.IsAutoSubmitAndAudit	提交并审核	true
FEntity.SubHeadEntity.IsVerifyBaseDataField	验证基础资料	true	是否验证所有的基础资料有效性，布尔类，默认false（非必录）
FEntity.SubHeadEntity.SubSystemId	系统模块	21	默认仓库模块

系统数据集成价值

通过无代码的数据集成与数据建模的智能数据管道技术，帮助企业将所有应用程序、数据库、事件和文件等数据信息提取到数据仓库中，并快速将分散的数据转化为数据集、API、自动化流程等开箱即用的数据服务。配置接口的模式对接聚水潭·奇门和金蝶云星空，使得单据无缝互通。打造企业内部数据一体化，让企业日常运营管理实现敏捷数据化运营。实现供应链业务信息流的互通，同时支持供应链数据分析流程自动化，结果推送，推进相关供应链问题优化。及时打通供应链孤岛，实现数据驱动供应链协同，进一步提升企业竞争力。