伯俊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 |
DESCRIPTION | 备注 | string | autoFillResponse |
BILLTYPE | 单据类型 | string | _autoFillResponse |
DOCNO | 单据编号 | string | autoFillResponse |
reftables | reftables | array | _autoFillResponse |
reftables.DOCNO | 单据编号 | string | autoFillResponse |
reftables.NO | 款号 | string | _autoFillResponse |
reftables.REL_NO | 关联款号 | string | autoFillResponse |
reftables.PRICELIST | 标准价 | string | _autoFillResponse |
reftables.QTY | 数量 | string | autoFillResponse |
reftables.PRECOST | 价格 | string | _autoFillResponse |
reftables.TAX_RATE | 税率 | 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.OWNERID_TRUENAME | 创建人 | string | autoFillResponse |
reftables.CREATIONDATE | 创建时间 | string | _autoFillResponse |
reftables.MODIFIERID_TRUENAME | 修改人 | string | autoFillResponse |
reftables.MODIFIEDDATE | 修改时间 | string | |
reftables.ID | ID | string | _autoFillResponse |
金蝶云星空接口明细
- API:batchSave
- NAME:调拨单新增
- METHOD:POST
请求参数
接口字段 | 字段名称 | 预设值 | 描述 |
FBillNo | 单据编号 | {{DOCNO}} | 单据编号 |
FBillTypeID | 单据类型 | ZJDB01_SYS | 单据类型 |
FBizType | 业务类型 | NORMAL | 下拉列表 |
FTransferDirect | 调拨方向 | GENERAL | 下拉列表 |
FTransferBizType | 调拨类型 | InnerOrgTransfer | 下拉列表 |
FSaleOrgId | 销售组织 | {{ORGANIZATION}} | 组织 |
FSettleOrgId | 结算组织 | {{ORGANIZATION}} | 组织 |
FStockOutOrgId | 调出库存组织 | {{ORGANIZATION}} | 组织 |
FOwnerTypeOutIdHead | 调出货主类型 | | 多类别基础资料列表 |
FOwnerOutIdHead | 调出货主 | _findCollection find FCreateOrgId_FNumber from 0b1afab3-a35b-3ee4-8a26-3dd62dfa8739 where FNumber={{reftables_NO}} FUseOrgId_FNumber={{ORGANIZATION}} _endFind | 多类别基础资料 |
FStockOrgId | 调入库存组织 | {{ORGANIZATION}} | 组织 |
FSETTLECURRID | 结算币别 | | 基础资料 |
FDate | 日期 | {{BILLDATE}} | 日期 |
FNote | 备注 | {{DESCRIPTION}} | 多行文本 |
FBillEntry | 明细信息 | | 1 |
FBillEntry.FMaterialId | 物料编码 | {{reftables_NO}} | 基础资料 |
FBillEntry.FCMKBarCode | 零售条形码 | {{reftables_NO}} | 文本 |
FBillEntry.FQty | 调拨数量 | {{reftables_QTY}} | 数量 |
FBillEntry.FLot | 调出批号 | | 批次 |
FBillEntry.FSrcStockId | 调出仓库 | {{ORGANIZATION}} | 基础资料 |
FBillEntry.FSrcStockLocId | 调出仓位 | | 维度关联字段 |
FBillEntry.FDestStockId | 调入仓库 | {{ORGANIZATION}} | 基础资料 |
FBillEntry.FDestStockLocId | 调入仓位 | | 维度关联字段 |
FBillEntry.FNoteEntry | 备注 | {{DESCRIPTION}} | 多行文本 |
FBillEntry.FISFREE | 赠品 | | 复选框 |
FBillEntry.FormId | 业务对象表单Id | STK_TransferDirect | 必须填写金蝶的表单ID如😛UR_PurchaseOrder |
FBillEntry.IsAutoSubmitAndAudit | 提交并审核 | true | |
FBillEntry.IsVerifyBaseDataField | 验证基础资料 | false | 是否验证所有的基础资料有效性,布尔类,默认false(非必录) |
FBillEntry.Operation | 执行的操作 | Save | |
FBillEntry.InterationFlags | 允许负库存 | STK_InvCheckResult | 是否验证所有的基础资料有效性,布尔类,默认false(非必录) |
系统对接概况
随着企业数字化业务的深入发展,对于企业的 IT 或者 CIO 来讲,正在面临一个愈发重要的问题——系统的结构太复杂了,尤其是头部企业,至少有十多套系统,这些系统之间的蛛网状的接口如果经常出问题。企业内部以及企业内部与外部建立起越来越多的业务应用系统,如何整合企业的现有IT资源,使企业中计算机孤岛式的应用向集体协作的方向发展,发挥资源效益的最大化,降低企业成本,正在逐渐成为企业关注的重要问题。用户希望企业内所有系统集成在一个平台上,操作统一,以节省培训时间。使用在轻易云应用集成平台 + MDM基础数据平台的解决方案中,轻易云应用集成平台负责实现异构、分布式系统之间互联互通,实现服务API治理以及数据传输交换。通过轻易云预置的各种适配器组件,连接现有各孤立应用系统,以图形化、拖拽方式构建集成流程和服务,提高应用系统集成工作效率,降低异构系统集成风险。针对未来可能出现的业务需求变更,在应用集成平台上进行动态调整,实现各应用系统之间的集成策略平滑升级。


