金蝶云星空对接打通旺店通·旗舰奇门收料通知单查询接口与新增采购订单接口

数据源平台:金蝶云星空

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

接通系统：旺店通·旗舰奇门

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

数据接口配置

使用系统数据集成平台对应的模块：数据集成方案。然后选择开始创建数据集成方案。在方案配置表单中选择对应的源业务系统：金蝶云星空，然后选择对应的连接器。选择对应的收料通知单查询作为数据对接来源。然后再通过写入目标平台配置目标系统为旺店通·旗舰奇门,并且选择对应连接器（关于旺店通·旗舰奇门的接口如何配置可以在轻易云数据集成社区论坛中找到相关信息,选择好对应的新增采购订单接口作为数据写入动作，既可以完成第一步的数据对接配置。

金蝶云星空接口明细

API：executeBillQuery
NAME：收料通知单查询
METHOD：POST

请求参数

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

响应参数

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

旺店通·旗舰奇门接口明细

调用接口：wdt.purchase.purchaseorder.createorder
接口名称：新增采购订单
方法：POST

请求参数

字段字段名称类型配置值 purchase_no采购单编号string{{FBillNo}} provider_no供应商编号string{{FSupplierId}} receive_warehouse_nos收货仓编号string{{FStockID}} expect_warehouse_no预计入库仓库编号string{{FStockID}} purchaser_name采购员string管理员 is_check是否要审核string apply_nos引用的采购申请单编号string receive_address收货地址string contact联系人string1 telno电话string logistics_name物流名称string flag_name标记名称string expect_time预计到货时间string created创建时间string pay_type付款方式string1 postfee_pay_type运费支付方式string1 remark备注string post_fee邮费string other_fee其他费用string purchase_details采购单详情arraydetails purchase_details.spec_no商家编码string{{details.FMaterialId}} purchase_details.num采购数量string{{details.FActReceiveQty}} purchase_details.purchase_unit_name采购单位string purchase_details.remark备注string purchase_details.prop1自定义属性1string purchase_details.prop2自定义属性2string purchase_details.price税前单价string{{details.FPrice}} purchase_details.discount折扣string0.0000 purchase_details.tax_rate税率string0.1300 purchase_details.tax_price税后单价string purchase_details.prop1采购单自定义属性1string purchase_details.prop2采购单自定义属性2string purchase_details.objectKey数据对象stringparams

数据对接价值

当企业规模逐渐增大时，作为支撑业务运营的IT建设也变得越来越重要，不过往往企业的IT建设过程中会发现某一家软件供应商基本不能完全覆盖企业所有的业务运营流程，这样的结果就是，企业上的IT系统很多很全，从ERP到HR、CRM、PDM、OA等，貌似所有的业务都覆盖到了，但实际上因为这些系统的不集成，而形成了企业很多新的信息孤岛，非常不利于企业的后续的管理和战略发展。从现今和往后的发展趋势来看，也不可避免会遇到上述问题，毕竟企业经营的多样化，并不是所有的业务都能在一个系统中完成，所以我们必须在产品架构上支持更好的与外部系统进行协同。通过轻易云集成平台统一的API管理平台，对API进行显性化、可视化，使所有API服务成为企业的数字资产，提升API利用率，发挥业务系统价值，实现企业IT资产的可插拔、可复用、可组成。

金蝶云星空对接打通旺店通·旗舰奇门收料通知单查询接口与新增采购订单接口