从金蝶云星空到聚水潭通过接口配置打通数据

对接源平台:金蝶云星空
金蝶K/3Cloud(金蝶云星空)是移动互联网时代的新型ERP,是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”,旨在帮助企业打造面向新时代的生态互联与协同平台,围绕生态中的每个角色,提供随手可得的云服务,最终实现敏捷协同,智慧运营的企业运营新境界。整个产品采用SOA架构,完全基于BOS平台组建而成,业务架构上贯穿流程驱动与角色驱动思想,结合中国管理模式与中国管理实践积累,精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建,支持跨数据库应用,支持本地部署、私有云部署与公有云部署三种部署方式,同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业,其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。
对接系统:聚水潭
聚水潭SaaSERP于2014年4月上线,目前累计超过2.5万商家注册使用,成为淘宝应用服务市场ERP类目商家数和商家月订单增速最快的ERP。2014年及2015年“双十一”当天,聚水潭SaaSERP平稳、安全、顺畅的处理了近千万订单,超过了淘宝对ERP系统吞吐量极限要求的16倍,成为行业里的新标杆。截止目前,聚水潭客户已超2.5万家,其中有南极人、POVOS奔腾,恒源祥,柚子美衣,洁丽雅,FLYCO飞科,波司登,满速,欧丝璐等,并与知名电商圈“老A电商学院”达成深度合作。
数据集成方案配置
轻易云集成平台的对接是通过一个个对应的对接方案去形成两个系统对接的连线,所以对接方案的配置极其重要,方案可以选择一键复制,轻易云有海量的对接方案可支持一键复制,复制后直接启动使用(对接方案借鉴可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息。或者可以通过手工配置,配置只要确认源平台:金蝶云星空的取数逻辑,例如什么时间取什么样的数据。即可完成配置,目标平台:聚水潭,把获取的数据组装成目标系统需要的格式进行写入。

金蝶云星空接口明细
- 调用接口:executeBillQuery
- 接口名称:组装拆卸单查询
- 方法:POST
请求参数
字段 | 字段名称 | 类型 | 配置值 |
FID | 实体主键 | string | FID |
FBillNo | 单据编号 | string | FBillNo |
FDocumentStatus | 单据状态 | string | FDocumentStatus |
FStockOrgId_FNumber | 库存组织 | string | FStockOrgId.FNumber |
FDate | 日期 | string | FDate |
FBillTypeID | 单据类型 | string | FBillTypeID |
FOwnerTypeIdHead | 成品货主类型 | string | FOwnerTypeIdHead |
FOwnerIdHead_FNumber | 成品货主 | string | FOwnerIdHead.FNumber |
FAffairType | 事务类型 | string | FAffairType |
FEE | 费用 | string | FEE |
FDeptID_FNumber | 部门 | string | FDeptID.FNumber |
FNote | 备注 | string | FNote |
FCreateDate | 创建日期 | string | FCreateDate |
FModifyDate | 最后修改日期 | string | FModifyDate |
FAPPROVEDATE | 审核日期 | string | FAPPROVEDATE |
FCANCELDATE | 作废日期 | string | FCANCELDATE |
FCANCELSTATUS | 作废状态 | string | FCANCELSTATUS |
FSubProOwnTypeIdH | 子件货主类型 | string | FSubProOwnTypeIdH |
FSubProOwnerIdH_FNumber | 子件货主 | string | FSubProOwnerIdH.FNumber |
FMaterialIDSETY_FNumber | 物料编码 | string | FMaterialIDSETY.FNumber |
FMaterialIDSETY_FBARCODE | 物料条码 | string | FMaterialIDSETY.FBARCODE |
FUnitIDSETY_FNumber | 单位 | string | FUnitIDSETY.FNumber |
FQtySETY | 数量 | string | FQtySETY |
FCostProportion | 成本拆分比例 | string | FCostProportion |
FStockIDSETY_FNumber | 仓库 | string | FStockIDSETY.FNumber |
FStockStatusIDSETY | 库存状态 | string | FStockStatusIDSETY |
FDescriptionSETY | 备注 | string | FDescriptionSETY |
FMTONOSETY | 计划跟踪号 | string | FMTONOSETY |
FProjectNoSETY | 项目编号 | string | FProjectNoSETY |
FOwnerTypeIDSETY | 货主类型 | string | FOwnerTypeIDSETY |
FOwnerIDSETY_FNumber | 货主 | string | FOwnerIDSETY.FNumber |
FKeeperTypeIDSETY | 保管者类型 | string | FKeeperTypeIDSETY |
FKeeperIDSETY | 保管者 | string | FKeeperIDSETY |
FPriceSETY | 成本价 | string | FPriceSETY |
FAmountSETY | 总成本 | string | FAmountSETY |
FLOTSETY_FNumber | 批号 | string | FLOTSETY.FNumber |
FProduceDateSETY | 生产日期 | string | FProduceDateSETY |
FEXPIRYDATESETY | 有效期至 | string | FEXPIRYDATESETY |
FSubEntity_FDetailID | FSubEntity_FDetailID | string | FSubEntity_FDetailID |
Limit | 最大行数 | string | {{PAGINATION_PAGE_SIZE}} |
StartRow | 开始行索引 | string | {{PAGINATION_START_ROW}} |
TopRowCount | 返回总行数 | int | |
FilterString | 过滤条件 | string | FApproveDate>='{{LAST_SYNC_TIME datetime}}' AND FDocumentStatus = 'C' AND FStockIDSETY.FNumber IN ( '11084916' ) and FAFFAIRTYPE = 'Assembly' AND FMaterialIDSETY.FIsSalseByNet=1 |
FieldKeys | 需查询的字段key集合 | array | |
FormId | 业务对象表单Id | string | STK_AssembledApp |
响应参数
字段 | 字段名称 | 类型 | 配置值 |
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 | |
FMaterialIDSETY_FNumber | 物料编码 | string | |
FMaterialIDSETY_FBARCODE | 物料条码 | string | |
FUnitIDSETY_FNumber | 单位 | string | |
FQtySETY | 数量 | string | |
FCostProportion | 成本拆分比例 | string | |
FStockIDSETY_FNumber | 仓库 | string | |
FStockStatusIDSETY | 库存状态 | string | |
FDescriptionSETY | 备注 | string | |
FMTONOSETY | 计划跟踪号 | string | |
FProjectNoSETY | 项目编号 | string | |
FOwnerTypeIDSETY | 货主类型 | string | |
FOwnerIDSETY_FNumber | 货主 | string | |
FKeeperTypeIDSETY | 保管者类型 | string | |
FKeeperIDSETY | 保管者 | string | |
FPriceSETY | 成本价 | string | |
FAmountSETY | 总成本 | string | |
FLOTSETY_FNumber | 批号 | string | |
FProduceDateSETY | 生产日期 | string | |
FEXPIRYDATESETY | 有效期至 | string | |
FSubEntity_FDetailID | FSubEntity_FDetailID | string | |
聚水潭接口明细
- API:jushuitan.otherinout.upload
- NAME:新建其它出入库(新)
- METHOD:POST
请求参数
接口字段 | 字段名称 | 预设值 | 描述 |
is_confirm | 是否自动确认单据 | false | 是否自动确认单据 |
wms_co_id | 分仓编号 | 11084916 | 分仓编号 |
type | 出入库类型: in是入库 out是出库 | out | 出入库类型: in是入库 out是出库 |
external_id | 外部单号 | {{FBillNo}}ZZout{{CURRENT_TIME}} | 外部单号 |
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.FMaterialIDSETY_FNumber}} | 商品编码 |
items.qty | 数量 | {{items.FQtySETY}} | 数量 |
items.batch_id | 批次单号,系统中需开启相关配置 | {{items.FLOTSETY_FNumber}} | 批次单号,系统中需开启相关配置 |
items.produced_date | 生产日期,系统中需开启相关配置 | {{items.FProduceDateSETY}} | 生产日期,系统中需开启相关配置 |
items.expiration_date | 有效期至,系统中需开启相关配置 | {{items.FEXPIRYDATESETY}} | 有效期至,系统中需开启相关配置 |
响应参数
接口字段 | 字段名称 | 预设值 | 描述 |
code | 非0失败 | | 非0失败 |
msg | 错误描述 | | 错误描述 |
data | 返回内容 | | 返回内容 |
data.external_id | 外部单号 | | 外部单号 |
data.io_id | 系统内部单号 | | 系统内部单号 |
系统打通概况
通过数据集成平台可视化的快速配置调用接口打通金蝶云星空与聚水潭之间的数据接口,使得两个系统之间的对接更加快捷、稳定。轻易云数据集成平台打破信息孤岛、适配多种场景、降低运营成本、缩短开发周期、灵活调度配置是这种多系统数据打通时的特性优势。采用元数据模型驱动的低代码集成工具,基于系统预置的数据模型、映射、编排、日志、脚本等集成核心引擎,通过可视化配置,快速实现客户灵活多变的动态集成需求,让集成开发简单、执行过程可靠、问题风险可控。
