从万里牛到金蝶云星空通过接口配置打通数据

数据源系统:万里牛

万里牛是杭州湖畔网络技术有限公司旗下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等等系统，都可以通过接口相互集成。