金蝶云星空和奇门WMS-A接口打通对接实战

金蝶云星空和奇门WMS-A接口打通对接实战

数据源平台:金蝶云星空

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

接入系统：奇门WMS-A

奇门WMS是针对菜鸟WMS、天猫国际保税仓、其它WMS系统（如：百世云仓、巨沃WMS、递四方、中仓仓储等第三方仓储WMS系统），进行对接与管理的模块。奇门WMS包含：基本信息配置、商品同步、商品对照、商品区域销售设置、渠道库存管理、库存同步设置、手动同步库存、仓库对照、供应商对照、采购订单、采购退货出库单、发货单列表、退货单列表、调拨单列表、仓内加工单、其他出库单、其他入库单、B2B出库单、接口日志查询、前后端商品映射关系同步

系统对接接口配置

集成方案是整个轻易云集成平台的核心，每一个集成方案代表一种业务的对接策略（对接方案借鉴可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息），用户可以根据业务的不同新建多个不同规则的集成方案。比如：采购订单同步，线上销售出库同步，线下销售出库同步。一个集成方案必须要配置源系统：金蝶云星空，源系统 API：采购订单查询，目标系统：奇门WMS-A，目标系统 API入库单创建。在新增集成方案之前需要确定两个系统的连接器都已经配置完成。

金蝶云星空接口明细

• 接口：executeBillQuery

• 接口名称：采购订单查询

• 接口方法：POST

请求参数

字段	名称	类型	描述
FPOOrderEntry_FEntryId	id	string
FBillNo	单据编号	string	单据编号
FSourceBillNo	源单编号	string	源单编号
FBillTypeID_FNumber	单据类型	string	单据类型
FBusinessType	业务类型	string	下拉列表
FSupplierId_FNumber	供应商	string	基础资料
FSettleModeId_FNumber	结算方式	string	基础资料
FPayConditionId_FNumber	付款条件	string	基础资料
FDate	采购日期	string	日期
FDocumentStatus	单据状态	string	单据状态
FPreMatchAmountFor	预付已核销金额	string	金额
FPayAdvanceBillId_FNumber	预付单号	string	基础资料
FPurchaseOrgId_FNumber	采购组织	string	组织
FPurchaseDeptId_FNumber	采购部门	string	基础资料
FPurchaserGroupId_FNumber	采购组	string	基础资料
FPurchaserId_FNumber	采购员	string	基础资料
FProviderId_FNumber	供货方	string	基础资料
FSettleId_FNumber	结算方	string	基础资料
FChargeId_FNumber	收款方	string	基础资料
FCorrespondOrgId_FNumber	对应组织	string	组织
FAssignSupplierId_FNumber	指定供应商	string	基础资料
FMaterialId_FNumber	物料编码	string	基础资料
FBarcode	零售条形码	string	文本
FQty	采购数量	string	数量
FDeliveryDate	交货日期	string	长日期
FLocation	交货地点	string	多行文本
FLocationAddress	交货地址	string	多行文本
FPrice	单价	string	单价
FTaxPrice	含税单价	string	单价
FEntryDiscountRate	折扣率%	string	小数
FEntryDiscount	折扣额	string	折扣额
FEntryTaxRate	税率%	string	小数
FEntryTaxAmount	税额	string	金额
FAllAmount	价税合计	string	金额
FEntryAmount	金额	string	金额
FRequireOrgId_FNumber	需求组织	string	组织
FRequireDeptId_FNumber	需求部门	string	基础资料
FRequireStaffId_FNumber	需求人	string	基础资料
FReceiveOrgId_FNumber	收料组织	string	组织
FBranchId_FNumber	收货门店	string	基础资料
FReceiveDeptId_FNumber	收料部门	string	基础资料
FEntrySettleOrgId_FNumber	结算组织	string	组织
FGiveAway	是否赠品	string	复选框
FEntryNote	备注	string	多行文本
FSupMatId	供应商物料编码	string	文本
FSupMatName	供应商物料名称	string	文本
FLot_FNumber	批号	string	批次
FSupplierLot	供应商批号	string	文本
FReceiveQty	累计收料数量	string	数量
FRemainReceiveQty	剩余收料数量	string	数量
FStockInQty	累计入库数量	string	数量
FRemainStockINQty	剩余入库数量	string	数量
FMrbQty	累计退料数量	string	数量
FCHECKRETQTY	收料可退数量	string	数量
FSTOCKRETQTY	库存可退数量	string	数量
FConsumeSumQty	消耗汇总数量	string	数量
FSrcBillTypeId	源单类型	string	源单类型
FSrcBillNo	源单编号	string	源单编号
FAuxPropId	销售渠道	string	文本
FMtoNo	计划跟踪号	string	文本
FDEMANDTYPE	需求来源	string	下拉列表
FDEMANDBILLNO	需求单据编号	string	文本
FDEMANDBILLENTRYSEQ	需求单据行号	string	整数
FDEMANDBILLENTRYID	需求单据分录内码	string	整数
FID	FID	string
F_ORA_FSTOCK	对接仓库	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

响应参数

字段	名称	类型	描述
FPOOrderEntry_FEntryId	id	string
FBillNo	单据编号	string	单据编号
FSourceBillNo	源单编号	string	源单编号
FBillTypeID_FNumber	单据类型	string	单据类型
FBusinessType	业务类型	string	下拉列表
FSupplierId_FNumber	供应商	string	基础资料
FSettleModeId_FNumber	结算方式	string	基础资料
FPayConditionId_FNumber	付款条件	string	基础资料
FDate	采购日期	string	日期
FDocumentStatus	单据状态	string	单据状态
FPreMatchAmountFor	预付已核销金额	string	金额
FPayAdvanceBillId_FNumber	预付单号	string	基础资料
FPurchaseOrgId_FNumber	采购组织	string	组织
FPurchaseDeptId_FNumber	采购部门	string	基础资料
FPurchaserGroupId_FNumber	采购组	string	基础资料
FPurchaserId_FNumber	采购员	string	基础资料
FProviderId_FNumber	供货方	string	基础资料
FSettleId_FNumber	结算方	string	基础资料
FChargeId_FNumber	收款方	string	基础资料
FCorrespondOrgId_FNumber	对应组织	string	组织
FAssignSupplierId_FNumber	指定供应商	string	基础资料
FMaterialId_FNumber	物料编码	string	基础资料
FBarcode	零售条形码	string	文本
FQty	采购数量	string	数量
FDeliveryDate	交货日期	string	长日期
FLocation	交货地点	string	多行文本
FLocationAddress	交货地址	string	多行文本
FPrice	单价	string	单价
FTaxPrice	含税单价	string	单价
FEntryDiscountRate	折扣率%	string	小数
FEntryDiscount	折扣额	string	折扣额
FEntryTaxRate	税率%	string	小数
FEntryTaxAmount	税额	string	金额
FAllAmount	价税合计	string	金额
FEntryAmount	金额	string	金额
FRequireOrgId_FNumber	需求组织	string	组织
FRequireDeptId_FNumber	需求部门	string	基础资料
FRequireStaffId_FNumber	需求人	string	基础资料
FReceiveOrgId_FNumber	收料组织	string	组织
FBranchId_FNumber	收货门店	string	基础资料
FReceiveDeptId_FNumber	收料部门	string	基础资料
FEntrySettleOrgId_FNumber	结算组织	string	组织
FGiveAway	是否赠品	string	复选框
FEntryNote	备注	string	多行文本
FSupMatId	供应商物料编码	string	文本
FSupMatName	供应商物料名称	string	文本
FLot_FNumber	批号	string	批次
FSupplierLot	供应商批号	string	文本
FReceiveQty	累计收料数量	string	数量
FRemainReceiveQty	剩余收料数量	string	数量
FStockInQty	累计入库数量	string	数量
FRemainStockINQty	剩余入库数量	string	数量
FMrbQty	累计退料数量	string	数量
FCHECKRETQTY	收料可退数量	string	数量
FSTOCKRETQTY	库存可退数量	string	数量
FConsumeSumQty	消耗汇总数量	string	数量
FSrcBillTypeId	源单类型	string	源单类型
FSrcBillNo	源单编号	string	源单编号
FAuxPropId	销售渠道	string	文本
FMtoNo	计划跟踪号	string	文本
FDEMANDTYPE	需求来源	string	下拉列表
FDEMANDBILLNO	需求单据编号	string	文本
FDEMANDBILLENTRYSEQ	需求单据行号	string	整数
FDEMANDBILLENTRYID	需求单据分录内码	string	整数
FID	FID	string
F_ORA_FSTOCK	对接仓库	string

奇门WMS-A接口明细

• API：entryorder.create

• NAME：入库单创建

• METHOD：POST

请求参数

接口字段	字段名称	预设值	描述
entryOrder	入库单信息
entryOrder.entryOrderCode	入库单号	{{FBillNo}}
entryOrder.ownerCode	货主编码	GZ202206111
entryOrder.purchaseOrderCode	采购单号	{{FBillNo}}	当orderType=CGRK时使用
entryOrder.warehouseCode	入库仓库编码	{{F_ORA_FSTOCK}}	统仓统配等无需ERP指定仓储编码的情况填OTHER
entryOrder.orderCreateTime	订单创建时间	{{FDate}}	YYYY-MM-DD HH:MM:SS
entryOrder.orderType	业务类型	CGRK	SCRK=生产入库;LYRK=领用入库;CCRK=残次品入库;CGRK=采购入库;DBRK=调拨入库;QTRK=其他入库;B2BRK=B2B入 库;XNRK=虚拟入库;只传英文编码
entryOrder.orderLines	入库单详情	details_list
entryOrder.orderLines.orderLine	orderLine
entryOrder.orderLines.orderLine.outBizCode	外部业务编码		消息ID;用于去重;当单据需要分批次发送时使用
entryOrder.orderLines.orderLine.orderLineNo	入库单的行号	{{details_list.FPOOrderEntry_FEntryId}}
entryOrder.orderLines.orderLine.ownerCode	货主编码	GZ202206111
entryOrder.orderLines.orderLine.itemCode	商品编码	{{details_list.FMaterialId_FNumber}}
entryOrder.orderLines.orderLine.itemId	仓储系统商品ID
entryOrder.orderLines.orderLine.itemName	商品名称
entryOrder.orderLines.orderLine.planQty	应收商品数量	{{details_list.FQty}}
entryOrder.orderLines.orderLine.skuProperty	商品属性
entryOrder.orderLines.orderLine.purchasePrice	采购价	{{details_list.FTaxPrice}}
entryOrder.orderLines.orderLine.retailPrice	零售价
entryOrder.orderLines.orderLine.inventoryType	库存类型	ZP	ZP=正品;CC=残次;JS=机损;XS=箱损;默认为ZP
entryOrder.orderLines.orderLine.productDate	商品生产日期		YYYY-MM-DD
entryOrder.orderLines.orderLine.expireDate	商品过期日期		YYYY-MM-DD
entryOrder.orderLines.orderLine.produceCode	生产批号
entryOrder.orderLines.orderLine.batchCode	批次编码
entryOrder.orderLines.orderLine.unit	单位

系统数据集成价值

异构系统都具有非常丰富的业务流程、复杂的系统架构和服务接口。在很多情况下，这两个系统都是分别独立部署和运行的，各自拥有不同的技术栈和编程模型，甚至两者在系统平台、技术平台和编程语言上是完全异构的。采用“轻易云集成方案”的解决方案，可以满足客户的实际业务需求，推动软件工程的规范化，使开发人员遵循统一的概要设计开发实现，降低系统实现的风险，做到系统设计资料的规范性与全面性，以利于系统的实现、测试、维护、版本升级等。通过轻易云系统集成平台完美结合：打破企业内部数据孤岛，无需繁琐的处理工序，与数据集成服务完美结合，让数据真正通起来。 资源互补：汇集各种行业解决方案，资源互补，企业管理融合提升。