从金蝶云星空到聚水潭通过接口配置打通数据
对接系统：金蝶云星空
金蝶K/3Cloud在总结百万家客户管理最佳实践的基础上，提供了标准的管理模式；通过标准的业务架构：多会计准则、多币别、多地点、多组织、多税制应用框架等，有效支持企业的运营管理；K/3Cloud提供了标准的业务建模：35种标准ERP领域模型、1046种模型元素、21243种模型元素属性组合，288个业务服务构件，让企业及伙伴可快速构建出行业化及个性化的应用。
对接目标平台:聚水潭
聚水潭成立于2014年，创始人兼CEO骆海东拥有近三十年传统及电商ERP的研发和实施部署经验。聚水潭创建之初，以电商SaaSERP切入市场，凭借出色的产品和服务，快速获得市场的肯定。随着客户需求的不断变化，如今聚水潭已经发展成为以SaaSERP为核心，集多种商家服务为一体的SaaS协同平台。经过8年多的发展，公司员工从2014年成立之初的9人增加到现在近4000人。聚水潭已在全国设立了超过100个线下服务网点，服务范围覆盖超过400个城镇，为客户提供及时、周到和专业的服务。
配置集成方案
数据集成平台对应的配置金蝶云星空与聚水潭的对接只要三步就能完成两个系统之间的数据对接。第一步根据金蝶云星空的接口参数要求记录在轻易云集成平台。第二步配置金蝶云星空与聚水潭之间的字段对应关系（更多方案可借鉴轻易云数据集成社区论坛中找到相关方案信息）第三步完成方案的检查参数设置：传递时间、重试次数、是否启动、前置条件等上线运行。
金蝶云星空接口明细
- API：executeBillQuery
- NAME：盘亏单查询
- METHOD：POST
请求参数
| 接口字段 | 字段名称 | 预设值 | 描述 |
|---|
| FBillEntry_FEntryID | FEntryID | FBillEntry_FEntryID | |
| FID | 实体主键 | FID | |
| FBillNo | 单据编号 | FBillNo | |
| FDocumentStatus | 单据状态 | FDocumentStatus | |
| FStockOrgId_FNumber | 库存组织 | FStockOrgId.FNumber | |
| FDate | 日期 | FDate | |
| FBillTypeID | 单据类型 | FBillTypeID | |
| FStockerId | 仓管员 | FStockerId | |
| FCreatorId | 创建人 | FCreatorId | |
| FCreateDate | 创建日期 | FCreateDate | |
| FModifierId | 最后修改人 | FModifierId | |
| FModifyDate | 最后修改日期 | FModifyDate | |
| FApproverId | 审核人 | FApproverId | |
| FApproveDate | 审核日期 | FApproveDate | |
| FNoteHead | 备注 | FNoteHead | |
| FMaterialId_FNumber | 物料编码 | FMaterialId.FNumber | |
| FMaterialId_FBARCODE | 条码 | FMaterialId.FBARCODE | |
| FUnitID | 单位 | FUnitID | |
| FAcctQty | 账存数量 | FAcctQty | |
| FCountQty | 盘点数量 | FCountQty | |
| FLossQty | 盘亏数量 | FLossQty | |
| FStockId_FNumber | 仓库 | FStockId.FNumber | |
| FStockStatusId | 库存状态 | FStockStatusId | |
| FOwnerid_FNumber | 货主 | FOwnerid.FNumber | |
| FPrice | 成本价 | FPrice | |
| FAmount | 总成本 | FAmount | |
| Fnote | 备注 | Fnote | |
| FBomId | BOM版本 | FBomId | |
| FMtoNo | 计划跟踪号 | FMtoNo | |
| FStockFlag | 库存更新标识 | FStockFlag | |
| FStockLocId | 仓位 | FStockLocId | |
| FLOT | 批号 | FLOT | |
| FCMKBarCode | 零售条形码 | FCMKBarCode | |
| Limit | 最大行数 | {{PAGINATION_PAGE_SIZE}} | 金蝶的查询分页参数 |
| StartRow | 开始行索引 | {{PAGINATION_START_ROW}} | 金蝶的查询分页参数 |
| TopRowCount | 返回总行数 | | 金蝶的查询分页参数 |
| FilterString | 过滤条件 | FApproveDate>='{{LAST_SYNC_TIME dateTime}}' AND FDocumentStatus = 'C' AND FStockId.FNumber IN ('A9') | 示例写法 FSupplierId.FNumber = 'VEN00010' and FApproveDate>= |
| FieldKeys | 需查询的字段key集合 | | 金蝶分录主键ID格式：FPOOrderEntry_FEntryId,其它格式 FPurchaseOrgId.FNumber |
| FormId | 业务对象表单Id | STK_StockCountLoss | 必须填写金蝶的表单ID如😛UR_PurchaseOrder |
响应参数
| 接口字段 | 字段名称 | 预设值 | 描述 |
|---|
| FBillEntry_FEntryID | FEntryID | | |
| FID | 实体主键 | | |
| FBillNo | 单据编号 | | |
| FDocumentStatus | 单据状态 | | |
| FStockOrgId_FNumber | 库存组织 | | |
| FDate | 日期 | | |
| FBillTypeID | 单据类型 | | |
| FStockerId | 仓管员 | | |
| FCreatorId | 创建人 | | |
| FCreateDate | 创建日期 | | |
| FModifierId | 最后修改人 | | |
| FModifyDate | 最后修改日期 | | |
| FApproverId | 审核人 | | |
| FApproveDate | 审核日期 | | |
| FNoteHead | 备注 | | |
| FMaterialId_FNumber | 物料编码 | | |
| FMaterialId_FBARCODE | 条码 | | |
| FUnitID | 单位 | | |
| FAcctQty | 账存数量 | | |
| FCountQty | 盘点数量 | | |
| FLossQty | 盘亏数量 | | |
| FStockId_FNumber | 仓库 | | |
| FStockStatusId | 库存状态 | | |
| FOwnerid_FNumber | 货主 | | |
| FPrice | 成本价 | | |
| FAmount | 总成本 | | |
| Fnote | 备注 | | |
| FBomId | BOM版本 | | |
| FMtoNo | 计划跟踪号 | | |
| FStockFlag | 库存更新标识 | | |
| FStockLocId | 仓位 | | |
| FLOT | 批号 | | |
| FCMKBarCode | 零售条形码 | | |
聚水潭接口明细
- API：jushuitan.otherinout.upload
- NAME：新建其它出入库（新）
- METHOD：POST
请求参数
| 接口字段 | 字段名称 | 预设值 | 描述 |
|---|
| is_confirm | 是否自动确认单据 | true | 是否自动确认单据 |
| wms_co_id | 分仓编号 | | 分仓编号 |
| type | 出入库类型: in是入库 out是出库 | out | 出入库类型: in是入库 out是出库 |
| external_id | 外部单号 | {{FBillNo}}{{FBillEntry_FEntryID}}PKOUT | 外部单号 |
| warehouse | 主仓=1，销退仓=2， 进货仓=3，次品仓 = 4 | 1 | 主仓=1，销退仓=2， 进货仓=3，次品仓 = 4 |
| drp_co_name | 出库类型 | | 出库类型 |
| receiver_name | 收件人姓名 | | 收件人姓名 |
| receiver_mobile | 收件人手机号 | | 收件人手机号 |
| receiver_state | 收件地址省 | | 收件地址省 |
| receiver_city | 收件地址市 | | 收件地址市 |
| receiver_district | 收件地址区 | 县 | | 收件地址区 县 |
| receiver_address | 收件详细地址 | | 收件详细地址 |
| items | 商品列表 | items | 商品列表 |
| items.remark | 备注 | | 备注 |
| items.sku_id | 商品编码 | {{items.FMaterialId_FNumber}} | 商品编码 |
| items.qty | 数量 | {{items.FLossQty}} | 数量 |
| items.batch_id | 批次单号，系统中需开启相关配置 | | 批次单号，系统中需开启相关配置 |
| items.produced_date | 生产日期，系统中需开启相关配置 | | 生产日期，系统中需开启相关配置 |
| items.expiration_date | 有效期至，系统中需开启相关配置 | | 有效期至，系统中需开启相关配置 |
响应参数
| 接口字段 | 字段名称 | 预设值 | 描述 |
|---|
| code | 非0失败 | | 非0失败 |
| msg | 错误描述 | | 错误描述 |
| data | 返回内容 | | 返回内容 |
| data.external_id | 外部单号 | | 外部单号 |
| data.io_id | 系统内部单号 | | 系统内部单号 |
系统对接总览
可视化配置，即便是普通业务人员也可以快速轻松对接多个平台，解决企业面临的数据孤岛，数据混乱等问题，实现数据可见、可用、可运营。进行统一化，模块化，标准化的服务能力和输出，实现对业务端数据需求的精准满足和高效响应，也可以在业务数据需求的不断增加下，让企业有整套的可复用的api资产以更换，支持业务的正常运转，节省开发成本。在不同的着重点和应用上解决数据共享，实现平台之间的独立管理。
