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

庄颜_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电商中心、供应商协同、多工厂计划、跨工厂领料、跨工厂加工、工厂间调拨、内部交易及结算、集团财务管理、阿米巴经营等。

系统对接接口配置

通过轻易云系统数据集成平台新增创建集成方案，通过轻易云的方案市场可以一键复制，并且可以借鉴其他的方案配置完成方案制作，方案制作只需要两步，第一步先确定好对应的数据来源；源系统：聚水潭接口：其他出入库查询通过请求调度者配置对应的请求参数即可获取到对应的数据。目标系统：金蝶云星空接口：销售退货新增，通过写入调度者匹配获取到的数据和写入的映射关系，即可自动生成符合目标系统：金蝶云星空写入的数据自动产生写入队列，通过运行概况，系统会自动帮你诊断方案的运行情况。实时监控到方案的运行情况

聚水潭接口明细

API：other.inout.query
NAME：其他出入库查询
METHOD：POST

请求参数

接口字段字段名称预设值描述 modified_begin修改起始时间{{LAST_SYNC_TIME datetime}} modified_end修改结束时间{{CURRENT_TIME datetime}} so_ids指定线上订单 types单据类型单据类型 :其它退货,其它出库,其它进仓 status单据状态Confirmed单据状态，Confirmed=生效，WaitConfirm待审核，Archive=归档，Cancelled=取消 page_index开始页码1 page_size每页行数{{PAGINATION_PAGE_SIZE}}

响应参数

接口字段字段名称预设值描述 io_date单据日期单据日期 status单据状态单据状态 so_id线上单号线上单号 type单据类型单据类型 f_status财务状态财务状态 warehouse仓库名称仓库名称 receiver_name收货人收货人 receiver_mobile收货人手机收货人手机 receiver_state收货人省收货人省 receiver_city收货人市收货人市 receiver_district收货人区收货人区 receiver_address收货人地址收货人地址 wh_id仓库编号仓库编号 modified修改时间修改时间 labels多标签多标签 wms_co_id分仓编号分仓编号 creator_name创建人创建人 items商品合集商品合集 items.io_id出仓单号出仓单号 items.remark商品备注商品备注 items.ioi_id子单号子单号 items.sku_id商品编码商品编码 items.name商品名称商品名称 items.properties_value颜色及规格颜色及规格 items.cost_price成本单价成本单价 items.cost_amount总成本价总成本价 items.i_id款式编码款式编码 items.sale_price单价单价 items.sale_amount金额金额 items.qty数量数量 items.batch批次集合 items.batch_no批次号批次号 items.product_date批次日期批次日期 items.supplier_id供应商编号供应商编号 items.supplier_name供应商名称供应商名称 items.inout_user出入库人员

金蝶云星空接口明细

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

请求参数

接口字段字段名称预设值描述 FBillTypeID单据类型XSTHD01_SYS单据类型 FBillNo单据编号{{io_id}}单据编号 FSaleOrgId销售组织findCollection find FSALEORGID_Fnumber from 9927cdb8-2b99-31f1-a379-964ddc5c777f where FBillNo={{so_id}}组织 FDate日期{{modified}}日期 FStockOrgId库存组织100组织 FRetcustId退货客户_findCollection find FRETCUSTID_Fnumber from 9927cdb8-2b99-31f1-a379-964ddc5c777f where FBillNo={{so_id}}基础资料 FHeadNote备注多行文本 FSalesManID销售员findCollection find FSalesManID from 9927cdb8-2b99-31f1-a379-964ddc5c777f where FBillNo={{so_id}} F_XC_Base跟单员_findCollection find F_XC_Base1 from 9927cdb8-2b99-31f1-a379-964ddc5c777f where FBillNo={{so_id}} F_XC_Base1运营员findCollection find F_XC_Base from 9927cdb8-2b99-31f1-a379-964ddc5c777f where FBillNo={{so_id}} FEntity明细信息items FEntity.FMaterialId物料编码{{items.sku_id}}基础资料 FEntity.FBarcode零售条形码文本 FEntity.FRealQty实退数量{{items.qty}}数量 FEntity.FTAXPRICE含税单价_findCollection find FTAXPRICE from 9927cdb8-2b99-31f1-a379-964ddc5c777f where FBillNo={{so_id}} FMaterialID_Fnumber={{items.sku_id}}单价 FEntity.FIsFree是否赠品复选框 FEntity.FEntryTaxRate税率%小数 FEntity.FReturnType退货类型单选辅助资料列表 FEntity.FOwnerTypeId货主类型BD_OwnerOrg多类别基础资料列表 FEntity.FOwnerId货主100多类别基础资料 FEntity.FStockId仓库{{wms_co_id}}基础资料 FEntity.FLot批号{{items.batch_no}}批次 FEntity.FProduceDate生产日期{{items.product_date}} FEntity.FDeliveryDate退货日期长日期 FEntity.FNote备注文本 FEntity.FSRCBILLTYPEID源单类型SAL_RETURNNOTICE FEntity.FSRCBILLNO源单编号{{so_id}} FEntity.FORDERNO订单单号findCollection find FSRCBILLNO from 9927cdb8-2b99-31f1-a379-964ddc5c777f where FBillNo={{so_id}}文本 FEntity.FExpiryDate有效期至{{batchs.expiration_date}} FEntity.FEntity_Link关联关系表 FEntity.FEntity_Link.FEntity_Link_FRuleId转换规则SalReturnNotice-SalReturnStock FEntity.FEntity_Link.FEntity_Link_FSTableName源单表T_SAL_RETURNNOTICEENTRY FEntity.FEntity_Link.FEntity_Link_FSBillId源单内码_findCollection find FID from 9927cdb8-2b99-31f1-a379-964ddc5c777f where FBillNo={{so_id}} FEntity.FEntity_Link.FEntity_Link_FSId源单分录内码findCollection find FEntity_FEntryID from 9927cdb8-2b99-31f1-a379-964ddc5c777f where FBillNo={{so_id}} FMaterialID_Fnumber={{items.sku_id}} FEntity.SubHeadEntity财务信息 FEntity.SubHeadEntity.FSettleOrgId结算组织_findCollection find FSALEORGID_Fnumber from 9927cdb8-2b99-31f1-a379-964ddc5c777f where FBillNo={{so_id}}组织 FEntity.SubHeadEntity.FSettleCurrId结算币别PRE001基础资料 FEntity.SubHeadEntity.FormId业务对象表单IdSAL_RETURNSTOCK必须填写金蝶的表单ID如😛UR_PurchaseOrder FEntity.SubHeadEntity.Operation执行的操作Save FEntity.SubHeadEntity.IsAutoSubmitAndAudit提交并审核true FEntity.SubHeadEntity.IsVerifyBaseDataField验证基础资料false是否验证所有的基础资料有效性，布尔类，默认false（非必录） FEntity.SubHeadEntity.SubSystemId系统模块21默认仓库模块

系统数据集成价值

通过数据集成平台可视化的快速配置调用接口打通聚水潭与金蝶云星空之间的数据接口，使得两个系统之间的对接更加快捷、稳定。轻易云数据集成平台打破信息孤岛、适配多种场景、降低运营成本、缩短开发周期、灵活调度配置是这种多系统数据打通时的特性优势。采用元数据模型驱动的低代码集成工具，基于系统预置的数据模型、映射、编排、日志、脚本等集成核心引擎，通过可视化配置，快速实现客户灵活多变的动态集成需求，让集成开发简单、执行过程可靠、问题风险可控。