万里牛与金蝶云星空对接集成查询退货入库单连通销售退货新增(万里牛销售退货-金蝶【销售退货单】)
接通系统：万里牛
万里牛作为行业领先的全渠道零售云服务商，成立于2011年，核心成员来自于阿里巴巴、信雅达等知名企业，是业内最早的SaaSERP服务商，致力于为企业提供全渠道零售一站式解决方案。万里牛目前旗下拥有ERP、WMS、BI和智慧零售等SaaS产品，行业覆盖鞋服、美妆、食品、家电、3C、快消等数十个领域，以先进云计算技术助力企业实现数字化与智能化升级。
对接目标系统:金蝶云星空
金蝶K/3Cloud结合当今先进管理理论和数十万家国内客户最佳应用实践，面向事业部制、多地点、多工厂等运营协同与管控型企业及集团公司，提供一个通用的ERP服务平台。K/3Cloud支持的协同应用包括但不限于：集中/分散销售、集中/分散采购、B2B电商管理、B2C电商中心、供应商协同、多工厂计划、跨工厂领料、跨工厂加工、工厂间调拨、内部交易及结算、集团财务管理、阿米巴经营等。
多系统对接方案配置
系统对接前期需要通过调研公司的业务，规划出最便捷，效率最高的整体流程。通过流程我们需要建立对应的方案来吧这些流程一一的落地，轻易云集成平台开箱即用的、可视化拖、拉、拽实现接口服务编排与聚合。只需要根据指引设定好对应的参数即可启动使用。设定好源平台：万里牛的接口参数设置，以及设定好目标平台：金蝶云星空的映射，即可启动方案进行测试
万里牛接口明细
- 接口：/erp/sale/stock/in/query
- 接口名称：查询退货入库单
- 接口方法：POST
请求参数
| 字段 | 名称 | 类型 | 描述 |
|---|
| bill_code | 单据编码 | String | 单据编码 |
| modify_time | 修改时间 | String | 修改时间，只能查近3个月 |
| modify_end_time | 修改结束时间 | String | 修改结束时间，与查询开始时间最大时间间隔为7天；不填默认与开始时间间隔7天 |
| page | 当前页码 | int | 当前页码，从1开始 |
| limit | 每页大小 | int | 每页大小,最大50 |
| is_split | 是否拆分组合商品 | Boolean | 是否拆分组合商品 |
| query_extend | 扩展字段 | object | 扩展字段 |
| query_extend.shop_nick | 店铺昵称 | String | 店铺昵称 |
| query_extend.shop_type | 店铺类型 | String | 店铺类型（shop_nick重复时使用） |
响应参数
| 字段 | 名称 | 类型 | 描述 |
|---|
| bill_date | 单据日期 | Datetime | 单据日期 |
| bill_type | 单据类型😐 | int | 单据类型: 0: 销售退货入库 |
| country | 国家 | String | 国家 |
| create_time | 创建时间 | Datetime | 创建时间 |
| custom_code | 客户编码 | String | 客户编码 |
| custom_name | 客户名称 | String | 客户名称 |
| customer_nick | 客户昵称 | String | 客户昵称 |
| customer_nick_type | 客户来源平台值 | Integer | 客户来源平台值 |
| customer_nick_type_name | 客户来源平台名称 | String | 客户来源平台名称 比如:淘宝,京东 |
| details | 明细集合 | array | 明细集合 |
| details.batch_infos | 批次号集合 | array | 批次号集合 |
| details.detail_id | 明细id | String | 明细id，如果是组合商品拆分出来的明细，这个id相同 |
| details.discount_fee | 优惠 | String | 优惠 |
| details.tax_rate | 税率 | int | 税率 |
| details.is_package | 是否组合商品 | boolean | 是否组合商品 |
| details.goods_name | 商品名称 | String | 商品名称 |
| details.nums | 数量 | String | 数量 |
| details.sku_name | sku名称 | String | sku名称 |
| details.sku_no | sku编码 | String | sku编码（万里牛编码） |
| details.sku_prop1 | 规格扩展属性 | String | 规格扩展属性，商品未删除，且设置了会返回 |
| details.sku_prop2 | 规格扩展属性 | String | 规格扩展属性，商品未删除，且设置了会返回 |
| details.sn_infos | 序列号集合 | String | 序列号集合，此字段以不返回数据，请使接口——/erp/sn/querysnbybillcode查询单据中的序列号 |
| details.sum_cost | 成本 | String | 成本 |
| details.sum_sale | 总售价,包含优惠 | String | 总售价,包含优惠 |
| details.unit | 单位 | String | 单位 |
| details.discount_fee | 优惠金额 | String | 优惠金额 |
| details.from_trade_no | 万里牛中的原始交易编号 | String | 万里牛中的原始交易编号（原单退回的不会返回） |
| details.inv_no | 单据编号 | String | 单据编号 |
| details.paid_fee | 实际支付金额 | String | 实际支付金额 |
| details.pay_type | 付款方式 | Integer | 付款方式 0 线上支付 1 现金 2 刷卡 3 微信 4 支付宝 5 转账 6 储值支付 7 1688支付 52 其它转账支付 |
| details.post_fee | 邮费 | String | 邮费 |
| details.express | 物流单号 | String | 物流单号 |
| details.express_code | ERP中快递公司编码物 | String | ERP中快递公司编码物 |
| details.modify_time | 单据修改时间 | String | 单据修改时间 |
| details.remark | 备注 | String | 备注 |
| details.sale_man | 业务员 | String | 业务员 |
| details.service_fee | 服务费 | String | 服务费 |
| details.shop_name | 店铺名称 | String | 店铺名称 |
| details.shop_nick | 店铺昵称 | String | 店铺昵称 |
| details.shop_source | 店铺来源 | String | 店铺来源 |
| details.storage_code | 仓库编码 | String | 仓库编码 |
| details.storage_name | 仓库名称 | String | 仓库名称 |
| details.sum_sale | 总金额,包含优惠 | String | 总金额,包含优惠 |
| details.tp_tid | 外部订单号( | String | 外部订单号(如淘宝/京东单号) |
| details.from_exchange_no | 万里牛系统售后单号 | String | 万里牛系统售后单号 |
金蝶云星空接口明细
- 调用接口：batchSave
- 接口名称：销售退货新增
- 方法：POST
请求参数
| 字段 | 字段名称 | 类型 | 配置值 |
|---|
| FBillTypeID | 单据类型 | string | XSTHD01_SYS |
| FBillNo | 单据编号 | string | {{inv_no}} |
| FSaleOrgId | 销售组织 | string | 101 |
| FDate | 日期 | string | {{bill_date}} |
| FStockOrgId | 库存组织 | string | 999 |
| FRetcustId | 退货客户 | string | {{shop_nick}} |
| FSaledeptid | 销售部门 | string | |
| FSettleCurrId | 结算币别 | string | PRE001 |
| FBranchId | 销售门店 | string | |
| FReturnReason | 退货原因 | string | |
| FCorrespondOrgId | 对应组织 | string | |
| FStockDeptId | 库存部门 | string | |
| FHeadNote | 备注 | string | {{remark}} |
| FPayCustId | 付款方 | string | |
| FEntity | 明细信息 | array | |
| FEntity.FMaterialId | 物料编码 | string | {{details.sku_no}} |
| FEntity.FBarcode | 零售条形码 | string | |
| FEntity.FRealQty | 实退数量 | string | {{details.nums}} |
| FEntity.FPrice | 单价 | string | |
| FEntity.FTaxPrice | 含税单价 | string | |
| FEntity.FIsFree | 是否赠品 | string | |
| FEntity.FEntryTaxRate | 税率% | string | |
| FEntity.FReturnType | 退货类型 | string | |
| FEntity.FOwnerTypeId | 货主类型 | string | BD_OwnerOrg |
| FEntity.FOwnerId | 货主 | string | 999 |
| FEntity.FStockId | 仓库 | string | {{storage_code}} |
| FEntity.FStocklocId | 仓位 | string | |
| FEntity.FLot | 批号 | string | |
| FEntity.FDeliveryDate | 退货日期 | string | |
| FEntity.FNote | 备注 | string | |
| FEntity.FEntity_Link | 关联关系表 | array | |
| FEntity.FEntity_Link.FEntity_Link_FRuleId | 转换规则 | string | OutStock-SalReturnStock |
| FEntity.FEntity_Link.FEntity_Link_FSTableName | 源单表 | string | T_SAL_OUTSTOCKENTRY |
| FEntity.FEntity_Link.FEntity_Link_FSBillId | 源单内码 | string | |
| FEntity.FEntity_Link.FEntity_Link_FSId | 源单分录内码 | string | |
| FEntity.SubHeadEntity | 财务信息 | object | |
| FEntity.SubHeadEntity.FSettleOrgId | 结算组织 | string | |
| FEntity.SubHeadEntity.FSettleTypeId | 结算方式 | string | |
| 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服务，很好地解决企业用户上面的问题。轻易云应用集成主要解决已有应用系统的无序蔓延现象，减少各业务系统间的维护成本，减少各应用系统的操作系统、开发语言、访问协议、通信技术多而杂、整合难度大的问题，将企业数据平滑对接，减少信息竖井。
