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

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

对接系统金蝶云星空

金蝶K/3Cloud（金蝶云星空）是移动互联网时代的新型ERP，是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”，旨在帮助企业打造面向新时代的生态互联与协同平台，围绕生态中的每个角色，提供随手可得的云服务，最终实现敏捷协同，智慧运营的企业运营新境界。整个产品采用SOA架构，完全基于BOS平台组建而成，业务架构上贯穿流程驱动与角色驱动思想，结合中国管理模式与中国管理实践积累，精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建，支持跨数据库应用，支持本地部署、私有云部署与公有云部署三种部署方式，同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业，其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。

集成系统:旺店通·企业奇门

旺店通是北京掌上先机网络科技有限公司旗下品牌，国内的零售云服务提供商，基于云计算SaaS服务模式，以体系化解决方案，助力零售企业数字化智能化管理升级。为零售电商企业的订单管理及仓储管理提供解决方案，致力于帮助企业实现数字化转型，企业规模化发展

配置集成方案

在轻易云平台进行集成方案的配置时，为了实现快速搭建，轻易云平台还提供了现有的市场方案进行复制参考。用户可以在创建集成方案的时候在第四步选择引用市场方案，参考市场主流所进行的字段配置完成集成方案的自定义化快速配置，即便是第一次使用轻易云平台的用户也能轻松搭建属于自己的数据同步方案。向导式配置，让配置更加清晰，首先确定该方方案的对接内容，第二歩获取筛选数据源平台的数据，第三步数据源与写入目标形成映射关系配置。完成配置后一键启用

金蝶云星空接口明细

• 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 F_QKZI_CheckBox是否线上云仓FStockId.F_QKZI_CheckBox Limit最大行数{{PAGINATION_PAGE_SIZE}}金蝶的查询分页参数 StartRow开始行索引{{PAGINATION_START_ROW}}金蝶的查询分页参数 TopRowCount返回总行数金蝶的查询分页参数 FilterString过滤条件FApproveDate>='{{LAST_SYNC_TIME dateTime}}' and FStockId.F_QKZI_CheckBox=1示例写法 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行标识 F_QKZI_CheckBox是否线上云仓

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

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

请求参数

字段名称类型描述 api_outer_no接口外部单号string调用本接口时推送的唯一单据编号，避免重复推送数据 warehouse_no仓库编号string代表仓库所有属性的唯一编码，用于仓库区分，ERP内支持自定义（ERP仓库界面设置）；本接口仓库编号对应的仓库类型必须为委外仓类型。【例如： 3京东仓储 4科捷 5百世物流 6 SKU360 7通天晓 8中联网仓 9顺丰仓储 10网仓2号 11奇门仓储 12旺店通仓储 13心怡仓储 14力威仓储 15京东沧海 16云集仓储 ）】 order_type出入类型string可选值：1(出库)；2（入库） logistics_fee邮资string物流或者快递运输货物产生的费用，默认为0 other_fee其他费用string其他费用，默认为0 province省string省份名称，直辖市注意输入值为“北京”不是“北京市”，“北京市”在city参数内输入 city市string市名称 district县（区）string区县名称 address详细地址string地址详情描述 ，例如 xx街道XX小区xx号楼xx单元401 contact联系人string联系人姓名 mobile手机号string手机号码 telno固话string固定电话号码 auto_check自动审核string1.自动审核 0.不自动审核 默认1 goods_list货品明细节点array入库单货品列表节点 goods_list.spec_no商家编码stringERP内单品唯一编码（SKU），代表单品(SKU)所有属性，并且为库存量出入计算最小单元。SKU概念介绍,单击这里， goods_list.num入库数量string入库数量 goods_list.position_no货位编号string商品在仓库内的位置编号,不传此参数，读ERP配置【入库开单货位优先级配置】，来决定取默认货位、上一次入库货位、ZANCUN货位其中一个货位。 goods_list.price价格string委外出入库货品价格 goods_list.batch_no批次string货品批次编号（需要传客户端中存在的批次编号） goods_list.remark备注string货品明细备注 goods_list.stockin_info委外出入库单列表节点string

系统打通概况

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