伯俊ERP和金蝶云星空接口打通对接实战对接系统伯俊ERP 伯俊科技，依托在企业信息化建设方面的领先技术与实践积累，致力于帮助企业实现全渠道一盘货。伯俊提供数字经营的咨询与系统实施，助力企业信息化升级、加速数字化转型，覆盖零售市场中时尚鞋服、母婴内衣、珠宝饰品、食品酒水等多个行业，为5000+家机构及企业提供数字化建设服务。接入系统：金蝶云星空金蝶K/3Cloud在总结百万家客户管理最佳实践的基础上，提供了标准的管理模式；通过标准的业务架构：多会计准则、多币别、多地点、多组织、多税制应用框架等，有效支持企业的运营管理；K/3Cloud提供了标准的业务建模：35种标准ERP领域模型、1046种模型元素、21243种模型元素属性组合，288个业务服务构件，让企业及伙伴可快速构建出行业化及个性化的应用。配置集成方案轻易云集成平台的对接是通过一个个对应的对接方案去形成两个系统对接的连线，所以对接方案的配置极其重要，方案可以选择一键复制，轻易云有海量的对接方案可支持一键复制，复制后直接启动使用（对接方案借鉴可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息。或者可以通过手工配置，配置只要确认源平台：伯俊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_TRANSFER params.command 操作命令 Query params.reftables 关联表 5195 {"name":"StringToArray","params":","} 响应参数接口字段字段名称预设值描述 OWNERID 创建人 autoFillResponse CREATIONDATE 创建时间 _autoFillResponse BILLDATE 单据日期 autoFillResponse BILLSTORE 店仓 _autoFillResponse EDIFLAG 接口标记 autoFillResponse SUPPLIER 供应商 _autoFillResponse BILLDATE 业务日期 autoFillResponse PO_DOCNO 订单编号 _autoFillResponse ORGANIZATION 财务组织 autoFillResponse IS_MODID 是否改标 _autoFillResponse DESCRIPTION 备注 autoFillResponse BILLTYPE 单据类型 _autoFillResponse DOCNO 单据编号 autoFillResponse reftables reftables _autoFillResponse reftables.DOCNO 单据编号 autoFillResponse reftables.NO 款号 _autoFillResponse reftables.QTY 数量 autoFillResponse reftables.PRICELIST 标准价 _autoFillResponse reftables.TOT_AMT_ACTUAL 标准金额 autoFillResponse reftables.WRITE_TIME 写入时间 _autoFillResponse reftables.READ_TIME 提取时间 autoFillResponse reftables.RESULTS 问题原因 _autoFillResponse reftables.EDIFLAG 接口标记 autoFillResponse reftables.OWNERID_TRUENAME 创建人 _autoFillResponse reftables.CREATIONDATE 创建时间 autoFillResponse reftables.MODIFIERID_TRUENAME 修改人 _autoFillResponse reftables.MODIFIEDDATE 修改时间 reftables.FQTY 关联数量 reftables.ID ID _autoFillResponse 金蝶云星空接口明细 API： batchSave NAME：分布式调入单新增 METHOD： POST 请求参数接口字段字段名称预设值描述 FBillNo 单据编号 {{bfn_num}} FBillTypeID 单据类型 FBDR01_SYS FTransferBizType 调拨类型 function case when '{{ORIG_ORGANIZATION}}' in ('{{DEST_ORGANIZATION}}') then 'InnerOrgTransfer' else 'OverOrgTransfer' end FTransferDirect 调拨方向 GENERAL FStockOrgID 调入库存组织 {{DEST_ORGANIZATION}} FStockOutOrgID 调出库存组织 {{ORIG_ORGANIZATION}} FTransferMode 调拨方式 INDIRECT FDate 日期 {{BILLDATE}} FOwnerTypeOutIdHead 调出货主类型 BD_OwnerOrg FOwnerOutIdHead 调出货主 _findCollection find FCreateOrgId_FNumber from 0b1afab3-a35b-3ee4-8a26-3dd62dfa8739 where FNumber={{reftables_NO}} endFind FBizType 业务类型 NORMAL FVESTONWAY 携带在途归属 A FOwnerTypeIdHead 调入货主类型 BD_OwnerOrg FOwnerIdHead 调入货主 _findCollection find FCreateOrgId_FNumber from 0b1afab3-a35b-3ee4-8a26-3dd62dfa8739 where FNumber={{reftables_NO}} endFind FNOTE 备注 FSTKTRSINENTRY 明细信息 FSTKTRSINENTRY.FMaterialID 物料编码 {{reftables_NO}} FSTKTRSINENTRY.FSrcMaterialId 调出物料 {{reftables_NO}} FSTKTRSINENTRY.FSrcStockID 调出仓库 _function case when '{{DCCK_NEW}}'='' then '{{ORIG_CODE}}' else '{{DCCK_NEW}}' end FSTKTRSINENTRY.FDestStockID 调入仓库 function case when '{{DRCK_NEW}}'='' then '{{DEST_CODE}}' else '{{DRCK_NEW}}' end FSTKTRSINENTRY.FDestStockStatusID 调入库存状态 KCZT01_SYS FSTKTRSINENTRY.FQty 调入数量 {{reftables_QTY}} FSTKTRSINENTRY.FOwnerID 调入货主 _findCollection find FCreateOrgId_FNumber from 0b1afab3-a35b-3ee4-8a26-3dd62dfa8739 where FNumber={{reftables_NO}} endFind FSTKTRSINENTRY.FOwnerOutID 调出货主 _findCollection find FCreateOrgId_FNumber from 0b1afab3-a35b-3ee4-8a26-3dd62dfa8739 where FNumber={{reftables_NO}} endFind FSTKTRSINENTRY.FEntryNote 备注 FSTKTRSINENTRY.FPathLossQty 途损数量 FSTKTRSINENTRY.FPlanTransferQty 计划调拨数量 {{reftables_QTY}} FSTKTRSINENTRY.FSrcBillType 源单类型 STK_TRANSFEROUT FSTKTRSINENTRY.FSRCBILLNO 源单编号 {{bfn_num}} FSTKTRSINENTRY.FSTKTSTKRANSFERINENTRY_Link 关联关系表 FSTKTRSINENTRY.FSTKTSTKRANSFERINENTRY_Link.FSTKTSTKRANSFERINENTRY_Link_FRuleId 转换规则 STK_TRANSFEROUT-STK_TRANSFERIN FSTKTRSINENTRY.FSTKTSTKRANSFERINENTRY_Link.FSTKTSTKRANSFERINENTRY_Link_FSTableName 源单表 T_STK_STKTRANSFEROUTENTRY FSTKTRSINENTRY.FSTKTSTKRANSFERINENTRY_Link.FSTKTSTKRANSFERINENTRY_Link_FSBillId 源单内码 _findCollection find FID from b128134f-34c8-378c-a9fc-8f0056bb0fb0 where F_PBLH_BJNO={{reftables_DOCNO}} FMaterialID_FNumber={{reftables_NO}} FSTKTRSINENTRY.FSTKTSTKRANSFERINENTRY_Link.FSTKTSTKRANSFERINENTRY_Link_FSId 源单分录内码 _findCollection find FSTKTRSOUTENTRY_FEntryID from b128134f-34c8-378c-a9fc-8f0056bb0fb0 where F_PBLH_BJNO={{reftables_DOCNO}} FMaterialID_FNumber={{reftables_NO}} FSTKTRSINENTRY.FormId 业务对象表单Id STK_TRANSFERIN 必须填写金蝶的表单ID如😛UR_PurchaseOrder FSTKTRSINENTRY.Operation 执行的操作 BatchSave FSTKTRSINENTRY.IsAutoSubmitAndAudit 提交并审核 true FSTKTRSINENTRY.IsVerifyBaseDataField 验证基础资料 false 是否验证所有的基础资料有效性，布尔类，默认false（非必录） FSTKTRSINENTRY.BatchCount 服务端开启的线程数，整型 5 是否验证所有的基础资料有效性，布尔类，默认false（非必录）数据对接价值当企业规模逐渐增大时，作为支撑业务运营的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个业务服务构件，让企业及伙伴可快速构建出行业化及个性化的应用。

配置集成方案

轻易云集成平台的对接是通过一个个对应的对接方案去形成两个系统对接的连线，所以对接方案的配置极其重要，方案可以选择一键复制，轻易云有海量的对接方案可支持一键复制，复制后直接启动使用（对接方案借鉴可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息。或者可以通过手工配置，配置只要确认源平台：伯俊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_TRANSFER
params.command	操作命令	Query
params.reftables	关联表	5195	{"name":"StringToArray","params":","}

响应参数

接口字段	字段名称	描述
OWNERID	创建人	autoFillResponse
CREATIONDATE	创建时间	_autoFillResponse
BILLDATE	单据日期	autoFillResponse
BILLSTORE	店仓	_autoFillResponse
EDIFLAG	接口标记	autoFillResponse
SUPPLIER	供应商	_autoFillResponse
BILLDATE	业务日期	autoFillResponse
PO_DOCNO	订单编号	_autoFillResponse
ORGANIZATION	财务组织	autoFillResponse
IS_MODID	是否改标	_autoFillResponse
DESCRIPTION	备注	autoFillResponse
BILLTYPE	单据类型	_autoFillResponse
DOCNO	单据编号	autoFillResponse
reftables	reftables	_autoFillResponse
reftables.DOCNO	单据编号	autoFillResponse
reftables.NO	款号	_autoFillResponse
reftables.QTY	数量	autoFillResponse
reftables.PRICELIST	标准价	_autoFillResponse
reftables.TOT_AMT_ACTUAL	标准金额	autoFillResponse
reftables.WRITE_TIME	写入时间	_autoFillResponse
reftables.READ_TIME	提取时间	autoFillResponse
reftables.RESULTS	问题原因	_autoFillResponse
reftables.EDIFLAG	接口标记	autoFillResponse
reftables.OWNERID_TRUENAME	创建人	_autoFillResponse
reftables.CREATIONDATE	创建时间	autoFillResponse
reftables.MODIFIERID_TRUENAME	修改人	_autoFillResponse
reftables.MODIFIEDDATE	修改时间
reftables.FQTY	关联数量
reftables.ID	ID	_autoFillResponse

金蝶云星空接口明细

API：batchSave
NAME：分布式调入单新增
METHOD：POST

请求参数

接口字段	字段名称	预设值	描述
FBillNo	单据编号	{{bfn_num}}
FBillTypeID	单据类型	FBDR01_SYS
FTransferBizType	调拨类型	function case when '{{ORIG_ORGANIZATION}}' in ('{{DEST_ORGANIZATION}}') then 'InnerOrgTransfer' else 'OverOrgTransfer' end
FTransferDirect	调拨方向	GENERAL
FStockOrgID	调入库存组织	{{DEST_ORGANIZATION}}
FStockOutOrgID	调出库存组织	{{ORIG_ORGANIZATION}}
FTransferMode	调拨方式	INDIRECT
FDate	日期	{{BILLDATE}}
FOwnerTypeOutIdHead	调出货主类型	BD_OwnerOrg
FOwnerOutIdHead	调出货主	_findCollection find FCreateOrgId_FNumber from 0b1afab3-a35b-3ee4-8a26-3dd62dfa8739 where FNumber={{reftables_NO}} endFind
FBizType	业务类型	NORMAL
FVESTONWAY	携带在途归属	A
FOwnerTypeIdHead	调入货主类型	BD_OwnerOrg
FOwnerIdHead	调入货主	_findCollection find FCreateOrgId_FNumber from 0b1afab3-a35b-3ee4-8a26-3dd62dfa8739 where FNumber={{reftables_NO}} endFind
FNOTE	备注
FSTKTRSINENTRY	明细信息
FSTKTRSINENTRY.FMaterialID	物料编码	{{reftables_NO}}
FSTKTRSINENTRY.FSrcMaterialId	调出物料	{{reftables_NO}}
FSTKTRSINENTRY.FSrcStockID	调出仓库	_function case when '{{DCCK_NEW}}'='' then '{{ORIG_CODE}}' else '{{DCCK_NEW}}' end
FSTKTRSINENTRY.FDestStockID	调入仓库	function case when '{{DRCK_NEW}}'='' then '{{DEST_CODE}}' else '{{DRCK_NEW}}' end
FSTKTRSINENTRY.FDestStockStatusID	调入库存状态	KCZT01_SYS
FSTKTRSINENTRY.FQty	调入数量	{{reftables_QTY}}
FSTKTRSINENTRY.FOwnerID	调入货主	_findCollection find FCreateOrgId_FNumber from 0b1afab3-a35b-3ee4-8a26-3dd62dfa8739 where FNumber={{reftables_NO}} endFind
FSTKTRSINENTRY.FOwnerOutID	调出货主	_findCollection find FCreateOrgId_FNumber from 0b1afab3-a35b-3ee4-8a26-3dd62dfa8739 where FNumber={{reftables_NO}} endFind
FSTKTRSINENTRY.FEntryNote	备注
FSTKTRSINENTRY.FPathLossQty	途损数量
FSTKTRSINENTRY.FPlanTransferQty	计划调拨数量	{{reftables_QTY}}
FSTKTRSINENTRY.FSrcBillType	源单类型	STK_TRANSFEROUT
FSTKTRSINENTRY.FSRCBILLNO	源单编号	{{bfn_num}}
FSTKTRSINENTRY.FSTKTSTKRANSFERINENTRY_Link	关联关系表
FSTKTRSINENTRY.FSTKTSTKRANSFERINENTRY_Link.FSTKTSTKRANSFERINENTRY_Link_FRuleId	转换规则	STK_TRANSFEROUT-STK_TRANSFERIN
FSTKTRSINENTRY.FSTKTSTKRANSFERINENTRY_Link.FSTKTSTKRANSFERINENTRY_Link_FSTableName	源单表	T_STK_STKTRANSFEROUTENTRY
FSTKTRSINENTRY.FSTKTSTKRANSFERINENTRY_Link.FSTKTSTKRANSFERINENTRY_Link_FSBillId	源单内码	_findCollection find FID from b128134f-34c8-378c-a9fc-8f0056bb0fb0 where F_PBLH_BJNO={{reftables_DOCNO}} FMaterialID_FNumber={{reftables_NO}}
FSTKTRSINENTRY.FSTKTSTKRANSFERINENTRY_Link.FSTKTSTKRANSFERINENTRY_Link_FSId	源单分录内码	_findCollection find FSTKTRSOUTENTRY_FEntryID from b128134f-34c8-378c-a9fc-8f0056bb0fb0 where F_PBLH_BJNO={{reftables_DOCNO}} FMaterialID_FNumber={{reftables_NO}}
FSTKTRSINENTRY.FormId	业务对象表单Id	STK_TRANSFERIN	必须填写金蝶的表单ID如😛UR_PurchaseOrder
FSTKTRSINENTRY.Operation	执行的操作	BatchSave
FSTKTRSINENTRY.IsAutoSubmitAndAudit	提交并审核	true
FSTKTRSINENTRY.IsVerifyBaseDataField	验证基础资料	false	是否验证所有的基础资料有效性，布尔类，默认false（非必录）
FSTKTRSINENTRY.BatchCount	服务端开启的线程数，整型	5	是否验证所有的基础资料有效性，布尔类，默认false（非必录）

数据对接价值

当企业规模逐渐增大时，作为支撑业务运营的IT建设也变得越来越重要，不过往往企业的IT建设过程中会发现某一家软件供应商基本不能完全覆盖企业所有的业务运营流程，这样的结果就是，企业上的IT系统很多很全，从ERP到HR、CRM、PDM、OA等，貌似所有的业务都覆盖到了，但实际上因为这些系统的不集成，而形成了企业很多新的信息孤岛，非常不利于企业的后续的管理和战略发展。从现今和往后的发展趋势来看，也不可避免会遇到上述问题，毕竟企业经营的多样化，并不是所有的业务都能在一个系统中完成，所以我们必须在产品架构上支持更好的与外部系统进行协同。通过轻易云集成平台统一的API管理平台，对API进行显性化、可视化，使所有API服务成为企业的数字资产，提升API利用率，发挥业务系统价值，实现企业IT资产的可插拔、可复用、可组成。