伯俊ERP和金蝶云星空接口打通对接实战对接系统伯俊ERP 未来，伯俊科技也会砥砺前行，不断为品牌提供更全面的零售终端致胜利器。伯俊科技始终坚持创新发展，探索大零售行业发力方向及突破机会，不断总结提炼当前及未来的新场景新玩法，优化升级自身体系的同时陪伴客户持续性发展。目标系统:金蝶云星空金蝶K/3Cloud结合当今先进管理理论和数十万家国内客户最佳应用实践，面向事业部制、多地点、多工厂等运营协同与管控型企业及集团公司，提供一个通用的ERP服务平台。K/3Cloud支持的协同应用包括但不限于：集中/分散销售、集中/分散采购、B2B电商管理、B2C电商中心、供应商协同、多工厂计划、跨工厂领料、跨工厂加工、工厂间调拨、内部交易及结算、集团财务管理、阿米巴经营等。数据接口配置集成方案是整个轻易云集成平台的核心，每一个集成方案代表一种业务的对接策略（对接方案借鉴可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息），用户可以根据业务的不同新建多个不同规则的集成方案。比如：采购订单同步，线上销售出库同步，线下销售出库同步。一个集成方案必须要配置源系统：伯俊ERP，源系统 API：表头表体组合查询，目标系统：金蝶云星空，目标系统 API销售退货新增。在新增集成方案之前需要确定两个系统的连接器都已经配置完成。伯俊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 金蝶云星空接口明细 API： batchSave NAME：销售退货新增 METHOD： POST 请求参数接口字段字段名称预设值描述 FBillTypeID 单据类型 BJLST FBillNo 单据编号 {{DOCNO}} FSaleOrgId 销售组织 {{ORGANIZATION}} FDate 日期 {{BILLDATE}} FStockOrgId 库存组织 {{ORGANIZATION}} FRetcustId 退货客户 {{ORIGNMAE}} 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 '{{ORIGNMAE}}' else '{{CK_NEW}}' end FEntity.FDeliveryDate 退货日期 {{reftables.WRITE_TIME}} FEntity.FNote 备注 FEntity.FStockstatusId FStockstatusId KCZT01_SYS FEntity.F_wk_zk 折扣 {{reftables.DISCOUNT}} FEntity.F_wk_DPJ 标准价 {{reftables.PRICELIST}} FEntity.F_wk_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 金额 _function abs({{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 系统数据集成价值通过轻易云集成平台系列产品线可以协助企业轻易快捷的构建基于微服务架构的新一代企业服务总线，传统基于SOA架构的ESB产品主要解决的数据集成和协议转换等基础功能，已完全不能满足基于微服务架构、混合云集成架构、跨组织、跨单位的总线解决方案。而轻易云集成平台的每个产品线都是新一代的按照最新的互联网架构模式进行研发的产品线，能快速协助企业从传统的SOA架构转向微服务架构的服务总线解决方案。

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

庄颜_qeasy

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

对接系统伯俊ERP

未来，伯俊科技也会砥砺前行，不断为品牌提供更全面的零售终端致胜利器。伯俊科技始终坚持创新发展，探索大零售行业发力方向及突破机会，不断总结提炼当前及未来的新场景新玩法，优化升级自身体系的同时陪伴客户持续性发展。

目标系统:金蝶云星空

金蝶K/3Cloud结合当今先进管理理论和数十万家国内客户最佳应用实践，面向事业部制、多地点、多工厂等运营协同与管控型企业及集团公司，提供一个通用的ERP服务平台。K/3Cloud支持的协同应用包括但不限于：集中/分散销售、集中/分散采购、B2B电商管理、B2C电商中心、供应商协同、多工厂计划、跨工厂领料、跨工厂加工、工厂间调拨、内部交易及结算、集团财务管理、阿米巴经营等。

数据接口配置

集成方案是整个轻易云集成平台的核心，每一个集成方案代表一种业务的对接策略（对接方案借鉴可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息），用户可以根据业务的不同新建多个不同规则的集成方案。比如：采购订单同步，线上销售出库同步，线下销售出库同步。一个集成方案必须要配置源系统：伯俊ERP，源系统 API：表头表体组合查询，目标系统：金蝶云星空，目标系统 API销售退货新增。在新增集成方案之前需要确定两个系统的连接器都已经配置完成。

伯俊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

金蝶云星空接口明细

API：batchSave
NAME：销售退货新增
METHOD：POST

请求参数

接口字段	字段名称	预设值
FBillTypeID	单据类型	BJLST
FBillNo	单据编号	{{DOCNO}}
FSaleOrgId	销售组织	{{ORGANIZATION}}
FDate	日期	{{BILLDATE}}
FStockOrgId	库存组织	{{ORGANIZATION}}
FRetcustId	退货客户	{{ORIGNMAE}}
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 '{{ORIGNMAE}}' else '{{CK_NEW}}' end
FEntity.FDeliveryDate	退货日期	{{reftables.WRITE_TIME}}
FEntity.FNote	备注
FEntity.FStockstatusId	FStockstatusId	KCZT01_SYS
FEntity.F_wk_zk	折扣	{{reftables.DISCOUNT}}
FEntity.F_wk_DPJ	标准价	{{reftables.PRICELIST}}
FEntity.F_wk_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	金额	_function abs({{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

系统数据集成价值

通过轻易云集成平台系列产品线可以协助企业轻易快捷的构建基于微服务架构的新一代企业服务总线，传统基于SOA架构的ESB产品主要解决的数据集成和协议转换等基础功能，已完全不能满足基于微服务架构、混合云集成架构、跨组织、跨单位的总线解决方案。而轻易云集成平台的每个产品线都是新一代的按照最新的互联网架构模式进行研发的产品线，能快速协助企业从传统的SOA架构转向微服务架构的服务总线解决方案。