从金蝶云星空到旺店通·企业奇门通过接口配置打通数据

源系统:金蝶云星空
金蝶K/3Cloud结合当今先进管理理论和数十万家国内客户最佳应用实践,面向事业部制、多地点、多工厂等运营协同与管控型企业及集团公司,提供一个通用的ERP服务平台。K/3Cloud支持的协同应用包括但不限于:集中/分散销售、集中/分散采购、B2B电商管理、B2C电商中心、供应商协同、多工厂计划、跨工厂领料、跨工厂加工、工厂间调拨、内部交易及结算、集团财务管理、阿米巴经营等。
接入系统:旺店通·企业奇门
慧策最先以旺店通ERP切入商家核心管理痛点——订单管理,之后围绕电商经营管理中的核心管理诉求,先后布局流量获取、会员管理、仓库管理等其他重要经营模块。慧策的产品线从旺店通ERP起步,向前向后延伸,全面布局零售企业经营,整体构建一体化智能零售解决方案,打破数据孤岛,AI植入系统,实现智能决策,助力零售企业智能化转型。当前旗下拥有店+小程序、数智门店POS、旺店通ERP、旺店通WMS、卡米全渠道、客优CRM、云筹大数据等多个PssS、SaaS产品,从前端吸引流量到后端集约化管理,助力企业智慧决策
接口方案配置
集成方案是整个轻易云集成平台的核心,每一个集成方案代表一种业务的对接策略(对接方案借鉴可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息),用户可以根据业务的不同新建多个不同规则的集成方案。比如:采购订单同步,线上销售出库同步,线下销售出库同步。一个集成方案必须要配置源系统:金蝶云星空,源系统 API:采购订单查询,目标系统:旺店通·企业奇门,目标系统 API创建采购单。在新增集成方案之前需要确定两个系统的连接器都已经配置完成。

金蝶云星空接口明细
- 调用接口:executeBillQuery
- 接口名称:采购订单查询
- 方法:POST
请求参数
字段 | 字段名称 | 类型 | 配置值 |
FPOOrderEntry_FEntryId | id | string | FPOOrderEntry_FEntryId |
FBillNo | 单据编号 | string | FBillNo |
FSourceBillNo | 源单编号 | string | FSourceBillNo |
FBillTypeID_FNumber | 单据类型 | string | FBillTypeID.FNumber |
FBusinessType | 业务类型 | string | FBusinessType |
FSupplierId_FNumber | 供应商 | string | FSupplierId.FNumber |
FSettleModeId_FNumber | 结算方式 | string | FSettleModeId.FNumber |
FPayConditionId_FNumber | 付款条件 | string | FPayConditionId.FNumber |
FDate | 采购日期 | string | FDate |
FDocumentStatus | 单据状态 | string | FDocumentStatus |
FPreMatchAmountFor | 预付已核销金额 | string | FPreMatchAmountFor |
FPayAdvanceBillId_FNumber | 预付单号 | string | FPayAdvanceBillId.FNumber |
FPurchaseOrgId_FNumber | 采购组织 | string | FPurchaseOrgId.FNumber |
FPurchaseDeptId_FNumber | 采购部门 | string | FPurchaseDeptId.FNumber |
FPurchaserGroupId_FNumber | 采购组 | string | FPurchaserGroupId.FNumber |
FPurchaserId_FNumber | 采购员 | string | FPurchaserId.FNumber |
FProviderId_FNumber | 供货方 | string | FProviderId.FNumber |
FSettleId_FNumber | 结算方 | string | FSettleId.FNumber |
FChargeId_FNumber | 收款方 | string | FChargeId.FNumber |
FCorrespondOrgId_FNumber | 对应组织 | string | FCorrespondOrgId.FNumber |
FAssignSupplierId_FNumber | 指定供应商 | string | FAssignSupplierId.FNumber |
FMaterialId_FNumber | 物料编码 | string | FMaterialId.FNumber |
FBarcode | 零售条形码 | string | FBarcode |
FQty | 采购数量 | string | FQty |
FDeliveryDate | 交货日期 | string | FDeliveryDate |
FLocation | 交货地点 | string | FLocation |
FLocationAddress | 交货地址 | string | FLocationAddress |
FPrice | 单价 | string | FPrice |
FTaxPrice | 含税单价 | string | FTaxPrice |
FEntryDiscountRate | 折扣率% | string | FEntryDiscountRate |
FEntryDiscount | 折扣额 | string | FEntryDiscount |
FEntryTaxRate | 税率% | string | FEntryTaxRate |
FEntryTaxAmount | 税额 | string | FEntryTaxAmount |
FAllAmount | 价税合计 | string | FAllAmount |
FEntryAmount | 金额 | string | FEntryAmount |
FRequireOrgId_FNumber | 需求组织 | string | FRequireOrgId.FNumber |
FRequireDeptId_FNumber | 需求部门 | string | FRequireDeptId.FNumber |
FRequireStaffId_FNumber | 需求人 | string | FRequireStaffId.FNumber |
FReceiveOrgId_FNumber | 收料组织 | string | FReceiveOrgId.FNumber |
FBranchId_FNumber | 收货门店 | string | FBranchId.FNumber |
FReceiveDeptId_FNumber | 收料部门 | string | FReceiveDeptId.FNumber |
FEntrySettleOrgId_FNumber | 结算组织 | string | FEntrySettleOrgId.FNumber |
FGiveAway | 是否赠品 | string | FGiveAway |
FEntryNote | 备注 | string | FEntryNote |
FSupMatId | 供应商物料编码 | string | FSupMatId |
FSupMatName | 供应商物料名称 | string | FSupMatName |
FLot | 批号 | string | FLot |
FSupplierLot | 供应商批号 | string | FSupplierLot |
FReceiveQty | 累计收料数量 | string | FReceiveQty |
FRemainReceiveQty | 剩余收料数量 | string | FRemainReceiveQty |
FStockInQty | 累计入库数量 | string | FStockInQty |
FRemainStockINQty | 剩余入库数量 | string | FRemainStockINQty |
FMrbQty | 累计退料数量 | string | FMrbQty |
FCHECKRETQTY | 收料可退数量 | string | FCHECKRETQTY |
FSTOCKRETQTY | 库存可退数量 | string | FSTOCKRETQTY |
FConsumeSumQty | 消耗汇总数量 | string | FConsumeSumQty |
FSrcBillTypeId | 源单类型 | string | FSrcBillTypeId |
FSrcBillNo | 源单编号 | string | FSrcBillNo |
FReqTraceNo | 需求跟踪号 | string | FReqTraceNo |
FMtoNo | 计划跟踪号 | string | FMtoNo |
FDEMANDTYPE | 需求来源 | string | FDEMANDTYPE |
FDEMANDBILLNO | 需求单据编号 | string | FDEMANDBILLNO |
FDEMANDBILLENTRYSEQ | 需求单据行号 | string | FDEMANDBILLENTRYSEQ |
FDEMANDBILLENTRYID | 需求单据分录内码 | string | FDEMANDBILLENTRYID |
FID | FID | string | |
Limit | 最大行数 | string | {{PAGINATION_PAGE_SIZE}} |
StartRow | 开始行索引 | string | {{PAGINATION_START_ROW}} |
TopRowCount | 返回总行数 | int | |
FilterString | 过滤条件 | string | |
FieldKeys | 需查询的字段key集合 | array | |
FormId | 业务对象表单Id | string | PUR_PurchaseOrder |
响应参数
字段 | 字段名称 | 类型 | 配置值 |
FPOOrderEntry_FEntryId | id | string | |
FBillNo | 单据编号 | string | |
FSourceBillNo | 源单编号 | string | |
FBillTypeID_FNumber | 单据类型 | string | CGDD02_SYS |
FBusinessType | 业务类型 | string | |
FSupplierId_FNumber | 供应商 | string | |
FSettleModeId_FNumber | 结算方式 | string | |
FPayConditionId_FNumber | 付款条件 | string | |
FDate | 采购日期 | string | |
FDocumentStatus | 单据状态 | string | |
FPreMatchAmountFor | 预付已核销金额 | string | |
FPayAdvanceBillId_FNumber | 预付单号 | string | |
FPurchaseOrgId_FNumber | 采购组织 | string | |
FPurchaseDeptId_FNumber | 采购部门 | string | |
FPurchaserGroupId_FNumber | 采购组 | string | |
FPurchaserId_FNumber | 采购员 | string | |
FProviderId_FNumber | 供货方 | string | |
FSettleId_FNumber | 结算方 | string | |
FChargeId_FNumber | 收款方 | string | |
FCorrespondOrgId_FNumber | 对应组织 | string | |
FAssignSupplierId_FNumber | 指定供应商 | string | |
FMaterialId_FNumber | 物料编码 | string | |
FBarcode | 零售条形码 | string | |
FQty | 采购数量 | string | |
FDeliveryDate | 交货日期 | string | |
FLocation | 交货地点 | string | |
FLocationAddress | 交货地址 | string | |
FPrice | 单价 | string | |
FTaxPrice | 含税单价 | string | |
FEntryDiscountRate | 折扣率% | string | |
FEntryDiscount | 折扣额 | string | |
FEntryTaxRate | 税率% | string | |
FEntryTaxAmount | 税额 | string | |
FAllAmount | 价税合计 | string | |
FEntryAmount | 金额 | string | |
FRequireOrgId_FNumber | 需求组织 | string | |
FRequireDeptId_FNumber | 需求部门 | string | |
FRequireStaffId_FNumber | 需求人 | string | |
FReceiveOrgId_FNumber | 收料组织 | string | |
FBranchId_FNumber | 收货门店 | string | |
FReceiveDeptId_FNumber | 收料部门 | string | |
FEntrySettleOrgId_FNumber | 结算组织 | string | |
FGiveAway | 是否赠品 | string | |
FEntryNote | 备注 | string | |
FSupMatId | 供应商物料编码 | string | |
FSupMatName | 供应商物料名称 | string | |
FLot | 批号 | string | |
FSupplierLot | 供应商批号 | string | |
FReceiveQty | 累计收料数量 | string | |
FRemainReceiveQty | 剩余收料数量 | string | |
FStockInQty | 累计入库数量 | string | |
FRemainStockINQty | 剩余入库数量 | string | |
FMrbQty | 累计退料数量 | string | |
FCHECKRETQTY | 收料可退数量 | string | |
FSTOCKRETQTY | 库存可退数量 | string | |
FConsumeSumQty | 消耗汇总数量 | string | |
FSrcBillTypeId | 源单类型 | string | |
FSrcBillNo | 源单编号 | string | |
FReqTraceNo | 需求跟踪号 | string | |
FMtoNo | 计划跟踪号 | string | |
FDEMANDTYPE | 需求来源 | string | |
FDEMANDBILLNO | 需求单据编号 | string | |
FDEMANDBILLENTRYSEQ | 需求单据行号 | string | |
FDEMANDBILLENTRYID | 需求单据分录内码 | string | |
FID | FID | string | |
旺店通·企业奇门接口明细
- API:wdt.purchase.order.push
- NAME:创建采购单
- METHOD:POST
请求参数
接口字段 | 字段名称 | 预设值 | 描述 |
provider_no | 供应商编号 | {{FSupplierId_FNumber}} | 供应商编号,ERP供应商档案必须存在此编号,否则推送失败 |
warehouse_no | 仓库编号 | 01 | 代表仓库所有属性的唯一编码,用于仓库区分,ERP内支持自定义(ERP仓库界面设置),用于创建指定仓库数据信息(不支持一次推送多个仓库编码) |
outer_no | API单号 | | API单号(如果【使用API单号作为系统采购单号】,那么该字段长度不能超过20)保证唯一 |
is_use_outer_no | 传入ERP采购单号 | {{FBillNo}} | 使用api外部单号作为系统采购单号(1使用,0不使用),默认不使用 |
is_check | 自动审核 | | 是否自动审核,0 不审核,1 审核,默认不自动审核(不影响财务审核) |
contact | 收货人姓名 | | 收货人姓名 |
purchase_name | 采购员 | wdt_248831 | 采购员 |
telno | 收货人联系电话 | | 收货人联系电话 |
receive_address | 收货地址 | | 收货地址 |
logistics_type | 货运方式 | | 货运方式 |
expect_arrive_time | 预计到货时间 | {{FDeliveryDate}} | 采购单对应货品预计到达仓库时间,时间格式:YYYY-MM-DD HH:MM:SS |
other_fee | 其他费用 | | 其他费用 |
post_fee | 邮资 | | 邮资 |
remark | 备注 | | 采购单备注 |
prop1 | 自定义属性1 | | 自定义属性1 |
prop2 | 自定义属性2 | | 自定义属性2 |
details_list | 采购明细节点 | details_list | 请求参数的2级数据节点,包含采购单所有货品明细信息的数据节点,节点下数据字段详见下述“details_list” |
details_list.spec_no | 商家编码 | {{FMaterialId_FNumber}} | 代表单品(sku)所有属性的编码,SKU概念介绍,单击这里 |
details_list.num | 采购量 | {{FQty}} | 采购量 |
details_list.price | 采购价格 | {{FTaxPrice}} | 采购价格,按采购单位,税前单价 |
details_list.discount | 折扣 | | 折扣(1为不打折,0.9为9折,以此类推,0即为免费,接口计算公式在上边) |
details_list.tax | 税率 | {{FEntryTaxRate}} | 货品的税率,传值范围大于等于0小于等于1 |
details_list.tax_price | 税后单价 | | 税后单价,推送税后单价时折扣(discount)传值不生效,由接口计算,公式为discount=tax_price/(price*(1+tax)) |
details_list.remark | 备注 | | 采购货品明细备注 |
details_list.prop1 | 自定义属性1 | | 自定义属性1 |
details_list.prop2 | 自定义属性2 | | 自定义属性2 |
details_list.purchase_info | 采购列表节点 | | 请求参数的1级数据节点,包含采购单所有属性信息的数据节点,节点下数据字段详见下述“purchase_info” |
系统对接概况
通过数据集成平台可视化的快速配置调用接口打通金蝶云星空与旺店通·企业奇门之间的数据接口,使得两个系统之间的对接更加快捷、稳定。轻易云数据集成平台打破信息孤岛、适配多种场景、降低运营成本、缩短开发周期、灵活调度配置是这种多系统数据打通时的特性优势。采用元数据模型驱动的低代码集成工具,基于系统预置的数据模型、映射、编排、日志、脚本等集成核心引擎,通过可视化配置,快速实现客户灵活多变的动态集成需求,让集成开发简单、执行过程可靠、问题风险可控。
