伯俊ERP和金蝶云星空接口打通对接实战源系统:伯俊ERP 伯俊科技，依托在企业信息化建设方面的领先技术与实践积累，致力于帮助企业实现全渠道一盘货。伯俊提供数字经营的咨询与系统实施，助力企业信息化升级、加速数字化转型，覆盖零售市场中时尚鞋服、母婴内衣、珠宝饰品、食品酒水等多个行业，为5000+家机构及企业提供数字化建设服务。集成系统:金蝶云星空金蝶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 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 EDIFLAG 接口标记 string _autoFillResponse WRITE_DATE 写入时间 string autoFillResponse ORGANIZATION 财务组织 string _autoFillResponse DESCRIPTION 备注 string autoFillResponse BILLTYPE 单据类型 string _autoFillResponse DOCNO 单据编号 string autoFillResponse ORIGNMAE 零售店仓 string reftables reftables array _autoFillResponse reftables.DOCNO 单据编号 string autoFillResponse reftables.NO 款号 string _autoFillResponse reftables.PRICELIST 标准价 string autoFillResponse reftables.KD_DISCOUNT 组织折扣 string _autoFillResponse reftables.QTY 数量 string autoFillResponse reftables.PRICEACTUAL 成交价 string _autoFillResponse reftables.TOT_AMT_ACTUAL 成交金额 string autoFillResponse reftables.DISCOUNT 折扣 string _autoFillResponse reftables.WRITE_TIME 写入时间 string autoFillResponse reftables.READ_TIME 提取时间 string _autoFillResponse reftables.EDIFLAG 接口标记 string autoFillResponse reftables.RESULTS 问题原因 string _autoFillResponse 金蝶云星空接口明细调用接口： batchSave 接口名称：销售退货新增方法： POST 请求参数字段字段名称类型配置值 FBillTypeID 单据类型 string BJLST FBillNo 单据编号 string {{DOCNO}} FSaleOrgId 销售组织 string {{ORGANIZATION}} FDate 日期 string {{BILLDATE}} FStockOrgId 库存组织 string {{ORGANIZATION}} FRetcustId 退货客户 string {{ORIGNMAE}} FHeadNote 备注 string {{DESCRIPTION}} FEntity 明细信息 array reftables FEntity.FMaterialId 物料编码 string {{reftables.NO}} FEntity.FRealQty 实退数量 string function abs({{reftables.QTY}}) FEntity.FTaxPrice 含税单价 string _function abs({{reftables.PRICEACTUAL}}) FEntity.FIsFree 是否赠品 string FEntity.FEntryTaxRate 税率% string FEntity.FStockId 仓库 string function case when '{{CK_NEW}}'='' then '{{ORIGNMAE}}' else '{{CK_NEW}}' end FEntity.FDeliveryDate 退货日期 string {{reftables.WRITE_TIME}} FEntity.FNote 备注 string FEntity.FStockstatusId FStockstatusId string KCZT01_SYS FEntity.F_wk_zk 折扣 string {{reftables.DISCOUNT}} FEntity.F_wk_DPJ 标准价 string {{reftables.PRICELIST}} FEntity.F_wk_ZKL 组织折扣 string {{reftables.KD_DISCOUNT}} FEntity.FOwnerTypeId 货主类型 string BD_OwnerOrg FEntity.FOwnerId 货主 string _findCollection find FCreateOrgId_FNumber from 0b1afab3-a35b-3ee4-8a26-3dd62dfa8739 where FNumber={{reftables.NO}} endFind FEntity.FAmount 金额 string _function abs({{reftables.TOT_AMT_ACTUAL}}) FEntity.SubHeadEntity 财务信息 object FEntity.SubHeadEntity.FSettleOrgId 结算组织 string {{ORGANIZATION}} FEntity.SubHeadEntity.FSETTLECURRID 结算币别 string PRE001 FEntity.SubHeadEntity.FormId 业务对象表单Id string SAL_RETURNSTOCK FEntity.SubHeadEntity.Operation 执行的操作 string Save FEntity.SubHeadEntity.IsAutoSubmitAndAudit 提交并审核 bool true FEntity.SubHeadEntity.IsVerifyBaseDataField 验证基础资料 bool true 数据对接价值随着企业数字化业务的深入发展，对于企业的 IT 或者 CIO 来讲，正在面临一个愈发重要的问题——系统的结构太复杂了，尤其是头部企业，至少有十多套系统，这些系统之间的蛛网状的接口如果经常出问题。企业内部以及企业内部与外部建立起越来越多的业务应用系统，如何整合企业的现有IT资源，使企业中计算机孤岛式的应用向集体协作的方向发展，发挥资源效益的最大化，降低企业成本，正在逐渐成为企业关注的重要问题。用户希望企业内所有系统集成在一个平台上，操作统一，以节省培训时间。使用在轻易云应用集成平台 + MDM基础数据平台的解决方案中，轻易云应用集成平台负责实现异构、分布式系统之间互联互通，实现服务API治理以及数据传输交换。通过轻易云预置的各种适配器组件，连接现有各孤立应用系统，以图形化、拖拽方式构建集成流程和服务，提高应用系统集成工作效率，降低异构系统集成风险。针对未来可能出现的业务需求变更，在应用集成平台上进行动态调整，实现各应用系统之间的集成策略平滑升级。

伯俊ERP和金蝶云星空接口打通对接实战

小群青V

伯俊ERP和金蝶云星空接口打通对接实战

源系统:伯俊ERP

伯俊科技，依托在企业信息化建设方面的领先技术与实践积累，致力于帮助企业实现全渠道一盘货。伯俊提供数字经营的咨询与系统实施，助力企业信息化升级、加速数字化转型，覆盖零售市场中时尚鞋服、母婴内衣、珠宝饰品、食品酒水等多个行业，为5000+家机构及企业提供数字化建设服务。

集成系统:金蝶云星空

金蝶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
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
EDIFLAG	接口标记	string	_autoFillResponse
WRITE_DATE	写入时间	string	autoFillResponse
ORGANIZATION	财务组织	string	_autoFillResponse
DESCRIPTION	备注	string	autoFillResponse
BILLTYPE	单据类型	string	_autoFillResponse
DOCNO	单据编号	string	autoFillResponse
ORIGNMAE	零售店仓	string
reftables	reftables	array	_autoFillResponse
reftables.DOCNO	单据编号	string	autoFillResponse
reftables.NO	款号	string	_autoFillResponse
reftables.PRICELIST	标准价	string	autoFillResponse
reftables.KD_DISCOUNT	组织折扣	string	_autoFillResponse
reftables.QTY	数量	string	autoFillResponse
reftables.PRICEACTUAL	成交价	string	_autoFillResponse
reftables.TOT_AMT_ACTUAL	成交金额	string	autoFillResponse
reftables.DISCOUNT	折扣	string	_autoFillResponse
reftables.WRITE_TIME	写入时间	string	autoFillResponse
reftables.READ_TIME	提取时间	string	_autoFillResponse
reftables.EDIFLAG	接口标记	string	autoFillResponse
reftables.RESULTS	问题原因	string	_autoFillResponse

金蝶云星空接口明细

调用接口：batchSave
接口名称：销售退货新增
方法：POST

请求参数

字段	字段名称	类型	配置值
FBillTypeID	单据类型	string	BJLST
FBillNo	单据编号	string	{{DOCNO}}
FSaleOrgId	销售组织	string	{{ORGANIZATION}}
FDate	日期	string	{{BILLDATE}}
FStockOrgId	库存组织	string	{{ORGANIZATION}}
FRetcustId	退货客户	string	{{ORIGNMAE}}
FHeadNote	备注	string	{{DESCRIPTION}}
FEntity	明细信息	array	reftables
FEntity.FMaterialId	物料编码	string	{{reftables.NO}}
FEntity.FRealQty	实退数量	string	function abs({{reftables.QTY}})
FEntity.FTaxPrice	含税单价	string	_function abs({{reftables.PRICEACTUAL}})
FEntity.FIsFree	是否赠品	string
FEntity.FEntryTaxRate	税率%	string
FEntity.FStockId	仓库	string	function case when '{{CK_NEW}}'='' then '{{ORIGNMAE}}' else '{{CK_NEW}}' end
FEntity.FDeliveryDate	退货日期	string	{{reftables.WRITE_TIME}}
FEntity.FNote	备注	string
FEntity.FStockstatusId	FStockstatusId	string	KCZT01_SYS
FEntity.F_wk_zk	折扣	string	{{reftables.DISCOUNT}}
FEntity.F_wk_DPJ	标准价	string	{{reftables.PRICELIST}}
FEntity.F_wk_ZKL	组织折扣	string	{{reftables.KD_DISCOUNT}}
FEntity.FOwnerTypeId	货主类型	string	BD_OwnerOrg
FEntity.FOwnerId	货主	string	_findCollection find FCreateOrgId_FNumber from 0b1afab3-a35b-3ee4-8a26-3dd62dfa8739 where FNumber={{reftables.NO}} endFind
FEntity.FAmount	金额	string	_function abs({{reftables.TOT_AMT_ACTUAL}})
FEntity.SubHeadEntity	财务信息	object
FEntity.SubHeadEntity.FSettleOrgId	结算组织	string	{{ORGANIZATION}}
FEntity.SubHeadEntity.FSETTLECURRID	结算币别	string	PRE001
FEntity.SubHeadEntity.FormId	业务对象表单Id	string	SAL_RETURNSTOCK
FEntity.SubHeadEntity.Operation	执行的操作	string	Save
FEntity.SubHeadEntity.IsAutoSubmitAndAudit	提交并审核	bool	true
FEntity.SubHeadEntity.IsVerifyBaseDataField	验证基础资料	bool	true

数据对接价值

随着企业数字化业务的深入发展，对于企业的 IT 或者 CIO 来讲，正在面临一个愈发重要的问题——系统的结构太复杂了，尤其是头部企业，至少有十多套系统，这些系统之间的蛛网状的接口如果经常出问题。企业内部以及企业内部与外部建立起越来越多的业务应用系统，如何整合企业的现有IT资源，使企业中计算机孤岛式的应用向集体协作的方向发展，发挥资源效益的最大化，降低企业成本，正在逐渐成为企业关注的重要问题。用户希望企业内所有系统集成在一个平台上，操作统一，以节省培训时间。使用在轻易云应用集成平台 + MDM基础数据平台的解决方案中，轻易云应用集成平台负责实现异构、分布式系统之间互联互通，实现服务API治理以及数据传输交换。通过轻易云预置的各种适配器组件，连接现有各孤立应用系统，以图形化、拖拽方式构建集成流程和服务，提高应用系统集成工作效率，降低异构系统集成风险。针对未来可能出现的业务需求变更，在应用集成平台上进行动态调整，实现各应用系统之间的集成策略平滑升级。