旺店通·旗舰奇门与金蝶云星空对接集成逐个单据查询连通新增采购订单(01-KW-采购订单同步)

接入系统:金蝶云星空
金蝶K/3Cloud(金蝶云星空)是移动互联网时代的新型ERP,是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”,旨在帮助企业打造面向新时代的生态互联与协同平台,围绕生态中的每个角色,提供随手可得的云服务,最终实现敏捷协同,智慧运营的企业运营新境界。整个产品采用SOA架构,完全基于BOS平台组建而成,业务架构上贯穿流程驱动与角色驱动思想,结合中国管理模式与中国管理实践积累,精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建,支持跨数据库应用,支持本地部署、私有云部署与公有云部署三种部署方式,同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业,其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。
接入系统:旺店通·旗舰奇门
慧策最先以旺店通ERP切入商家核心管理痛点——订单管理,之后围绕电商经营管理中的核心管理诉求,先后布局流量获取、会员管理、仓库管理等其他重要经营模块。慧策的产品线从旺店通ERP起步,向前向后延伸,全面布局零售企业经营,整体构建一体化智能零售解决方案,打破数据孤岛,AI植入系统,实现智能决策,助力零售企业智能化转型。当前旗下拥有店+小程序、数智门店POS、旺店通ERP、旺店通WMS、卡米全渠道、客优CRM、云筹大数据等多个PssS、SaaS产品,从前端吸引流量到后端集约化管理,助力企业智慧决策
接口方案配置
集成方案是整个轻易云集成平台的核心,每一个集成方案代表一种业务的对接策略(对接方案借鉴可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息),用户可以根据业务的不同新建多个不同规则的集成方案。比如:采购订单同步,线上销售出库同步,线下销售出库同步。一个集成方案必须要配置源系统:金蝶云星空,源系统 API:逐个单据查询,目标系统:旺店通·旗舰奇门,目标系统 API新增采购订单。在新增集成方案之前需要确定两个系统的连接器都已经配置完成。

金蝶云星空接口明细
- API:executeBillQuery
- NAME:逐个单据查询
- METHOD:POST
请求参数
| 接口字段 | 字段名称 | 预设值 | 描述 |
| FPOOrderEntry_FEntryId | FPOOrderEntry_FEntryId | FPOOrderEntry_FEntryId | |
| FID | FID | FID | |
| FBillNo | 单据编号 | FBillNo | |
| FSourceBillNo | 源单编号 | FSourceBillNo | |
| FBillTypeID_FNumber | 单据类型 | FBillTypeID.FNumber | |
| FBusinessType | 业务类型 | FBusinessType | |
| FSupplierId_FNumber | 供应商 | FSupplierId.FNumber | |
| FPayConditionId_FNumber | 付款条件 | FPayConditionId.FNumber | |
| FDate | 采购日期 | FDate | |
| FDocumentStatus | 单据状态 | FDocumentStatus | |
| FPreMatchAmountFor | 预付已核销金额 | FPreMatchAmountFor | |
| FPayAdvanceBillId_FNumber | 预付单号 | FPayAdvanceBillId.FNumber | |
| FPurchaseOrgId_FNumber | 采购组织 | FPurchaseOrgId.FNumber | |
| FPurchaseDeptId_FNumber | 采购部门 | FPurchaseDeptId.FNumber | |
| FPurchaserGroupId_FNumber | 采购组 | FPurchaserGroupId.FNumber | |
| FPurchaserId_FNumber | 采购员 | FPurchaserId.FNumber | |
| FProviderId_FNumber | 供货方 | FProviderId.FNumber | |
| FSettleId_FNumber | 结算方 | FSettleId.FNumber | |
| FChargeId_FNumber | 收款方 | FChargeId.FNumber | |
| FCorrespondOrgId_FNumber | 对应组织 | FCorrespondOrgId.FNumber | |
| FAssignSupplierId_FNumber | 指定供应商 | FAssignSupplierId.FNumber | |
| FMaterialId_FNumber | 物料编码 | FMaterialId.FNumber | |
| FBarcode | 零售条形码 | FBarcode | |
| FQty | 采购数量 | FQty | |
| FDeliveryDate | 交货日期 | FDeliveryDate | |
| FLocation | 交货地点 | FLocation | |
| FLocationAddress | 交货地址 | FLocationAddress | |
| FPrice | 单价 | FPrice | |
| FTaxPrice | 含税单价 | FTaxPrice | |
| FEntryDiscountRate | 折扣率% | FEntryDiscountRate | |
| FEntryDiscount | 折扣额 | FEntryDiscount | |
| FEntryTaxRate | 税率% | FEntryTaxRate | |
| FEntryTaxAmount | 税额 | FEntryTaxAmount | |
| FAllAmount | 价税合计 | FAllAmount | |
| FEntryAmount | 金额 | FEntryAmount | |
| FRequireOrgId_FNumber | 需求组织 | FRequireOrgId.FNumber | |
| FRequireDeptId_FNumber | 需求部门 | FRequireDeptId.FNumber | |
| FRequireStaffId_FNumber | 需求人 | FRequireStaffId.FNumber | |
| FReceiveOrgId_FNumber | 收料组织 | FReceiveOrgId.FNumber | |
| FBranchId_FNumber | 收货门店 | FBranchId.FNumber | |
| FReceiveDeptId_FNumber | 收料部门 | FReceiveDeptId.FNumber | |
| FEntrySettleOrgId_FNumber | 结算组织 | FEntrySettleOrgId.FNumber | |
| FGiveAway | 是否赠品 | FGiveAway | |
| FEntryNote | 备注 | FEntryNote | |
| FSupMatId | 供应商物料编码 | FSupMatId | |
| FSupMatName | 供应商物料名称 | FSupMatName | |
| FLot | 批号 | FLot | |
| FSupplierLot | 供应商批号 | FSupplierLot | |
| FReceiveQty | 累计收料数量 | FReceiveQty | |
| FRemainReceiveQty | 剩余收料数量 | FRemainReceiveQty | |
| FStockInQty | 累计入库数量 | FStockInQty | |
| FRemainStockINQty | 剩余入库数量 | FRemainStockINQty | |
| FMrbQty | 累计退料数量 | FMrbQty | |
| FCHECKRETQTY | 收料可退数量 | FCHECKRETQTY | |
| FSTOCKRETQTY | 库存可退数量 | FSTOCKRETQTY | |
| FConsumeSumQty | 消耗汇总数量 | FConsumeSumQty | |
| FSrcBillTypeId | 源单类型 | FSrcBillTypeId | |
| FSrcBillNo | 源单编号 | FSrcBillNo | |
| FReqTraceNo | 需求跟踪号 | FReqTraceNo | |
| FMtoNo | 计划跟踪号 | FMtoNo | |
| FDEMANDTYPE | 需求来源 | FDEMANDTYPE | |
| FDEMANDBILLNO | 需求单据编号 | FDEMANDBILLNO | |
| FDEMANDBILLENTRYSEQ | 需求单据行号 | FDEMANDBILLENTRYSEQ | |
| FDEMANDBILLENTRYID | 需求单据分录内码 | FDEMANDBILLENTRYID | |
| F_TPRO_LargeText | 备注 | F_TPRO_LargeText | |
| FProviderAddress | 交货地址 | FProviderAddress | |
| FProviderContactId_FName | 联系人 | FProviderContactId.FName | |
| FSettleModeId_FName | 付款方式 | FSettleModeId.FName | |
| F_TPRO_Base2_FNumber | 收货仓库 | F_TPRO_Base2.FNumber | |
| F_UEQV_Remarks | 订单备注 | F_UEQV_Remarks | |
| Limit | 最大行数 | {{PAGINATION_PAGE_SIZE}} | |
| StartRow | 开始行索引 | {{PAGINATION_START_ROW}} | |
| TopRowCount | 返回总行数 | | |
| FilterString | 过滤条件 | FApproveDate>='{{LAST_SYNC_TIME datetime}}' and FDocumentStatus = 'C' and FPurchaseOrgId.FNumber = '100' | |
| FieldKeys | 需查询的字段key集合 | | |
| FormId | 业务对象表单Id | PUR_PurchaseOrder | |
响应参数
| 接口字段 | 字段名称 | 预设值 | 描述 |
| FPOOrderEntry_FEntryId | FPOOrderEntry_FEntryId | | |
| FID | FID | | |
| FBillNo | 单据编号 | | |
| FSourceBillNo | 源单编号 | | |
| FBillTypeID_FNumber | 单据类型 | | |
| FBusinessType | 业务类型 | | |
| FSupplierId_FNumber | 供应商 | | |
| FPayConditionId_FNumber | 付款条件 | | |
| FDate | 采购日期 | | |
| FDocumentStatus | 单据状态 | 4 | |
| FPreMatchAmountFor | 预付已核销金额 | | |
| FPayAdvanceBillId_FNumber | 预付单号 | | |
| FPurchaseOrgId_FNumber | 采购组织 | 100 | |
| FPurchaseDeptId_FNumber | 采购部门 | | |
| FPurchaserGroupId_FNumber | 采购组 | | |
| FPurchaserId_FNumber | 采购员 | | |
| FProviderId_FNumber | 供货方 | | |
| FSettleId_FNumber | 结算方 | | |
| FChargeId_FNumber | 收款方 | | |
| FCorrespondOrgId_FNumber | 对应组织 | | |
| FAssignSupplierId_FNumber | 指定供应商 | | |
| FMaterialId_FNumber | 物料编码 | | |
| FBarcode | 零售条形码 | | |
| FQty | 采购数量 | | |
| FDeliveryDate | 交货日期 | | |
| FLocation | 交货地点 | | |
| FLocationAddress | 交货地址 | | |
| FPrice | 单价 | | |
| FTaxPrice | 含税单价 | | |
| FEntryDiscountRate | 折扣率% | | |
| FEntryDiscount | 折扣额 | | |
| FEntryTaxRate | 税率% | | |
| FEntryTaxAmount | 税额 | | |
| FAllAmount | 价税合计 | | |
| FEntryAmount | 金额 | | |
| FRequireOrgId_FNumber | 需求组织 | 100 | |
| FRequireDeptId_FNumber | 需求部门 | | |
| FRequireStaffId_FNumber | 需求人 | | |
| FReceiveOrgId_FNumber | 收料组织 | 100 | |
| FBranchId_FNumber | 收货门店 | | |
| FReceiveDeptId_FNumber | 收料部门 | | |
| FEntrySettleOrgId_FNumber | 结算组织 | 100 | |
| FGiveAway | 是否赠品 | | |
| FEntryNote | 备注 | | |
| FSupMatId | 供应商物料编码 | | |
| FSupMatName | 供应商物料名称 | | |
| FLot | 批号 | | |
| FSupplierLot | 供应商批号 | | |
| FReceiveQty | 累计收料数量 | | |
| FRemainReceiveQty | 剩余收料数量 | | |
| FStockInQty | 累计入库数量 | | |
| FRemainStockINQty | 剩余入库数量 | | |
| FMrbQty | 累计退料数量 | | |
| FCHECKRETQTY | 收料可退数量 | | |
| FSTOCKRETQTY | 库存可退数量 | | |
| FConsumeSumQty | 消耗汇总数量 | | |
| FSrcBillTypeId | 源单类型 | | |
| FSrcBillNo | 源单编号 | | |
| FReqTraceNo | 需求跟踪号 | | |
| FMtoNo | 计划跟踪号 | | |
| FDEMANDTYPE | 需求来源 | | |
| FDEMANDBILLNO | 需求单据编号 | | |
| FDEMANDBILLENTRYSEQ | 需求单据行号 | | |
| FDEMANDBILLENTRYID | 需求单据分录内码 | | |
| F_TPRO_LargeText | 备注 | | |
| FProviderAddress | 交货地址 | | |
| FProviderContactId_FName | 联系人 | | |
| FSettleModeId_FName | 付款方式 | | |
| F_TPRO_Base2_FNumber | 收货仓库 | | |
| F_UEQV_Remarks | 订单备注 | | |
旺店通·旗舰奇门接口明细
- 调用接口:wdt.purchase.purchaseorder.createorder
- 接口名称:新增采购订单
- 方法:POST
请求参数
| 字段 | 字段名称 | 类型 | 配置值 |
| purchase_no | 采购单编号 | string | {{FBillNo}} |
| provider_no | 供应商编号 | string | {{FSupplierId_FNumber}} |
| remark | 备注 | string | {{F_UEQV_Remarks}} |
| receive_warehouse_nos | 收货仓编号 | string | {{F_TPRO_Base2_FNumber}} |
| expect_warehouse_no | 预计入库仓库编号 | string | {{F_TPRO_Base2_FNumber}} |
| prop1 | 采购单自定义属性1 | string | {{FPurchaserId_FNumber}} |
| prop2 | 采购单自定义属性2 | string | |
| purchaser_name | 采购员 | string | 金蝶云实施测试账户 |
| is_check | 是否要审核 | string | true |
| receive_address | 收货地址 | string | {{FProviderAddress}} |
| contact | 联系人 | string | {{FProviderContactId_FName}} |
| telno | 电话 | string | |
| logistics_name | 物流名称 | string | |
| flag_name | 标记名称 | string | |
| expect_time | 预计到货时间 | string | {{FDeliveryDate datetime}} |
| created | 创建时间 | string | |
| pay_type | 付款方式 | string | 1 |
| postfee_pay_type | 运费支付方式 | string | 1 |
| post_fee | 邮费 | string | |
| other_fee | 其他费用 | string | |
| purchase_details | 采购单详情 | array | POOrderEntry |
| purchase_details.spec_no | 商家编码 | string | {{POOrderEntry.FMaterialId_FNumber}} |
| purchase_details.num | 采购数量 | string | {{POOrderEntry.FQty}} |
| purchase_details.purchase_unit_name | 采购单位 | string | |
| purchase_details.price | 税前单价 | string | {{POOrderEntry.FPrice}} |
| purchase_details.discount | 折扣 | string | |
| purchase_details.tax_rate | 税率 | string | |
| purchase_details.objectKey | 数据对象 | string | params |
数据对接价值
通过数据集成平台可视化的快速配置调用接口打通金蝶云星空与旺店通·旗舰奇门之间的数据接口,使得两个系统之间的对接更加快捷、稳定。轻易云数据集成平台打破信息孤岛、适配多种场景、降低运营成本、缩短开发周期、灵活调度配置是这种多系统数据打通时的特性优势。采用元数据模型驱动的低代码集成工具,基于系统预置的数据模型、映射、编排、日志、脚本等集成核心引擎,通过可视化配置,快速实现客户灵活多变的动态集成需求,让集成开发简单、执行过程可靠、问题风险可控。

