网店管家·奇门与金蝶云星空对接集成查询管家中产生的退换订单连通销售退货新增(销售退换订单-销售退货)
来源系统:网店管家·奇门
“网店管家”是广泛应用于电商行业，开发历史悠久的电子商务ERP/CRM/O2O/跨境一体化解决方案。功能上囊括了订单处理、生产加工、财务账款、供应链、仓储、门店管家(ePOS)、跨境以及CRM、OA等主要模块。“网店管家”价格公开，自由下载，免费试用，开放论坛，重产品，轻交付，操作简单，短时间可下载学习掌握，给用户带来极大的便利性，为大促活动标配软件
集成系统:金蝶云星空
金蝶K/3Cloud结合当今先进管理理论和数十万家国内客户最佳应用实践，面向事业部制、多地点、多工厂等运营协同与管控型企业及集团公司，提供一个通用的ERP服务平台。K/3Cloud支持的协同应用包括但不限于：集中/分散销售、集中/分散采购、B2B电商管理、B2C电商中心、供应商协同、多工厂计划、跨工厂领料、跨工厂加工、工厂间调拨、内部交易及结算、集团财务管理、阿米巴经营等。
数据接口配置
通过轻易云系统数据集成平台新增创建集成方案，然后在数据源平台中选择对应的源平台为：网店管家·奇门，并且选择对应的连接器（关于网店管家·奇门的接口连接器如何配置可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息）。选择对应的查询管家中产生的退换订单接口作为数据对接来源。然后再通过写入目标平台配置目标系统为金蝶云星空，并且选择对应连接器。选择对应的销售退货新增接口作为数据写入动作，既可以完成第一步的数据对接配置；打破跨系统连接，让数据轻易互通成为现实。
网店管家·奇门接口明细
- 接口：wdgj.sellbacknosensitiveinfo.list.get
- 接口名称：查询管家中产生的退换订单
- 接口方法：POST
请求参数
| 字段 | 名称 | 类型 | 描述 |
|---|
| pageno | 页码 | String | 页码 |
| pagesize | 每页条数 | String | 每页条数，取值范围 1 ~ 100 |
| begintime | 查询开始时间 | String | 查询开始时间 YYYY-MM-DD HH:mm:ss |
| endtime | 查询结束时间 | String | 查询结束时间 YYYY-MM-DD HH:mm:ss |
| timetype | 时间类型 | String | 时间类型（1：表示登记时间，2：表示收货时间, 3：表示结算时间 不填或者填写其他值默认为登记时间） |
| searchstatus | searchstatus | String | 0 待收货 1 待结算 2 被取消 3 已完成 4 待审核 默认所有 |
| searchno | 退换单号 | String | 退换单号 |
| relationno | 关联单号 | String | 关联单号（管家订单号） |
| querymarkup | 单据查询标记 | String | 单据查询标记 |
响应参数
| 字段 | 名称 | 类型 | 描述 |
|---|
| tradeid | 退换单ID | String | 退换单ID |
| tradeno | 退换单号 | String | 退换单号 |
| rawno | 原始单号 | String | 原始单号 |
| oldno | 管家原关联订单号 | String | 管家原关联订单号 |
| newno | 换货管家关联订单号 | String | 换货管家关联订单号 |
| tradestatus | 退换单状态 | String | 退换单状态 0 待收货 1 待结算 2 被取消 3 已完成 4 待审核 |
| shopname | 原店铺名 | String | 原店铺名 |
| shopno | 原店铺编号 | String | 原店铺编号 |
| shopname2 | 换货店铺名 | String | 换货店铺名 |
| chargetime | 结算时间 | String | 结算时间 |
| regtime | 登记时间 | String | 登记时间 |
| rcvtime | 收货时间 | String | 收货时间 |
| seller | 业务员 | String | 业务员 |
| tradetype | 原订单类型 | String | 原订单类型 |
| warehouseid | 退货仓库id | String | 退货仓库id |
| warehouseno | 退货仓库编号 | String | 退货仓库编号 |
| warehousename | 退货仓库名 | String | 退货仓库名 |
| warehouseid2 | 换货仓库id | String | 换货仓库id |
| warehouseno2 | 换货仓库编号 | String | 换货仓库编号 |
| warehousename2 | 换货仓库名 | String | 换货仓库名 |
| logisticid | 物流id | String | 物流id |
| logisticno | 物流编号 | String | 物流编号 |
| logisticname | 物流名 | String | 物流名 |
| postid | 快递单号 | String | 快递单号 |
| postagetotal | 应收邮资 | String | 应收邮资 |
| totalrcv | 换货金额 | String | 换货金额 |
| totalpay | 退货金额 | String | 退货金额 |
| returntotal | 应退合计 | String | 应退合计 |
| recvtotal | 结算金额 | String | 结算金额 |
| reason | 取消原因 | String | 取消原因 |
| remark | 卖家备注 | String | 卖家备注 |
| customerid | 会员id | String | 会员id |
| shoptype | 原店铺类别 | String | 原店铺类别 |
| shoptype2 | 换货店铺类别 | String | 换货店铺类别 |
| zip | 邮编 | String | 邮编 |
| returntype | 类型 | String | 类型“退”只有退货；“换”有换货 |
| goodslist | 退货商品明细 | array | 退货商品明细 |
| goodslist.goodsid | 货品ID | String | 货品ID |
| goodslist.specid | 规格ID | String | 规格ID，单规格为0 |
| goodslist.goodsno | 货品编号 | String | 货品编号 |
| goodslist.goodsname | 品名 | String | 品名 |
| goodslist.unit | 单位 | String | 单位 |
| goodslist.specname | 规格名 | String | 规格名 |
| goodslist.price | 单价 | String | 单价 |
| goodslist.goodscount | 数量 | String | 数量 |
| goodslist.goodsmoney | 金额 | String | 金额 |
| goodslist.barcode | 条码 | String | 条码 （条码+附加码） |
| goodslist.remark | 备注 | String | 备注 |
| goodslist.bgift | 是否赠品 | String | 是否赠品 True/False（换货没有这个字段） |
| goodslist.bfit | 是否组合装 | String | 是否组合装 True/False |
| goodslist.recid | 记录id | String | 记录id（唯一） |
| goodslist.goodslist2 | 换货商品明细 | array | 换货商品明细 |
| goodslist.goodslist2.goodsid | 货品ID | String | 货品ID |
| goodslist.goodslist2.stockinno | 退换单关联入库单号 | String | 退换单关联入库单号 |
| goodslist.goodslist2.shopno2 | 换货店铺编号 | String | 换货店铺编号 |
| goodslist.goodslist2.country | 国家 | String | 国家 |
| goodslist.goodslist2.province | 省 | String | 省 |
| goodslist.goodslist2.city | 市 | String | 市 |
| goodslist.goodslist2.town | 区县 | String | 区县 |
| goodslist.goodslist2.returnspreferential | 退货优惠 | String | 退货优惠 |
| goodslist.goodslist2.exchangepreferential | 换货优惠 | String | 换货优惠 |
| goodslist.goodslist2.orderpreferential | 订单优惠 | String | 订单优惠 |
| goodslist.goodslist2.nickname | 网名 | String | 网名 |
| goodslist.goodslist2.sndto | 收件人 | String | 收件人 |
| goodslist.goodslist2.adr | 地址 | String | 地址 |
| goodslist.goodslist2.orderadr | 原订单的地址 | String | 原订单的地址 |
| goodslist.goodslist2.tel | 电话 | String | 电话 |
| goodslist.goodslist2.specid | 规格ID | String | 规格ID，单规格为0 |
| goodslist.goodslist2.goodsno | 货品编号 | String | 货品编号 |
| goodslist.goodslist2.goodsname | 品名 | String | 品名 |
| goodslist.goodslist2.unit | 单位 | String | 单位 |
| goodslist.goodslist2.specname | 规格名 | String | 规格名 |
| goodslist.goodslist2.price | 单价 | String | 单价 |
| goodslist.goodslist2.goodscount | 数量 | String | 数量 |
| goodslist.goodslist2.goodsmoney | 金额 | String | 金额 |
| goodslist.goodslist2.barcode | 条码 | String | 条码 （条码+附加码） |
| goodslist.goodslist2.remark | 备注 | String | 备注 |
| goodslist.goodslist2.bgift | 是否赠品 | String | 是否赠品 True/False（换货没有这个字段） |
| goodslist.goodslist2.bfit | 是否组合装 | String | 是否组合装 True/False |
| goodslist.goodslist2.recid | 记录id（唯一） | String | 记录id（唯一） |
金蝶云星空接口明细
- 调用接口：batchSave
- 接口名称：销售退货新增
- 方法：POST
请求参数
| 字段 | 字段名称 | 类型 | 配置值 |
|---|
| FBillTypeID | 单据类型 | string | XSTHD01_SYS |
| FBillNo | 单据编号 | string | {{tradeno}} |
| FSaleOrgId | 销售组织 | string | 100 |
| FDate | 日期 | string | {{rcvtime}} |
| FStockOrgId | 库存组织 | string | 100 |
| FRetcustId | 退货客户 | string | {{shopno}} |
| FHeadNote | 备注 | string | |
| FEntity | 明细信息 | array | goodslist |
| FEntity.FMaterialId | 物料编码 | string | findCollection find FNumber from 82ef9f7d-42dc-3e11-bd3c-3814cc3c044d where FBARCODE={{goodslist.goodsno}} |
| FEntity.FBarcode | 零售条形码 | string | |
| FEntity.FRealQty | 实退数量 | string | {{goodslist.goodscount}} |
| FEntity.FPrice | 单价 | string | |
| FEntity.FTaxPrice | 含税单价 | string | _function round(({{goodslist.goodsmoney}}/{{goodslist.goodscount}}),6) |
| FEntity.FIsFree | 是否赠品 | string | {{goodslist.bgift}} |
| FEntity.FEntryTaxRate | 税率% | string | |
| FEntity.FReturnType | 退货类型 | string | THLX01_SYS |
| FEntity.FStockId | 仓库 | string | {{warehouseno}} |
| FEntity.FNote | 备注 | string | |
| FEntity.SubHeadEntity | 财务信息 | object | |
| FEntity.SubHeadEntity.FSettleOrgId | 结算组织 | string | 100 |
| FEntity.SubHeadEntity.FormId | 业务对象表单Id | string | SAL_RETURNSTOCK |
| FEntity.SubHeadEntity.Operation | 执行的操作 | string | Save |
| FEntity.SubHeadEntity.IsAutoSubmitAndAudit | 提交并审核 | bool | true |
| FEntity.SubHeadEntity.IsVerifyBaseDataField | 验证基础资料 | bool | false |
| FEntity.SubHeadEntity.SubSystemId | 系统模块 | string | 21 |
数据对接价值
全面管控企业的API资产，梳理现有业务系统的API。实现API文档的统一管理，建立API的上线、下线、监控的统一管理体系。API低代码开发平台能够实现低代码或零代码一键发布API服务，很好地解决企业用户上面的问题。轻易云应用集成主要解决已有应用系统的无序蔓延现象，减少各业务系统间的维护成本，减少各应用系统的操作系统、开发语言、访问协议、通信技术多而杂、整合难度大的问题，将企业数据平滑对接，减少信息竖井。
