金蝶云星空和聚水潭单据接口对接
对接系统：聚水潭
聚水潭是SaaS协同平台、电商ERP软件。聚水潭成立于2014年，创始人兼CEO骆海东拥有近三十年传统及电商ERP的研发和实施部署经验。聚水潭创建之初，以电商SaaSERP切入市场，凭借出色的产品和服务，快速获得市场的肯定。
接入系统：金蝶云星空
金蝶K/3Cloud结合当今先进管理理论和数十万家国内客户最佳应用实践，面向事业部制、多地点、多工厂等运营协同与管控型企业及集团公司，提供一个通用的ERP服务平台。K/3Cloud支持的协同应用包括但不限于：集中/分散销售、集中/分散采购、B2B电商管理、B2C电商中心、供应商协同、多工厂计划、跨工厂领料、跨工厂加工、工厂间调拨、内部交易及结算、集团财务管理、阿米巴经营等。
数据接口配置
使用轻易云系统数据集成平台对应的模块：数据集成方案。然后选择开始创建数据集成方案。在方案配置表单中选择对应的源业务系统：聚水潭，然后选择对应的连接器。选择对应的库存盘点查询作为数据对接来源。然后再通过写入目标平台配置目标系统为金蝶云星空,并且选择对应连接器（关于金蝶云星空的接口如何配置可以在轻易云数据集成社区论坛中找到相关信息,选择好对应的物料盘点作业新增接口作为数据写入动作，既可以完成第一步的数据对接配置。
聚水潭接口明细
- API：inventory.count.query
- NAME：库存盘点查询
- METHOD：POST
请求参数
| 接口字段 | 字段名称 | 预设值 | 描述 |
|---|
| page_index | 开始页码 | 1 | 第几页，从第一页开始，默认1 |
| page_size | 每页条数 | 50 | 每页多少条，默认30，最大50 |
| modified_begin | 修改开始时间 | 2021-07-01 00:00:00 | 修改起始时间，和结束时间必须同时存在，时间间隔不能超过七天，与线上单号不能同时为空 |
| modified_end | 修改结束时间 | 2021-07-07 00:00:00 | 修改结束时间，和起始时间必须同时存在，时间间隔不能超过七天，与线上单号不能同时为空 |
| io_ids | 盘点单号 | | 指定盘点单号，多个用逗号分隔，最多50，和时间段不能同时为空 |
| status | 单据状态 | Confirmed | 单据状态，Confirmed=生效，WaitConfirm待审核，Creating=草拟，Archive=归档，Cancelled=作废 |
响应参数
| 接口字段 | 字段名称 | 预设值 | 描述 |
|---|
| type | 单据类型 | | 单据类型 |
| io_date | 单据日期 | | 单据日期 |
| status | 状态; | | 状态;WaitConfirm:待确认,Confirmed:生效,Archive:归档,Cancelled:取消,Delete:作废 |
| warehouse | 仓库名称 | | 仓库名称 |
| creator_name | 创建人 | | 创建人 |
| remark | 备注 | | 备注 |
| wh_id | 仓库编号 | | 仓库编号，主仓=1，销退仓=2， 进货仓=3，次品仓 = 4 |
| wms_co_id | 分仓编号 | | 分仓编号 |
| modified | 修改时间 | | 修改时间 |
| items | 商品合集 | | |
| items.io_id | 盘点单号 | | 盘点单号 |
| items.ioi_id | 子单号 | | 子单号 |
| items.sku_id | 商品编码 | | 商品编码 |
| items.name | 商品名称 | | 商品名称 |
| items.properties_value | 颜色及规格 | | 颜色及规格 |
| items.qty | 盘亏数量 | | 数量 |
| items.r_qty | 盘点后数量 | | 盘点后数量 |
| items.batchs | 批次集合 | | |
| items.batchs.sku_id | 商品编码 | | 商品编码 |
| items.batchs.qty | 数量 | | 数量 |
| items.batchs.batch_no | 批次号 | | 批次号 |
| items.batchs.product_date | 批次日期 | | 批次日期 |
| items.batchs.supplier_id | 供应商编号 | | 供应商编号 |
| items.batchs.supplier_name | 供应商名称 | | 供应商名称 |
| items.batchs.expiration_date | 有效期至 | | 有效期至 |
金蝶云星空接口明细
- 调用接口：batchSave
- 接口名称：物料盘点作业新增
- 方法：POST
请求参数
| 字段 | 字段名称 | 类型 | 配置值 |
|---|
| FBillNo | 单据编码 | string | {{io_ids}} |
| FStockOrgId | 库存组织 | string | 101 |
| FDate | 日期 | string | {{io_date}} |
| FFinDate | 财务日期 | string | |
| FBackUpDate | 账存日期 | string | |
| FNoteHead | 备注 | string | {{remark}} |
| FSource | 来源 | string | |
| FUpdateStock | 更新库存 | string | true |
| FZeroStockInCount | 零库存参与盘点 | string | true |
| FAllowAddMaterial | 物料盘点作业允许增加物料 | string | true |
| FBillTypeID | 单据类型 | string | WLPDZY01_SYS |
| FBillEntry | 单据体 | array | |
| FBillEntry.FStockId | 仓库编码 | string | 11084916 |
| FBillEntry.FStockStatusId | 库存状态 | string | KCZT01_SYS |
| FBillEntry.FMaterialId | 物料编码 | string | {{items.sku_id}} |
| FBillEntry.FAcctQty | 账存数量 | string | |
| FBillEntry.FCountQty | 盘点数量 | string | {{items.r_qty}} |
| FBillEntry.FGainQty | 盘盈数量 | string | |
| FBillEntry.FLossQty | 盘亏数量 | string | |
| FBillEntry.FOwnerTypeId | 货主类型 | string | BD_OwnerOrg |
| FBillEntry.FOwnerId | 货主 | string | 101 |
| FBillEntry.FNote | 备注 | string | |
| FBillEntry.FProjectNo | 项目跟踪号 | string | |
| FBillEntry.FMtoNo | 计划跟踪号 | string | |
| FBillEntry.FStockLocId | 仓位 | string | |
| FBillEntry.FLot | 批号 | string | {{batchs.batch_no}} |
| FBillEntry.FProduceDate | 生产日期 | string | {{batchs.product_date}} |
| FBillEntry.FExpiryDate | 有效期至 | string | {{batchs.expiration_date}} |
| FBillEntry.FormId | 业务对象表单Id | string | STK_StockCountInput |
| FBillEntry.Operation | 执行的操作 | string | BatchSave |
| FBillEntry.IsAutoSubmitAndAudit | 提交并审核 | bool | false |
| FBillEntry.IsVerifyBaseDataField | 验证基础资料 | bool | false |
系统数据对接
采集并引入全业务、多终端、多形态的数据，经过处理以及对应平台接口的数据结构适配，形成以业务核心为对象为中心的连接和标签体系。配合企业根据自身的实际情况以及业务需求完成方案的规划、部署与实施，将沉淀的业务数据进入到平台进行体系化的加工，再以服务化的方式支持业务平台上的应用。达成高效支持业务敏捷创新的高质量和标准化的数据服务组合。
