金蝶云星空和网店管家·奇门单据接口对接
对接系统：网店管家·奇门
“网店管家”是广泛应用于电商行业，开发历史悠久的电子商务ERP/CRM/O2O/跨境一体化解决方案。功能上囊括了订单处理、生产加工、财务账款、供应链、仓储、门店管家(ePOS)、跨境以及CRM、OA等主要模块。“网店管家”价格公开，自由下载，免费试用，开放论坛，重产品，轻交付，操作简单，短时间可下载学习掌握，给用户带来极大的便利性，为大促活动标配软件
写入目标:金蝶云星空
金蝶K/3Cloud在总结百万家客户管理最佳实践的基础上，提供了标准的管理模式；通过标准的业务架构：多会计准则、多币别、多地点、多组织、多税制应用框架等，有效支持企业的运营管理；K/3Cloud提供了标准的业务建模：35种标准ERP领域模型、1046种模型元素、21243种模型元素属性组合，288个业务服务构件，让企业及伙伴可快速构建出行业化及个性化的应用。
系统对接接口配置
轻易云集成平台的对接是通过一个个对应的对接方案去形成两个系统对接的连线，所以对接方案的配置极其重要，方案可以选择一键复制，轻易云有海量的对接方案可支持一键复制，复制后直接启动使用（对接方案借鉴可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息。或者可以通过手工配置，配置只要确认源平台：网店管家·奇门的取数逻辑，例如什么时间取什么样的数据。即可完成配置，目标平台：金蝶云星空，把获取的数据组装成目标系统需要的格式进行写入。
网店管家·奇门接口明细
- 调用接口：wdgj.sellbacknosensitiveinfo.list.get
- 接口名称：查询管家中产生的退换订单
- 方法：POST
请求参数
| 字段 | 字段名称 | 类型 | 配置值 |
|---|
| pageno | 页码 | String | 1 |
| pagesize | 每页条数 | String | 100 |
| begintime | 查询开始时间 | String | {{LAST_SYNC_TIME datetime}} |
| endtime | 查询结束时间 | String | {{CURRENT_TIME datetime}} |
| timetype | 时间类型 | String | 2 |
| searchstatus | searchstatus | String | |
| searchno | 退换单号 | String | |
| relationno | 关联单号 | String | |
| querymarkup | 单据查询标记 | String | |
响应参数
| 字段 | 字段名称 | 类型 | 配置值 |
|---|
| tradeid | 退换单ID | String | |
| tradeno | 退换单号 | String | |
| rawno | 原始单号 | String | |
| oldno | 管家原关联订单号 | String | |
| newno | 换货管家关联订单号 | String | |
| tradestatus | 退换单状态 | String | |
| shopname | 原店铺名 | String | |
| shopno | 原店铺编号 | String | |
| shopname2 | 换货店铺名 | String | |
| chargetime | 结算时间 | String | |
| regtime | 登记时间 | String | |
| rcvtime | 收货时间 | String | |
| seller | 业务员 | String | |
| tradetype | 原订单类型 | String | |
| warehouseid | 退货仓库id | String | |
| warehouseno | 退货仓库编号 | String | |
| warehousename | 退货仓库名 | String | |
| warehouseid2 | 换货仓库id | String | |
| warehouseno2 | 换货仓库编号 | String | |
| warehousename2 | 换货仓库名 | String | |
| logisticid | 物流id | String | |
| logisticno | 物流编号 | String | |
| logisticname | 物流名 | String | |
| postid | 快递单号 | String | |
| postagetotal | 应收邮资 | String | |
| totalrcv | 换货金额 | String | |
| totalpay | 退货金额 | String | |
| returntotal | 应退合计 | String | |
| recvtotal | 结算金额 | String | |
| reason | 取消原因 | String | |
| remark | 卖家备注 | String | |
| customerid | 会员id | String | |
| shoptype | 原店铺类别 | String | |
| shoptype2 | 换货店铺类别 | String | |
| zip | 邮编 | String | |
| returntype | 类型 | String | |
| goodslist | 退货商品明细 | array | |
| goodslist.goodsid | 货品ID | String | |
| goodslist.specid | 规格ID | String | |
| 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 | |
| goodslist.bfit | 是否组合装 | String | |
| goodslist.recid | 记录id | String | |
| goodslist.goodslist2 | 换货商品明细 | array | |
| goodslist.goodslist2.goodsid | 货品ID | String | |
| 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 | |
| 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 | |
| goodslist.goodslist2.bfit | 是否组合装 | String | |
| goodslist.goodslist2.recid | 记录id（唯一） | String | |
金蝶云星空接口明细
- 接口：batchSave
- 接口名称：销售退货新增
- 接口方法：POST
请求参数
| 字段 | 名称 | 类型 | 描述 |
|---|
| FBillTypeID | 单据类型 | string | 单据类型 |
| FBillNo | 单据编号 | string | 单据编号 |
| FSaleOrgId | 销售组织 | string | 组织 |
| FDate | 日期 | string | 日期 |
| FStockOrgId | 库存组织 | string | 组织 |
| FRetcustId | 退货客户 | string | 基础资料 |
| FHeadNote | 备注 | string | 多行文本 |
| FEntity | 明细信息 | array | |
| FEntity.FMaterialId | 物料编码 | string | 基础资料 |
| FEntity.FBarcode | 零售条形码 | string | 文本 |
| FEntity.FRealQty | 实退数量 | string | 数量 |
| FEntity.FPrice | 单价 | string | 单价 |
| FEntity.FTaxPrice | 含税单价 | string | 单价 |
| FEntity.FIsFree | 是否赠品 | string | 复选框 |
| FEntity.FEntryTaxRate | 税率% | string | 小数 |
| FEntity.FReturnType | 退货类型 | string | 单选辅助资料列表 |
| FEntity.FStockId | 仓库 | string | 基础资料 |
| FEntity.FNote | 备注 | string | 文本 |
| FEntity.SubHeadEntity | 财务信息 | object | |
| FEntity.SubHeadEntity.FSettleOrgId | 结算组织 | string | 组织 |
| FEntity.SubHeadEntity.FormId | 业务对象表单Id | string | 必须填写金蝶的表单ID如😛UR_PurchaseOrder |
| FEntity.SubHeadEntity.Operation | 执行的操作 | string | |
| FEntity.SubHeadEntity.IsAutoSubmitAndAudit | 提交并审核 | bool | |
| FEntity.SubHeadEntity.IsVerifyBaseDataField | 验证基础资料 | bool | 是否验证所有的基础资料有效性，布尔类，默认false（非必录） |
| FEntity.SubHeadEntity.SubSystemId | 系统模块 | string | 默认仓库模块 |
系统打通概况
全新的API数据集成模式，赋能企业业务创新 传统企业集成主要采用点对点或ESB集成方式，基于全新API战略中台的API新型集成方式通过解耦系统资源，降低系统间对接难度，实现快速业务需求响应，提升对接效率，助力企业满足快速业务交付需求，实现业务创新。通过构建API生态，助力能力开放与共享 基于API战略中台梳理并整合内部API资源与IT资产，可实现内部资源共享，满足内部开发人员资源使用需求，例如：金蝶云星空与网店管家·奇门之间数据集成；并将API资源对外可控开放，打造面向开发者的生态服务，为您打通自身和上下游合作伙伴，创造共赢价值链。开展API战略中台，重塑IT 帮助您基于内部资源构建不同业务能力中心，打造企业统一API战略中台，赋能企业发展，实现对业务频繁变化的快速响应。同时您在能力中心基础上构建新业务时，无需从“零”组建各业务模块，提升开发效率，重塑IT组织及交付能力。
