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

来源系统:伯俊ERP
伯俊科技拥有近千人的团队、出色的本地化服务能力及强劲的研发创新实力,在深耕零售行业24年中,成功研发企业级ERP系统、OMS订单管理系统、门店收银系统、门店管理软硬件一体机等。探索零售行业数字化的进程中,伯俊科技成功落地百余全渠道项目,积累丰富的业务中台、数据中台落地经验。
集成系统:金蝶云星空
金蝶K/3Cloud在总结百万家客户管理最佳实践的基础上,提供了标准的管理模式;通过标准的业务架构:多会计准则、多币别、多地点、多组织、多税制应用框架等,有效支持企业的运营管理;K/3Cloud提供了标准的业务建模:35种标准ERP领域模型、1046种模型元素、21243种模型元素属性组合,288个业务服务构件,让企业及伙伴可快速构建出行业化及个性化的应用。
多系统对接方案配置
通过轻易云系统数据集成平台:数据集成方案。选择开始创建数据集成方案菜单。在方案配置表单中选择对应的源业务系统:伯俊ERP,然后选择对应的连接器。选择对应的/rest/excute作为数据对接来源。然后再写入目标平台配置目标系统为金蝶云星空,并且选择对应连接器(关于金蝶云星空的接口如何连接可以在轻易云数据集成社区论坛bbs.qeasy.cloud中找到相关信息)。选择好对应的batchSave接口作为数据写入动作完成第一步的接口配置。


伯俊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 | |
params.expr1.condition | 条件 | string | |
params.expr1.column | 字段 | string | |
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 | {"name":"StringToArray","params":","} |
响应参数
字段 | 名称 | 类型 | 描述 |
OWNERID | 创建人 | string | autoFillResponse |
CREATIONDATE | 创建时间 | string | _autoFillResponse |
BILLDATE | 单据日期 | string | autoFillResponse |
DESTNAME | DESTNAME | string | _autoFillResponse |
MODIFIEDDATE | 修改时间 | string | autoFillResponse |
EDIFLAG | 接口标记 | string | _autoFillResponse |
WRITE_DATE | 写入时间 | string | autoFillResponse |
ORGANIZATION | 财务组织 | string | _autoFillResponse |
MODIFIERID | 修改人 | string | autoFillResponse |
BILLTYPE | 单据类型 | string | _autoFillResponse |
DOCNO | 单据编号 | string | autoFillResponse |
CUSTOMER_CODE | 客户编码 | string | _autoFillResponse |
reftables | reftables | array | autoFillResponse |
reftables.DOCNO | 单据编号 | string | _autoFillResponse |
reftables.NO | 款号 | string | autoFillResponse |
reftables.PRICELIST | 标准价 | string | _autoFillResponse |
reftables.QTY | 数量 | string | autoFillResponse |
reftables.PRICEACTUAL | 销售价 | string | _autoFillResponse |
reftables.DISCOUNT | 折扣 | string | autoFillResponse |
reftables.TOT_AMT_ACTUAL | 金额 | string | _autoFillResponse |
reftables.KD_DISCOUNT | 组织折扣 | string | autoFillResponse |
reftables.READ_TIME | 提取时间 | string | _autoFillResponse |
reftables.RESULTS | 问题原因 | string | autoFillResponse |
reftables.EDIFLAG | 接口标记 | string | _autoFillResponse |
reftables.RESULTS | 问题原因 | string | autoFillResponse |
reftables.OWNERID_TRUENAME | 创建人 | string | _autoFillResponse |
reftables.CREATIONDATE | 创建时间 | string | autoFillResponse |
reftables.MODIFIERID_TRUENAME | 修改人 | string | _autoFillResponse |
reftables.ID | ID | string | _autoFillResponse |
reftables.ORIGNMAE | 发货仓库 | string | |
金蝶云星空接口明细
- API:batchSave
- NAME:销售退货新增
- METHOD:POST
请求参数
接口字段 | 字段名称 | 预设值 | 描述 |
FBillTypeID | 单据类型 | XSTHD01_SYS | |
FBillNo | 单据编号 | {{DOCNO}} | |
FSaleOrgId | 销售组织 | {{ORGANIZATION}} | |
FDate | 日期 | {{BILLDATE}} | |
FStockOrgId | 库存组织 | findCollection find FUseOrgId from dc968bc0-4133-3ddd-97d0-bbbd1a6818cc where F_SSLP_Text1={{DESTCODE}} FUseOrgId={{ORGANIZATION}} | |
FRetcustId | 退货客户 | {{CUSTOMER_CODE}} | |
FHeadNote | 备注 | {{DESCRIPTION}} | |
FEntity | 明细信息 | reftables | |
FEntity.FMaterialId | 物料编码 | {{reftables.NO}} | |
FEntity.FRealQty | 实退数量 | _function abs({{reftables.QTY}}) | |
FEntity.FTaxPrice | 含税单价 | function abs({{reftables.PRICEACTUAL}}) | |
FEntity.FIsFree | 是否赠品 | | |
FEntity.FEntryTaxRate | 税率% | | |
FEntity.FStockId | 仓库 | _function case when '{{CK_NEW}}'='' then '{{DESTCODE}}' else '{{CK_NEW}}' end | |
FEntity.FDeliveryDate | 退货日期 | {{reftables.CREATIONDATE}} | |
FEntity.FNote | 备注 | | |
FEntity.FStockstatusId | FStockstatusId | KCZT01_SYS | |
FEntity.F_wk_zk | 折扣 | {{reftables.DISCOUNT}} | |
FEntity.F_wk_DPJ | 标准价 | {{reftables.PRICELIST}} | |
FEntity.F_wk_ZKL | 组织折扣 | {{reftables.zkl}}{{reftables.KD_DISCOUNT}} | |
FEntity.FOwnerTypeId | 货主类型 | BD_OwnerOrg | |
FEntity.FOwnerId | 货主 | _findCollection find FCreateOrgId_FNumber from 0b1afab3-a35b-3ee4-8a26-3dd62dfa8739 where FNumber={{reftables.NO}} _endFind | |
FEntity.FAmount | 金额 | {{reftables.TOT_AMT_ACTUAL}} | |
FEntity.SubHeadEntity | 财务信息 | | |
FEntity.SubHeadEntity.FSettleOrgId | 结算组织 | {{ORGANIZATION}} | |
FEntity.SubHeadEntity.FSETTLECURRID | 结算币别 | PRE001 | |
FEntity.SubHeadEntity.FormId | 业务对象表单Id | SAL_RETURNSTOCK | |
FEntity.SubHeadEntity.Operation | 执行的操作 | Save | |
FEntity.SubHeadEntity.IsAutoSubmitAndAudit | 提交并审核 | true | |
FEntity.SubHeadEntity.IsVerifyBaseDataField | 验证基础资料 | true | |
系统对接概况
全面管控企业的API资产,梳理现有业务系统的API。实现API文档的统一管理,建立API的上线、下线、监控的统一管理体系。API低代码开发平台能够实现低代码或零代码一键发布API服务,很好地解决企业用户上面的问题。轻易云应用集成主要解决已有应用系统的无序蔓延现象,减少各业务系统间的维护成本,减少各应用系统的操作系统、开发语言、访问协议、通信技术多而杂、整合难度大的问题,将企业数据平滑对接,减少信息竖井。
