系统数据集成方案

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

对接源平台:金蝶云星空

接入系统：巨益OMS

接口方案配置

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

金蝶云星空接口明细

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

请求参数

字段	名称	类型	描述
FInStockEntry_FEntryId	id	string
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
FBOMId	BOM版本	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
FStockLocId	FStockLocId	string
FPriceUnitID_FNumber	FPriceUnitID_FNumber	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如:PUR_PurchaseOrder

响应参数

字段	名称	类型	描述
FInStockEntry_FEntryId	id	string
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
FBOMId	BOM版本	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
FStockLocId	FStockLocId	string
FPriceUnitID_FNumber	FPriceUnitID_FNumber	string

巨益OMS接口明细

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

请求参数

字段	名称	类型	描述
entryOrder	入库单	object	入库单
entryOrder.businessId	businessId	string	businessId
entryOrder.companyCode	companyCode	string
entryOrder.confirmType	confirmType	string	confirmType
entryOrder.consignId	consignId	string	consignId
entryOrder.contractCode	contractCode	string	contractCode
entryOrder.entryOrderCode	入库单号	string	入库单号,示例值(E1234)
entryOrder.entryOrderId	entryOrderId	string	entryOrderId
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.extOrderCode	extOrderCode	string	extOrderCode
entryOrder.isCheck	isCheck	string	isCheck
entryOrder.isNudePackage	isNudePackage	string	isNudePackage
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.logisticsContactName	logisticsContactName	string	logisticsContactName
entryOrder.logisticsContactNo	logisticsContactNo	string	logisticsContactNo
entryOrder.logisticsContactPhone	logisticsContactPhone	string	logisticsContactPhone
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.orderSource	orderSource	string	orderSource,示例值(temp)
entryOrder.orderType	业务类型	string	业务类型(SCRK=生产入库;LYRK=领用入库;CCRK=残次品入库;CGRK=采购入库;DBRK=调拨入库;QTRK=其他入库;B2BRK=B2B入 库;XNRK=虚拟入库;只传英文编码),示例值(SCRK)
entryOrder.outBizCode	外部业务编码	string	外部业务编码,示例值(temp)
entryOrder.ownerCode1	货主编码	string	货主编码,示例值(O1234)
entryOrder.planArrivalTime	planArrivalTime	string	planArrivalTime,示例值(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.sizeDetail	sizeDetail	string	sizeDetail,示例值(temp)
entryOrder.receiverInfo.relatedOrders.supplierAddress	supplierAddress	string	supplierAddress,示例值(temp)
entryOrder.receiverInfo.relatedOrders.supplierArea	supplierArea	string	supplierArea,示例值(temp)
entryOrder.receiverInfo.relatedOrders.supplierCity	supplierCity	string	supplierCity,示例值(temp)
entryOrder.receiverInfo.relatedOrders.supplierCode	供应商编码	string	供应商编码,示例值(G1234)
entryOrder.receiverInfo.relatedOrders.supplierEmail	supplierEmail	string	supplierEmail,示例值(temp)
entryOrder.receiverInfo.relatedOrders.supplierName	供应商名称	string	供应商名称,示例值(GN1234)
entryOrder.receiverInfo.relatedOrders.supplierPhone	supplierPhone	string	supplierPhone,示例值(temp)
entryOrder.receiverInfo.relatedOrders.supplierProvince	supplierProvince	string	supplierProvince,示例值(temp)
entryOrder.receiverInfo.relatedOrders.supplierTel	supplierTel	string	supplierTel,示例值(temp)
entryOrder.receiverInfo.relatedOrders.supplierTown	supplierTown	string	supplierTown,示例值(temp)
entryOrder.receiverInfo.relatedOrders.supplierZipCode	supplierZipCode	string	supplierZipCode,示例值(temp)
entryOrder.receiverInfo.relatedOrders.totalOrderLines	totalOrderLines	string	totalOrderLines,示例值(12)
entryOrder.receiverInfo.relatedOrders.warehouseCode	入库仓库编码	string	入库仓库编码(统仓统配等无需ERP指定仓储编码的情况填OTHER),示例值(LD)
entryOrder.orderLines	入库明细	array	入库明细
entryOrder.orderLines.actualPrice	actualPrice	string	actualPrice
entryOrder.orderLines.actualQty	数量	string	actualQty
entryOrder.orderLines.amount	amount	string	amount
entryOrder.orderLines.batchCode	批次编码	string	批次编码,示例值(PCODE123)
entryOrder.orderLines.color	color	string	color,示例值(temp)
entryOrder.orderLines.deliveryOrderId	deliveryOrderId	string	deliveryOrderId,示例值(temp)
entryOrder.orderLines.discount	discount	string	discount,示例值(temp)
entryOrder.orderLines.discountAmount	discountAmount	string	discountAmount,示例值(temp)
entryOrder.orderLines.discountPrice	discountPrice	string	discountPrice,示例值(temp)
entryOrder.orderLines.exceptionQty	exceptionQty	string	exceptionQty,示例值(temp)
entryOrder.orderLines.expireDate	商品过期日期	string	商品过期日期(YYYY-MM-DD),示例值(2017-09-09)
entryOrder.orderLines.extCode	extCode	string	extCode,示例值(temp)
entryOrder.orderLines.inventoryType	库存类型	string	库存类型(ZP=正品;CC=残次;JS=机损;XS=箱损;默认为ZP),示例值(ZP)
entryOrder.orderLines.itemCode	商品编码	string	商品编码,示例值(K1234)
entryOrder.orderLines.itemId	仓储系统商品ID	string	仓储系统商品ID,示例值(CI123)
entryOrder.orderLines.itemName	商品名称	string	商品名称,示例值(IN123)
entryOrder.orderLines.locationCode	locationCode	string	locationCode,示例值(temp)
entryOrder.orderLines.moveInLocation	moveInLocation	string	moveInLocation,示例值(temp)
entryOrder.orderLines.moveOutLocation	moveOutLocation	string	moveOutLocation,示例值(temp)
entryOrder.orderLines.orderLineNo	入库单的行号	string	入库单的行号,示例值(EL123)
entryOrder.orderLines.orderSourceCode	orderSourceCode	string	orderSourceCode,示例值(temp)
entryOrder.orderLines.ownerCode	货主编码	string	货主编码,示例值(O123)
entryOrder.orderLines.payNo	payNo	string	payNo,示例值(temp)
entryOrder.orderLines.planQty	应收商品数量	string	应收商品数量,示例值(12)
entryOrder.orderLines.produceCode	生产批号	string	生产批号,示例值(P1234)
entryOrder.orderLines.productCode	productCode	string	productCode,示例值(temp)
entryOrder.orderLines.productDate	商品生产日期	string	商品生产日期(YYYY-MM-DD),示例值(2017-09-09)
entryOrder.orderLines.purchasePrice	采购价	string	采购价,示例值(12)
entryOrder.orderLines.qrCode	qrCode	string	qrCode,示例值(temp)
entryOrder.orderLines.quantity	quantity	string	quantity,示例值(temp)
entryOrder.orderLines.referencePrice	referencePrice	string	referencePrice,示例值(temp)
entryOrder.orderLines.remark	remark	string	remark,示例值(temp)
entryOrder.orderLines.retailPrice	零售价	string	零售价,示例值(12)
entryOrder.orderLines.settlementAmount	settlementAmount	string	settlementAmount,示例值(temp)
entryOrder.orderLines.size	size	string	size,示例值(temp)
entryOrder.orderLines.skuProperty	商品属性	string	商品属性,示例值(属性)
entryOrder.orderLines.sourceOrderCode	sourceOrderCode	string	sourceOrderCode,示例值(temp)
entryOrder.orderLines.sourceQty	sourceQty	string	sourceQty,示例值(123)
entryOrder.orderLines.standardAmount	standardAmount	string	standardAmount,示例值(temp)
entryOrder.orderLines.standardPrice	standardPrice	string	standardPrice,示例值(temp)
entryOrder.orderLines.status	status	string	status,示例值(temp)
entryOrder.orderLines.stockInQty	stockInQty	string	stockInQty,示例值(temp)
entryOrder.orderLines.stockOutQty	stockOutQty	string	stockOutQty,示例值(temp)
entryOrder.orderLines.subDeliveryOrderId	subDeliveryOrderId	string	subDeliveryOrderId,示例值(temp)
entryOrder.orderLines.subSourceCode	subSourceCode	string	subSourceCode,示例值(temp)
entryOrder.orderLines.subSourceOrderCode	subSourceOrderCode	string	subSourceOrderCode,示例值(temp)
entryOrder.orderLines.taobaoItemCode	taobaoItemCode	string	taobaoItemCode,示例值(temp)
entryOrder.orderLines.unit	单位	string	单位,示例值(个/盒/箱/柜等)
entryOrder.orderLines.manufacturerItemNumber	仓位	string

系统打通概况

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

系统数据对接方案元数据代码