万里牛和金蝶云星空接口打通对接实战
对接系统：万里牛
万里牛是一家SaaSERP服务商，提供一站式对接全球电商平台解决方案。万里牛系列产品是以ERP/WMS作为核心，并延展到智慧零售、商业智能（BI）、B2B分销及供应链等领域构成完整的SaaS产品矩阵，覆盖鞋服、百货、美妆、食品、家电、3C、快消等行业领域，累计服务30万+用户，以先进的云服务技术助力企业实现数智化转型。
目标系统:金蝶云星空
金蝶K/3Cloud结合当今先进管理理论和数十万家国内客户最佳应用实践，面向事业部制、多地点、多工厂等运营协同与管控型企业及集团公司，提供一个通用的ERP服务平台。K/3Cloud支持的协同应用包括但不限于：集中/分散销售、集中/分散采购、B2B电商管理、B2C电商中心、供应商协同、多工厂计划、跨工厂领料、跨工厂加工、工厂间调拨、内部交易及结算、集团财务管理、阿米巴经营等。
数据接口配置
轻易云集成平台的对接是通过一个个对应的对接方案去形成两个系统对接的连线，所以对接方案的配置极其重要，方案可以选择一键复制，轻易云有海量的对接方案可支持一键复制，复制后直接启动使用（对接方案借鉴可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息。或者可以通过手工配置，配置只要确认源平台：万里牛的取数逻辑，例如什么时间取什么样的数据。即可完成配置，目标平台：金蝶云星空，把获取的数据组装成目标系统需要的格式进行写入。系统数据集成平台更加专注于数据集成与流程自动化的应用连接器，通过自研引擎，与各个平台或者服务完成对接，从而打通数据孤岛，实现数据的跨系统自由流转，让数据真正成为企业的核心生产力。
万里牛接口明细
- API：/erp/sale/stock/in/query
- NAME：查询退货入库单
- METHOD：POST
请求参数
| 接口字段 | 名称 | 预设值 |
|---|
| bill_code | 单据编码 | |
| modify_time | 修改时间 | |
| modify_end_time | 修改结束时间 | |
| page | 当前页码 | |
| limit | 每页大小 | |
| is_split | 是否拆分组合商品 | |
| query_extend | 扩展字段 | |
| query_extend.shop_nick | 店铺昵称 | |
| query_extend.shop_type | 店铺类型 | |
响应参数
| 接口字段 | 名称 | 预设值 |
|---|
| bill_date | 单据日期 | |
| bill_type | 单据类型😐 | |
| country | 国家 | |
| create_time | 创建时间 | |
| custom_code | 客户编码 | |
| custom_name | 客户名称 | |
| customer_nick | 客户昵称 | |
| customer_nick_type | 客户来源平台值 | |
| customer_nick_type_name | 客户来源平台名称 | |
| details | 明细集合 | |
| details.batch_infos | 批次号集合 | |
| details.detail_id | 明细id | |
| details.discount_fee | 优惠 | |
| details.tax_rate | 税率 | |
| details.is_package | 是否组合商品 | |
| details.goods_name | 商品名称 | |
| details.nums | 数量 | |
| details.sku_name | sku名称 | |
| details.sku_no | sku编码 | |
| details.sku_prop1 | 规格扩展属性 | |
| details.sku_prop2 | 规格扩展属性 | |
| details.sn_infos | 序列号集合 | |
| details.sum_cost | 成本 | |
| details.sum_sale | 总售价,包含优惠 | |
| details.unit | 单位 | |
| details.discount_fee | 优惠金额 | |
| details.from_trade_no | 万里牛中的原始交易编号 | |
| details.inv_no | 单据编号 | |
| details.paid_fee | 实际支付金额 | |
| details.pay_type | 付款方式 | |
| details.post_fee | 邮费 | |
| details.express | 物流单号 | |
| details.express_code | ERP中快递公司编码物 | |
| details.modify_time | 单据修改时间 | |
| details.remark | 备注 | |
| details.sale_man | 业务员 | |
| details.service_fee | 服务费 | |
| details.shop_name | 店铺名称 | |
| details.shop_nick | 店铺昵称 | |
| details.shop_source | 店铺来源 | |
| details.storage_code | 仓库编码 | |
| details.storage_name | 仓库名称 | |
| details.sum_sale | 总金额,包含优惠 | |
| details.tp_tid | 外部订单号( | |
| details.from_exchange_no | 万里牛系统售后单号 | |
金蝶云星空接口明细
- 接口：batchSave
- 接口名称：销售退货新增
- 接口方法：POST
请求参数
| 字段 | 名称 | 类型 |
|---|
| FSettleCurrId | 结算币别 | string |
| FEntity.FEntity_Link.FEntity_Link_FSTableName | 源单表 | string |
| FEntity.SubHeadEntity.IsAutoSubmitAndAudit | 提交并审核 | bool |
| FCorrespondOrgId | 对应组织 | string |
| FEntity.FLot | 批号 | string |
| FEntity.FOwnerId | 货主 | string |
| FBillTypeID | 单据类型 | string |
| FEntity.SubHeadEntity | 财务信息 | object |
| FStockOrgId | 库存组织 | string |
| FPayCustId | 付款方 | string |
| FEntity.FEntity_Link.FEntity_Link_FSBillId | 源单内码 | string |
| FEntity.FStockId | 仓库 | string |
| FEntity.SubHeadEntity.FSettleOrgId | 结算组织 | string |
| FEntity.SubHeadEntity.FSettleTypeId | 结算方式 | string |
| FEntity.SubHeadEntity.FormId | 业务对象表单Id | string |
| FHeadNote | 备注 | string |
| FBranchId | 销售门店 | string |
| FSaleOrgId | 销售组织 | string |
| FBillNo | 单据编号 | string |
| FDate | 日期 | string |
| FReturnReason | 退货原因 | string |
| FEntity | 明细信息 | array |
| FEntity.FDeliveryDate | 退货日期 | string |
| FEntity.FTaxPrice | 含税单价 | string |
| FEntity.FBarcode | 零售条形码 | string |
| FSaledeptid | 销售部门 | string |
| FEntity.FPrice | 单价 | string |
| FEntity.FEntity_Link.FEntity_Link_FRuleId | 转换规则 | string |
| FEntity.FEntryTaxRate | 税率% | string |
| FEntity.FEntity_Link.FEntity_Link_FSId | 源单分录内码 | string |
| FEntity.FIsFree | 是否赠品 | string |
| FEntity.FEntity_Link | 关联关系表 | array |
| FEntity.FOwnerTypeId | 货主类型 | string |
| FEntity.SubHeadEntity.IsVerifyBaseDataField | 验证基础资料 | bool |
| FRetcustId | 退货客户 | string |
| FEntity.FReturnType | 退货类型 | string |
| FEntity.FNote | 备注 | string |
| FEntity.FRealQty | 实退数量 | string |
| FEntity.SubHeadEntity.Operation | 执行的操作 | string |
| FEntity.FMaterialId | 物料编码 | string |
| FEntity.FStocklocId | 仓位 | string |
| FStockDeptId | 库存部门 | string |
| FEntity.SubHeadEntity.SubSystemId | 系统模块 | string |
数据对接效果
通过轻易云集成平台系列产品线可以协助企业轻易快捷的构建基于微服务架构的新一代企业服务总线，传统基于SOA架构的ESB产品主要解决的数据集成和协议转换等基础功能，已完全不能满足基于微服务架构、混合云集成架构、跨组织、跨单位的总线解决方案。 而轻易云集成平台的每个产品线都是新一代的按照最新的互联网架构模式进行研发的产品线，能快速协助企业从传统的SOA架构转向微服务架构的服务总线解决方案。
