金蝶云星空对接打通奇门WMS-A采购入库查询接口与入库单创建接口

接通系统：金蝶云星空

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

对接目标系统:奇门WMS-A

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

数据接口配置方案

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

金蝶云星空接口明细

API：executeBillQuery
NAME：采购入库查询
METHOD：POST

请求参数

接口字段字段名称预设值描述 FInStockEntry_FEntryIdidFInStockEntry_FEntryId FID实体主键FID FBillNo单据编号FBillNo FDocumentStatus单据状态FDocumentStatus FStockOrgId_FNumber收料组织FStockOrgId.FNumber FDate入库日期FDate FBillTypeID_FNumber单据类型FBillTypeID.FNumber FOwnerTypeIdHead货主类型FOwnerTypeIdHead FOwnerIdHead_FNumber货主FOwnerIdHead.FNumber FDemandOrgId_FNumber需求组织FDemandOrgId.FNumber FPurchaseOrgId_FNumber采购组织FPurchaseOrgId.FNumber FSupplierId_FNumber供应商FSupplierId.FNumber FStockerGroupId_FNumber库存组FStockerGroupId.FNumber FStockDeptId_FNumber收料部门FStockDeptId.FNumber FCreateDate创建日期FCreateDate FCancelDate作废日期FCancelDate FDeliveryBill送货单号FDeliveryBill FTakeDeliveryBill提货单号FTakeDeliveryBill FApproveDate审核日期FApproveDate FCancelStatus作废状态FCancelStatus FSupplyId_FNumber供货方FSupplyId.FNumber FSettleId_FNumber结算方FSettleId.FNumber FChargeId_FNumber收款方FChargeId.FNumber FBusinessType业务类型FBusinessType FSupplyAddress供货方地址FSupplyAddress FAPSTATUS应付状态FAPSTATUS FTransferBizType跨组织业务类型FTransferBizType FDisassemblyFlag拆单新单标识FDisassemblyFlag FConfirmDate确认日期FConfirmDate FConfirmStatus确认状态FConfirmStatus FSplitBillType拆单类型FSplitBillType FPayOrgId_FNumber付款组织FPayOrgId.FNumber FSettleOrgId_FNumber结算组织FSettleOrgId.FNumber FSettleCurrId_FNumber结算币别FSettleCurrId.FNumber FBillCost整单费用FBillCost FBillTaxAmount税额FBillTaxAmount FBillCostAmount总成本FBillCostAmount FBillAllAmount价税合计FBillAllAmount FSettleTypeId结算方式FSettleTypeId FExchangeRate汇率FExchangeRate FLocalCurrId_FNumber本位币FLocalCurrId.FNumber FBillAmount金额FBillAmount FIsIncludedTax含税FIsIncludedTax FOwnerCustomerID_FNumber货主客户FOwnerCustomerID.FNumber FSettleSupplierID_FNumber结算组织供应商FSettleSupplierID.FNumber FISGENFORIOS跨组织结算生成FISGENFORIOS FISPRICEEXCLUDETAX价外税FISPRICEEXCLUDETAX FISINVOICEARLIER先到票后入库FISINVOICEARLIER FMaterialId_FNumber物料编码FMaterialId.FNumber FStockId_FNumber仓库FStockId.FNumber FProduceDate生产日期FProduceDate FNote备注FNote FSupplierLot供应商批号FSupplierLot FGrossWeight毛重FGrossWeight FNetWeight净重FNetWeight FContractlNo合同单号FContractlNo FReqTraceNo需求跟踪号FReqTraceNo FMustQty应收数量FMustQty FRealQty实收数量FRealQty FSRCRowId源单行内码FSRCRowId FExpiryDate有效期至FExpiryDate FIsFree免费FIsFree FStockStatusId库存状态FStockStatusId FBOMIdBOM版本FBOMId FTaxPrice含税单价FTaxPrice FCostPrice成本价FCostPrice FEntryTaxRate税率(%)FEntryTaxRate FEntryTaxAmount税额FEntryTaxAmount FDiscountRate折扣率(%)FDiscountRate FPriceCoefficient价格系数FPriceCoefficient FPriceUnitQty计价数量FPriceUnitQty FTaxNetPrice净价FTaxNetPrice FEntryCostAmount总成本FEntryCostAmount FAllAmount价税合计FAllAmount FStockFlag入库库存更新标志FStockFlag FPOOrderNo订单单号FPOOrderNo FEXPUnit保质期单位FEXPUnit FExpPeriod保质期FExpPeriod FSRCBILLTYPEID源单类型FSRCBILLTYPEID FSRCBillNo源单编号FSRCBillNo FINVOICEDQTY已开票数量FINVOICEDQTY FBaseAPJoinQty关联应付数量（计价基本）FBaseAPJoinQty FReceiveStockFlag收货库存更新标志FReceiveStockFlag FProcessFee加工费FProcessFee FMaterialCosts材料成本FMaterialCosts FLot批号FLot.FNumber FPrice单价FPrice FAmount金额FAmount FDiscount折扣额FDiscount FReturnJoinQty退料关联数量FReturnJoinQty FBFLowId业务流程FBFLowId FGiveAway是否赠品FGiveAway FWWInType入库类型FWWInType FRowId行标识FRowId 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业务对象表单IdSTK_InStock必须填写金蝶的表单ID如😛UR_PurchaseOrder

响应参数

接口字段字段名称预设值描述 FInStockEntry_FEntryIdid FID实体主键 FBillNo单据编号 FDocumentStatus单据状态 FStockOrgId_FNumber收料组织 FDate入库日期 FBillTypeID_FNumber单据类型 FOwnerTypeIdHead货主类型 FOwnerIdHead_FNumber货主 FDemandOrgId_FNumber需求组织 FPurchaseOrgId_FNumber采购组织 FSupplierId_FNumber供应商 FStockerGroupId_FNumber库存组 FStockDeptId_FNumber收料部门 FCreateDate创建日期 FCancelDate作废日期 FDeliveryBill送货单号 FTakeDeliveryBill提货单号 FApproveDate审核日期 FCancelStatus作废状态 FSupplyId_FNumber供货方 FSettleId_FNumber结算方 FChargeId_FNumber收款方 FBusinessType业务类型 FSupplyAddress供货方地址 FAPSTATUS应付状态 FTransferBizType跨组织业务类型 FDisassemblyFlag拆单新单标识 FConfirmDate确认日期 FConfirmStatus确认状态 FSplitBillType拆单类型 FPayOrgId_FNumber付款组织 FSettleOrgId_FNumber结算组织 FSettleCurrId_FNumber结算币别 FBillCost整单费用 FBillTaxAmount税额 FBillCostAmount总成本 FBillAllAmount价税合计 FSettleTypeId结算方式 FExchangeRate汇率 FLocalCurrId_FNumber本位币 FBillAmount金额 FIsIncludedTax含税 FOwnerCustomerID_FNumber货主客户 FSettleSupplierID_FNumber结算组织供应商 FISGENFORIOS跨组织结算生成 FISPRICEEXCLUDETAX价外税 FISINVOICEARLIER先到票后入库 FMaterialId_FNumber物料编码 FStockId_FNumber仓库 FProduceDate生产日期 FNote备注 FSupplierLot供应商批号 FGrossWeight毛重 FNetWeight净重 FContractlNo合同单号 FReqTraceNo需求跟踪号 FMustQty应收数量 FRealQty实收数量 FSRCRowId源单行内码 FExpiryDate有效期至 FIsFree免费 FStockStatusId库存状态 FBOMIdBOM版本 FTaxPrice含税单价 FCostPrice成本价 FEntryTaxRate税率(%) FEntryTaxAmount税额 FDiscountRate折扣率(%) FPriceCoefficient价格系数 FPriceUnitQty计价数量 FTaxNetPrice净价 FEntryCostAmount总成本 FAllAmount价税合计 FStockFlag入库库存更新标志 FPOOrderNo订单单号 FEXPUnit保质期单位 FExpPeriod保质期 FSRCBILLTYPEID源单类型 FSRCBillNo源单编号 FINVOICEDQTY已开票数量 FBaseAPJoinQty关联应付数量（计价基本） FReceiveStockFlag收货库存更新标志 FProcessFee加工费 FMaterialCosts材料成本 FLot批号 FPrice单价 FAmount金额 FDiscount折扣额 FReturnJoinQty退料关联数量 FBFLowId业务流程 FGiveAway是否赠品 FWWInType入库类型 FRowId行标识

奇门WMS-A接口明细

API：entryorder.create
NAME：入库单创建
METHOD：POST

请求参数

接口字段字段名称预设值描述 entryOrder入库单信息 entryOrder.entryOrderCode入库单号{{FBillNo}}-{{FStockId_FNumber}} entryOrder.ownerCode货主编码GZ202206111 entryOrder.purchaseOrderCode采购单号{{FBillNo}}当orderType=CGRK时使用 entryOrder.warehouseCode入库仓库编码{{FStockId_FNumber}}统仓统配等无需ERP指定仓储编码的情况填OTHER entryOrder.orderCreateTime订单创建时间{{FDate}}YYYY-MM-DD HH:MM:SS entryOrder.orderType业务类型CGRKSCRK=生产入库;LYRK=领用入库;CCRK=残次品入库;CGRK=采购入库;DBRK=调拨入库;QTRK=其他入库;B2BRK=B2B入库;XNRK=虚拟入库;只传英文编码 entryOrder.remark备注金蝶采购入库对接-{{FBillNo}}-{{FDate}} entryOrder.orderLines入库单详情details_list entryOrder.orderLines.orderLineorderLine entryOrder.orderLines.orderLine.outBizCode外部业务编码{{FBillNo}}-{{FStockId_FNumber}}消息ID;用于去重;当单据需要分批次发送时使用 entryOrder.orderLines.orderLine.orderLineNo入库单的行号{{details_list.FInStockEntry_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.FRealQty}} entryOrder.orderLines.orderLine.skuProperty商品属性 entryOrder.orderLines.orderLine.purchasePrice采购价 entryOrder.orderLines.orderLine.retailPrice零售价 entryOrder.orderLines.orderLine.inventoryType库存类型ZPZP=正品;CC=残次;JS=机损;XS=箱损;默认为ZP entryOrder.orderLines.orderLine.batchCode批次编码{{details_list.FLot}} entryOrder.orderLines.orderLine.productDate商品生产日期{{details_list.FProduceDate}}YYYY-MM-DD entryOrder.orderLines.orderLine.expireDate商品过期日期{{details_list.FExpiryDate}}YYYY-MM-DD entryOrder.orderLines.orderLine.produceCode生产批号 entryOrder.orderLines.orderLine.unit单位

系统数据集成价值

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

金蝶云星空对接打通奇门WMS-A采购入库查询接口与入库单创建接口