金蝶云星空和万里牛接口打通对接实战

接通系统：金蝶云星空

金蝶K/3Cloud（金蝶云星空）是移动互联网时代的新型ERP，是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”，旨在帮助企业打造面向新时代的生态互联与协同平台，围绕生态中的每个角色，提供随手可得的云服务，最终实现敏捷协同，智慧运营的企业运营新境界。整个产品采用SOA架构，完全基于BOS平台组建而成，业务架构上贯穿流程驱动与角色驱动思想，结合中国管理模式与中国管理实践积累，精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建，支持跨数据库应用，支持本地部署、私有云部署与公有云部署三种部署方式，同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业，其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。

对接系统：万里牛

万里牛作为行业领先的全渠道零售云服务商，成立于2011年，核心成员来自于阿里巴巴、信雅达等知名企业，是业内最早的SaaSERP服务商，致力于为企业提供全渠道零售一站式解决方案。万里牛目前旗下拥有ERP、WMS、BI和智慧零售等SaaS产品，行业覆盖鞋服、美妆、食品、家电、3C、快消等数十个领域，以先进云计算技术助力企业实现数字化与智能化升级。

配置集成方案

使用轻易云系统数据集成平台对应的模块：数据集成方案。然后选择开始创建数据集成方案。在方案配置表单中选择对应的源业务系统：金蝶云星空，然后选择对应的连接器。选择对应的销售订单查询作为数据对接来源。然后再通过写入目标平台配置目标系统为万里牛,并且选择对应连接器（关于万里牛的接口如何配置可以在轻易云数据集成社区论坛中找到相关信息,选择好对应的订单状态流转接口作为数据写入动作，既可以完成第一步的数据对接配置。

金蝶云星空接口明细

接口：executeBillQuery
接口名称：销售订单查询
接口方法：POST

请求参数

字段	名称	类型	描述
FSaleOrderEntry_FEntryID	FSaleOrderEntry_FEntryID	string
FID	FID	string
FBillNo	单据编号	string
FDocumentStatus	单据状态	string
FSaleOrgId_FNumber	销售组织	string
FDate	日期	string
FCustId_FNumber	客户	string
FSaleDeptId_Fnumber	销售部门	string
FSaleGroupId	销售组	string
FSalerId	销售员	string
FReceiveId	收货方	string
FSettleId	结算方	string
FSettleAddress	结算方地址	string
FChargeId	付款方	string
FCreatorId	创建人	string
FCreateDate	创建日期	string
FModifierId	最后修改人	string
FModifyDate	最后修改日期	string
FApproverId	审核人	string
FApproveDate	审核日期	string
FCloseStatus	关闭状态	string
FCloserId	关闭人	string
FCloseDate	关闭日期	string
FCancelStatus	作废状态	string
FCancellerId	作废人	string
FCancelDate	作废日期	string
FVersionNo	版本号	string
FChangerId	变更人	string
FChangeDate	变更日期	string
FChangeReason	变更原因	string
FBillTypeID_Fnumber	单据类型	string
FBusinessType	业务类型	string
FHeadDeliveryWay	交货方式	string
FReceiveAddress	收货方地址	string
FHEADLOCID	交货地点	string
FCreditCheckResult	信用检查结果	string
FReceiveContact	收货方联系人	string
FNetOrderBillNo	移动销售订单编号	string
FNetOrderBillId	移动销售订单ID	string
FOppID	商机内码	array
FSalePhaseID	销售阶段	string
FISINIT	是否期初单据	string
FNote	备注	string
FSignStatus	签收状态	string
FManualClose	是否手工关闭	string
FLinkMan	收货人姓名	string
FLinkPhone	联系电话	string
FSOFrom	订单来源	string
FMaterialId_Fnumber	物料编码	string
FMaterialName	物料名称	string
FMaterialModel	规格型号	string
FMaterialType	物料类别	string
FUnitID_Fnumber	销售单位	string
FPrice	单价	string
FTaxPrice	含税单价	string
FBomId	BOM版本	string
FPriceUnitId	计价单位	string
FPriceUnitQty	计价数量	string
FPriceCoefficient	价格系数	string
FDiscountRate	折扣率%	string
FDiscount	折扣额	string
FEntryTaxRate	税率%	string
FEntryTaxAmount	税额	string
FAllAmount	价税合计	string
FTaxNetPrice	净价	string
FBaseUnitQty	销售基本数量	string
FDeliveryControl	控制发货数量	string
FDeliveryMaxQty	发货上限	string
FDeliveryMinQty	发货下限	string
FTransportLeadTime1	运输提前期	string
FBefDisAllAmt	折前价税合计	string
FBefDisAmt	折前金额	string
FTaxAmount_LC	税额（本位币）	string
FAmount_LC	金额（本位币）	string
FAllAmount_LC	价税合计（本位币）	string
FMrpCloseStatus	业务关闭	string
FMrpFreezeStatus	业务冻结	string
FFreezerId	冻结人	string
FFreezeDate	冻结日期	string
FMrpTerminateStatus	业务终止	string
FTerminaterId	终止人	string
FTerminateDate	终止日期	string
FBaseDeliJoinQty	（代码有用）关联发货通知数量（销售基本）	string
FDeliQty	累计发货通知数量	string
FStockOutQty	累计出库数量	string
FRetNoticeQty	累计退货通知数量（销售）	string
FReturnQty	累计退货数量（销售）	string
FRemainOutQty	剩余未出数量（销售）	string
FBaseInvoiceJoinQty	关联开票数量（基本）(作废)	string
FInvoiceJoinQty	关联开票数量(作废)	string
FInvoiceQty	累计开票数量(作废)	string
FInvoiceAmount	累计开票金额(作废)	string
FReceiveAmount	累计收款金额	string
FBasePurJoinQty	关联采购/生产数量（销售基本）	string
FPurJoinQty	关联采购/生产数量	string
FPurReqQty	累计采购申请数量	string
FPurOrderQty	累计采购订单数量	string
FReceiptOrgId	收款组织	string
FSettleOrgIds	结算组织	string
FAmount	金额	string
FEntryNote	备注	string
FQty	销售数量	string
FLimitDownPrice	最低限价	string
FSysPrice	系统定价	string
FStockOrgId	库存组织	string
FBaseStockOutQty	累计出库数量（销售基本）	string
FBaseDeliQty	累计发货通知数量（销售基本）	string
FBaseRetNoticeQty	累计退货通知数量（销售基本）	string
FBaseReturnQty	累计退货数量（销售基本）	string
FBasePurReqQty	累计采购申请数量（销售基本）	string
FBasePurOrderQty	累计采购订单数量（销售基本）	string
FBaseUnitId	基本单位	string
FChangeFlag	变更标志	string
FMapId	客户物料编码	string
FOwnerTypeId	货主类型	string
FOwnerId	货主	string
FIsFree	是否赠品	string
FLOCKQTY	锁库/预留数量(库存单位)	string
FLOCKFLAG	锁库/预留标识	string
FProduceDate	生产日期	string
FExpiryDate	有效期至	string
FExpUnit	保质期单位	string
FExpPeriod	保质期	string
FMaterialIsProduce	物料允许生产属性	string
FTaxCombination	税组合	string
FLot	批号	string
FMapName	客户物料名称	string
FAuxPropId	辅助属性	string
FReturnType	退补类型	string
FDeliveryDate	要货日期	string
FTransJoinQty	累计调拨数量	string
FBaseTransJoinQty	累计调拨数量(销售基本)	string
FSrcType	源单类型	string
FSrcBillNo	源单编号	string
FBaseDeliveryMaxQty	发货上限（基本）	string
FBaseDeliveryMinQty	发货下限（基本）	string
FOEMInStockJoinQty	关联受托材料入库套数	string
FBaseOEMInStockJoinQty	关联受托材料入库套数(库存基本)	string
FBaseARJoinQty	关联应收数量（计价基本）	string
FIsReturn	物料允许退货属性	string
FBFLowId	业务流程	string
FIsInventory	物料允许库存属性	string
FBASEARQTY	累计应收数量（销售基本）	string
FARJOINAMOUNT	关联应收金额	string
FARAMOUNT	累计应收金额	string
FBaseRemainOutQty	剩余未出数量（销售基本）	string
FReBackQty	累计退货补货数量（销售）	string
FBaseReBackQty	累计退货补货数量（销售基本）	string
FARQTY	累计应收数量（销售）	string
FMaterialIsSubContract	物料允许委外属性	string
FCanOutQty	可出数量（销售）	string
FBaseCanOutQty	可出数量（销售基本）	string
FCanReturnQty	可退数量（销售）	string
FBaseCanReturnQty	可退数量（销售基本）	string
FBASEAPQTY	累计应付数量(基本单位)	string
FAPAMOUNT	累计应付金额	string
FMtoNo	计划跟踪号	string
FPriority	需求优先级	string
FReserveType	预留类型	string
FMinPlanDeliveryDate	计划交货日期	string
FDeliveryStatus	发货状态	string
FOldQty	原数量	string
FPromotionMatchType	促销匹配类型	string
FPriceListEntry	行价目表	string
FSupplyOrgId	供应组织	string
FNetOrderEntryId	供应商协同平台订单分录ID	string
FPriceBaseQty	计价基本数量	string
FSetPriceUnitID	定价单位	string
FStockUnitID	库存单位	string
FStockQty	库存数量	string
FStockBaseQty	库存基本数量	string
FStockBaseCanOutQty	可出数量（库存基本）	string
FStockBaseCanReturnQty	可退数量（库存基本）	string
FStockBaseARJoinQty	关联应收数量（库存基本）	string
FStockBaseTransJoinQty	累计调拨数量（库存基本）	string
FStockBasePurJoinQty	关联采购/生产数量（库存基本）	string
FSalBaseNum	源单基本分子	string
FStockBaseDen	库存基本分母	string
FSRCBIZUNITID	携带主单位	string
FPurBaseQty	采购基本数量	string
FPurUnitID	采购单位	string
FPurQty	采购数量	string
FSalBaseARJoinQty	关联应收数量（销售基本）	string
FSTOCKBASESTOCKOUTQTY	累计出库数量（库存基本）	string
FSTOCKBASEREBACKQTY	累计退货补货数量（库存基本）	string
FOUTLMTUNIT	超发控制单位类型	string
FOutLmtUnitID	超发控制单位	string
FTRANSRETURNQTY	累计调拨退货数量	string
FTRANSRETURNBASEQTY	累计调拨退货数量（销售基本）	string
FCONSIGNSETTQTY	寄售结算数量	string
FCONSIGNSETTBASEQTY	寄售结算数量（销售基本）	string
FLeftQty	待锁库/待预留数量(库存单位)	string
FRowType	产品类型	string
FParentMatId	父项产品	string
FRowId	行标识	string
FParentRowId	父行标识	string
FInStockPrice	最新采购入库价	string
FSOStockId_Fnumber	仓库	string
FSOStockLocalId	仓位	string
FPurPriceUnitId	采购计价单位	string
FISMRP	已计划运算	string
FBarcode	零售条形码	string
FBranchId	发货门店	string
FRetailSaleProm	是否零售促销	string
FBASEFINARQTY	先开票数量（计价基本）	string
FSALBASEFINARQTY	先开票数量（销售基本）	string
FEntryDiscountList	行折扣表	string
FPriceDiscount	单价折扣	string
FZHJStockQty	智慧记上报库存	string
FSPMENTRYID	促销政策ID	string
FSPMANDRPMCONTENT	促销内容	string
FTransReturnStockBaseQty	累计调拨退货数量（库存基本）	string
FTailDiffFlag	尾差处理标识	string
Limit	最大行数	string	金蝶的查询分页参数
StartRow	开始行索引	string	金蝶的查询分页参数
TopRowCount	返回总行数	int	金蝶的查询分页参数
FilterString	过滤条件	string	示例写法 FSupplierId.FNumber = 'VEN00010' and FApproveDate>=
FieldKeys	需查询的字段key集合	array	金蝶分录主键ID格式：FPOOrderEntry_FEntryId,其它格式 FPurchaseOrgId.FNumber
FormId	业务对象表单Id	string	必须填写金蝶的表单ID如😛UR_PurchaseOrder

响应参数

字段	名称	类型
FSaleOrderEntry_FEntryID	FSaleOrderEntry_FEntryID	string
FID	FID	string
FBillNo	单据编号	string
FDocumentStatus	单据状态	string
FSaleOrgId_FNumber	销售组织	string
FDate	日期	string
FCustId_FNumber	客户	string
FSaleDeptId_Fnumber	销售部门	string
FSaleGroupId	销售组	string
FSalerId	销售员	string
FReceiveId	收货方	string
FSettleId	结算方	string
FSettleAddress	结算方地址	string
FChargeId	付款方	string
FCreatorId	创建人	string
FCreateDate	创建日期	string
FModifierId	最后修改人	string
FModifyDate	最后修改日期	string
FApproverId	审核人	string
FApproveDate	审核日期	string
FCloseStatus	关闭状态	string
FCloserId	关闭人	string
FCloseDate	关闭日期	string
FCancelStatus	作废状态	string
FCancellerId	作废人	string
FCancelDate	作废日期	string
FVersionNo	版本号	string
FChangerId	变更人	string
FChangeDate	变更日期	string
FChangeReason	变更原因	string
FBillTypeID_Fnumber	单据类型	string
FBusinessType	业务类型	string
FHeadDeliveryWay	交货方式	string
FReceiveAddress	收货方地址	string
FHEADLOCID	交货地点	string
FCreditCheckResult	信用检查结果	string
FReceiveContact	收货方联系人	string
FNetOrderBillNo	移动销售订单编号	string
FNetOrderBillId	移动销售订单ID	string
FOppID	商机内码	array
FSalePhaseID	销售阶段	string
FISINIT	是否期初单据	string
FNote	备注	string
FSignStatus	签收状态	string
FManualClose	是否手工关闭	string
FLinkMan	收货人姓名	string
FLinkPhone	联系电话	string
FSOFrom	订单来源	string
FMaterialId_Fnumber	物料编码	string
FMaterialName	物料名称	string
FMaterialModel	规格型号	string
FMaterialType	物料类别	string
FUnitID_Fnumber	销售单位	string
FPrice	单价	string
FTaxPrice	含税单价	string
FBomId	BOM版本	string
FPriceUnitId	计价单位	string
FPriceUnitQty	计价数量	string
FPriceCoefficient	价格系数	string
FDiscountRate	折扣率%	string
FDiscount	折扣额	string
FEntryTaxRate	税率%	string
FEntryTaxAmount	税额	string
FAllAmount	价税合计	string
FTaxNetPrice	净价	string
FBaseUnitQty	销售基本数量	string
FDeliveryControl	控制发货数量	string
FDeliveryMaxQty	发货上限	string
FDeliveryMinQty	发货下限	string
FTransportLeadTime1	运输提前期	string
FBefDisAllAmt	折前价税合计	string
FBefDisAmt	折前金额	string
FTaxAmount_LC	税额（本位币）	string
FAmount_LC	金额（本位币）	string
FAllAmount_LC	价税合计（本位币）	string
FMrpCloseStatus	业务关闭	string
FMrpFreezeStatus	业务冻结	string
FFreezerId	冻结人	string
FFreezeDate	冻结日期	string
FMrpTerminateStatus	业务终止	string
FTerminaterId	终止人	string
FTerminateDate	终止日期	string
FBaseDeliJoinQty	（代码有用）关联发货通知数量（销售基本）	string
FDeliQty	累计发货通知数量	string
FStockOutQty	累计出库数量	string
FRetNoticeQty	累计退货通知数量（销售）	string
FReturnQty	累计退货数量（销售）	string
FRemainOutQty	剩余未出数量（销售）	string
FBaseInvoiceJoinQty	关联开票数量（基本）(作废)	string
FInvoiceJoinQty	关联开票数量(作废)	string
FInvoiceQty	累计开票数量(作废)	string
FInvoiceAmount	累计开票金额(作废)	string
FReceiveAmount	累计收款金额	string
FBasePurJoinQty	关联采购/生产数量（销售基本）	string
FPurJoinQty	关联采购/生产数量	string
FPurReqQty	累计采购申请数量	string
FPurOrderQty	累计采购订单数量	string
FReceiptOrgId	收款组织	string
FSettleOrgIds	结算组织	string
FAmount	金额	string
FEntryNote	备注	string
FQty	销售数量	string
FLimitDownPrice	最低限价	string
FSysPrice	系统定价	string
FStockOrgId	库存组织	string
FBaseStockOutQty	累计出库数量（销售基本）	string
FBaseDeliQty	累计发货通知数量（销售基本）	string
FBaseRetNoticeQty	累计退货通知数量（销售基本）	string
FBaseReturnQty	累计退货数量（销售基本）	string
FBasePurReqQty	累计采购申请数量（销售基本）	string
FBasePurOrderQty	累计采购订单数量（销售基本）	string
FBaseUnitId	基本单位	string
FChangeFlag	变更标志	string
FMapId	客户物料编码	string
FOwnerTypeId	货主类型	string
FOwnerId	货主	string
FIsFree	是否赠品	string
FLOCKQTY	锁库/预留数量(库存单位)	string
FLOCKFLAG	锁库/预留标识	string
FProduceDate	生产日期	string
FExpiryDate	有效期至	string
FExpUnit	保质期单位	string
FExpPeriod	保质期	string
FMaterialIsProduce	物料允许生产属性	string
FTaxCombination	税组合	string
FLot	批号	string
FMapName	客户物料名称	string
FAuxPropId	辅助属性	string
FReturnType	退补类型	string
FDeliveryDate	要货日期	string
FTransJoinQty	累计调拨数量	string
FBaseTransJoinQty	累计调拨数量(销售基本)	string
FSrcType	源单类型	string
FSrcBillNo	源单编号	string
FBaseDeliveryMaxQty	发货上限（基本）	string
FBaseDeliveryMinQty	发货下限（基本）	string
FOEMInStockJoinQty	关联受托材料入库套数	string
FBaseOEMInStockJoinQty	关联受托材料入库套数(库存基本)	string
FBaseARJoinQty	关联应收数量（计价基本）	string
FIsReturn	物料允许退货属性	string
FBFLowId	业务流程	string
FIsInventory	物料允许库存属性	string
FBASEARQTY	累计应收数量（销售基本）	string
FARJOINAMOUNT	关联应收金额	string
FARAMOUNT	累计应收金额	string
FBaseRemainOutQty	剩余未出数量（销售基本）	string
FReBackQty	累计退货补货数量（销售）	string
FBaseReBackQty	累计退货补货数量（销售基本）	string
FARQTY	累计应收数量（销售）	string
FMaterialIsSubContract	物料允许委外属性	string
FCanOutQty	可出数量（销售）	string
FBaseCanOutQty	可出数量（销售基本）	string
FCanReturnQty	可退数量（销售）	string
FBaseCanReturnQty	可退数量（销售基本）	string
FBASEAPQTY	累计应付数量(基本单位)	string
FAPAMOUNT	累计应付金额	string
FMtoNo	计划跟踪号	string
FPriority	需求优先级	string
FReserveType	预留类型	string
FMinPlanDeliveryDate	计划交货日期	string
FDeliveryStatus	发货状态	string
FOldQty	原数量	string
FPromotionMatchType	促销匹配类型	string
FPriceListEntry	行价目表	string
FSupplyOrgId	供应组织	string
FNetOrderEntryId	供应商协同平台订单分录ID	string
FPriceBaseQty	计价基本数量	string
FSetPriceUnitID	定价单位	string
FStockUnitID	库存单位	string
FStockQty	库存数量	string
FStockBaseQty	库存基本数量	string
FStockBaseCanOutQty	可出数量（库存基本）	string
FStockBaseCanReturnQty	可退数量（库存基本）	string
FStockBaseARJoinQty	关联应收数量（库存基本）	string
FStockBaseTransJoinQty	累计调拨数量（库存基本）	string
FStockBasePurJoinQty	关联采购/生产数量（库存基本）	string
FSalBaseNum	源单基本分子	string
FStockBaseDen	库存基本分母	string
FSRCBIZUNITID	携带主单位	string
FPurBaseQty	采购基本数量	string
FPurUnitID	采购单位	string
FPurQty	采购数量	string
FSalBaseARJoinQty	关联应收数量（销售基本）	string
FSTOCKBASESTOCKOUTQTY	累计出库数量（库存基本）	string
FSTOCKBASEREBACKQTY	累计退货补货数量（库存基本）	string
FOUTLMTUNIT	超发控制单位类型	string
FOutLmtUnitID	超发控制单位	string
FTRANSRETURNQTY	累计调拨退货数量	string
FTRANSRETURNBASEQTY	累计调拨退货数量（销售基本）	string
FCONSIGNSETTQTY	寄售结算数量	string
FCONSIGNSETTBASEQTY	寄售结算数量（销售基本）	string
FLeftQty	待锁库/待预留数量(库存单位)	string
FRowType	产品类型	string
FParentMatId	父项产品	string
FRowId	行标识	string
FParentRowId	父行标识	string
FInStockPrice	最新采购入库价	string
FSOStockId_Fnumber	仓库	string
FSOStockLocalId	仓位	string
FPurPriceUnitId	采购计价单位	string
FISMRP	已计划运算	string
FBarcode	零售条形码	string
FBranchId	发货门店	string
FRetailSaleProm	是否零售促销	string
FBASEFINARQTY	先开票数量（计价基本）	string
FSALBASEFINARQTY	先开票数量（销售基本）	string
FEntryDiscountList	行折扣表	string
FPriceDiscount	单价折扣	string
FZHJStockQty	智慧记上报库存	string
FSPMENTRYID	促销政策ID	string
FSPMANDRPMCONTENT	促销内容	string
FTransReturnStockBaseQty	累计调拨退货数量（库存基本）	string
FTailDiffFlag	尾差处理标识	string

万里牛接口明细

接口：/erp/opentrade/trade/commit
接口名称：订单状态流转
接口方法：POST

请求参数

字段	名称	类型	描述
bill_code	万里牛系统订单号	String	万里牛系统订单号
trade_status	订单当前状态	Integer	订单当前状态(0:审核 5：财审 1：打单配货 2：验货)
commit_type	操作方式	Integer	操作方式 0 正向提交 1 打回
next_status	打回的订单状态	Integer	打回的订单状态 commit_type = 1 必传,0:审核，1：打单配货，2：验货，3：称重，5：财审
force	是否强制提交	Boolean	是否强制提交-库存不足的时候

数据对接效果

可视化配置，即便是普通业务人员也可以快速轻松对接多个平台，解决企业面临的数据孤岛，数据混乱等问题，实现数据可见、可用、可运营。进行统一化，模块化，标准化的服务能力和输出，实现对业务端数据需求的精准满足和高效响应，也可以在业务数据需求的不断增加下，让企业有整套的可复用的api资产以更换，支持业务的正常运转，节省开发成本。在不同的着重点和应用上解决数据共享，实现平台之间的独立管理。