金蝶云星空与巨益OMS对接集成采购退料查询连通库存异动(ERP采购退料对接OMS库存异动)

接入系统：金蝶云星空

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

接通系统：巨益OMS

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

配置集成方案

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

金蝶云星空接口明细

• API：executeBillQuery

• NAME：采购退料查询

• METHOD：POST

请求参数

接口字段	字段名称	预设值	描述
FPURMRBENTRY_FEntryID	明细信息ID	FPURMRBENTRY_FEntryID
FID	实体主键	FID
FBillNo	单据编号	FBillNo
FDocumentStatus	单据状态	FDocumentStatus
FStockOrgId_FNumber	退料组织	FStockOrgId.FNumber
FDate	退料日期	FDate
FBillTypeID_FNumber	单据类型	FBillTypeID.FNumber
FTAKEDELIVERYNO	提货单号	FTAKEDELIVERYNO
FSupplierID_FNumber	供应商	FSupplierID.FNumber
FDESCRIPTION	备注	FDESCRIPTION
FCarrierID_FNumber	承运商	FCarrierID.FNumber
FDELIVERYNO	送货单号	FDELIVERYNO
FPurchaseOrgId_FNumber	采购组织	FPurchaseOrgId.FNumber
FMRTYPE	退料类型	FMRTYPE
FMRMODE	退料方式	FMRMODE
FMRREASON	退料原因	FMRREASON
FREPLENISHMODE	补料方式	FREPLENISHMODE
FCreateDate	创建日期	FCreateDate
FModifyDate	最后修改日期	FModifyDate
FApproveDate	审核日期	FApproveDate
FCreatorId	创建人	FCreatorId
FApproverId	审核人	FApproverId
FCancelerId	作废人	FCancelerId
FCancelDate	作废日期	FCancelDate
FCARRYNO	运输单号	FCARRYNO
FCancelStatus	作废状态	FCancelStatus
FACCEPTORID_FNumber	接收方	FACCEPTORID.FNumber
FSettleId_FNumber	结算方	FSettleId.FNumber
FBusinessType	业务类型	FBusinessType
FAcceptAddress	接收方地址	FAcceptAddress
FCHARGEID_FNumber	收款方	FCHARGEID.FNumber
FAPSTATUS	应付状态	FAPSTATUS
FTransferBizType	跨组织业务类型	FTransferBizType
FCorrespondOrgId_FNumber	对应组织	FCorrespondOrgId.FNumber
FSupplyOrderNo	订单号	FSupplyOrderNo
FPayOrgId_FNumber	付款组织	FPayOrgId.FNumber
FSettleOrgId_FNumber	结算组织	FSettleOrgId.FNumber
FSETTLETYPEID_FNumber	结算方式	FSETTLETYPEID.FNumber
FPAYCONDITIONID_FNumber	付款条件	FPAYCONDITIONID.FNumber
FSettleCurrId_FNumber	结算币别	FSettleCurrId.FNumber
FBILLTAXAMOUNT	税额	FBILLTAXAMOUNT
FBILLCOSTAMOUNT	总成本	FBILLCOSTAMOUNT
FBILLALLAMOUNT	价税合计	FBILLALLAMOUNT
FEXCHANGETYPEID_FNumber	汇率类型	FEXCHANGETYPEID.FNumber
FIsIncludedTax	含税	FIsIncludedTax
FBillAmount	金额	FBillAmount
FISGENFORIOS	跨组织结算生成	FISGENFORIOS
FSettleSupplierID_FNumber	结算组织供应商	FSettleSupplierID.FNumber
FISPRICEEXCLUDETAX	价外税	FISPRICEEXCLUDETAX
FISINVOICEARLIER	先到票后入库	FISINVOICEARLIER
FTHIRDSRCTYPE	第三方来源	FTHIRDSRCTYPE
FTHIRDBILLID	第三方单据ID	FTHIRDBILLID
FTHIRDBILLNO	第三方单据编号	FTHIRDBILLNO
FMATERIALID_FNumber	物料编码	FMATERIALID.FNumber
FMATERIALID_FBARCODE	条码	FMATERIALID.FBARCODE
FREPLENISHQTY	补料数量	FREPLENISHQTY
FKEAPAMTQTY	扣款数量	FKEAPAMTQTY
FSTOCKID_FNumber	仓库	FSTOCKID.FNumber
FStockStatusId	库存状态	FStockStatusId
FNOTE	备注	FNOTE
FProduceDate	生产日期	FProduceDate
FEXPIRYDATE	到期日	FEXPIRYDATE
FCONTRACTNO	合同单号	FCONTRACTNO
FREQTRACENO	需求跟踪号	FREQTRACENO
FORDERNO	订单单号	FORDERNO
FPRICEUNITQTY	计价数量	FPRICEUNITQTY
FCostPrice	成本价	FCostPrice
FTAXPRICE	含税单价	FTAXPRICE
FDISCOUNTRATE	折扣率(%)	FDISCOUNTRATE
FTAXNETPRICE	净价	FTAXNETPRICE
FENTRYCOSTAMOUNT	总成本	FENTRYCOSTAMOUNT
FENTRYTAXRATE	税率	FENTRYTAXRATE
FENTRYTAXAMOUNT	税额	FENTRYTAXAMOUNT
FALLAMOUNT	价税合计	FALLAMOUNT
FOWNERID_FNumber	货主	FOWNERID.FNumber
FJOINQTY	关联数量	FJOINQTY
FRMREALQTY	实退数量	FRMREALQTY
FRMMUSTQTY	应退数量	FRMMUSTQTY
FSTOCKLOCID	仓位	FSTOCKLOCID
FSRCBillTypeId	源单类型	FSRCBillTypeId
FSRCBillNo	源单编号	FSRCBillNo
FLot_FNumber	批号	FLot.FNumber
FPrice	单价	FPrice
FAmount	金额	FAmount
FDiscount	折扣额	FDiscount
FBFLowId	业务流程	FBFLowId
FSRCSeq	源单行号	FSRCSeq
FMtoNo	计划跟踪号	FMtoNo
FIsStock	是否可库存	FIsStock
FGiveAway	是否赠品	FGiveAway
FRowId	行标识	FRowId
FParentRowId	父行标识	FParentRowId
FBarcode	零售条形码	FBarcode
Limit	最大行数	{{PAGINATION_PAGE_SIZE}}	金蝶的查询分页参数
StartRow	开始行索引	{{PAGINATION_START_ROW}}	金蝶的查询分页参数
TopRowCount	返回总行数		金蝶的查询分页参数
FilterString	过滤条件	FApproveDate>='{{LAST_SYNC_TIME dateTime}}' AND FMATERIALID.FIsSalseByNet=1 and FStockOrgId.fnumber in ('101','102','118','110')	示例写法 FSupplierId.FNumber = 'VEN00010' and FApproveDate>=
FieldKeys	需查询的字段key集合		金蝶分录主键ID格式：FPOOrderEntry_FEntryId,其它格式 FPurchaseOrgId.FNumber
FormId	业务对象表单Id	PUR_MRB	必须填写金蝶的表单ID如 UR_PurchaseOrder

响应参数

接口字段	字段名称	预设值	描述
FPURMRBENTRY_FEntryID	明细信息ID
FID	实体主键
FBillNo	单据编号
FDocumentStatus	单据状态
FStockOrgId_FNumber	退料组织
FDate	退料日期
FBillTypeID_FNumber	单据类型
FTAKEDELIVERYNO	提货单号
FSupplierID_FNumber	供应商
FDESCRIPTION	备注
FCarrierID_FNumber	承运商
FDELIVERYNO	送货单号
FPurchaseOrgId_FNumber	采购组织
FMRTYPE	退料类型
FMRMODE	退料方式
FMRREASON	退料原因
FREPLENISHMODE	补料方式
FCreateDate	创建日期
FModifyDate	最后修改日期
FApproveDate	审核日期
FCreatorId	创建人
FApproverId	审核人
FCancelerId	作废人
FCancelDate	作废日期
FCARRYNO	运输单号
FCancelStatus	作废状态
FACCEPTORID_FNumber	接收方
FSettleId_FNumber	结算方
FBusinessType	业务类型
FAcceptAddress	接收方地址
FCHARGEID_FNumber	收款方
FAPSTATUS	应付状态
FTransferBizType	跨组织业务类型
FCorrespondOrgId_FNumber	对应组织
FSupplyOrderNo	订单号
FPayOrgId_FNumber	付款组织
FSettleOrgId_FNumber	结算组织
FSETTLETYPEID_FNumber	结算方式
FPAYCONDITIONID_FNumber	付款条件
FSettleCurrId_FNumber	结算币别
FBILLTAXAMOUNT	税额
FBILLCOSTAMOUNT	总成本
FBILLALLAMOUNT	价税合计
FEXCHANGETYPEID_FNumber	汇率类型
FIsIncludedTax	含税
FBillAmount	金额
FISGENFORIOS	跨组织结算生成
FSettleSupplierID_FNumber	结算组织供应商
FISPRICEEXCLUDETAX	价外税
FISINVOICEARLIER	先到票后入库
FTHIRDSRCTYPE	第三方来源
FTHIRDBILLID	第三方单据ID
FTHIRDBILLNO	第三方单据编号
FMATERIALID_FNumber	物料编码
FMATERIALID_FBARCODE	条码
FREPLENISHQTY	补料数量
FKEAPAMTQTY	扣款数量
FSTOCKID_FNumber	仓库
FStockStatusId	库存状态
FNOTE	备注
FProduceDate	生产日期
FEXPIRYDATE	到期日
FCONTRACTNO	合同单号
FREQTRACENO	需求跟踪号
FORDERNO	订单单号
FPRICEUNITQTY	计价数量
FCostPrice	成本价
FTAXPRICE	含税单价
FDISCOUNTRATE	折扣率(%)
FTAXNETPRICE	净价
FENTRYCOSTAMOUNT	总成本
FENTRYTAXRATE	税率
FENTRYTAXAMOUNT	税额
FALLAMOUNT	价税合计
FOWNERID_FNumber	货主
FJOINQTY	关联数量
FRMREALQTY	实退数量
FRMMUSTQTY	应退数量
FSTOCKLOCID	仓位
FSRCBillTypeId	源单类型
FSRCBillNo	源单编号
FLot_FNumber	批号
FPrice	单价
FAmount	金额
FDiscount	折扣额
FBFLowId	业务流程
FSRCSeq	源单行号
FMtoNo	计划跟踪号
FIsStock	是否可库存
FGiveAway	是否赠品
FRowId	行标识
FParentRowId	父行标识
FBarcode	零售条形码

巨益OMS接口明细

• API：stockchange.report

• NAME：库存异动

• METHOD：POST

请求参数

接口字段	字段名称	预设值	描述
items	items	items
items.actualAmount	actualAmount
items.adventLifecycle	adventLifecycle
items.amount	amount
items.approvalNumber	approvalNumber
items.barCode	barCode
items.batchRemark	batchRemark
items.batchs	批次信息
items.batchs.actualQty	actualQty
items.batchs.batchCode	批次编号	{{items.FLot_FNumber}}
items.batchs.expireDate	expireDate	{{items.FEXPIRYDATE}}
items.batchs.inventoryType	库存类型	CP
items.batchs.produceCode	produceCode
items.batchs.productDate	productDate	{{items.FProduceDate}}
items.batchs.quantity	异动数量	{{items.FRMREALQTY}}
items.batchs.remark	remark
items.batchs.brandCode	brandCode
items.batchs.brandName	brandName
items.batchs.categoryId	categoryId
items.batchs.categoryName	categoryName
items.batchs.changeTime	异动时间	{{FDate_new}}
items.batchs.channelCode	channelCode
items.batchs.color	color
items.batchs.costPrice	costPrice
items.batchs.defectiveQty	defectiveQty
items.batchs.diffQuantity	diffQuantity
items.batchs.discount	discount
items.batchs.discountPrice	discountPrice
items.batchs.englishName	englishName
items.batchs.exCode	exCode
items.batchs.extCode	extCode
items.batchs.goodsCode	物料编码	{{items.FMATERIALID_FNumber}}
items.batchs.grossWeight	grossWeight
items.batchs.height	height
items.batchs.isAreaSale	isAreaSale
items.batchs.isBatchMgmt	isBatchMgmt
items.batchs.isFragile	isFragile
items.batchs.isHazardous	isHazardous
items.batchs.isSNMgmt	isSNMgmt
items.batchs.isShelfLifeMgmt	isShelfLifeMgmt
items.batchs.isSku	isSku
items.batchs.itemCode	商品编码	{{items.FMATERIALID_FNumber}}
items.batchs.itemId	itemId
items.batchs.itemName	itemName
items.batchs.itemType	itemType
items.batchs.lackQty	lackQty
items.batchs.latestUpdateTime	latestUpdateTime
items.batchs.length	length
items.batchs.lockQuantity	lockQuantity
items.batchs.lockupLifecycle	lockupLifecycle
items.batchs.netWeight	netWeight
items.batchs.normalQty	normalQty
items.batchs.orderLineNo	orderLineNo
items.batchs.originAddress	originAddress
items.batchs.originCode	originCode
items.batchs.packCode	packCode
items.batchs.packageMaterial	packageMaterial
items.batchs.paperQty	paperQty
items.batchs.pcs	pcs
items.batchs.planQty	planQty
items.batchs.price	price
items.batchs.pricingCategory	pricingCategory
items.batchs.productCode	productCode
items.batchs.purchasePrice	purchasePrice
items.batchs.reason	reason
items.batchs.receiveQty	receiveQty	{{items.FRMREALQTY}}
items.batchs.referencePrice	referencePrice
items.batchs.rejectLifecycle	rejectLifecycle
items.batchs.retailPrice	retailPrice
items.batchs.safetyStock	safetyStock
items.batchs.seasonCode	seasonCode
items.batchs.seasonName	seasonName
items.batchs.shelfLife	shelfLife
items.batchs.shortName	shortName
items.batchs.size	size
items.batchs.skuProperty	skuProperty
items.batchs.sn	sn
items.batchs.snCode	snCode
items.batchs.sourceOrderCode	sourceOrderCode
items.batchs.standardPrice	standardPrice
items.batchs.stockStatus	stockStatus
items.batchs.stockUnit	stockUnit
items.batchs.subSourceOrderCode	subSourceOrderCode
items.batchs.supplierCode	supplierCode
items.batchs.supplierName	supplierName
items.batchs.tagPrice	tagPrice
items.batchs.tareWeight	tareWeight
items.batchs.tempRequirement	tempRequirement
items.batchs.warehouseCode	warehouseCode	test01
items.batchs.unit	unit
items.batchs.volume	volume
items.batchs.width	width
items.batchs.quantity	数量	-{{items.FRMREALQTY}}
items.batchs.orderCode	来源编码	{{FBillNo}}{{FSTOCKID_FNumber}}
items.batchs.orderType	单据类型	JYCK
items.batchs.outBizCode	外部业务编码	{{FBillNo}}{{FSTOCKID_FNumber}}
items.batchs.outCode	outCode	{{FBillNo}}{{FSTOCKID_FNumber}}
items.batchs.ownerCode	货主编码	{{FOWNERID_FNumber}}
items.batchs.warehouseCode	仓库	test01

系统数据集成价值

数据集成中台设计中心Web界面以“拖拽”式交互设计，使用鼠标即可构建设计多异构系统数据集成流程，低代码平台大大降低流程设计者上手门槛。还有丰富的组件库快速满足复杂业务需求，结合不同模块即可生成不同业务流程，提升流程设计效率。平台支持多种高度灵活部署，高并发、高性能、高可用，可以通过多节点组成集群实现性能的横向扩展。适度集群配置其数据集成处理能力可达GB级/秒，为业务流提供更高数据吞吐量。平台已集成数据回压、优先级队列等能力，保障运行稳定性。完善的企业API运营管理机制帮助您构建“API生产者、API管理者、API消费者”三者结合的统一API数字化生态。支持市面上主流厂家软件如：金蝶、用友、SAP、泛微、蓝凌、旺店通、聚水潭、马帮、小满CRM等等。