金蝶云星空与旺店通·旗舰版对接集成调拨申请单打通采购订单新增
来源系统:金蝶云星空
金蝶K/3Cloud（金蝶云星空）是移动互联网时代的新型ERP，是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”，旨在帮助企业打造面向新时代的生态互联与协同平台，围绕生态中的每个角色，提供随手可得的云服务，最终实现敏捷协同，智慧运营的企业运营新境界。整个产品采用SOA架构，完全基于BOS平台组建而成，业务架构上贯穿流程驱动与角色驱动思想，结合中国管理模式与中国管理实践积累，精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建，支持跨数据库应用，支持本地部署、私有云部署与公有云部署三种部署方式，同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业，其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。
目标系统:旺店通·旗舰版
慧策（原旺店通）是一家技术驱动型智能零售服务商，基于云计算PaaS、SaaS模式，以一体化智能零售解决方案，帮助零售企业数字化智能化升级，实现企业规模化发展。
数据对接方案
通过轻易云系统数据集成平台新增创建集成方案，然后在数据源平台中选择对应的源平台为：金蝶云星空，并且选择对应的连接器（关于金蝶云星空的接口连接器如何配置可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息）。选择对应的调拨申请单接口作为数据对接来源。然后再通过写入目标平台配置目标系统为旺店通·旗舰版，并且选择对应连接器。选择对应的采购订单新增接口作为数据写入动作，既可以完成第一步的数据对接配置；打破跨系统连接，让数据轻易互通成为现实。
金蝶云星空接口明细
- 调用接口：executeBillQuery
- 接口名称：调拨申请单
- 方法：POST
请求参数
| 字段 | 字段名称 | 类型 | 配置值 |
|---|
| FBillTypeID_FNumber | 单据类型 | string | FBillTypeID.FNumber |
| FBillNo | 单据编号 | string | FBillNo |
| FDate | 日期 | string | FDate |
| FSaleOrgId_FNumber | 销售组织 | string | FSaleOrgId.FNumber |
| FCustomerID_FNumber | 客户 | string | FCustomerID.FNumber |
| FBranchId_FNumber | 销售门店 | string | FBranchId.FNumber |
| FSaleDeptID_FNumber | 销售部门 | string | FSaleDeptID.FNumber |
| FHeadLocationId_FNumber | 交货地点 | string | FHeadLocationId.FNumber |
| FCorrespondOrgId_FNumber | 对应组织 | string | FCorrespondOrgId.FNumber |
| FCarrierID_FNumber | 承运商 | string | FCarrierID.FNumber |
| FCarriageNO | 运输单号 | string | FCarriageNO |
| FSalesGroupID_FNumber | 销售组 | string | FSalesGroupID.FNumber |
| FSalesManID_FNumber | 销售员 | string | FSalesManID.FNumber |
| FThirdBillNo | 第三方单据编号 | string | FThirdBillNo |
| FStockOrgId_FNumber | 发货组织 | string | FStockOrgId.FNumber |
| FDeliveryDeptID_FNumber | 发货部门 | string | FDeliveryDeptID.FNumber |
| FThirdBillId | 第三方单据平台单号 | string | FThirdBillId |
| FLinkPhone | 联系电话 | string | FLinkPhone |
| FLinkMan | 收货人姓名 | string | FLinkMan |
| FThirdSrcType | 第三方系统来源 | string | FThirdSrcType |
| FStockerID_FNumber | 仓管员 | string | FStockerID.FNumber |
| FBussinessType | 业务类型 | string | FBussinessType |
| FDocumentStatus | 单据状态 | string | FDocumentStatus |
| FNote | 备注 | string | FNote |
| FReceiverID_FNumber | 收货方 | string | FReceiverID.FNumber |
| FReceiveAddress | 收货方地址 | string | FReceiveAddress |
| FSettleID_FNumber | 结算方 | string | FSettleID.FNumber |
| FReceiverContactID_FNumber | 收货方联系人 | string | FReceiverContactID.FNumber |
| FPayerID_FNumber | 付款方 | string | FPayerID.FNumber |
| FSettleOrgID_FNumber | 结算组织 | string | FSettleOrgID.FNumber |
| FSettleTypeID_FNumber | 结算方式 | string | FSettleTypeID.FNumber |
| FReceiptConditionID_FNumber | 收款条件 | string | FReceiptConditionID.FNumber |
| FOwnerIdHead_FNumber | 货主 | string | FOwnerIdHead.FNumber |
| FBuyerNick | 会员名称 | string | FBuyerNick |
| FReceiverAddress | 收货人地址 | string | FReceiverAddress |
| FReceiverName | 收货人 | string | FReceiverName |
| FReceiverMobile | 收货人手机 | string | FReceiverMobile |
| FReceiverCountry | 收货人国家 | string | FReceiverCountry |
| FReceiverState | 收货人省份 | string | FReceiverState |
| FReceiverCity | 收货人城市 | string | FReceiverCity |
| FReceiverDistrict | 收货人地区 | string | FReceiverDistrict |
| FReceiverPhone | 收货人电话 | string | FReceiverPhone |
| FSHOPNUMBER | 网店编码 | string | FSHOPNUMBER |
| FSALECHANNEL | 销售渠道 | string | FSALECHANNEL |
| FVIPCODE | 会员编码 | string | FVIPCODE |
| FCustMatID_FNumber | 客户物料编码 | string | FCustMatID.FNumber |
| FMaterialID_FNumber | 物料编码 | string | FMaterialID.FNumber |
| FBarcode | 零售条形码 | string | FBarcode |
| FMustQty | 应发数量 | string | FMustQty |
| FRealQty | 实发数量 | string | FRealQty |
| FPrice | 单价 | string | FPrice |
| FTaxPrice | 含税单价 | string | FTaxPrice |
| FIsFree | 是否赠品 | string | FIsFree |
| FLot | 批号 | string | FLot.FNumber |
| FProduceDate | 生产日期 | string | FProduceDate |
| FExpiryDate | 有效期至 | string | FExpiryDate |
| FEntryTaxRate | 税率% | string | FEntryTaxRate |
| FEntryTaxAmount | 税额 | string | FEntryTaxAmount |
| FAmount | 金额 | string | FAmount |
| FAllAmount | 价税合计 | string | FAllAmount |
| FStockID_FNumber | 仓库 | string | FStockID.FNumber |
| FStockStatusID_FNumber | 库存状态 | string | FStockStatusID.FNumber |
| FMtoNo | 计划跟踪号 | string | FMtoNo |
| FEntrynote | 备注 | string | FEntrynote |
| FSrcType | 源单类型 | string | FSrcType |
| FSrcBillNo | 源单编号 | string | FSrcBillNo |
| FSoorDerno | 订单单号 | string | FSoorDerno |
| FDiscountRate | 折扣率% | string | FDiscountRate |
| FDiscount | 折扣额 | string | FDiscount |
| FPriceDiscount | 单价折扣 | string | FPriceDiscount |
| FSOEntryId | 销售订单EntryId | string | FSOEntryId |
| FB2CORDERDETAILID | B2C订单明细Id | string | FB2CORDERDETAILID |
| FThirdEntryId | 管易订单单号 | string | FThirdEntryId |
| FETHIRDBILLID | 第三方单据ID | string | FETHIRDBILLID |
| FETHIRDBILLNO | 第三方单据编号 | string | FETHIRDBILLNO |
| FGYFINDate | 管易到账时间 | string | FGYFINDate |
| FGYFINSTATUS | 管易是否到账 | string | FGYFINSTATUS |
| FEntity_FENTRYID | 分录FENTRYID | string | FEntity_FENTRYID |
| Limit | 最大行数 | string | {{PAGINATION_PAGE_SIZE}} |
| StartRow | 开始行索引 | string | {{PAGINATION_START_ROW}} |
| TopRowCount | 返回总行数 | int | |
| FilterString | 过滤条件 | string | FBillNo = 'PSXSCK1072022122711' |
| FieldKeys | 需查询的字段key集合 | array | |
| FormId | 业务对象表单Id | string | SAL_OUTSTOCK |
响应参数
| 字段 | 字段名称 | 类型 | 配置值 |
|---|
| FBillTypeID_FNumber | 单据类型 | string | |
| FBillNo | 单据编号 | string | |
| FDate | 日期 | string | |
| FSaleOrgId_FNumber | 销售组织 | string | |
| FCustomerID_FNumber | 客户 | string | |
| FBranchId_FNumber | 销售门店 | string | |
| FSaleDeptID_FNumber | 销售部门 | string | |
| FHeadLocationId_FNumber | 交货地点 | string | |
| FCorrespondOrgId_FNumber | 对应组织 | string | |
| FCarrierID_FNumber | 承运商 | string | |
| FCarriageNO | 运输单号 | string | |
| FSalesGroupID_FNumber | 销售组 | string | |
| FSalesManID_FNumber | 销售员 | string | |
| FThirdBillNo | 第三方单据编号 | string | |
| FStockOrgId_FNumber | 发货组织 | string | |
| FDeliveryDeptID_FNumber | 发货部门 | string | |
| FThirdBillId | 第三方单据平台单号 | string | |
| FLinkPhone | 联系电话 | string | |
| FLinkMan | 收货人姓名 | string | |
| FThirdSrcType | 第三方系统来源 | string | |
| FStockerID_FNumber | 仓管员 | string | |
| FBussinessType | 业务类型 | string | |
| FDocumentStatus | 单据状态 | string | |
| FNote | 备注 | string | |
| FReceiverID_FNumber | 收货方 | string | |
| FReceiveAddress | 收货方地址 | string | |
| FSettleID_FNumber | 结算方 | string | |
| FReceiverContactID_FNumber | 收货方联系人 | string | |
| FPayerID_FNumber | 付款方 | string | |
| FSettleOrgID_FNumber | 结算组织 | string | |
| FSettleTypeID_FNumber | 结算方式 | string | |
| FReceiptConditionID_FNumber | 收款条件 | string | |
| FOwnerIdHead_FNumber | 货主 | string | |
| FBuyerNick | 会员名称 | string | |
| FReceiverAddress | 收货人地址 | string | |
| FReceiverName | 收货人 | string | |
| FReceiverMobile | 收货人手机 | string | |
| FReceiverCountry | 收货人国家 | string | |
| FReceiverState | 收货人省份 | string | |
| FReceiverCity | 收货人城市 | string | |
| FReceiverDistrict | 收货人地区 | string | |
| FReceiverPhone | 收货人电话 | string | |
| FSHOPNUMBER | 网店编码 | string | |
| FSALECHANNEL | 销售渠道 | string | |
| FVIPCODE | 会员编码 | string | |
| FCustMatID_FNumber | 客户物料编码 | string | |
| FMaterialID_FNumber | 物料编码 | string | |
| FBarcode | 零售条形码 | string | |
| FMustQty | 应发数量 | string | |
| FRealQty | 实发数量 | string | |
| FPrice | 单价 | string | |
| FTaxPrice | 含税单价 | string | |
| FIsFree | 是否赠品 | string | |
| FLot | 批号 | string | |
| FProduceDate | 生产日期 | string | |
| FExpiryDate | 有效期至 | string | |
| FEntryTaxRate | 税率% | string | |
| FEntryTaxAmount | 税额 | string | |
| FAmount | 金额 | string | |
| FAllAmount | 价税合计 | string | |
| FStockID_FNumber | 仓库 | string | |
| FStockStatusID_FNumber | 库存状态 | string | |
| FMtoNo | 计划跟踪号 | string | |
| FEntrynote | 备注 | string | |
| FSrcType | 源单类型 | string | |
| FSrcBillNo | 源单编号 | string | |
| FSoorDerno | 订单单号 | string | |
| FDiscountRate | 折扣率% | string | |
| FDiscount | 折扣额 | string | |
| FPriceDiscount | 单价折扣 | string | |
| FSOEntryId | 销售订单EntryId | string | |
| FB2CORDERDETAILID | B2C订单明细Id | string | |
| FThirdEntryId | 管易订单单号 | string | |
| FETHIRDBILLID | 第三方单据ID | string | |
| FETHIRDBILLNO | 第三方单据编号 | string | |
| FGYFINDate | 管易到账时间 | string | |
| FGYFINSTATUS | 管易是否到账 | string | |
| FEntity_FENTRYID | 分录FENTRYID | string | FEntity_FENTRYID |
旺店通·旗舰版接口明细
- 调用接口：purchase.PurchaseOrder.createOrder
- 接口名称：采购订单新增
- 方法：POST
请求参数
| 字段 | 字段名称 | 类型 | 配置值 |
|---|
| purchase_no | 采购单编号 | String | {{FBillNo}}_3 |
| provider_no | 供应商编号 | String | wdt_gys_01 |
| receive_warehouse_nos | 收货仓编号 | String | wdt_pdsmkj3_01 |
| expect_warehouse_no | 预计入库仓库编号 | String | wdt_pdsmkj3_01 |
| purchaser_name | 采购员 | String | 余金月 |
| is_check | 是否要审核 | String | false |
| apply_nos | 引用的采购申请单编号 | String | {{FSrcBillNo}} |
| remark | 备注 | String | {{FNote}} |
| purchase_details | 采购单详情 | array | details |
| purchase_details.spec_no | 商家编码 | String | {{details.FMaterialID_FNumber}} |
| purchase_details.num | 采购数量 | String | {{details.FRealQty}} |
| purchase_details.remark | 备注 | String | {{details.FEntrynote}} |
| purchase_details.price | 税前单价 | string | {{details.FTaxPrice}} |
| purchase_details.tax_price | 税后单价 | string | {{details.FPrice}} |
| purchase_details.tax_rate | 税率 | string | {{details.FEntryTaxRate}} |
响应参数
| 字段 | 字段名称 | 类型 | 配置值 |
|---|
| status | 状态码 | string | |
| message | 错误信息 | string | |
系统对接概况
从API服务总线层面解决企业烟囱式业务系统集成现状 相互连接企业各业务系统，实现流程端到端打通，复用已有的业务系统能力，让集成架构、服务关系更清晰 使用统一的API管理平台，对API进行显性化、可视化，使所有API服务成为企业的数字资产，提升API利用率，发挥业务系统价值，实现企业IT资产的可插拔、可复用、可组成。
