从伯俊ERP到金蝶云星空通过接口配置打通数据

接通系统:伯俊ERP
伯俊科技拥有近千人的团队、出色的本地化服务能力及强劲的研发创新实力,在深耕零售行业24年中,成功研发企业级ERP系统、OMS订单管理系统、门店收银系统、门店管理软硬件一体机等。探索零售行业数字化的进程中,伯俊科技成功落地百余全渠道项目,积累丰富的业务中台、数据中台落地经验。
集成系统:金蝶云星空
金蝶K/3Cloud(金蝶云星空)是移动互联网时代的新型ERP,是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”,旨在帮助企业打造面向新时代的生态互联与协同平台,围绕生态中的每个角色,提供随手可得的云服务,最终实现敏捷协同,智慧运营的企业运营新境界。整个产品采用SOA架构,完全基于BOS平台组建而成,业务架构上贯穿流程驱动与角色驱动思想,结合中国管理模式与中国管理实践积累,精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建,支持跨数据库应用,支持本地部署、私有云部署与公有云部署三种部署方式,同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业,其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。
配置集成方案
异构系统具有非常丰富的业务流程、复杂的系统架构和服务接口。在很多情况下,这两个系统都是分别独立部署和运行的,各自拥有不同的技术栈和编程模型,甚至两者在系统平台、技术平台和编程语言上是完全异构的。那么对接就需要根据接口配置对应的规则,例如取数就要根据查询接口获取伯俊ERP的数据,并且根据对应的条件进行取数,目标系统就必须根据目标系统的格式,以及获取的数据进行加工处理后进行写入到金蝶云星空中。轻易云集成平台的可视化配置轻松实现。

伯俊ERP接口明细
- 接口:/rest/excute
- 接口名称:表头表体组合查询
- 接口方法:POST
请求参数
字段 | 名称 | 类型 | 描述 |
start | 页码 | string | 从结果集合的哪一行开始获取记录(从0计算) |
range | 页数 | string | 最多获取start行开始的多少条记录,考虑系统 性能,最大值将由系统参数设定 (Bos3.0.properties#rest.query.max.range ,缺省为100) |
count | 是否计算总数 | string | |
columns | 需要查询的字段 | string | 需要查询的字段,不传默认查全部 |
params | 过滤参数 | object | 结构,称为Expression,为嵌套二叉树结构 |
params.expr1 | 参数-1 | object | 通过combine指明两个Expression之间的关系 |
params.expr1.expr1 | 参数-1 | object | |
params.expr1.expr1.condition | 条件 | string | |
params.expr1.expr1.column | 字段 | string | |
params.expr1.expr1.expr2 | 参数-2 | object | |
params.expr1.expr1.expr2.condition | 条件 | string | |
params.expr1.expr1.expr2.column | 字段 | string | |
params.expr1.expr1.expr2.combine | 组合关系 | string | “and” “or” “and not” “or not”,若设置,必填expr1和expr2属性,忽略 column和condition。 |
params.expr1.expr2 | 参数-2 | object | |
params.expr1.expr2.condition | 条件 | string | |
params.expr1.expr2.column | 字段 | string | |
params.expr1.expr2.combine | 组合关系 | string | “and” “or” “and not” “or not”,若设置,必填expr1和expr2属性,忽略 column和condition。 |
params.table | 表名 | string | |
params.command | 操作命令 | string | |
params.reftables | 关联表 | string | |
响应参数
字段 | 名称 | 类型 | 描述 |
OWNERID | 创建人 | string | autoFillResponse |
CREATIONDATE | 创建时间 | string | _autoFillResponse |
BILLDATE | 单据日期 | string | autoFillResponse |
BILLSTORE | 店仓 | string | _autoFillResponse |
EDIFLAG | 接口标记 | string | autoFillResponse |
SUPPLIER | 供应商 | string | _autoFillResponse |
BILLDATE | 业务日期 | string | autoFillResponse |
PO_DOCNO | 订单编号 | string | _autoFillResponse |
ORGANIZATION | 财务组织 | string | autoFillResponse |
IS_MODID | 是否改标 | string | _autoFillResponse |
ORGANIZATION | 财务组织 | string | autoFillResponse |
BILLTYPE | 单据类型 | string | _autoFillResponse |
DOCNO | 单据编号 | string | autoFillResponse |
reftables | reftables | array | _autoFillResponse |
reftables.DOCNO | 单据编号 | string | autoFillResponse |
reftables.NO | 款号 | string | _autoFillResponse |
reftables.PRICELIST | 标准价 | string | autoFillResponse |
reftables.QTY | 数量 | string | _autoFillResponse |
reftables.PRECOST | 价格 | string | autoFillResponse |
reftables.TOT_AMT_ACTUAL | 金额 | string | _autoFillResponse |
reftables.WRITE_TIME | 写入时间 | string | autoFillResponse |
reftables.READ_TIME | 提取时间 | string | _autoFillResponse |
reftables.EDIFLAG | 接口标记 | string | autoFillResponse |
reftables.RESULTS | 问题原因 | string | _autoFillResponse |
reftables.ID | ID | string | _autoFillResponse |
金蝶云星空接口明细
- 调用接口:batchSave
- 接口名称:应付单新增
- 方法:POST
请求参数
字段 | 字段名称 | 类型 | 配置值 |
FBillNo | 单据编号 | string | {{DOCNO}} |
FBillTypeID | 单据类型 | string | YFD01_SYS |
FDOCUMENTSTATUS | 单据状态 | string | |
FDATE | 业务日期 | string | {{CREATIONDATE}} |
FENDDATE_H | 到期日 | string | {{reftables.READ_TIME}} |
FSUPPLIERID | 供应商 | string | {{SUPPLIER}} |
FSetAccountType | 立账类型 | string | |
FSETTLEORGID | 结算组织 | string | {{ORGANIZATION}} |
FPAYORGID | 付款组织 | string | {{ORGANIZATION}} |
FEntityDetail | 明细 | array | reftables |
FEntityDetail.FMATERIALID | 物料编码 | string | {{reftables.NO}} |
FEntityDetail.FTaxPrice | 含税单价 | string | {{reftables.PRICELIST}} |
FEntityDetail.FEntryTaxRate | 税率 | string | 0.13 |
FEntityDetail.FPriceQty | 计价数量 | string | {{reftables.QTY}} |
FEntityDetail.FLot | 批号 | string | |
FEntityDetail.FSOURCETYPE | 源单类型 | string | |
FEntityDetail.FSourceBillNo | 源单编号 | string | {{SOURCE_DOCNO}} |
FEntityDetail.FEntityDetail_Link | 关联关系 | array | |
FEntityDetail.FEntityDetail_Link.FEntityDetail_Link_FSTableName | 源单表名 | string | T_PUR_MRBENTRY |
FEntityDetail.FEntityDetail_Link.FEntityDetail_Link_FRuleId | 下推关系 | string | AP_MRBToPayableMap |
FEntityDetail.FEntityDetail_Link.FEntityDetail_Link_FSBillId | 源单ID | string | findCollection find FID from d5a040f4-20a9-3978-8169-21453e4d705c where FBillNo={{SOURCE_DOCNO}} |
FEntityDetail.FEntityDetail_Link.FEntityDetail_Link_FSId | 表体ID | string | _findCollection find FPURMRBENTRY_FEntryID from d5a040f4-20a9-3978-8169-21453e4d705c where FBillNo={{SOURCE_DOCNO}} FMaterialId_FNumber={{reftables.NO}} |
FEntityDetail.FormId | 业务对象表单Id | string | AP_Payable |
FEntityDetail.Operation | 执行的操作 | string | BatchSave |
FEntityDetail.IsVerifyBaseDataField | 验证基础资料 | bool | false |
FEntityDetail.IsAutoSubmitAndAudit | 提交并审核 | bool | true |
系统对接概况
通过数据集成平台可视化的快速配置调用接口打通伯俊ERP与金蝶云星空之间的数据接口,使得两个系统之间的对接更加快捷、稳定。轻易云数据集成平台打破信息孤岛、适配多种场景、降低运营成本、缩短开发周期、灵活调度配置是这种多系统数据打通时的特性优势。采用元数据模型驱动的低代码集成工具,基于系统预置的数据模型、映射、编排、日志、脚本等集成核心引擎,通过可视化配置,快速实现客户灵活多变的动态集成需求,让集成开发简单、执行过程可靠、问题风险可控。

