金蝶云星空和旺店通·企业奇门接口打通对接实战
来源系统:金蝶云星空
金蝶K/3Cloud（金蝶云星空）是移动互联网时代的新型ERP，是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”，旨在帮助企业打造面向新时代的生态互联与协同平台，围绕生态中的每个角色，提供随手可得的云服务，最终实现敏捷协同，智慧运营的企业运营新境界。整个产品采用SOA架构，完全基于BOS平台组建而成，业务架构上贯穿流程驱动与角色驱动思想，结合中国管理模式与中国管理实践积累，精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建，支持跨数据库应用，支持本地部署、私有云部署与公有云部署三种部署方式，同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业，其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。
对接目标平台:旺店通·企业奇门
慧策（原旺店通）是一家技术驱动型智能零售服务商，基于云计算PaaS、SaaS模式，以一体化智能零售解决方案，帮助零售企业数字化智能化升级，实现企业规模化发展。
系统对接接口配置
通过轻易云系统数据集成平台新增创建集成方案，通过轻易云的方案市场可以一键复制，并且可以借鉴其他的方案配置完成方案制作，方案制作只需要两步，第一步先确定好对应的数据来源；源系统：金蝶云星空接口：盘盈单查询通过请求调度者配置对应的请求参数即可获取到对应的数据。目标系统：旺店通·企业奇门接口：创建调拨出库单，通过写入调度者匹配获取到的数据和写入的映射关系，即可自动生成符合目标系统：旺店通·企业奇门写入的数据自动产生写入队列，通过运行概况，系统会自动帮你诊断方案的运行情况。实时监控到方案的运行情况
金蝶云星空接口明细
- 调用接口：executeBillQuery
- 接口名称：盘盈单查询
- 方法：POST
请求参数
| 字段 | 字段名称 | 类型 | 配置值 |
|---|---|---|---|
| FBillEntry_FEntryID | FEntryID | string | FBillEntry_FEntryID |
| FID | 实体主键 | string | FID |
| FBillNo | 单据编号 | string | FBillNo |
| FDocumentStatus | 单据状态 | string | FDocumentStatus |
| FStockOrgId_FNumber | 库存组织 | string | FStockOrgId.FNumber |
| FDate | 日期 | string | FDate |
| FBillTypeID | 单据类型 | string | FBillTypeID |
| FStockerId | 仓管员 | string | FStockerId |
| FCreatorId | 创建人 | string | FCreatorId |
| FCreateDate | 创建日期 | string | FCreateDate |
| FModifierId | 最后修改人 | string | FModifierId |
| FModifyDate | 最后修改日期 | string | FModifyDate |
| FApproverId | 审核人 | string | FApproverId |
| FApproveDate | 审核日期 | string | FApproveDate |
| FNoteHead | 备注 | string | FNoteHead |
| FMaterialId_FNumber | 物料编码 | string | FMaterialId.FNumber |
| FMaterialId_FBARCODE | 条码 | string | FMaterialId.FBARCODE |
| FUnitID | 单位 | string | FUnitID |
| FAcctQty | 账存数量 | string | FAcctQty |
| FCountQty | 盘点数量 | string | FCountQty |
| FLossQty | 盘亏数量 | string | FLossQty |
| FStockId_FNumber | 仓库 | string | FStockId.FNumber |
| FStockStatusId | 库存状态 | string | FStockStatusId |
| FOwnerid_FNumber | 货主 | string | FOwnerid.FNumber |
| FPrice | 成本价 | string | FPrice |
| FAmount | 总成本 | string | FAmount |
| Fnote | 备注 | string | Fnote |
| FBomId | BOM版本 | string | FBomId |
| FMtoNo | 计划跟踪号 | string | FMtoNo |
| FStockFlag | 库存更新标识 | string | FStockFlag |
| FStockLocId | 仓位 | string | FStockLocId |
| FLOT | 批号 | string | FLOT |
| FCMKBarCode | 零售条形码 | string | FCMKBarCode |
| Limit | 最大行数 | string | {{PAGINATION_PAGE_SIZE}} |
| StartRow | 开始行索引 | string | {{PAGINATION_START_ROW}} |
| TopRowCount | 返回总行数 | int | |
| FilterString | 过滤条件 | string | FApproveDate>='{{LAST_SYNC_TIME dateTime}}' AND FDocumentStatus = 'C' AND FMaterialId.FBARCODE IS NOT NULL AND FMaterialId.FBARCODE <> '' AND FStockId.FNumber IN ( '02.02','03','06.01','02.01','02','01','04.01') AND FMaterialId.FBARCODE NOT LIKE '%LSBM%' AND FMaterialId.FBARCODE NOT LIKE '%lsbm%' and FStockId.F_DSG_CheckBox=0 |
| FieldKeys | 需查询的字段key集合 | array | |
| FormId | 业务对象表单Id | string | STK_StockCountLoss |
响应参数
| 字段 | 字段名称 | 类型 | 配置值 |
|---|---|---|---|
| FBillEntry_FEntryID | FEntryID | string | |
| FID | 实体主键 | string | |
| FBillNo | 单据编号 | string | |
| FDocumentStatus | 单据状态 | string | |
| FStockOrgId_FNumber | 库存组织 | string | |
| FDate | 日期 | string | |
| FBillTypeID | 单据类型 | string | |
| FStockerId | 仓管员 | string | |
| FCreatorId | 创建人 | string | |
| FCreateDate | 创建日期 | string | |
| FModifierId | 最后修改人 | string | |
| FModifyDate | 最后修改日期 | string | |
| FApproverId | 审核人 | string | |
| FApproveDate | 审核日期 | string | |
| FNoteHead | 备注 | string | |
| FMaterialId_FNumber | 物料编码 | string | |
| FMaterialId_FBARCODE | 条码 | string | |
| FUnitID | 单位 | string | |
| FAcctQty | 账存数量 | string | |
| FCountQty | 盘点数量 | string | |
| FLossQty | 盘亏数量 | string | |
| FStockId_FNumber | 仓库 | string | |
| FStockStatusId | 库存状态 | string | |
| FOwnerid_FNumber | 货主 | string | |
| FPrice | 成本价 | string | |
| FAmount | 总成本 | string | |
| Fnote | 备注 | string | |
| FBomId | BOM版本 | string | |
| FMtoNo | 计划跟踪号 | string | |
| FStockFlag | 库存更新标识 | string | |
| FStockLocId | 仓位 | string | |
| FLOT | 批号 | string | |
| FCMKBarCode | 零售条形码 | string |
旺店通·企业奇门接口明细
- API：wdt.stockout.order.push
- NAME：创建调拨出库单
- METHOD：POST
请求参数
| 接口字段 | 字段名称 | 预设值 | 描述 |
|---|---|---|---|
| outer_no | 外部单号 | {{FBillNo}}K{{FStockId_FNumber}} | 外部系统的唯一单据编号，避免重复推送数据 |
| is_check | 是否审核 | 1：自动审核 0：不自动审核 默认0 | |
| warehouse_no | 仓库编号 | {{FStockId_FNumber}} | 代表仓库所有属性的唯一编码，用于仓库区分，ERP内支持自定义（ERP仓库界面设置） |
| logistics_code | 物流编号 | 代表物流所有属性的唯一编码，用于物流区分，ERP内支持自定义（ERP物流界面设置） | |
| logistics_no | 物流单号 | 物流公司的运单号 | |
| goods_total_amount | 总售价 | 总售价 | |
| goods_total_cost | 总成本价 | 总成本价 | |
| post_cost | 邮费 | 邮费 | |
| remark | 备注 | 金蝶盘亏对接其他出库 | 其他出库单备注 |
| reason | 其他出库原因 | 其他出库原因（需要在客户端维护好该原因，如客户端无该原因或者原因停用，则推送失败，路径：设置—>基本设置—>原因列表） | |
| detail_list | 货品列表节点 | 请求参数的2级数据节点，包含其他出库单所有货品属性信息的数据节点，节点下数据字段详见下述“ detail_list” | |
| detail_list.remark | 备注 | 货品明细备注 | |
| detail_list.spec_no | 商家编码 | {{goods_list.FMaterialId_FBARCODE}} | 代表单品(sku)所有属性的编码，SKU概念介绍,单击这里 |
| detail_list.num | 出库数量 | {{goods_list.FLossQty}} | 出库数量 |
| detail_list.price | 价格 | 价格 | |
| detail_list.position_no | 货位编号 | 货位编号 | |
| detail_list.batch_no | 批次号 | 指定批次号 | |
| detail_list.is_enable_sn | 是否开启序列号 | 是否开启序列号: 0代表不开启序列号 1代表开启序列号 默认为不开启 | |
| detail_list.sn_list | 序列号列表 | 序列号列表，多个序列号通过","隔开字符串区分，例如"xxx1,xxx2,xxx3" | |
| detail_list.stockout_info | stockout_info |
系统对接概况
通过无代码的数据集成与数据建模的智能数据管道技术，帮助企业将所有应用程序、数据库、事件和文件等数据信息提取到数据仓库中，并快速将分散的数据转化为数据集、API、自动化流程等开箱即用的数据服务。配置接口的模式对接金蝶云星空和旺店通·企业奇门，使得单据无缝互通。打造企业内部数据一体化，让企业日常运营管理实现敏捷数据化运营。实现供应链业务信息流的互通，同时支持供应链数据分析流程自动化，结果推送，推进相关供应链问题优化。及时打通供应链孤岛，实现数据驱动供应链协同，进一步提升企业竞争力。
