聚水潭·奇门、金蝶云星空通过接口配置数据对接
对接系统:聚水潭·奇门
聚水潭成立于2014年,创始人兼CEO骆海东拥有近三十年传统及电商ERP的研发和实施部署经验。聚水潭创建之初,以电商SaaSERP切入市场,凭借出色的产品和服务,快速获得市场的肯定。随着客户需求的不断变化,如今聚水潭已经发展成为以SaaSERP为核心,集多种商家服务为一体的SaaS协同平台。经过8年多的发展,公司员工从2014年成立之初的9人增加到现在近4000人。聚水潭已在全国设立了超过100个线下服务网点,服务范围覆盖超过400个城镇,为客户提供及时、周到和专业的服务。
目标系统:金蝶云星空
金蝶K/3Cloud结合当今先进管理理论和数十万家国内客户最佳应用实践,面向事业部制、多地点、多工厂等运营协同与管控型企业及集团公司,提供一个通用的ERP服务平台。K/3Cloud支持的协同应用包括但不限于:集中/分散销售、集中/分散采购、B2B电商管理、B2C电商中心、供应商协同、多工厂计划、跨工厂领料、跨工厂加工、工厂间调拨、内部交易及结算、集团财务管理、阿米巴经营等。
系统对接接口配置
使用系统数据集成平台对应的模块:数据集成方案。然后选择开始创建数据集成方案。在方案配置表单中选择对应的源业务系统:聚水潭·奇门,然后选择对应的连接器。选择对应的订单查询作为数据对接来源。然后再通过写入目标平台配置目标系统为金蝶云星空,并且选择对应连接器(关于金蝶云星空的接口如何配置可以在轻易云数据集成社区论坛中找到相关信息,选择好对应的[聚水潭][销售退货单标准新增]-v1接口作为数据写入动作,既可以完成第一步的数据对接配置。
聚水潭·奇门接口明细
- 调用接口:refund.single.query
- 接口名称:订单查询
- 方法:POST
请求参数
字段 | 字段名称 | 类型 | 配置值 |
shop_id | 店铺编号 | string | |
is_offline_shop | shop_id为0且is_offline_shop为true查询线下店铺单据 | string | |
modified_begin | 修改起始时间 | string | {{LAST_SYNC_TIME datetime}} |
modified_end | 修改结束时间 | string | {{CURRENT_TIME datetime}} |
so_ids | 线上订单号 | string | |
shop_buyer_ids | 指定买家账号 | string | |
page_index | 第几页,从第一页开始,默认1 | string | 1 |
page_size | 每页多少条,默认30,最大50 | string | 50 |
响应参数
字段 | 字段名称 | 类型 | 配置值 |
as_date | 申请时间 | string | |
outer_as_id | 平台退货退款单号 | string | |
o_id | 内部单号 | string | |
so_id | 线上单号 | string | |
created | 登记时间 | string | |
modified | 修改时间 | string | |
status | 状态 | string | |
shop_status | 订单对应状态 | string | |
remark | 备注 | string | |
question_type | 问题类型 | array | |
warehouse | 仓库 | string | |
refund | 退款金额 | string | |
payment | 补偿金额 | string | |
good_status | 货物状态 | string | |
node | 售后线下备注 | string | |
order_status | 原订单状态 | string | |
shop_id | 店铺编号 | string | |
logistics_company | 物流公司 | string | |
l_id | 物流单号 | string | |
wh_id | 仓库编号 | string | |
wms_co_id | 分仓编号 | string | |
confirm_date | 最后确认日期 | string | |
freight | 卖家应退运费 | string | |
drp_co_id_from | 分销商编号 | string | |
receiver_mobile | 收件人电话 | string | |
receiver_name | 收件人名称 | string | |
shop_buyer_id | 买家账号 | string | |
items | 商品列表 | array | |
items.as_id | ERP售后单号 | string | |
items.type | 类型(退货,换货,补发) | string | |
items.asi_id | 售后子单号 | string | |
items.price | 单价 | string | |
items.amount | 金额 | string | |
items.name | 商品名称 | string | |
items.pic | 图片地址 | string | |
items.properties_value | 颜色规格 | string | |
items.outer_oi_id | 子订单号 | string | |
items.sku_type | 商品类型 | string | |
items.r_qty | 实收退货数量 | string | |
items.batchs | 批次集合 | array | |
items.batchs.sku_id | 商品编码 | string | |
items.batchs.qty | 商品数量 | string | |
items.batchs.batch_no | 批次号 | string | |
items.batchs.product_date | 批次日期 | string | |
items.batchs.supplier_id | 供应商编号 | string | |
items.batchs.supplier_name | 供应商名称 | string | |
金蝶云星空接口明细
- 调用接口:batchSave
- 接口名称:[聚水潭][销售退货单标准新增]-v1
- 方法:POST
请求参数
字段 | 字段名称 | 类型 | 配置值 |
FBillTypeID | 单据类型 | string | XSTHD01_SYS |
FBillNo | 单据编号 | string | {{o_id}} |
FSaleOrgId | 销售组织 | string | 100 |
FDate | 日期 | string | {{confirm_date}} |
FStockOrgId | 库存组织 | string | 100 |
FRetcustId | 退货客户 | string | |
FSettleCurrId | 结算币别 | string | PRE001 |
FHeadNote | 备注 | string | {{as_id}} |
FEntity | 明细信息 | array | |
FEntity.FMaterialId | 物料编码 | string | {{items.sku_id}} |
FEntity.FRealQty | 实退数量 | string | {{items.qty}} |
FEntity.FPrice | 单价 | string | {{items.price}} |
FEntity.FTaxPrice | 含税单价 | string | |
FEntity.FIsFree | 是否赠品 | string | |
FEntity.FEntryTaxRate | 税率% | string | |
FEntity.FReturnType | 退货类型 | string | THLX01_SYS |
FEntity.FOwnerTypeId | 货主类型 | string | BD_OwnerOrg |
FEntity.FOwnerId | 货主 | string | |
FEntity.FStockId | 仓库 | string | |
FEntity.FNote | 备注 | string | |
FEntity.SubHeadEntity | 财务信息 | object | |
FEntity.SubHeadEntity.FSettleOrgId | 结算组织 | string | 100 |
FEntity.SubHeadEntity.FormId | 业务对象表单Id | string | SAL_RETURNSTOCK |
FEntity.SubHeadEntity.Operation | 执行的操作 | string | BatchSave |
FEntity.SubHeadEntity.IsAutoSubmitAndAudit | 提交并审核 | bool | true |
FEntity.SubHeadEntity.IsVerifyBaseDataField | 验证基础资料 | bool | false |
系统数据集成价值
当企业规模逐渐增大时,作为支撑业务运营的IT建设也变得越来越重要,不过往往企业的IT建设过程中会发现某一家软件供应商基本不能完全覆盖企业所有的业务运营流程,这样的结果就是,企业上的IT系统很多很全,从ERP到HR、CRM、PDM、OA等,貌似所有的业务都覆盖到了,但实际上因为这些系统的不集成,而形成了企业很多新的信息孤岛,非常不利于企业的后续的管理和战略发展。从现今和往后的发展趋势来看,也不可避免会遇到上述问题,毕竟企业经营的多样化,并不是所有的业务都能在一个系统中完成,所以我们必须在产品架构上支持更好的与外部系统进行协同。通过轻易云集成平台统一的API管理平台,对API进行显性化、可视化,使所有API服务成为企业的数字资产,提升API利用率,发挥业务系统价值,实现企业IT资产的可插拔、可复用、可组成。