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

来源系统:金蝶云星空

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

集成系统:奇门WMS-A

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

接口方案配置

异构系统具有非常丰富的业务流程、复杂的系统架构和服务接口。在很多情况下，这两个系统都是分别独立部署和运行的，各自拥有不同的技术栈和编程模型，甚至两者在系统平台、技术平台和编程语言上是完全异构的。那么对接就需要根据接口配置对应的规则，例如取数就要根据查询接口获取金蝶云星空的数据，并且根据对应的条件进行取数，目标系统就必须根据目标系统的格式，以及获取的数据进行加工处理后进行写入到奇门WMS-A中。轻易云集成平台的可视化配置轻松实现。

金蝶云星空接口明细

API：executeBillQuery
NAME：退料申请查询
METHOD：POST

请求参数

接口字段名称预设值 FBillNo单据编号FBillNo FEntity_FEntryIDFEntity_FEntryIDFEntity_FEntryID FIDFIDFID FDocumentStatus单据状态FDocumentStatus FBillTypeID_Fnumber单据类型FBillTypeID.Fnumber FDate申请日期FDate FPURCHASEORGID_Fnumber采购组织FPURCHASEORGID.Fnumber FAPPORGID_Fnumber申请组织FAPPORGID.Fnumber FAPPDEPTID_Fnumber申请部门FAPPDEPTID.Fnumber FRMLOC退料地点FRMLOC FSUPPLIERID_Fnumber供应商FSUPPLIERID.Fnumber FRMMODE退料方式FRMMODE FREPLENISHMODE补料方式FREPLENISHMODE FCreatorId创建人FCreatorId FCreateDate创建日期FCreateDate FModifierId最后修改人FModifierId FModifyDate最后修改日期FModifyDate FAPPROVERID审核人FAPPROVERID FAPPROVEDATE审核日期FAPPROVEDATE FCANCELLERID作废人FCANCELLERID FCANCELDATE作废日期FCANCELDATE FCANCELSTATUS作废状态FCANCELSTATUS FBusinessType业务类型FBusinessType FRemarks备注FRemarks FRMREASON退料原因FRMREASON FRequireOrgId_Fnumber需求组织FRequireOrgId.Fnumber FCorrespondOrgId_Fnumber对应组织FCorrespondOrgId.Fnumber FConfirmerId确认人FConfirmerId FConfirmDate确认日期FConfirmDate FConfirmStatus确认状态FConfirmStatus FMATERIALID_Fnumber物料编码FMATERIALID.Fnumber FMaterialName物料名称FMaterialName FUOM规格型号FUOM FMaterialType存货类别FMaterialType FMRAPPQTY申请退料数量FMRAPPQTY FREPLENISHQTY补料数量FREPLENISHQTY FKEAPAMTQTY扣款数量FKEAPAMTQTY FMRJOINQTY退料关联数量FMRJOINQTY FMRQTY退料数量FMRQTY FNOTE_M备注FNOTE_M FPRICEQTY_F计价数量FPRICEQTY_F FPRICE_F单价FPRICE_F FPRICECOEFFICIENT_F价格系数FPRICECOEFFICIENT_F FDISCOUNTRATE_F折扣率FDISCOUNTRATE_F FDISCOUNT_F折扣额FDISCOUNT_F FTAXNETPRICE_F净价FTAXNETPRICE_F FAMOUNT_F退料金额FAMOUNT_F FALLAMOUNT_F退料含税金额FALLAMOUNT_F FAPPROVEPRICE_F含税单价FAPPROVEPRICE_F FSRCSEQ源单行号FSRCSEQ FCONTRACTNO合同单号FCONTRACTNO FORDERNO订单单号FORDERNO FREQTRACENO需求跟踪号FREQTRACENO FBASEUNITQTY库存基本数量FBASEUNITQTY FBASEUNITID退料申请基本单位FBASEUNITID FUNITID库存单位FUNITID FPRICEUNITID_F计价单位FPRICEUNITID_F FBASEMRJOINQTY退料关联数量（库存基本）FBASEMRJOINQTY FBASEMRQTY退料数量(基本单位)FBASEMRQTY FAUXPROPID销售渠道FAUXPROPID.Fnumber FSRCBILLNO源单编号FSRCBILLNO FSRCBILLTYPEID源单类型FSRCBILLTYPEID FREPLENISHAMOUNT补料金额FREPLENISHAMOUNT FKEAPAMTAMOUNT扣款金额FKEAPAMTAMOUNT FLot批号FLot FRMREASON_M退料原因FRMREASON_M FBFLowId业务流程FBFLowId FMtoNo计划跟踪号FMtoNo FGiveAway是否赠品FGiveAway FPriceBaseQty计价基本数量FPriceBaseQty FPURUNITID采购单位FPURUNITID FPurQty采购数量FPurQty FPurBaseQty采购基本数量FPurBaseQty FPURBASENUM采购基本分子FPURBASENUM FSTOCKBASEDEN库存基本分母FSTOCKBASEDEN FSRCBIZUNITID携带的主业务单位FSRCBIZUNITID FRETURNSTOCKJNBASEQTY退料关联数量（采购基本）FRETURNSTOCKJNBASEQTY FEntryTaxRate税率%FEntryTaxRate FENTRYPRICELISTID分录价目表FENTRYPRICELISTID FPOORDERENTRYID采购订单分录内码FPOORDERENTRYID FStockId_Fnumber仓库FStockId.Fnumber FISSYNTOTHIRD是否同步管易(GY)FISSYNTOTHIRD FRowType产品类型FRowType FPARENTMATID父项产品FPARENTMATID FPriceDiscount单价折扣FPriceDiscount FSTOCKLOCID仓位FSTOCKLOCID FPriLstEntryId价目表分录idFPriLstEntryId FEntity_Link_FFlowId业务流程图FEntity_Link_FFlowId FEntity_Link_FFlowLineId推进路线FEntity_Link_FFlowLineId FEntity_Link_FRuleId转换规则FEntity_Link_FRuleId FEntity_Link_FSTableId源单表内码FEntity_Link_FSTableId FEntity_Link_FSTableName源单表FEntity_Link_FSTableName FEntity_Link_FSBillId源单内码FEntity_Link_FSBillId FEntity_Link_FSId源单分录内码FEntity_Link_FSId FEntity_Link_FBASEUNITQTYOld原始携带量FEntity_Link_FBASEUNITQTYOld FEntity_Link_FBASEUNITQTY修改携带量FEntity_Link_FBASEUNITQTY FEntity_Link_FPurBaseQtyOld原始携带量FEntity_Link_FPurBaseQtyOld FEntity_Link_FPurBaseQty修改携带量FEntity_Link_FPurBaseQty FEntity_Link_FLnkTrackerId迁移图FEntity_Link_FLnkTrackerId FEntity_Link_FLnkSState上游状态FEntity_Link_FLnkSState FEntity_Link_FLnkAmount数量FLnkFEntity_Link_FLnkAmount FieldKeys需查询的字段key集合 Limit最大行数{{PAGINATION_PAGE_SIZE}} StartRow开始行索引{{PAGINATION_START_ROW}} TopRowCount返回总行数 FilterString过滤条件FApproveDate>='{{LAST_SYNC_TIME dateTime}}' and FDocumentStatus='C' FormId业务对象表单IdPUR_MRAPP

响应参数

接口字段名称预设值 FBillNo单据编号 FEntity_FEntryIDFEntity_FEntryID FIDFID FDocumentStatus单据状态 FBillTypeID_Fnumber单据类型 FDate申请日期 FPURCHASEORGID_Fnumber采购组织 FAPPORGID_Fnumber申请组织 FAPPDEPTID_Fnumber申请部门 FRMLOC退料地点 FSUPPLIERID_Fnumber供应商 FRMMODE退料方式 FREPLENISHMODE补料方式 FCreatorId创建人 FCreateDate创建日期 FModifierId最后修改人 FModifyDate最后修改日期 FAPPROVERID审核人 FAPPROVEDATE审核日期 FCANCELLERID作废人 FCANCELDATE作废日期 FCANCELSTATUS作废状态 FBusinessType业务类型 FRemarks备注 FRMREASON退料原因 FRequireOrgId_Fnumber需求组织 FCorrespondOrgId_Fnumber对应组织 FConfirmerId确认人 FConfirmDate确认日期 FConfirmStatus确认状态 FMATERIALID_Fnumber物料编码 FMaterialName物料名称 FUOM规格型号 FMaterialType存货类别 FMRAPPQTY申请退料数量 FREPLENISHQTY补料数量 FKEAPAMTQTY扣款数量 FMRJOINQTY退料关联数量 FMRQTY退料数量 FNOTE_M备注 FPRICEQTY_F计价数量 FPRICE_F单价 FPRICECOEFFICIENT_F价格系数 FDISCOUNTRATE_F折扣率 FDISCOUNT_F折扣额 FTAXNETPRICE_F净价 FAMOUNT_F退料金额 FALLAMOUNT_F退料含税金额 FAPPROVEPRICE_F含税单价 FSRCSEQ源单行号 FCONTRACTNO合同单号 FORDERNO订单单号 FREQTRACENO需求跟踪号 FBASEUNITQTY库存基本数量 FBASEUNITID退料申请基本单位 FUNITID库存单位 FPRICEUNITID_F计价单位 FBASEMRJOINQTY退料关联数量（库存基本） FBASEMRQTY退料数量(基本单位) FAUXPROPID销售渠道 FSRCBILLNO源单编号 FSRCBILLTYPEID源单类型 FREPLENISHAMOUNT补料金额 FKEAPAMTAMOUNT扣款金额 FLot批号 FRMREASON_M退料原因 FBFLowId业务流程 FMtoNo计划跟踪号 FGiveAway是否赠品 FPriceBaseQty计价基本数量 FPURUNITID采购单位 FPurQty采购数量 FPurBaseQty采购基本数量 FPURBASENUM采购基本分子 FSTOCKBASEDEN库存基本分母 FSRCBIZUNITID携带的主业务单位 FRETURNSTOCKJNBASEQTY退料关联数量（采购基本） FEntryTaxRate税率% FENTRYPRICELISTID分录价目表 FPOORDERENTRYID采购订单分录内码 FStockId_Fnumber仓库 FISSYNTOTHIRD是否同步管易(GY) FRowType产品类型 FPARENTMATID父项产品 FPriceDiscount单价折扣 FSTOCKLOCID仓位 FPriLstEntryId价目表分录id FEntity_Link_FFlowId业务流程图 FEntity_Link_FFlowLineId推进路线 FEntity_Link_FRuleId转换规则 FEntity_Link_FSTableId源单表内码 FEntity_Link_FSTableName源单表 FEntity_Link_FSBillId源单内码 FEntity_Link_FSId源单分录内码 FEntity_Link_FBASEUNITQTYOld原始携带量 FEntity_Link_FBASEUNITQTY修改携带量 FEntity_Link_FPurBaseQtyOld原始携带量 FEntity_Link_FPurBaseQty修改携带量 FEntity_Link_FLnkTrackerId迁移图 FEntity_Link_FLnkSState上游状态 FEntity_Link_FLnkAmount数量FLnk

奇门WMS-A接口明细

API：stockout.create
NAME：出库单创建
METHOD：POST

请求参数

接口字段名称预设值 deliveryOrder出库单信息 deliveryOrder.totalOrderLines单据总行数 deliveryOrder.deliveryOrderCode出库单号{{FBillNo}} deliveryOrder.orderType出库单类型CGTH deliveryOrder.warehouseCode仓库编码{{FStockId_Fnumber}} deliveryOrder.createTime出库单创建时间{{FDate}} deliveryOrder.orderLines单据信息details_list deliveryOrder.orderLines.orderLineorderLine deliveryOrder.orderLines.orderLine.outBizCode外部业务编码 deliveryOrder.orderLines.orderLine.orderLineNo单据行号{{details_list.FEntity_FEntryID}} deliveryOrder.orderLines.orderLine.ownerCode货主编码GZ202206111 deliveryOrder.orderLines.orderLine.itemCode商品编码{{details_list.FMATERIALID_Fnumber}} deliveryOrder.orderLines.orderLine.itemId仓储系统商品编码 deliveryOrder.orderLines.orderLine.inventoryType库存类型 deliveryOrder.orderLines.orderLine.itemName商品名称 deliveryOrder.orderLines.orderLine.planQty应发商品数量{{details_list.FMRAPPQTY}} deliveryOrder.orderLines.orderLine.batchCode批次编码 deliveryOrder.orderLines.orderLine.productDate生产日期 deliveryOrder.orderLines.orderLine.expireDate过期日期 deliveryOrder.orderLines.orderLine.produceCode生产批号 deliveryOrder.orderLines.orderLine.platformCode交易平台商品编码 deliveryOrder.orderLines.orderLine.unit单位 deliveryOrder.orderLines.orderLine.extendProps扩展属性 deliveryOrder.orderLines.extendProps扩展属性

系统打通概况

从API服务总线层面解决企业烟囱式业务系统集成现状相互连接企业各业务系统，实现流程端到端打通，复用已有的业务系统能力，让集成架构、服务关系更清晰使用统一的API管理平台，对API进行显性化、可视化，使所有API服务成为企业的数字资产，提升API利用率，发挥业务系统价值，实现企业IT资产的可插拔、可复用、可组成。

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