金蝶云星空和奇门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_FEntryIdidstring 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整数 FIDFIDstring 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业务对象表单Idstring必须填写金蝶的表单ID如😛UR_PurchaseOrder

响应参数

奇门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业务类型CGRKSCRK=生产入库;LYRK=领用入库;CCRK=残次品入库;CGRK=采购入库;DBRK=调拨入库;QTRK=其他入库;B2BRK=B2B入库;XNRK=虚拟入库;只传英文编码 entryOrder.orderLines入库单详情details_list entryOrder.orderLines.orderLineorderLine 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库存类型ZPZP=正品;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单位

系统数据集成价值

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

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