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

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

数据源系统:金蝶云星空

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

写入目标:旺店通·企业奇门

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

多系统对接方案配置

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

金蝶云星空接口明细

• 接口：executeBillQuery
• 接口名称：收料通知单查询
• 接口方法：POST

请求参数

字段名称类型描述 FBillNo单据编号String FDocumentStatus单据状态String FMaterialId物料编码String FStockOrgId_FNumber收料组织String FMaterialName物料名称String FDate收料日期String FMateriaModel规格型号String FBillTypeID.fnumber单据类型String FAuxPropId辅助属性String FOwnerTypeIdHead货主类型String FOwnerIdHead货主String FMateriaType物料类别String FActlandQty实到数量String FSupplierId供应商String FActReceiveQty交货数量String FSendBillNo送货单号String FStockID仓库String FLadBillNo提货单号String FStockStatusId库存状态String FCarrierId承运商String FBomIdBOM版本String FReceiveDeptId收料部门String FStockGroupId库存组String FSupplierLot供应商批号String FProduceDate生产日期String FReceiverId收料员String FExpiryDate有效期至String FPurOrgId采购组织String FPurDeptId.fnumber采购部门String FAuxUnitQty库存辅单位数量String FPurGroupId采购组String FDemandDeptId需求部门String FPurchaserId.fnumber采购员String FCtrlStockInPercent控制入库数量String FNote备注String FStockInMaxQty入库上限String FStockInMinQty入库下限String FCreatorId创建人String FInStockJoinQty合格入库关联数量String FCreateDate创建日期String FModifierId最后修改人String FInStockQty入库数量String FIsFree免费String FModifyDate最后修改日期String FPriceUnitQty计价数量String FApproveDate审核日期String FApproverId审核人String FDiscountRate折扣率%String FCancellerId作废人String FTaxNetPrice净价String FCancelDate作废日期String FAmount金额String FCancelStatus作废状态String FEntryTaxRate税率%String FSupplyContact供货方联系人(旧)String FPrice单价String FSettleId结算方String FEntryTaxAmount税额String FSupplyId供货方String FAllAmount价税合计String FReqTraceNo需求跟踪号String FChargeId收款方String FCloseStatus整单关闭状态String FOrderBillNo订单单号String FBusinessType业务类型String FTaxPrice含税单价String FMinPrice价格下限String FNeedCheck需要检验String FDemandOrgId需求组织String FMaxPrice价格上限String FSupplyAddress供货方地址String FDescription备注String FCorrespondOrgId对应组织String FAmount_LC金额(本位币)String FTaxAmount_LC税额(本位币)String FConfirmStatus确认状态String FAllAmount_LC价税合计(本位币)String FConfirmerId确认人String FConfirmDate确认日期String FIsInsideBill外部单据String FProviderContactId供货方联系人String FIsMobile来自移动String FDetailEntity_FEntryIDFDetailEntity_FEntryIDstring FSrcBillNo源单编号（采购订单）string FIDFIDstring FPOORDERENTRYID采购订单分录内码string FTextWWDDH委外订单号string FQtyWWDDSL委外订单数量string Limit最大行数string金蝶的查询分页参数 StartRow开始行索引string金蝶的查询分页参数 TopRowCount返回总行数int金蝶的查询分页参数 FilterString过滤条件string示例写法 FSupplierId.FNumber = 'VEN00010' and FApproveDate>= FieldKeys需查询的字段key集合array金蝶分录主键ID格式：FPOOrderEntry_FEntryId,其它格式 FPurchaseOrgId.FNumber FormId业务对象表单Idstring必须填写金蝶的表单ID如😛UR_PurchaseOrder

响应参数

字段名称类型描述 FBillNo单据编号String FDocumentStatus单据状态String FMaterialId物料编码String FStockOrgId_FNumber收料组织String FMaterialName物料名称String FDate收料日期String FMateriaModel规格型号String FBillTypeID单据类型String FAuxPropId辅助属性String FOwnerTypeIdHead货主类型String FOwnerIdHead货主String FMateriaType物料类别String FActlandQty实到数量String FSupplierId供应商String FActReceiveQty交货数量String FSendBillNo送货单号String FStockID仓库String FLadBillNo提货单号String FStockStatusId库存状态String FCarrierId承运商String FBomIdBOM版本String FReceiveDeptId收料部门String FStockGroupId库存组String FSupplierLot供应商批号String FProduceDate生产日期String FReceiverId收料员String FExpiryDate有效期至String FPurOrgId采购组织String FPurDeptId_fnumber采购部门String FAuxUnitQty库存辅单位数量String FPurGroupId采购组String FDemandDeptId需求部门String FPurchaserId采购员String FCtrlStockInPercent控制入库数量String FNote备注String FStockInMaxQty入库上限String FStockInMinQty入库下限String FCreatorId创建人String FInStockJoinQty合格入库关联数量String FCreateDate创建日期String FModifierId最后修改人String FInStockQty入库数量String FIsFree免费String FModifyDate最后修改日期String FPriceUnitQty计价数量String FApproveDate审核日期String FApproverId审核人String FDiscountRate折扣率%String FCancellerId作废人String FTaxNetPrice净价String FCancelDate作废日期String FAmount金额String FCancelStatus作废状态String FEntryTaxRate税率%String FSupplyContact供货方联系人(旧)String FPrice单价String FSettleId结算方String FEntryTaxAmount税额String FSupplyId供货方String FAllAmount价税合计String FReqTraceNo需求跟踪号String FChargeId收款方String FCloseStatus整单关闭状态String FOrderBillNo订单单号String FBusinessType业务类型String FTaxPrice含税单价String FMinPrice价格下限String FNeedCheck需要检验String FDemandOrgId需求组织String FMaxPrice价格上限String FSupplyAddress供货方地址String FDescription备注String FCorrespondOrgId对应组织String FAmount_LC金额(本位币)String FTaxAmount_LC税额(本位币)String FConfirmStatus确认状态String FAllAmount_LC价税合计(本位币)String FConfirmerId确认人String FConfirmDate确认日期String FIsInsideBill外部单据String FProviderContactId供货方联系人String FIsMobile来自移动String FDetailEntity_FEntryIDFDetailEntity_FEntryIDstring FSrcBillNo源单编号（采购订单）string FIDFIDstring FPOORDERENTRYID采购订单分录内码string FQtyWWDDSL委外订单数量string FTextWWDDH委外订单号string

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

• 接口：wdt.purchase.order.push
• 接口名称：创建采购单
• 接口方法：POST

请求参数

字段名称类型描述 provider_no供应商编号string供应商编号，ERP供应商档案必须存在此编号，否则推送失败 warehouse_no仓库编号string代表仓库所有属性的唯一编码，用于仓库区分，ERP内支持自定义（ERP仓库界面设置），用于创建指定仓库数据信息(不支持一次推送多个仓库编码) outer_noAPI单号stringAPI单号（如果【使用API单号作为系统采购单号】，那么该字段长度不能超过20）保证唯一 contact收货人姓名string收货人姓名 purchase_name采购员string采购员 telno收货人联系电话string收货人联系电话 receive_address收货地址string收货地址 expect_arrive_time预计到货时间string采购单对应货品预计到达仓库时间，时间格式：YYYY-MM-DD HH:MM:SS other_fee其他费用string其他费用 post_fee邮资string邮资 remark备注string采购单备注 details_list采购明细节点array请求参数的2级数据节点，包含采购单所有货品明细信息的数据节点，节点下数据字段详见下述“details_list” details_list.spec_no商家编码string代表单品(sku)所有属性的编码，SKU概念介绍,单击这里 details_list.num采购量string采购量 details_list.price采购价格string采购价格,按采购单位，税前单价 details_list.tax税率string货品的税率，传值范围大于等于0小于等于1 details_list.is_check自动审核string details_list.purchase_info采购列表节点string请求参数的1级数据节点，包含采购单所有属性信息的数据节点，节点下数据字段详见下述“purchase_info”

数据对接效果

全新的API数据集成模式，赋能企业业务创新 传统企业集成主要采用点对点或ESB集成方式，基于全新API战略中台的API新型集成方式通过解耦系统资源，降低系统间对接难度，实现快速业务需求响应，提升对接效率，助力企业满足快速业务交付需求，实现业务创新。通过构建API生态，助力能力开放与共享 基于API战略中台梳理并整合内部API资源与IT资产，可实现内部资源共享，满足内部开发人员资源使用需求，例如：旺店通·企业奇门与金蝶云星空之间数据集成；并将API资源对外可控开放，打造面向开发者的生态服务，为您打通自身和上下游合作伙伴，创造共赢价值链。开展API战略中台，重塑IT 帮助您基于内部资源构建不同业务能力中心，打造企业统一API战略中台，赋能企业发展，实现对业务频繁变化的快速响应。同时您在能力中心基础上构建新业务时，无需从“零”组建各业务模块，提升开发效率，重塑IT组织及交付能力。