从金蝶云星空到奇门WMS-A通过接口配置打通数据

对接系统金蝶云星空

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

接入系统：奇门WMS-A

用于菜鸟的仓库（使用其他支持奇门的仓库同理），故而希望能和仓库的wms系统打通，这样我们采购收货，采购入库，销售出库，采购退货，销售退货等多个场景就能和我们的中台（erp）进行数据同步。

数据接口配置方案

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

金蝶云星空接口明细

API：executeBillQuery
NAME：采购退料查询
METHOD：POST

请求参数

接口字段字段名称预设值描述 FPURMRBENTRY_FEntryID明细信息IDFPURMRBENTRY_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第三方单据IDFTHIRDBILLID FTHIRDBILLNO第三方单据编号FTHIRDBILLNO FMATERIALID_FNumber物料编码FMATERIALID.FNumber 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 FStockId_FNumber仓位FStockId.FNumber 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 FDocumentStatus = 'C'示例写法 FSupplierId.FNumber = 'VEN00010' and FApproveDate>= FieldKeys需查询的字段key集合金蝶分录主键ID格式：FPOOrderEntry_FEntryId,其它格式 FPurchaseOrgId.FNumber FormId业务对象表单IdPUR_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物料编码 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零售条形码

奇门WMS-A接口明细

调用接口：stockout.create
接口名称：发货单创建
方法：POST

请求参数

字段字段名称类型配置值 deliveryOrder出库单信息object deliveryOrder.totalOrderLines单据总行数string deliveryOrder.deliveryOrderCode出库单号string{{FBillNo}}-{{FSTOCKID_FNumber}} deliveryOrder.warehouseCode仓库编码string{{FSTOCKID_FNumber}} deliveryOrder.createTime出库单创建时间string{{FDate}} deliveryOrder.orderType出库单类型stringCGTH deliveryOrder.remark备注string金蝶采购退料对接-{{FBillNo}}-{{FDate}} deliveryOrder.orderLines单据信息arraydetails_list deliveryOrder.orderLines.orderLineorderLinearray deliveryOrder.orderLines.orderLine.outBizCode外部业务编码string{{FBillNo}}-{{FSTOCKID_FNumber}} deliveryOrder.orderLines.orderLine.orderLineNo单据行号string{{details_list.FPURMRBENTRY_FEntryID}} deliveryOrder.orderLines.orderLine.ownerCode货主编码stringGZ202206111 deliveryOrder.orderLines.orderLine.itemCode商品编码string{{details_list.FMATERIALID_FNumber}} deliveryOrder.orderLines.orderLine.itemId仓储系统商品编码string deliveryOrder.orderLines.orderLine.inventoryType库存类型stringZP deliveryOrder.orderLines.orderLine.itemName商品名称string deliveryOrder.orderLines.orderLine.planQty应发商品数量string{{details_list.FRMREALQTY}} deliveryOrder.orderLines.orderLine.batchCode批次编码string{{details_list.FLot_FNumber}} deliveryOrder.orderLines.orderLine.productDate生产日期string{{details_list.FProduceDate}} deliveryOrder.orderLines.orderLine.expireDate过期日期string{{details_list.FEXPIRYDATE}} deliveryOrder.orderLines.orderLine.produceCode生产批号string deliveryOrder.orderLines.orderLine.platformCode交易平台商品编码string deliveryOrder.orderLines.orderLine.unit单位string deliveryOrder.orderLines.orderLine.extendProps扩展属性string deliveryOrder.orderLines.extendProps扩展属性string

系统打通概况

从API层面解决企业烟囱式业务系统集成现状,实现深度的业务流程拉通金蝶云星空到奇门WMS-A之间数据集成；通过API连接各业务系统，复用已有的业务系统能力，让集成架构、服务关系更清晰。使用统一的API管理平台，对API进行显性化、可视化，使所有API服务成为企业的数字资产，提升复用率和价值。全面管控企业的API资产，梳理现有业务系统的API。实现API文档的统一管理，建立API的上线、下线、监控的统一管理体系及标准规范。已链接和打通主流SaaS系统超过100+，快速对接各种API接口，实现云上云下的互联互通。将SaaS和本地业务系统联接起来，打破时间与空间界限，打通原有核心数据及SaaS应用，构建可平滑演进的企业IT架构。

从金蝶云星空到奇门WMS-A通过接口配置打通数据