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

对接系统:金蝶云星空
金蝶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架构。

