从万里牛到金蝶云星空通过接口配置打通数据
数据源系统:万里牛
万里牛是杭州湖畔网络技术有限公司旗下SaaS软件品牌，主要针对电商、外贸、实体门店等业务群体，帮助企业快速布局新零售，提升订单处理效率，实现数据化业务管理，为企业降本增效。
对接系统：金蝶云星空
金蝶K/3Cloud结合当今先进管理理论和数十万家国内客户最佳应用实践，面向事业部制、多地点、多工厂等运营协同与管控型企业及集团公司，提供一个通用的ERP服务平台。K/3Cloud支持的协同应用包括但不限于：集中/分散销售、集中/分散采购、B2B电商管理、B2C电商中心、供应商协同、多工厂计划、跨工厂领料、跨工厂加工、工厂间调拨、内部交易及结算、集团财务管理、阿米巴经营等。
接口方案配置
通过轻易云系统数据集成平台新增创建集成方案，然后在数据源平台中选择对应的源平台为：万里牛，并且选择对应的连接器（关于万里牛的接口连接器如何配置可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息）。选择对应的销售出库单查询接口作为数据对接来源。然后再通过写入目标平台配置目标系统为金蝶云星空，并且选择对应连接器。选择对应的销售出库新增接口作为数据写入动作，既可以完成第一步的数据对接配置；打破跨系统连接，让数据轻易互通成为现实。
万里牛接口明细
- 接口：/erp/sale/stock/out/query
- 接口名称：销售出库单查询
- 接口方法：POST
请求参数
| 字段 | 名称 | 类型 | 描述 |
|---|
| bill_code | 单据编码 | String | 单据编码 |
| trade_code | 系统订单号/线上单号 | String | 系统订单号/线上单号 |
| modify_time | 修改时间 | String | 修改时间，不填修改结束时间只能查近7天 |
| modify_time_end | 修改结束时间 | String | 修改结束时间 |
| page | 当前页码 | int | 当前页码，从1开始 |
| limit | 每页大小 | int | 每页大小,最大200 |
| is_split | 是否拆分组合商品 | Boolean | 是否拆分组合商品 |
| query_extend | 扩展查询字段 | object | 扩展查询字段 |
| query_extend.shop_nick | 店铺昵称 | String | 店铺昵称 - 对应店铺管理 掌柜旺旺/账户ID |
| query_extend.shop_type | 店铺类型 | String | 店铺类型（shop_nick重复时使用） |
响应参数
| 字段 | 名称 | 类型 | 描述 |
|---|
| bill_type | 单据类型: 1: 销售出库单 2： 线下出库单 | int | 单据类型: 1: 销售出库单 2： 线下出库单 |
| country | 国家 | String | 国家 |
| bill_date | 业务日期 | String | 业务日期 |
| create_time | 创建时间 | Datetime | 创建时间 |
| custom_code | 客户编码 | String | 客户编码 |
| custom_name | 客户名称 | String | 客户名称 |
| customer_nick | 客户昵称 | String | 客户昵称 |
| customer_nick_type | 客户来源平台值 | int | 客户来源平台值 |
| customer_nick_type_name | 客户来源平台名称 比如:淘宝,京东 | String | 客户来源平台名称 比如:淘宝,京东 |
| details | 明细集合 | object | 明细集合 |
| details.batch_infos | 批次号集合 | object | 批次号集合 |
| details.batch_infos.batch_no | 批次号 | String | 批次号 |
| details.batch_infos.nums | 数量 | String | 数量 |
| details.batch_infos.expiry_date | 有效期 | Datetime | 有效期 |
| details.batch_infos.batch_date | 生产日期 | Datetime | 生产日期 |
| details.batch_infos.detail_id | 明细id | String | 明细id，如果是组合商品拆分出来的明细，这个id相同 |
| details.batch_infos.discount_fee | 优惠 | String | 优惠 |
| details.batch_infos.goods_name | 商品名称 | String | 商品名称 |
| details.batch_infos.is_package | 是否组合商品 | boolean | 是否组合商品 |
| details.batch_infos.nums | 数量 | String | 数量 |
| details.batch_infos.sku_name | sku名称 | String | sku名称 |
| details.batch_infos.sku_no | sku编码 | String | sku编码（万里牛编码） |
| details.batch_infos.sku_prop1 | 规格扩展属性 | String | 规格扩展属性，商品未删除，且设置了会返回 |
| details.batch_infos.sku_prop2 | 规格扩展属性 | String | 规格扩展属性，商品未删除，且设置了会返回 |
| details.batch_infos.sn_infos | 序列号集合 | string | 序列号集合，此字段以不返回数据，请使接口——/erp/sn/querysnbybillcode查询单据中的序列号 |
| details.batch_infos.sum_cost | 成本 | string | 成本 |
| details.batch_infos.sum_sale | 总售价,包含优惠 | string | 总售价,包含优惠 |
| details.batch_infos.unit | 单位 | String | 单位 |
| details.discount_fee | 优惠金额 | String | 优惠金额 |
| details.from_trade_no | 万里牛中的原始交易编号 | String | 万里牛中的原始交易编号 |
| details.inv_no | 单据编号 | String | 单据编号 |
| details.paid_fee | 实际支付金额 | String | 实际支付金额 |
| details.pay_type | 付款方式 0 线上支付 1 现金 2 刷卡 3 微信 4 支付宝 5 转账 6 储值支付 7 1688支付 52 其它转账支付 | int | 付款方式 0 线上支付 1 现金 2 刷卡 3 微信 4 支付宝 5 转账 6 储值支付 7 1688支付 52 其它转账支付 |
| details.post_fee | 邮费 | String | 邮费 |
| details.remark | 备注 | String | 备注 |
| details.sys_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 | 外部订单号(如/京东单号) |
金蝶云星空接口明细
- API：batchSave
- NAME：销售出库新增
- METHOD：POST
请求参数
| 接口字段 | 字段名称 | 预设值 | 描述 |
|---|
| FBillTypeID | 单据类型 | XSCKD01_SYS | 单据类型 |
| FBillNo | 单据编号 | {{inv_no}} | 单据编号 |
| FDate | 日期 | {{bill_date datetime}} | 日期 |
| FSaleOrgId | 销售组织 | 101 | 组织 |
| FCustomerID | 客户 | {{shop_name}} | 基础资料 |
| FCarriageNO | 运输单号 | | 文本 |
| FStockOrgId | 发货组织 | 999 | 组织 |
| FLinkPhone | 联系电话 | | 文本 |
| FLinkMan | 收货人姓名 | | 文本 |
| FReceiveAddress | 收货方地址 | | 文本 |
| SubHeadEntity | 财务信息 | | |
| SubHeadEntity.FSettleTypeID | 结算方式 | JSFS04_SYS | 基础资料 |
| SubHeadEntity.FReceiverAddress | 收货人地址 | | 文本 |
| SubHeadEntity.FReceiverName | 收货人 | | 文本 |
| SubHeadEntity.FReceiverMobile | 收货人手机 | | 文本 |
| SubHeadEntity.FEntity | 明细信息 | details | |
| SubHeadEntity.FEntity.FMaterialID | 物料编码 | {{details.sku_no}} | 基础资料 |
| SubHeadEntity.FEntity.FRealQty | 实发数量 | {{details.nums}} | 数量 |
| SubHeadEntity.FEntity.FTaxPrice | 含税单价 | | 单价 |
| SubHeadEntity.FEntity.FStockID | 仓库 | {{storage_code}} | 基础资料 |
| SubHeadEntity.FEntity.FEntity_Link | 关联关系表 | | |
| SubHeadEntity.FEntity.FEntity_Link.FEntity_Link_FRuleId | 转换规则 | SaleOrder-OutStock | |
| SubHeadEntity.FEntity.FEntity_Link.FEntity_Link_FSTableName | 源单表 | T_SAL_ORDERENTRY | |
| SubHeadEntity.FEntity.FEntity_Link.FEntity_Link_FSBillId | 源单内码 | findCollection find FID from 447f3215-e908-3acf-bed9-7fd904d49a99 where FBillNo={{from_trade_no}} | |
| SubHeadEntity.FEntity.FEntity_Link.FEntity_Link_FSId | 源单分录内码 | _findCollection find FSaleOrderEntry_FEntryID from 447f3215-e908-3acf-bed9-7fd904d49a99 where FBillNo={{from_trade_no}} FMaterialId_Fnumber={{details.sku_no}} | |
| SubHeadEntity.FEntity.F_POIH_Text | 实际客户 | {{custom_name}} | |
| SubHeadEntity.FEntity.FNote | 备注 | {{remark}} | |
| SubHeadEntity.FEntity.FormId | 业务对象表单Id | SAL_OUTSTOCK | 必须填写金蝶的表单ID如😛UR_PurchaseOrder |
| SubHeadEntity.FEntity.Operation | 执行的操作 | Save | |
| SubHeadEntity.FEntity.IsAutoSubmitAndAudit | 提交并审核 | false | |
| SubHeadEntity.FEntity.IsVerifyBaseDataField | 验证基础资料 | false | 是否验证所有的基础资料有效性，布尔类，默认false（非必录） |
| SubHeadEntity.FEntity.SubSystemId | 系统模块 | 21 | 默认仓库模块 |
系统对接概况
使用全界面可视化配置集成流，快速应对企业的集成需求使得万里牛与金蝶云星空之间的数据接口一站式的快速集成能力，构建企业数据通道，解决数据孤岛问题。快速构建企业元数据标准、主数据标准、业财数据标准，完成数据的采集、统一、分发、清洗、归集等，帮助企业建立高质量的数据中台。目前轻易云平台已经支持300+系统，同时具备快速适配新系统的能力，集成海量接口数据。无论是对接ERP还是MES、OA、CRM、WMS、OMS等等系统，都可以通过接口相互集成。
