网店管家·奇门和金蝶云星空接口打通对接实战

对接系统：网店管家·奇门

网店管家是一款面向B2C企业、C2C团队卖家的企业级电子商务C/S架构ERP软件，是业内应用广泛的电子商务后台系统。以订单处理为主线，进销存为核心，涵盖了订单处理、CRM、WMS、SCM、办公OA、售后服务等业务模块。

对接系统：金蝶云星空

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

数据集成方案配置

通过可视化界面的拖、拉、拽即可轻松快速构建数据集成流程，将网店管家·奇门、金蝶云星空之间接口数据联通，支持数据在线预览、数据集成流程全过程调试，Web界面追踪调试日志等功能。平台兼具实时数据处理和数据集成分发功能，用户通过可视化的拖、拽即可完成数据处理逻辑，将数据加工处理后分发到下游业务系统或其他异构存储中。

网店管家·奇门接口明细

API：wdgj.sellbacknosensitiveinfo.list.get
NAME：查询管家中产生的退换订单
METHOD：POST

请求参数

接口字段字段名称预设值描述 pageno页码1页码 pagesize每页条数100每页条数，取值范围 1 ~ 100 begintime查询开始时间{{LAST_SYNC_TIME datetime}}查询开始时间 YYYY-MM-DD HH:mm:ss endtime查询结束时间{{CURRENT_TIME datetime}}查询结束时间 YYYY-MM-DD HH:mm:ss timetype时间类型2时间类型（1：表示登记时间，2：表示收货时间, 3：表示结算时间不填或者填写其他值默认为登记时间） searchstatussearchstatus0 待收货 1 待结算 2 被取消 3 已完成 4 待审核默认所有 searchno退换单号退换单号 relationno关联单号关联单号（管家订单号） querymarkup单据查询标记单据查询标记

响应参数

接口字段字段名称预设值描述 tradeid退换单ID退换单ID tradeno退换单号退换单号 rawno原始单号原始单号 oldno管家原关联订单号管家原关联订单号 newno换货管家关联订单号换货管家关联订单号 tradestatus退换单状态退换单状态 0 待收货 1 待结算 2 被取消 3 已完成 4 待审核 shopname原店铺名原店铺名 shopno原店铺编号原店铺编号 shopname2换货店铺名换货店铺名 chargetime结算时间结算时间 regtime登记时间登记时间 rcvtime收货时间收货时间 seller业务员业务员 tradetype原订单类型原订单类型 warehouseid退货仓库id退货仓库id warehouseno退货仓库编号退货仓库编号 warehousename退货仓库名退货仓库名 warehouseid2换货仓库id换货仓库id warehouseno2换货仓库编号换货仓库编号 warehousename2换货仓库名换货仓库名 logisticid物流id物流id logisticno物流编号物流编号 logisticname物流名物流名 postid快递单号快递单号 postagetotal应收邮资应收邮资 totalrcv换货金额换货金额 totalpay退货金额退货金额 returntotal应退合计应退合计 recvtotal结算金额结算金额 reason取消原因取消原因 remark卖家备注卖家备注 customerid会员id会员id shoptype原店铺类别原店铺类别 shoptype2换货店铺类别换货店铺类别 zip邮编邮编 returntype类型类型“退”只有退货；“换”有换货 goodslist退货商品明细退货商品明细 goodslist.goodsid货品ID货品ID goodslist.specid规格ID规格ID，单规格为0 goodslist.goodsno货品编号货品编号 goodslist.goodsname品名品名 goodslist.unit单位单位 goodslist.specname规格名规格名 goodslist.price单价单价 goodslist.goodscount数量数量 goodslist.goodsmoney金额金额 goodslist.barcode条码条码（条码+附加码） goodslist.remark备注备注 goodslist.bgift是否赠品是否赠品 True/False（换货没有这个字段） goodslist.bfit是否组合装是否组合装 True/False goodslist.recid记录id记录id（唯一） goodslist.goodslist2换货商品明细换货商品明细 goodslist.goodslist2.goodsid货品ID货品ID goodslist.goodslist2.stockinno退换单关联入库单号退换单关联入库单号 goodslist.goodslist2.shopno2换货店铺编号换货店铺编号 goodslist.goodslist2.country国家国家 goodslist.goodslist2.province省省 goodslist.goodslist2.city市市 goodslist.goodslist2.town区县区县 goodslist.goodslist2.returnspreferential退货优惠退货优惠 goodslist.goodslist2.exchangepreferential换货优惠换货优惠 goodslist.goodslist2.orderpreferential订单优惠订单优惠 goodslist.goodslist2.nickname网名网名 goodslist.goodslist2.sndto收件人收件人 goodslist.goodslist2.adr地址地址 goodslist.goodslist2.orderadr原订单的地址原订单的地址 goodslist.goodslist2.tel电话电话 goodslist.goodslist2.specid规格ID规格ID，单规格为0 goodslist.goodslist2.goodsno货品编号货品编号 goodslist.goodslist2.goodsname品名品名 goodslist.goodslist2.unit单位单位 goodslist.goodslist2.specname规格名规格名 goodslist.goodslist2.price单价单价 goodslist.goodslist2.goodscount数量数量 goodslist.goodslist2.goodsmoney金额金额 goodslist.goodslist2.barcode条码条码（条码+附加码） goodslist.goodslist2.remark备注备注 goodslist.goodslist2.bgift是否赠品是否赠品 True/False（换货没有这个字段） goodslist.goodslist2.bfit是否组合装是否组合装 True/False goodslist.goodslist2.recid记录id（唯一）记录id（唯一）

金蝶云星空接口明细

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

请求参数

接口字段字段名称预设值描述 FBillTypeID单据类型XSTHD01_SYS单据类型 FBillNo单据编号{{tradeno}}单据编号 FSaleOrgId销售组织100组织 FDate日期{{rcvtime}}日期 FStockOrgId库存组织100组织 FRetcustId退货客户{{shopno}}基础资料 FHeadNote备注多行文本 FEntity明细信息goodslist FEntity.FMaterialId物料编码findCollection find FNumber from 82ef9f7d-42dc-3e11-bd3c-3814cc3c044d where FBARCODE={{goodslist.goodsno}}基础资料 FEntity.FBarcode零售条形码文本 FEntity.FRealQty实退数量{{goodslist.goodscount}}数量 FEntity.FPrice单价单价 FEntity.FTaxPrice含税单价_function round(({{goodslist.goodsmoney}}/{{goodslist.goodscount}}),6)单价 FEntity.FIsFree是否赠品{{goodslist.bgift}}复选框 FEntity.FEntryTaxRate税率%小数 FEntity.FReturnType退货类型THLX01_SYS单选辅助资料列表 FEntity.FStockId仓库{{warehouseno}}基础资料 FEntity.FNote备注文本 FEntity.SubHeadEntity财务信息 FEntity.SubHeadEntity.FSettleOrgId结算组织100组织 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默认仓库模块

系统数据集成价值

当企业规模逐渐增大时，作为支撑业务运营的IT建设也变得越来越重要，不过往往企业的IT建设过程中会发现某一家软件供应商基本不能完全覆盖企业所有的业务运营流程，这样的结果就是，企业上的IT系统很多很全，从ERP到HR、CRM、PDM、OA等，貌似所有的业务都覆盖到了，但实际上因为这些系统的不集成，而形成了企业很多新的信息孤岛，非常不利于企业的后续的管理和战略发展。从现今和往后的发展趋势来看，也不可避免会遇到上述问题，毕竟企业经营的多样化，并不是所有的业务都能在一个系统中完成，所以我们必须在产品架构上支持更好的与外部系统进行协同。通过轻易云集成平台统一的API管理平台，对API进行显性化、可视化，使所有API服务成为企业的数字资产，提升API利用率，发挥业务系统价值，实现企业IT资产的可插拔、可复用、可组成。

网店管家·奇门和金蝶云星空接口打通对接实战