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

对接系统伯俊ERP
未来,伯俊科技也会砥砺前行,不断为品牌提供更全面的零售终端致胜利器。伯俊科技始终坚持创新发展,探索大零售行业发力方向及突破机会,不断总结提炼当前及未来的新场景新玩法,优化升级自身体系的同时陪伴客户持续性发展。
对接目标系统:金蝶云星空
金蝶K/3Cloud在总结百万家客户管理最佳实践的基础上,提供了标准的管理模式;通过标准的业务架构:多会计准则、多币别、多地点、多组织、多税制应用框架等,有效支持企业的运营管理;K/3Cloud提供了标准的业务建模:35种标准ERP领域模型、1046种模型元素、21243种模型元素属性组合,288个业务服务构件,让企业及伙伴可快速构建出行业化及个性化的应用。
配置集成方案
数据集成平台对应的配置伯俊ERP与金蝶云星空的对接只要三步就能完成两个系统之间的数据对接。第一步根据伯俊ERP的接口参数要求记录在轻易云集成平台。第二步配置伯俊ERP与金蝶云星空之间的字段对应关系(更多方案可借鉴轻易云数据集成社区论坛中找到相关方案信息)第三步完成方案的检查参数设置:传递时间、重试次数、是否启动、前置条件等上线运行。

伯俊ERP接口明细
- API:/rest/excute
- NAME:表头表体组合查询
- METHOD:POST
请求参数
接口字段 | 字段名称 | 预设值 | 描述 |
start | 页码 | | 从结果集合的哪一行开始获取记录(从0计算) |
range | 页数 | 500 | 最多获取start行开始的多少条记录,考虑系统 性能,最大值将由系统参数设定 (Bos3.0.properties#rest.query.max.range ,缺省为100) |
count | 是否计算总数 | true | |
columns | 需要查询的字段 | ID,DOCNO | 需要查询的字段,不传默认查全部,用英文逗号隔开字段 |
params | 过滤参数 | | 结构,称为Expression,为嵌套二叉树结构 |
params.expr1 | 参数-1 | | |
params.expr1.condition | 条件 | WRITE_TIME between to_date('{{LAST_SYNC_TIME datetime}}','yyyy-mm-dd hh24:mi:ss') and to_date('{{CURRENT_TIME datetime}}','yyyy-mm-dd hh24:mi:ss') | |
params.expr1.column | 字段 | | |
params.expr1.expr2 | 参数-2 | | |
params.expr1.expr2.condition | 条件 | 2 | |
params.expr1.expr2.column | 字段 | BILLTYPE | |
params.expr1.expr2.combine | 组合关系 | AND | “and” “or” “and not” “or not”,若设置,必填expr1和expr2属性,忽略 column和condition。 |
params.table | 表名 | KD_SALE | |
params.command | 操作命令 | Query | |
params.reftables | 关联表 | 5194 | {"name":"StringToArray","params":","} |
响应参数
接口字段 | 字段名称 | 预设值 | 描述 |
OWNERID | 创建人 | | autoFillResponse |
CREATIONDATE | 创建时间 | | _autoFillResponse |
BILLDATE | 单据日期 | | autoFillResponse |
DESTNAME | DESTNAME | | _autoFillResponse |
MODIFIEDDATE | 修改时间 | | autoFillResponse |
EDIFLAG | 接口标记 | | _autoFillResponse |
WRITE_DATE | 写入时间 | | autoFillResponse |
ORGANIZATION | 财务组织 | | _autoFillResponse |
MODIFIERID | 修改人 | | autoFillResponse |
BILLTYPE | 单据类型 | | _autoFillResponse |
DOCNO | 单据编号 | | autoFillResponse |
CUSTOMER_CODE | 客户编码 | | _autoFillResponse |
reftables | reftables | | autoFillResponse |
reftables.DOCNO | 单据编号 | | _autoFillResponse |
reftables.NO | 款号 | | autoFillResponse |
reftables.PRICELIST | 标准价 | | _autoFillResponse |
reftables.QTY | 数量 | | autoFillResponse |
reftables.PRICEACTUAL | 销售价 | | _autoFillResponse |
reftables.DISCOUNT | 折扣 | | autoFillResponse |
reftables.TOT_AMT_ACTUAL | 金额 | | _autoFillResponse |
reftables.KD_DISCOUNT | 组织折扣 | | autoFillResponse |
reftables.READ_TIME | 提取时间 | | _autoFillResponse |
reftables.RESULTS | 问题原因 | | autoFillResponse |
reftables.EDIFLAG | 接口标记 | | _autoFillResponse |
reftables.RESULTS | 问题原因 | | autoFillResponse |
reftables.OWNERID_TRUENAME | 创建人 | | _autoFillResponse |
reftables.CREATIONDATE | 创建时间 | | autoFillResponse |
reftables.MODIFIERID_TRUENAME | 修改人 | | _autoFillResponse |
reftables.ID | ID | | _autoFillResponse |
reftables.ORIGNMAE | 发货仓库 | | |
金蝶云星空接口明细
- 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 | |
系统打通概况
随着企业数字化业务的深入发展,对于企业的 IT 或者 CIO 来讲,正在面临一个愈发重要的问题——系统的结构太复杂了,尤其是头部企业,至少有十多套系统,这些系统之间的蛛网状的接口如果经常出问题。企业内部以及企业内部与外部建立起越来越多的业务应用系统,如何整合企业的现有IT资源,使企业中计算机孤岛式的应用向集体协作的方向发展,发挥资源效益的最大化,降低企业成本,正在逐渐成为企业关注的重要问题。用户希望企业内所有系统集成在一个平台上,操作统一,以节省培训时间。使用在轻易云应用集成平台 + MDM基础数据平台的解决方案中,轻易云应用集成平台负责实现异构、分布式系统之间互联互通,实现服务API治理以及数据传输交换。通过轻易云预置的各种适配器组件,连接现有各孤立应用系统,以图形化、拖拽方式构建集成流程和服务,提高应用系统集成工作效率,降低异构系统集成风险。针对未来可能出现的业务需求变更,在应用集成平台上进行动态调整,实现各应用系统之间的集成策略平滑升级。

