巨益OMS和金蝶云星空单据接口对接

巨益OMS和金蝶云星空单据接口对接

来源系统:金蝶云星空

金蝶K/3Cloud在总结百万家客户管理最佳实践的基础上，提供了标准的管理模式；通过标准的业务架构：多会计准则、多币别、多地点、多组织、多税制应用框架等，有效支持企业的运营管理；K/3Cloud提供了标准的业务建模：35种标准ERP领域模型、1046种模型元素、21243种模型元素属性组合，288个业务服务构件，让企业及伙伴可快速构建出行业化及个性化的应用。

对接系统：巨益OMS

将天猫，京东，唯品，抖音小店，微信小程序，企业独立站，跨境平台等三方平台产生的订单经过路由计算给到不同的发货方；将不同的存货实体比如仓库，门店，工厂的库存汇总计算后共享到三方平台销售。

配置集成方案

通过轻易云系统数据集成平台新增创建集成方案，然后在数据源平台中选择对应的源平台为：金蝶云星空，并且选择对应的连接器（关于金蝶云星空的接口连接器如何配置可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息）。选择对应的采购入库查询接口作为数据对接来源。然后再通过写入目标平台配置目标系统为巨益OMS，并且选择对应连接器。选择对应的入库单创建接口作为数据写入动作，既可以完成第一步的数据对接配置；打破跨系统连接，让数据轻易互通成为现实。

金蝶云星空接口明细

• 调用接口：executeBillQuery
• 接口名称：采购入库查询
• 方法：POST

请求参数

字段字段名称类型配置值 FInStockEntry_FEntryIdidstringFInStockEntry_FEntryId FID实体主键stringFID FBillNo单据编号stringFBillNo FDocumentStatus单据状态stringFDocumentStatus FStockOrgId_FNumber收料组织stringFStockOrgId.FNumber FDate入库日期stringFDate FBillTypeID_FNumber单据类型stringFBillTypeID.FNumber FOwnerTypeIdHead货主类型stringFOwnerTypeIdHead FOwnerIdHead_FNumber货主stringFOwnerIdHead.FNumber FDemandOrgId_FNumber需求组织stringFDemandOrgId.FNumber FPurchaseOrgId_FNumber采购组织stringFPurchaseOrgId.FNumber FSupplierId_FNumber供应商stringFSupplierId.FNumber FStockerGroupId_FNumber库存组stringFStockerGroupId.FNumber FStockDeptId_FNumber收料部门stringFStockDeptId.FNumber FCreateDate创建日期stringFCreateDate FCancelDate作废日期stringFCancelDate FDeliveryBill送货单号stringFDeliveryBill FTakeDeliveryBill提货单号stringFTakeDeliveryBill FApproveDate审核日期stringFApproveDate FCancelStatus作废状态stringFCancelStatus FSupplyId_FNumber供货方stringFSupplyId.FNumber FSettleId_FNumber结算方stringFSettleId.FNumber FChargeId_FNumber收款方stringFChargeId.FNumber FBusinessType业务类型stringFBusinessType FSupplyAddress供货方地址stringFSupplyAddress FAPSTATUS应付状态stringFAPSTATUS FTransferBizType跨组织业务类型stringFTransferBizType FDisassemblyFlag拆单新单标识stringFDisassemblyFlag FConfirmDate确认日期stringFConfirmDate FConfirmStatus确认状态stringFConfirmStatus FSplitBillType拆单类型stringFSplitBillType FPayOrgId_FNumber付款组织stringFPayOrgId.FNumber FSettleOrgId_FNumber结算组织stringFSettleOrgId.FNumber FSettleCurrId_FNumber结算币别stringFSettleCurrId.FNumber FBillCost整单费用stringFBillCost FBillTaxAmount税额stringFBillTaxAmount FBillCostAmount总成本stringFBillCostAmount FBillAllAmount价税合计stringFBillAllAmount FSettleTypeId结算方式stringFSettleTypeId FExchangeRate汇率stringFExchangeRate FLocalCurrId_FNumber本位币stringFLocalCurrId.FNumber FBillAmount金额stringFBillAmount FIsIncludedTax含税stringFIsIncludedTax FOwnerCustomerID_FNumber货主客户stringFOwnerCustomerID.FNumber FSettleSupplierID_FNumber结算组织供应商stringFSettleSupplierID.FNumber FISGENFORIOS跨组织结算生成stringFISGENFORIOS FISPRICEEXCLUDETAX价外税stringFISPRICEEXCLUDETAX FISINVOICEARLIER先到票后入库stringFISINVOICEARLIER FMaterialId_FNumber物料编码stringFMaterialId.FNumber FMaterialId_FBARCODE条码stringFMaterialId.FBARCODE FStockId_FNumber仓库stringFStockId.FNumber FProduceDate生产日期stringFProduceDate FNote备注stringFNote FSupplierLot供应商批号stringFSupplierLot FGrossWeight毛重stringFGrossWeight FNetWeight净重stringFNetWeight FContractlNo合同单号stringFContractlNo FReqTraceNo需求跟踪号stringFReqTraceNo FMustQty应收数量stringFMustQty FRealQty实收数量stringFRealQty FSRCRowId源单行内码stringFSRCRowId FExpiryDate有效期至stringFExpiryDate FIsFree免费stringFIsFree FStockStatusId库存状态stringFStockStatusId FBOMIdBOM版本stringFBOMId FTaxPrice含税单价stringFTaxPrice FCostPrice成本价stringFCostPrice FEntryTaxRate税率(%)stringFEntryTaxRate FEntryTaxAmount税额stringFEntryTaxAmount FDiscountRate折扣率(%)stringFDiscountRate FPriceCoefficient价格系数stringFPriceCoefficient FPriceUnitQty计价数量stringFPriceUnitQty FTaxNetPrice净价stringFTaxNetPrice FEntryCostAmount总成本stringFEntryCostAmount FAllAmount价税合计stringFAllAmount FStockFlag入库库存更新标志stringFStockFlag FPOOrderNo订单单号stringFPOOrderNo FEXPUnit保质期单位stringFEXPUnit FExpPeriod保质期stringFExpPeriod FSRCBILLTYPEID源单类型stringFSRCBILLTYPEID FSRCBillNo源单编号stringFSRCBillNo FINVOICEDQTY已开票数量stringFINVOICEDQTY FBaseAPJoinQty关联应付数量（计价基本）stringFBaseAPJoinQty FReceiveStockFlag收货库存更新标志stringFReceiveStockFlag FProcessFee加工费stringFProcessFee FMaterialCosts材料成本stringFMaterialCosts FLot_FNumber批号stringFLot.FNumber FPrice单价stringFPrice FAmount金额stringFAmount FDiscount折扣额stringFDiscount FReturnJoinQty退料关联数量stringFReturnJoinQty FBFLowId业务流程stringFBFLowId FGiveAway是否赠品stringFGiveAway FWWInType入库类型stringFWWInType FRowId行标识stringFRowId FStockLocIdFStockLocIdstringFStockLocId FPriceUnitID_FNumberFPriceUnitID_FNumberstringFPriceUnitID.FNumber Limit最大行数string{{PAGINATION_PAGE_SIZE}} StartRow开始行索引string{{PAGINATION_START_ROW}} TopRowCount返回总行数int FilterString过滤条件stringFApproveDate>='{{LAST_SYNC_TIME dateTime}}' AND FMATERIALID.FIsSalseByNet=1 and FStockOrgId.fnumber in ('101','102','118','110') FieldKeys需查询的字段key集合array FormId业务对象表单IdstringSTK_InStock

响应参数

字段字段名称类型配置值 FInStockEntry_FEntryIdidstring FID实体主键string FBillNo单据编号string FDocumentStatus单据状态string FStockOrgId_FNumber收料组织string FDate入库日期string FBillTypeID_FNumber单据类型string FOwnerTypeIdHead货主类型string FOwnerIdHead_FNumber货主string FDemandOrgId_FNumber需求组织string FPurchaseOrgId_FNumber采购组织string FSupplierId_FNumber供应商string FStockerGroupId_FNumber库存组string FStockDeptId_FNumber收料部门string FCreateDate创建日期string FCancelDate作废日期string FDeliveryBill送货单号string FTakeDeliveryBill提货单号string FApproveDate审核日期string FCancelStatus作废状态string FSupplyId_FNumber供货方string FSettleId_FNumber结算方string FChargeId_FNumber收款方string FBusinessType业务类型string FSupplyAddress供货方地址string FAPSTATUS应付状态string FTransferBizType跨组织业务类型string FDisassemblyFlag拆单新单标识string FConfirmDate确认日期string FConfirmStatus确认状态string FSplitBillType拆单类型string FPayOrgId_FNumber付款组织string FSettleOrgId_FNumber结算组织string FSettleCurrId_FNumber结算币别string FBillCost整单费用string FBillTaxAmount税额string FBillCostAmount总成本string FBillAllAmount价税合计string FSettleTypeId结算方式string FExchangeRate汇率string FLocalCurrId_FNumber本位币string FBillAmount金额string FIsIncludedTax含税string FOwnerCustomerID_FNumber货主客户string FSettleSupplierID_FNumber结算组织供应商string FISGENFORIOS跨组织结算生成string FISPRICEEXCLUDETAX价外税string FISINVOICEARLIER先到票后入库string FMaterialId_FNumber物料编码string FMaterialId_FBARCODE条码string FStockId_FNumber仓库string FProduceDate生产日期string FNote备注string FSupplierLot供应商批号string FGrossWeight毛重string FNetWeight净重string FContractlNo合同单号string FReqTraceNo需求跟踪号string FMustQty应收数量string FRealQty实收数量string FSRCRowId源单行内码string FExpiryDate有效期至string FIsFree免费string FStockStatusId库存状态string FBOMIdBOM版本string FTaxPrice含税单价string FCostPrice成本价string FEntryTaxRate税率(%)string FEntryTaxAmount税额string FDiscountRate折扣率(%)string FPriceCoefficient价格系数string FPriceUnitQty计价数量string FTaxNetPrice净价string FEntryCostAmount总成本string FAllAmount价税合计string FStockFlag入库库存更新标志string FPOOrderNo订单单号string FEXPUnit保质期单位string FExpPeriod保质期string FSRCBILLTYPEID源单类型string FSRCBillNo源单编号string FINVOICEDQTY已开票数量string FBaseAPJoinQty关联应付数量（计价基本）string FReceiveStockFlag收货库存更新标志string FProcessFee加工费string FMaterialCosts材料成本string FLot_FNumber批号string FPrice单价string FAmount金额string FDiscount折扣额string FReturnJoinQty退料关联数量string FBFLowId业务流程string FGiveAway是否赠品string FWWInType入库类型string FRowId行标识string FStockLocIdFStockLocIdstring FPriceUnitID_FNumberFPriceUnitID_FNumberstring

巨益OMS接口明细

• 接口：entryorder.create
• 接口名称：入库单创建
• 接口方法：POST

请求参数

字段名称类型描述 entryOrder入库单object入库单 entryOrder.businessIdbusinessIdstringbusinessId entryOrder.companyCodecompanyCodestring entryOrder.confirmTypeconfirmTypestringconfirmType entryOrder.consignIdconsignIdstringconsignId entryOrder.contractCodecontractCodestringcontractCode entryOrder.entryOrderCode入库单号string入库单号,示例值(E1234) entryOrder.entryOrderIdentryOrderIdstringentryOrderId entryOrder.expectEndTime最迟预期到货时间string最迟预期到货时间(YYYY-MM-DD HH:MM:SS),示例值(2015-09-09 12:00:00) entryOrder.expectStartTime预期到货时间string预期到货时间(YYYY-MM-DD HH:MM:SS),示例值(2015-09-09 12:00:00) entryOrder.expressCode运单号string运单号,示例值(Y1234) entryOrder.extOrderCodeextOrderCodestringextOrderCode entryOrder.isCheckisCheckstringisCheck entryOrder.isNudePackageisNudePackagestringisNudePackage entryOrder.logisticsCode物流公司编码string物流公司编码(SF=顺丰、EMS=标准快递、EYB=经济快件、ZJS=宅急送、YTO=圆通 、ZTO=中通(ZTO)、HTKY=百世汇通、 UC=优速、STO=申通、TTKDEX=天天快递、QFKD=全峰、FAST=快捷、POSTB=邮政小包、GTO=国通、YUNDA=韵达、JD=京东配送、DD=当当宅配、 AMAZON=亚马逊物流、OTHER=其他(只传英文编码)),示例值(SF) entryOrder.logisticsContactNamelogisticsContactNamestringlogisticsContactName entryOrder.logisticsContactNologisticsContactNostringlogisticsContactNo entryOrder.logisticsContactPhonelogisticsContactPhonestringlogisticsContactPhone entryOrder.logisticsName物流公司名称string物流公司名称,示例值(顺丰) entryOrder.operateTime操作时间string操作时间(YYYY-MM-DD HH:MM:SS),示例值(2017-09-09 12:00:00) entryOrder.operatorCode操作员编码string操作员编码,示例值(ON1234) entryOrder.operatorName操作员名称string操作员名称,示例值(老王) entryOrder.orderCreateTime订单创建时间string订单创建时间(YYYY-MM-DD HH:MM:SS),示例值(2016-09-09 12:00:00) entryOrder.orderSourceorderSourcestringorderSource,示例值(temp) entryOrder.orderType业务类型string业务类型(SCRK=生产入库;LYRK=领用入库;CCRK=残次品入库;CGRK=采购入库;DBRK=调拨入库;QTRK=其他入库;B2BRK=B2B入 库;XNRK=虚拟入库;只传英文编码),示例值(SCRK) entryOrder.outBizCode外部业务编码string外部业务编码,示例值(temp) entryOrder.ownerCode1货主编码string货主编码,示例值(O1234) entryOrder.planArrivalTimeplanArrivalTimestringplanArrivalTime,示例值(temp) entryOrder.purchaseOrderCode采购单号string采购单号(当orderType=CGRK时使用),示例值(C123455) entryOrder.receiverInfo收件人信息object收件人信息 entryOrder.receiverInfo.area区域string区域,示例值(余杭) entryOrder.receiverInfo.city城市string城市,示例值(杭州) entryOrder.receiverInfo.countryCode国家二字码string国家二字码,示例值(045565) entryOrder.receiverInfo.detailAddress详细地址string详细地址,示例值(杭州市余杭区989号) entryOrder.receiverInfo.mobile移动电话string移动电话,示例值(13423456785) entryOrder.receiverInfo.name姓名string姓名,示例值(老王) entryOrder.receiverInfo.province省份string省份,示例值(浙江省) entryOrder.receiverInfo.town村镇string村镇,示例值(横加桥) entryOrder.receiverInfo.relatedOrders关联订单信息array关联订单信息 entryOrder.receiverInfo.relatedOrders.orderCode关联的订单编号string关联的订单编号,示例值(G1234) entryOrder.receiverInfo.relatedOrders.sizeDetailsizeDetailstringsizeDetail,示例值(temp) entryOrder.receiverInfo.relatedOrders.supplierAddresssupplierAddressstringsupplierAddress,示例值(temp) entryOrder.receiverInfo.relatedOrders.supplierAreasupplierAreastringsupplierArea,示例值(temp) entryOrder.receiverInfo.relatedOrders.supplierCitysupplierCitystringsupplierCity,示例值(temp) entryOrder.receiverInfo.relatedOrders.supplierCode供应商编码string供应商编码,示例值(G1234) entryOrder.receiverInfo.relatedOrders.supplierEmailsupplierEmailstringsupplierEmail,示例值(temp) entryOrder.receiverInfo.relatedOrders.supplierName供应商名称string供应商名称,示例值(GN1234) entryOrder.receiverInfo.relatedOrders.supplierPhonesupplierPhonestringsupplierPhone,示例值(temp) entryOrder.receiverInfo.relatedOrders.supplierProvincesupplierProvincestringsupplierProvince,示例值(temp) entryOrder.receiverInfo.relatedOrders.supplierTelsupplierTelstringsupplierTel,示例值(temp) entryOrder.receiverInfo.relatedOrders.supplierTownsupplierTownstringsupplierTown,示例值(temp) entryOrder.receiverInfo.relatedOrders.supplierZipCodesupplierZipCodestringsupplierZipCode,示例值(temp) entryOrder.receiverInfo.relatedOrders.totalOrderLinestotalOrderLinesstringtotalOrderLines,示例值(12) entryOrder.receiverInfo.relatedOrders.warehouseCode入库仓库编码string入库仓库编码(统仓统配等无需ERP指定仓储编码的情况填OTHER),示例值(LD) entryOrder.orderLines入库明细array入库明细 entryOrder.orderLines.actualPriceactualPricestringactualPrice entryOrder.orderLines.actualQty数量stringactualQty entryOrder.orderLines.amountamountstringamount entryOrder.orderLines.batchCode批次编码string批次编码,示例值(PCODE123) entryOrder.orderLines.colorcolorstringcolor,示例值(temp) entryOrder.orderLines.deliveryOrderIddeliveryOrderIdstringdeliveryOrderId,示例值(temp) entryOrder.orderLines.discountdiscountstringdiscount,示例值(temp) entryOrder.orderLines.discountAmountdiscountAmountstringdiscountAmount,示例值(temp) entryOrder.orderLines.discountPricediscountPricestringdiscountPrice,示例值(temp) entryOrder.orderLines.exceptionQtyexceptionQtystringexceptionQty,示例值(temp) entryOrder.orderLines.expireDate商品过期日期string商品过期日期(YYYY-MM-DD),示例值(2017-09-09) entryOrder.orderLines.extCodeextCodestringextCode,示例值(temp) entryOrder.orderLines.inventoryType库存类型string库存类型(ZP=正品;CC=残次;JS=机损;XS=箱损;默认为ZP),示例值(ZP) entryOrder.orderLines.itemCode商品编码string商品编码,示例值(K1234) entryOrder.orderLines.itemId仓储系统商品IDstring仓储系统商品ID,示例值(CI123) entryOrder.orderLines.itemName商品名称string商品名称,示例值(IN123) entryOrder.orderLines.locationCodelocationCodestringlocationCode,示例值(temp) entryOrder.orderLines.moveInLocationmoveInLocationstringmoveInLocation,示例值(temp) entryOrder.orderLines.moveOutLocationmoveOutLocationstringmoveOutLocation,示例值(temp) entryOrder.orderLines.orderLineNo入库单的行号string入库单的行号,示例值(EL123) entryOrder.orderLines.orderSourceCodeorderSourceCodestringorderSourceCode,示例值(temp) entryOrder.orderLines.ownerCode货主编码string货主编码,示例值(O123) entryOrder.orderLines.payNopayNostringpayNo,示例值(temp) entryOrder.orderLines.planQty应收商品数量string应收商品数量,示例值(12) entryOrder.orderLines.produceCode生产批号string生产批号,示例值(P1234) entryOrder.orderLines.productCodeproductCodestringproductCode,示例值(temp) entryOrder.orderLines.productDate商品生产日期string商品生产日期(YYYY-MM-DD),示例值(2017-09-09) entryOrder.orderLines.purchasePrice采购价string采购价,示例值(12) entryOrder.orderLines.qrCodeqrCodestringqrCode,示例值(temp) entryOrder.orderLines.quantityquantitystringquantity,示例值(temp) entryOrder.orderLines.referencePricereferencePricestringreferencePrice,示例值(temp) entryOrder.orderLines.remarkremarkstringremark,示例值(temp) entryOrder.orderLines.retailPrice零售价string零售价,示例值(12) entryOrder.orderLines.settlementAmountsettlementAmountstringsettlementAmount,示例值(temp) entryOrder.orderLines.sizesizestringsize,示例值(temp) entryOrder.orderLines.skuProperty商品属性string商品属性,示例值(属性) entryOrder.orderLines.sourceOrderCodesourceOrderCodestringsourceOrderCode,示例值(temp) entryOrder.orderLines.sourceQtysourceQtystringsourceQty,示例值(123) entryOrder.orderLines.standardAmountstandardAmountstringstandardAmount,示例值(temp) entryOrder.orderLines.standardPricestandardPricestringstandardPrice,示例值(temp) entryOrder.orderLines.statusstatusstringstatus,示例值(temp) entryOrder.orderLines.stockInQtystockInQtystringstockInQty,示例值(temp) entryOrder.orderLines.stockOutQtystockOutQtystringstockOutQty,示例值(temp) entryOrder.orderLines.subDeliveryOrderIdsubDeliveryOrderIdstringsubDeliveryOrderId,示例值(temp) entryOrder.orderLines.subSourceCodesubSourceCodestringsubSourceCode,示例值(temp) entryOrder.orderLines.subSourceOrderCodesubSourceOrderCodestringsubSourceOrderCode,示例值(temp) entryOrder.orderLines.taobaoItemCodetaobaoItemCodestringtaobaoItemCode,示例值(temp) entryOrder.orderLines.unit单位string单位,示例值(个/盒/箱/柜等) entryOrder.orderLines.manufacturerItemNumber仓位string

系统打通概况

基于轻易云的连接器和数据服务能力，轻松实现供应链异构系统的“相互沟通”，通过数据应用自动化业务流程管理，全面管控供应链的每一环节。从要货、销售出库、退货入库、到盘点、调拨，无需人工参与，实时更新，自动化流转。通过快速连接金蝶云星空接口抽取数据后再自动分发到巨益OMS， 解放生产力，自动生成数据、并分发推送到业务应用，数据传递时效性提升10倍以上。