网店管家·奇门和金蝶云星空接口打通对接实战
对接系统：网店管家·奇门
网店管家是一款面向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：表示结算时间 不填或者填写其他值默认为登记时间） |
| searchstatus | searchstatus | | 0 待收货 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 | 业务对象表单Id | SAL_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资产的可插拔、可复用、可组成。
