金蝶云星空和旺店通·企业奇门接口打通对接实战

金蝶云星空和旺店通·企业奇门接口打通对接实战

接入系统：金蝶云星空

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

目标系统:旺店通·企业奇门

慧策（原旺店通）是一家技术驱动型智能零售服务商，基于云计算PaaS、SaaS模式，以一体化智能零售解决方案，帮助零售企业数字化智能化升级，实现企业规模化发展。

数据接口配置方案

系统对接前期需要通过调研公司的业务，规划出最便捷，效率最高的整体流程。通过流程我们需要建立对应的方案来吧这些流程一一的落地，轻易云集成平台开箱即用的、可视化拖、拉、拽实现接口服务编排与聚合。只需要根据指引设定好对应的参数即可启动使用。设定好源平台：金蝶云星空的接口参数设置，以及设定好目标平台：旺店通·企业奇门的映射，即可启动方案进行测试

金蝶云星空接口明细

• 调用接口：executeBillQuery
• 接口名称：采购入库查询
• 方法：POST

请求参数

字段字段名称类型配置值 FInStockEntry_FEntryIdidstringFInStockEntry_FEntryId FID实体主键stringFID FBillNo单据编号stringFBillNo FDocumentStatus单据状态stringFDocumentStatus FStockOrgId_FNumber收料组织stringFStockOrgId.FNumber FDate入库日期stringFDate FBillTypeID_FNumber单据类型stringFBillTypeID.FNumber FOwnerTypeIdHead货主类型stringFOwnerTypeIdHead FOwnerIdHead_FNumber货主stringFOwnerIdHead.FNumber FDemandOrgId_FNumber需求组织stringFDemandOrgId.FNumber FPurchaseOrgId_FNumber采购组织stringFPurchaseOrgId.FNumber FSupplierId_FNumber供应商stringFSupplierId.FNumber FStockerGroupId_FNumber库存组stringFStockerGroupId.FNumber FStockDeptId_FNumber收料部门stringFStockDeptId.FNumber FCreateDate创建日期stringFCreateDate FCancelDate作废日期stringFCancelDate FDeliveryBill送货单号stringFDeliveryBill FTakeDeliveryBill提货单号stringFTakeDeliveryBill FApproveDate审核日期stringFApproveDate FCancelStatus作废状态stringFCancelStatus FSupplyId_FNumber供货方stringFSupplyId.FNumber FSettleId_FNumber结算方stringFSettleId.FNumber FChargeId_FNumber收款方stringFChargeId.FNumber FBusinessType业务类型stringFBusinessType FSupplyAddress供货方地址stringFSupplyAddress FAPSTATUS应付状态stringFAPSTATUS FTransferBizType跨组织业务类型stringFTransferBizType FDisassemblyFlag拆单新单标识stringFDisassemblyFlag FConfirmDate确认日期stringFConfirmDate FConfirmStatus确认状态stringFConfirmStatus FSplitBillType拆单类型stringFSplitBillType FPayOrgId_FNumber付款组织stringFPayOrgId.FNumber FSettleOrgId_FNumber结算组织stringFSettleOrgId.FNumber FSettleCurrId_FNumber结算币别stringFSettleCurrId.FNumber FBillCost整单费用stringFBillCost FBillTaxAmount税额stringFBillTaxAmount FBillCostAmount总成本stringFBillCostAmount FBillAllAmount价税合计stringFBillAllAmount FSettleTypeId结算方式stringFSettleTypeId FExchangeRate汇率stringFExchangeRate FLocalCurrId_FNumber本位币stringFLocalCurrId.FNumber FBillAmount金额stringFBillAmount FIsIncludedTax含税stringFIsIncludedTax FOwnerCustomerID_FNumber货主客户stringFOwnerCustomerID.FNumber FSettleSupplierID_FNumber结算组织供应商stringFSettleSupplierID.FNumber FISGENFORIOS跨组织结算生成stringFISGENFORIOS FISPRICEEXCLUDETAX价外税stringFISPRICEEXCLUDETAX FISINVOICEARLIER先到票后入库stringFISINVOICEARLIER FMaterialId_FNumber物料编码stringFMaterialId.FNumber FStockId_FNumber仓库stringFStockId.FNumber FProduceDate生产日期stringFProduceDate FNote备注stringFNote FSupplierLot供应商批号stringFSupplierLot FGrossWeight毛重stringFGrossWeight FNetWeight净重stringFNetWeight FContractlNo合同单号stringFContractlNo FReqTraceNo需求跟踪号stringFReqTraceNo FMustQty应收数量stringFMustQty FRealQty实收数量stringFRealQty FSRCRowId源单行内码stringFSRCRowId FExpiryDate有效期至stringFExpiryDate FIsFree免费stringFIsFree FStockStatusId库存状态stringFStockStatusId FBOMIdBOM版本stringFBOMId FTaxPrice含税单价stringFTaxPrice FCostPrice成本价stringFCostPrice FEntryTaxRate税率(%)stringFEntryTaxRate FEntryTaxAmount税额stringFEntryTaxAmount FDiscountRate折扣率(%)stringFDiscountRate FPriceCoefficient价格系数stringFPriceCoefficient FPriceUnitQty计价数量stringFPriceUnitQty FTaxNetPrice净价stringFTaxNetPrice FEntryCostAmount总成本stringFEntryCostAmount FAllAmount价税合计stringFAllAmount FStockFlag入库库存更新标志stringFStockFlag FPOOrderNo订单单号stringFPOOrderNo FEXPUnit保质期单位stringFEXPUnit FExpPeriod保质期stringFExpPeriod FSRCBILLTYPEID源单类型stringFSRCBILLTYPEID FSRCBillNo源单编号stringFSRCBillNo FINVOICEDQTY已开票数量stringFINVOICEDQTY FBaseAPJoinQty关联应付数量（计价基本）stringFBaseAPJoinQty FReceiveStockFlag收货库存更新标志stringFReceiveStockFlag FProcessFee加工费stringFProcessFee FMaterialCosts材料成本stringFMaterialCosts FLot批号stringFLot FPrice单价stringFPrice FAmount金额stringFAmount FDiscount折扣额stringFDiscount FReturnJoinQty退料关联数量stringFReturnJoinQty FBFLowId业务流程stringFBFLowId FGiveAway是否赠品stringFGiveAway FWWInType入库类型stringFWWInType FRowId行标识stringFRowId Limit最大行数string{{PAGINATION_PAGE_SIZE}} StartRow开始行索引string{{PAGINATION_START_ROW}} TopRowCount返回总行数int FilterString过滤条件stringFApproveDate>='{{LAST_SYNC_TIME dateTime}}' FieldKeys需查询的字段key集合array FormId业务对象表单IdstringSTK_InStock

响应参数

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

旺店通·企业奇门接口明细

• 接口：wdt.stockin.order.push
• 接口名称：创建其他入库单
• 接口方法：POST

请求参数

字段名称类型描述 outer_no外部单号string外部系统的唯一单据编号，避免重复推送数据 warehouse_no仓库编号string代表仓库所有属性的唯一编码，用于仓库区分，ERP内支持自定义（ERP仓库界面设置） logistics_code物流编号string代表物流所有属性的唯一编码，用于物流区分，ERP内支持自定义（ERP物流界面设置） logistics_no物流单号string物流公司的运单号，用于追踪物流、快递流转信息（路由）的数字编码 is_check是否审核string1：审核 0：不审核 默认0 is_create_batch是否创建批次string0:否；1:是，默认是0。ERP“批次管理”不存在推送的批次号，是否允许单据创建成功，并创建新的“批次号”。 post_fee邮资string物流或者快递运输货物产生的费用 other_fee其他费用string其他费用 remark备注string其他入库单备注 reason入库原因string入库原因（需要在客户端维护好该原因，如客户端无该原因或者原因停用，则推送失败，路径：设置—>基本设置—>原因列表） goods_list货品明细节点array入库单货品列表节点 goods_list.spec_no商家编码stringERP内单品唯一编码（SKU），代表单品(SKU)所有属性，并且为库存量出入计算最小单元。SKU概念介绍,单击这里 goods_list.stockin_num入库数量string入库数量 goods_list.position_no货位编号string商品在仓库内的位置编号,不传此参数，读ERP配置【入库开单货位优先级配置】，来决定取默认货位、上一次入库货位、ZANCUN货位其中一个货位。 goods_list.batch_no批次string货品批次编号 goods_list.batch_remark批次备注string货品批次备注 goods_list.production_date生产日期string货品生产日期，格式：yyyy-MM-dd HH:mm:ss goods_list.validity_days有效期天数string商品有效期，单位：天 goods_list.src_price原价string上层单据的的货品价格，例如采购单的税前折后单价为采购入库的原价，原价减去入库价得出货品优惠。其他入库没有上层单据，根据业务情况自行传值。无特殊业务建议同入库价一致。 goods_list.stockin_price入库价string入库价格，如推送为0默认取成本价。 goods_list.tax税率string对征税对象的征收比例或征收额度。例如税率为16%，请求时填值为0.16 goods_list.is_enable_sn是否开启序列号string是否开启序列号: 0代表不开启序列号    1代表开启序列号    默认为不开启 goods_list.sn_list序列号列表string序列号列表，多个序列号通过","隔开字符串区分，例如"xxx1,xxx2,xxx3" goods_list.stockin_infostockin_infostring

数据对接价值

通过数据集成平台可视化的快速配置调用接口打通金蝶云星空与旺店通·企业奇门之间的数据接口，使得两个系统之间的对接更加快捷、稳定。轻易云数据集成平台打破信息孤岛、适配多种场景、降低运营成本、缩短开发周期、灵活调度配置是这种多系统数据打通时的特性优势。采用元数据模型驱动的低代码集成工具，基于系统预置的数据模型、映射、编排、日志、脚本等集成核心引擎，通过可视化配置，快速实现客户灵活多变的动态集成需求，让集成开发简单、执行过程可靠、问题风险可控。