从伯俊ERP到金蝶云星空通过接口集成数据源系统:伯俊ERP 伯俊科技，依托在企业信息化建设方面的领先技术与实践积累，致力于帮助企业实现全渠道一盘货。伯俊提供数字经营的咨询与系统实施，助力企业信息化升级、加速数字化转型，覆盖零售市场中时尚鞋服、母婴内衣、珠宝饰品、食品酒水等多个行业，为5000+家机构及企业提供数字化建设服务。对接目标平台:金蝶云星空金蝶K/3Cloud在总结百万家客户管理最佳实践的基础上，提供了标准的管理模式；通过标准的业务架构：多会计准则、多币别、多地点、多组织、多税制应用框架等，有效支持企业的运营管理；K/3Cloud提供了标准的业务建模：35种标准ERP领域模型、1046种模型元素、21243种模型元素属性组合，288个业务服务构件，让企业及伙伴可快速构建出行业化及个性化的应用。数据接口配置系统对接前期需要通过调研公司的业务，规划出最便捷，效率最高的整体流程。通过流程我们需要建立对应的方案来吧这些流程一一的落地，轻易云集成平台开箱即用的、可视化拖、拉、拽实现接口服务编排与聚合。只需要根据指引设定好对应的参数即可启动使用。设定好源平台：伯俊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建设也变得越来越重要，不过往往企业的IT建设过程中会发现某一家软件供应商基本不能完全覆盖企业所有的业务运营流程，这样的结果就是，企业上的IT系统很多很全，从ERP到HR、CRM、PDM、OA等，貌似所有的业务都覆盖到了，但实际上因为这些系统的不集成，而形成了企业很多新的信息孤岛，非常不利于企业的后续的管理和战略发展。从现今和往后的发展趋势来看，也不可避免会遇到上述问题，毕竟企业经营的多样化，并不是所有的业务都能在一个系统中完成，所以我们必须在产品架构上支持更好的与外部系统进行协同。通过轻易云集成平台统一的API管理平台，对API进行显性化、可视化，使所有API服务成为企业的数字资产，提升API利用率，发挥业务系统价值，实现企业IT资产的可插拔、可复用、可组成。

从伯俊ERP到金蝶云星空通过接口集成数据

汪淼_轻易云

从伯俊ERP到金蝶云星空通过接口集成数据

源系统:伯俊ERP

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

对接目标平台:金蝶云星空

金蝶K/3Cloud在总结百万家客户管理最佳实践的基础上，提供了标准的管理模式；通过标准的业务架构：多会计准则、多币别、多地点、多组织、多税制应用框架等，有效支持企业的运营管理；K/3Cloud提供了标准的业务建模：35种标准ERP领域模型、1046种模型元素、21243种模型元素属性组合，288个业务服务构件，让企业及伙伴可快速构建出行业化及个性化的应用。

数据接口配置

系统对接前期需要通过调研公司的业务，规划出最便捷，效率最高的整体流程。通过流程我们需要建立对应的方案来吧这些流程一一的落地，轻易云集成平台开箱即用的、可视化拖、拉、拽实现接口服务编排与聚合。只需要根据指引设定好对应的参数即可启动使用。设定好源平台：伯俊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建设也变得越来越重要，不过往往企业的IT建设过程中会发现某一家软件供应商基本不能完全覆盖企业所有的业务运营流程，这样的结果就是，企业上的IT系统很多很全，从ERP到HR、CRM、PDM、OA等，貌似所有的业务都覆盖到了，但实际上因为这些系统的不集成，而形成了企业很多新的信息孤岛，非常不利于企业的后续的管理和战略发展。从现今和往后的发展趋势来看，也不可避免会遇到上述问题，毕竟企业经营的多样化，并不是所有的业务都能在一个系统中完成，所以我们必须在产品架构上支持更好的与外部系统进行协同。通过轻易云集成平台统一的API管理平台，对API进行显性化、可视化，使所有API服务成为企业的数字资产，提升API利用率，发挥业务系统价值，实现企业IT资产的可插拔、可复用、可组成。