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

对接系统聚水潭

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

集成系统:金蝶云星空

金蝶K/3Cloud（金蝶云星空）是移动互联网时代的新型ERP，是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”，旨在帮助企业打造面向新时代的生态互联与协同平台，围绕生态中的每个角色，提供随手可得的云服务，最终实现敏捷协同，智慧运营的企业运营新境界。整个产品采用SOA架构，完全基于BOS平台组建而成，业务架构上贯穿流程驱动与角色驱动思想，结合中国管理模式与中国管理实践积累，精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建，支持跨数据库应用，支持本地部署、私有云部署与公有云部署三种部署方式，同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业，其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。

系统对接接口配置

系统对接前期需要通过调研公司的业务，规划出最便捷，效率最高的整体流程。通过流程我们需要建立对应的方案来吧这些流程一一的落地，轻易云集成平台开箱即用的、可视化拖、拉、拽实现接口服务编排与聚合。只需要根据指引设定好对应的参数即可启动使用。设定好源平台：聚水潭的接口参数设置，以及设定好目标平台：金蝶云星空的映射，即可启动方案进行测试轻易云数据集成中台提供快速与各种业务系统进行连接的能力，可以将软件接口上线到平台轻松实现数百款应用软件的数据互通。也可以将轻易云的集成能力嵌入到您的软件系统中，将数百款软件的集成能力变成您产品的功能与卖点，扩展额外收入，提升客户成交率，成交金额与满意度。

聚水潭接口明细

API：refund.single.query
NAME：退货退款查询
METHOD：POST

请求参数

接口字段名称预设值 shop_id店铺编号11086511,12435576 is_offline_shopshop_id为0且is_offline_shop为true查询线下店铺单据 modified_begin修改起始时间2022-04-09 18:40:57 modified_end修改结束时间2022-04-09 21:40:57 so_ids线上订单号 shop_buyer_ids指定买家账号 page_index第几页，从第一页开始，默认11 page_size每页多少条，默认30，最大505

响应参数

接口字段名称预设值 as_date申请时间 as_id售后单号 outer_as_id平台退货退款单号 o_id内部单号 so_id线上单号 created登记时间 modified修改时间 status状态 shop_status订单对应状态 remark备注 question_type问题类型 warehouse仓库 refund退款金额 payment补偿金额 good_status货物状态 node售后线下备注 order_status原订单状态 shop_id店铺编号 logistics_company物流公司 l_id物流单号 wh_id仓库编号 wms_co_id分仓编号 confirm_date最后确认日期 freight卖家应退运费 drp_co_id_from分销商编号 receiver_mobile收件人电话 receiver_name收件人名称 shop_buyer_id买家账号 items商品列表 items.as_idERP售后单号 items.type类型（退货，换货,补发） items.asi_id售后子单号 items.price单价 items.amount金额 items.name商品名称 items.pic图片地址 items.properties_value颜色规格 items.outer_oi_id子订单号 items.sku_type商品类型 items.r_qty实收退货数量 items.batchs批次集合 items.batchs.sku_id商品编码 items.batchs.qty商品数量 items.batchs.batch_no批次号 items.batchs.product_date批次日期 items.batchs.supplier_id供应商编号 items.batchs.supplier_name供应商名称

金蝶云星空接口明细

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

请求参数

接口字段名称预设值 FBillTypeID单据类型XSXSTHD FBillNo单据编号{{bfn_num}} FSaleOrgId销售组织findCollection find F_XC_Base_Fnumber from 8ea1287e-05cd-3ce7-b0e6-4a9a7daa783e where FNumber={{shop_id}} FDate日期{{items_receive_date}} FStockOrgId库存组织100 FRetcustId退货客户{{shop_id}} FHeadNote备注{{remark}} F_XC_Text业务员_findCollection find order_staff_name from 42a3ec23-0349-330c-90db-2455f04e598d where o_id={{o_id}} FEntity明细信息 FEntity.FMaterialId物料编码{{items_sku_id}} FEntity.FBarcode零售条形码 FEntity.FRealQty实退数量{{items_r_qty}} FEntity.FPrice单价 FEntity.FTaxPrice含税单价function {{items_amount}}/{{items_r_qty}} 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.F_XC_TEXT4快递单号{{l_id}} FEntity.FNote备注 FEntity.F_XC_TEXT5电商单号{{raw_so_id}} FEntity.SubHeadEntity财务信息 FEntity.SubHeadEntity.FSettleOrgId结算组织_findCollection find F_XC_Base_Fnumber from 8ea1287e-05cd-3ce7-b0e6-4a9a7daa783e where FNumber={{shop_id}} FEntity.SubHeadEntity.FSETTLECURRID结算币别PRE001 FEntity.SubHeadEntity.FormId业务对象表单IdSAL_RETURNSTOCK FEntity.SubHeadEntity.Operation执行的操作Save FEntity.SubHeadEntity.IsAutoSubmitAndAudit提交并审核true FEntity.SubHeadEntity.IsVerifyBaseDataField验证基础资料false FEntity.SubHeadEntity.SubSystemId系统模块21

系统集成总览

使用全界面可视化配置集成流，快速应对企业的集成需求使得聚水潭与金蝶云星空之间的数据接口一站式的快速集成能力，构建企业数据通道，解决数据孤岛问题。快速构建企业元数据标准、主数据标准、业财数据标准，完成数据的采集、统一、分发、清洗、归集等，帮助企业建立高质量的数据中台。目前轻易云平台已经支持300+系统，同时具备快速适配新系统的能力，集成海量接口数据。无论是对接ERP还是MES、OA、CRM、WMS、OMS等等系统，都可以通过接口相互集成。

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