从金蝶云星空到聚水潭通过接口集成数据

对接系统:金蝶云星空
金蝶K/3Cloud在总结百万家客户管理最佳实践的基础上,提供了标准的管理模式;通过标准的业务架构:多会计准则、多币别、多地点、多组织、多税制应用框架等,有效支持企业的运营管理;K/3Cloud提供了标准的业务建模:35种标准ERP领域模型、1046种模型元素、21243种模型元素属性组合,288个业务服务构件,让企业及伙伴可快速构建出行业化及个性化的应用。
对接目标系统:聚水潭
聚水潭是SaaS协同平台、电商ERP软件。聚水潭成立于2014年,创始人兼CEO骆海东拥有近三十年传统及电商ERP的研发和实施部署经验。聚水潭创建之初,以电商SaaSERP切入市场,凭借出色的产品和服务,快速获得市场的肯定。
数据对接方案
异构系统具有非常丰富的业务流程、复杂的系统架构和服务接口。在很多情况下,这两个系统都是分别独立部署和运行的,各自拥有不同的技术栈和编程模型,甚至两者在系统平台、技术平台和编程语言上是完全异构的。那么对接就需要根据接口配置对应的规则,例如取数就要根据查询接口获取金蝶云星空的数据,并且根据对应的条件进行取数,目标系统就必须根据目标系统的格式,以及获取的数据进行加工处理后进行写入到聚水潭中。轻易云集成平台的可视化配置轻松实现。


金蝶云星空接口明细
- 接口:executeBillQuery
- 接口名称:组装拆卸单查询(成品)
- 接口方法:POST
请求参数
| 字段 | 名称 | 类型 |
| FQty | 数量 | string |
| FBillNo | 单据编号 | string |
| Fee_ETY | 费用 | string |
| FSubProOwnerIdH_FNumber | 子件货主 | string |
| FLOT_FNumber | 批号 | string |
| FStockID_FNumber | 仓库 | string |
| FOwnerID_FNumber | 货主 | string |
| FOwnerTypeID | 货主类型 | string |
| FBomID | BOM版本 | string |
| FOwnerTypeIdHead | 成品货主类型 | string |
| FormId | 业务对象表单Id | string |
| FKeeperTypeID | 保管者类型 | string |
| FRowType | 行类型 | string |
| FDate | 日期 | string |
| FUnitID_FNumber | 单位 | string |
| FEE | 费用 | string |
| FSubProOwnTypeIdH | 子件货主类型 | string |
| FBillTypeID | 单据类型 | string |
| FProduceDate | 生产日期 | string |
| FAffairType | 事务类型 | string |
| FCreateDate | 创建日期 | string |
| FKeeperID_FNumber | 保管者 | string |
| FEntity_FEntryID | FEntity_FEntryID | string |
| Limit | 最大行数 | string |
| FMTONO | 计划跟踪号 | string |
| FieldKeys | 需查询的字段key集合 | array |
| FStockStatusID | 库存状态 | string |
| FStockOrgId_FNumber | 库存组织 | string |
| FEXPIRYDATE | 有效期至 | string |
| FilterString | 过滤条件 | string |
| TopRowCount | 返回总行数 | int |
| FDeptID_FNumber | 部门 | string |
| FNote | 备注 | string |
| FModifyDate | 最后修改日期 | string |
| StartRow | 开始行索引 | string |
| FDocumentStatus | 单据状态 | string |
| FDescription | 备注 | string |
| FCANCELDATE | 作废日期 | string |
| FID | 实体主键 | string |
| FSrcBillNo | 源单编号 | string |
| FMaterialID_FNumber | 物料编码 | string |
| FAPPROVEDATE | 审核日期 | string |
| FSrcBillTypeId | 源单类型 | string |
| FOwnerIdHead_FNumber | 成品货主 | string |
| FMaterialID_FBARCODE | 物料条码 | string |
| FCANCELSTATUS | 作废状态 | string |
响应参数
| 字段 | 名称 | 类型 | 描述 |
| FID | 实体主键 | string | |
| FBillNo | 单据编号 | string | |
| FDocumentStatus | 单据状态 | string | |
| FStockOrgId_FNumber | 库存组织 | string | |
| FDate | 日期 | string | |
| FBillTypeID | 单据类型 | string | |
| FOwnerTypeIdHead | 成品货主类型 | string | |
| FOwnerIdHead_FNumber | 成品货主 | string | |
| FAffairType | 事务类型 | string | |
| FEE | 费用 | string | |
| FDeptID_FNumber | 部门 | string | |
| FNote | 备注 | string | |
| FCreateDate | 创建日期 | string | |
| FModifyDate | 最后修改日期 | string | |
| FAPPROVEDATE | 审核日期 | string | |
| FCANCELDATE | 作废日期 | string | |
| FCANCELSTATUS | 作废状态 | string | |
| FSubProOwnTypeIdH | 子件货主类型 | string | |
| FSubProOwnerIdH_FNumber | 子件货主 | string | |
| FRowType | 行类型 | string | |
| FMaterialID_FNumber | 物料编码 | string | |
| FMaterialID_FBARCODE | 物料编码 | string | |
| FUnitID_FNumber | 单位 | string | |
| FQty | 数量 | string | |
| Fee_ETY | 费用 | string | |
| FStockID_FNumber | 仓库 | string | |
| FStockStatusID | 库存状态 | string | |
| FDescription | 备注 | string | |
| FMTONO | 计划跟踪号 | string | |
| FOwnerTypeID | 货主类型 | string | |
| FOwnerID_FNumber | 货主 | string | |
| FKeeperTypeID | 保管者类型 | string | |
| FKeeperID_FNumber | 保管者 | string | |
| FBomID | BOM版本 | string | |
| FProduceDate | 生产日期 | string | |
| FEXPIRYDATE | 有效期至 | string | |
| FLOT_FNumber | 批号 | string | |
| FSrcBillTypeId | 源单类型 | string | |
| FSrcBillNo | 源单编号 | string | |
| FEntity_FEntryID | FEntity_FEntryID | string | |
聚水潭接口明细
- 调用接口:jushuitan.otherinout.upload
- 接口名称:新建其它出入库(新)
- 方法:POST
请求参数
| 字段 | 字段名称 | 类型 | 配置值 |
| is_confirm | 是否自动确认单据 | string | true |
| wms_co_id | 分仓编号 | string | 11084916 |
| type | 出入库类型: in是入库 out是出库 | string | in |
| external_id | 外部单号 | string | {{FBillNo}}ZZin |
| warehouse | 主仓=1,销退仓=2, 进货仓=3,次品仓 = 4 | string | 3 |
| drp_co_name | 出库类型 | string | 组装成品入库 |
| receiver_name | 收件人姓名 | string | |
| receiver_mobile | 收件人手机号 | string | |
| receiver_state | 收件地址省 | string | |
| receiver_city | 收件地址市 | string | |
| receiver_district | 收件地址区 | 县 | string | |
| receiver_address | 收件详细地址 | string | |
| items | 商品列表 | array | items |
| items.remark | 备注 | string | |
| items.sku_id | 商品编码 | string | {{items.FMaterialID_FNumber}} |
| items.qty | 数量 | string | {{items.FQty}} |
| items.batch_id | 批次单号,系统中需开启相关配置 | string | {{items.FLOT_FNumber}} |
| items.produced_date | 生产日期,系统中需开启相关配置 | string | {{items.FProduceDate}} |
| items.expiration_date | 有效期至,系统中需开启相关配置 | string | {{items.FEXPIRYDATE}} |
| items.supplier_id | 供应商编号 | int | 3954100 |
| items.supplier_name | 供应商名称 | string | 广州北纬纯净食品有限公司 |
响应参数
| 字段 | 字段名称 | 类型 | 配置值 |
| code | 非0失败 | string | |
| msg | 错误描述 | string | |
| data | 返回内容 | array | |
| data.external_id | 外部单号 | string | |
| data.io_id | 系统内部单号 | string | |
系统对接总览
从API层面解决企业烟囱式业务系统集成现状,实现深度的业务流程拉通金蝶云星空到聚水潭之间数据集成;通过API连接各业务系统,复用已有的业务系统能力,让集成架构、服务关系更清晰。使用统一的API管理平台,对API进行显性化、可视化,使所有API服务成为企业的数字资产,提升复用率和价值。全面管控企业的API资产,梳理现有业务系统的API。实现API文档的统一管理,建立API的上线、下线、监控的统一管理体系及标准规范。已链接和打通主流SaaS系统超过100+,快速对接各种API接口,实现云上云下的互联互通。将SaaS和本地业务系统联接起来,打破时间与空间界限,打通原有核心数据及SaaS应用,构建可平滑演进的企业IT架构。

