聚水潭·奇门和金蝶云星空接口打通对接实战
对接系统:聚水潭·奇门
聚水潭成立于2014年,创始人兼CEO骆海东拥有近三十年传统及电商ERP的研发和实施部署经验。聚水潭创建之初,以电商SaaSERP切入市场,凭借出色的产品和服务,快速获得市场的肯定。随着客户需求的不断变化,如今聚水潭已经发展成为以SaaSERP为核心,集多种商家服务为一体的SaaS协同平台。经过8年多的发展,公司员工从2014年成立之初的9人增加到现在近4000人。聚水潭已在全国设立了超过100个线下服务网点,服务范围覆盖超过400个城镇,为客户提供及时、周到和专业的服务。
对接目标系统:金蝶云星空
金蝶K/3Cloud在总结百万家客户管理最佳实践的基础上,提供了标准的管理模式;通过标准的业务架构:多会计准则、多币别、多地点、多组织、多税制应用框架等,有效支持企业的运营管理;K/3Cloud提供了标准的业务建模:35种标准ERP领域模型、1046种模型元素、21243种模型元素属性组合,288个业务服务构件,让企业及伙伴可快速构建出行业化及个性化的应用。
多系统对接方案配置
集成方案是整个轻易云集成平台的核心,每一个集成方案代表一种业务的对接策略(对接方案借鉴可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息),用户可以根据业务的不同新建多个不同规则的集成方案。比如:采购订单同步,线上销售出库同步,线下销售出库同步。一个集成方案必须要配置源系统:聚水潭·奇门,源系统 API:订单查询,目标系统:金蝶云星空,目标系统 API[聚水潭][销售退货单标准新增]-v1。在新增集成方案之前需要确定两个系统的连接器都已经配置完成。
聚水潭·奇门接口明细
- 调用接口:jushuitan.refund.list.query
- 接口名称:订单查询
- 方法:POST
请求参数
字段 | 字段名称 | 类型 | 配置值 |
page_index | 页码 | string | 1 |
page_size | 页数 | string | 50 |
start_time | 开始时间 | string | 2022-12-01 00:00:00 |
end_time | 结束时间 | string | 2022-12-01 23:59:59 |
so_ids | 线上单号列表 | string | |
date_type | 时间类型 | string | |
status | status | string | |
good_status | good_status | string | |
响应参数
字段 | 字段名称 | 类型 | 配置值 |
as_id | as_id | string | |
as_date | as_date | string | |
outer_as_id | outer_as_id | string | |
so_id | so_id | string | |
type | type | string | |
modified | modified | string | |
items | items | array | |
items.amount | amount | string | |
items.combine_sku_id | combine_sku_id | string | |
items.asi_id | asi_id | string | |
items.sku_id | sku_id | string | |
items.qty | qty | string | |
items.price | price | string | |
items.name | name | string | |
items.type | type | string | |
items.properties_value | properties_value | string | |
items.r_qty | r_qty | string | |
items.shop_name | shop_name | string | |
items.type | 售后类型 | string | |
items.date_type | 时间类型 | string | |
items.wms_co_id | wms_co_id | string | |
items.drp_co_id_from | drp_co_id_from | string | |
金蝶云星空接口明细
- 调用接口:batchSave
- 接口名称:[聚水潭][销售退货单标准新增]-v1
- 方法:POST
请求参数
字段 | 字段名称 | 类型 | 配置值 |
FBillTypeID | 单据类型 | string | XSTHD01_SYS |
FBillNo | 单据编号 | string | {{as_id}} |
FSaleOrgId | 销售组织 | string | function case when'{{shop_id}}' ='12948597' then '102' else '101' end |
FDate | 日期 | string | {{as_date}} |
FStockOrgId | 库存组织 | string | _function case when'{{shop_id}}' ='12948597' then '102' else '101' end |
FRetcustId | 退货客户 | string | function case when'{{drp_co_id_from}}'='' then '{{new_shop_id}}' else '{{drp_co_id_from}}' end |
FSettleCurrId | 结算币别 | string | _function case when'{{shop_id}}' ='12948597' then 'PRE007' else 'PRE001' end |
FHeadNote | 备注 | string | {{as_id}} |
FEntity | 明细信息 | array | items |
FEntity.FMaterialId | 物料编码 | string | {{items.sku_id}} |
FEntity.FRealQty | 实退数量 | string | {{items.r_qty}} |
FEntity.FPrice | 单价 | string | {{items.price}} |
FEntity.FTaxPrice | 含税单价 | string | {{items.price}} |
FEntity.FIsFree | 是否赠品 | string | |
FEntity.FEntryTaxRate | 税率% | string | |
FEntity.FReturnType | 退货类型 | string | THLX01_SYS |
FEntity.FOwnerTypeId | 货主类型 | string | BD_OwnerOrg |
FEntity.FOwnerId | 货主 | string | |
FEntity.FStockId | 仓库 | string | {{wms_co_id}} |
FEntity.FNote | 备注 | string | |
FEntity.SubHeadEntity | 财务信息 | object | |
FEntity.SubHeadEntity.FSettleOrgId | 结算组织 | string | _function case when'{{shop_id}}' ='12948597' then '102' else '101' end |
FEntity.SubHeadEntity.F_KLF_Text1 | 聚水潭物流单号 | string | {{l_id}} |
FEntity.SubHeadEntity.F_KLF_Text | 聚水潭订单号 | string | {{so_id}} |
FEntity.SubHeadEntity.FormId | 业务对象表单Id | string | SAL_RETURNSTOCK |
FEntity.SubHeadEntity.Operation | 执行的操作 | string | BatchSave |
FEntity.SubHeadEntity.IsAutoSubmitAndAudit | 提交并审核 | bool | true |
FEntity.SubHeadEntity.IsVerifyBaseDataField | 验证基础资料 | bool | false |
系统对接总览
基于轻易云的连接器和数据服务能力,轻松实现供应链异构系统的“相互沟通”,通过数据应用自动化业务流程管理,全面管控供应链的每一环节。从要货、销售出库、退货入库、到盘点、调拨,无需人工参与,实时更新,自动化流转。通过快速连接聚水潭·奇门接口抽取数据后再自动分发到金蝶云星空, 解放生产力,自动生成数据、并分发推送到业务应用,数据传递时效性提升10倍以上。