伯俊ERP和金蝶云星空接口打通对接实战来源系统:伯俊ERP 伯俊科技，依托在企业信息化建设方面的领先技术与实践积累，致力于帮助企业实现全渠道一盘货。伯俊提供数字经营的咨询与系统实施，助力企业信息化升级、加速数字化转型，覆盖零售市场中时尚鞋服、母婴内衣、珠宝饰品、食品酒水等多个行业，为5000+家机构及企业提供数字化建设服务。接入系统：金蝶云星空金蝶K/3Cloud（金蝶云星空）是移动互联网时代的新型ERP，是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”，旨在帮助企业打造面向新时代的生态互联与协同平台，围绕生态中的每个角色，提供随手可得的云服务，最终实现敏捷协同，智慧运营的企业运营新境界。整个产品采用SOA架构，完全基于BOS平台组建而成，业务架构上贯穿流程驱动与角色驱动思想，结合中国管理模式与中国管理实践积累，精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建，支持跨数据库应用，支持本地部署、私有云部署与公有云部署三种部署方式，同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业，其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。数据集成方案配置集成方案是整个轻易云集成平台的核心，每一个集成方案代表一种业务的对接策略（对接方案借鉴可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息），用户可以根据业务的不同新建多个不同规则的集成方案。比如：采购订单同步，线上销售出库同步，线下销售出库同步。一个集成方案必须要配置源系统：伯俊ERP，源系统 API：表头表体组合查询，目标系统：金蝶云星空，目标系统 API付款单新增。在新增集成方案之前需要确定两个系统的连接器都已经配置完成。伯俊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 通过combine指明两个Expression之间的关系 params.expr1.expr1 参数-1 params.expr1.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.expr1.column 字段 params.expr1.expr1.expr2 参数-2 params.expr1.expr1.expr2.condition 条件 2 params.expr1.expr1.expr2.column 字段 BILLTYPE params.expr1.expr1.expr2.combine 组合关系 AND “and” “or” “and not” “or not”，若设置，必填expr1和expr2属性，忽略 column和condition。 params.expr1.expr2 参数-2 params.expr1.expr2.condition 条件 replace(BILLDATE,'-')>=20220601 params.expr1.expr2.column 字段 params.expr1.expr2.combine 组合关系 AND “and” “or” “and not” “or not”，若设置，必填expr1和expr2属性，忽略 column和condition。 params.table 表名 KD_PAY params.command 操作命令 Query params.reftables 关联表 {"name":"StringToArray","params":","} 响应参数接口字段字段名称预设值描述 BILLTYPE 单据类型 autoFillResponse DOCNO 单据编号 _autoFillResponse PO_DOCNO 订单编号 autoFillResponse SUPPLIER 供应商 _autoFillResponse FEETYPE 费用类型 autoFillResponse ORGANIZATION 财务组织 _autoFillResponse PAYWAY 银行账号 autoFillResponse PAYWAY_TYPE 结算方式 _autoFillResponse PAYMAT_AMT 付款金额 autoFillResponse DESCRIPTION 备注 _autoFillResponse BILLDATE 日期 autoFillResponse WRITE_TIME 写入时间 _autoFillResponse READ_TIME 提取时间 autoFillResponse EDIFLAG 接口标记 _autoFillResponse RESULTS 问题原因 autoFillResponse MODIFIERID_TRUENAME 修改人 _autoFillResponse MODIFIEDDATE 修改时间 _autoFillResponse 金蝶云星空接口明细 API： batchSave NAME：付款单新增 METHOD： POST 请求参数接口字段字段名称预设值描述 FBillNo 单据编号 {{DOCNO}} FCURRENCYID 币别 PRE001 FDATE 业务日期 {{MODIFIEDDATE}} FBillTypeID 单据类型 FKDLX01_SYS FCONTACTUNITTYPE 往来单位类型 BD_Supplier FCONTACTUNIT 往来单位 {{SUPPLIER}} FRECTUNITTYPE 收款单位类型 BD_Supplier FRECTUNIT 收款单位 {{SUPPLIER}} FSETTLEORGID 结算组织 {{ORGANIZATION}} FDepartment 部门 FPAYORGID 付款组织 _function case when 'FPAYORGID'>0 then 'FPAYORGID' else '{{ORGANIZATION}}' end FPAYAMOUNTFOR 付款金额 {{reftables.PRICELIST}} FEXCHANGETYPE 汇率类型 HLTX01_SYS FSETTLECUR 结算币别 PRE001 FREMARK 备注 {{DESCRIPTION}} FPAYBILLENTRY 付款单明细 FPAYBILLENTRY.FSETTLETYPEID 结算方式 JSFS01_SYS FPAYBILLENTRY.FPAYTOTALAMOUNTFOR 付款金额 {{PAYMAT_AMT}} FPAYBILLENTRY.FPURPOSEID 收付款用途 SFKYT09_SYS FPAYBILLENTRY.FACCOUNTID 我方银行账号 FPAYBILLENTRY.FCOMMENT 备注创建人：{{TRUENAME}} ；客户：{{CUSTOMER_CODE}} FPAYBILLENTRY.FCOSTID 费用项目 {{FEETYPE}} FPAYBILLENTRY.FEXPENSEDEPTID_E 费用承担部门 FPAYBILLENTRY.FSOURCETYPE 源单类型文本 FPAYBILLENTRY.FSourceBillNo 源单编号 {{SOURCE_DOCNO}} 文本 FPAYBILLENTRY.F_WK_SKR 收款人 {{EMAIL}} FPAYBILLENTRY.F_WK_KHH 对方开户行 {{DEPOSIT_BANK}} FPAYBILLENTRY.F_WK_SKYHZH 收款银行账号 {{REMARK}} FPAYBILLENTRY.FormId 业务对象表单Id AP_PAYBILL 必须填写金蝶的表单ID如😛UR_PurchaseOrder FPAYBILLENTRY.Operation 执行的操作 BatchSave FPAYBILLENTRY.IsAutoSubmitAndAudit 提交并审核 false FPAYBILLENTRY.IsVerifyBaseDataField 验证基础资料 false 是否验证所有的基础资料有效性，布尔类，默认false（非必录）系统对接概况将传统的统计分析转变为预测分析，从被动分析到主动分析，从非实时分析转变为实时分析，从结构化的数据变成多元化的数据。精准查询数据流同步状况，实时监管队列任务以及数据资产的有序管理。为业务赋能，降本增效，让企业能够更加合理的布局团队；结合业务需求实现与OA，CRM，WMS等系统之间的数据交流与同步，为企业定制自定义的数据管理方案，用技术拓展商业边界，为新业务、新部门提供成长空间。

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

汪淼_轻易云

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

来源系统:伯俊ERP

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

接入系统：金蝶云星空

金蝶K/3Cloud（金蝶云星空）是移动互联网时代的新型ERP，是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”，旨在帮助企业打造面向新时代的生态互联与协同平台，围绕生态中的每个角色，提供随手可得的云服务，最终实现敏捷协同，智慧运营的企业运营新境界。整个产品采用SOA架构，完全基于BOS平台组建而成，业务架构上贯穿流程驱动与角色驱动思想，结合中国管理模式与中国管理实践积累，精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建，支持跨数据库应用，支持本地部署、私有云部署与公有云部署三种部署方式，同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业，其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。

数据集成方案配置

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

伯俊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		通过combine指明两个Expression之间的关系
params.expr1.expr1	参数-1
params.expr1.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.expr1.column	字段
params.expr1.expr1.expr2	参数-2
params.expr1.expr1.expr2.condition	条件	2
params.expr1.expr1.expr2.column	字段	BILLTYPE
params.expr1.expr1.expr2.combine	组合关系	AND	“and” “or” “and not” “or not”，若设置，必填expr1和expr2属性，忽略 column和condition。
params.expr1.expr2	参数-2
params.expr1.expr2.condition	条件	replace(BILLDATE,'-')>=20220601
params.expr1.expr2.column	字段
params.expr1.expr2.combine	组合关系	AND	“and” “or” “and not” “or not”，若设置，必填expr1和expr2属性，忽略 column和condition。
params.table	表名	KD_PAY
params.command	操作命令	Query
params.reftables	关联表		{"name":"StringToArray","params":","}

响应参数

接口字段	字段名称	描述
BILLTYPE	单据类型	autoFillResponse
DOCNO	单据编号	_autoFillResponse
PO_DOCNO	订单编号	autoFillResponse
SUPPLIER	供应商	_autoFillResponse
FEETYPE	费用类型	autoFillResponse
ORGANIZATION	财务组织	_autoFillResponse
PAYWAY	银行账号	autoFillResponse
PAYWAY_TYPE	结算方式	_autoFillResponse
PAYMAT_AMT	付款金额	autoFillResponse
DESCRIPTION	备注	_autoFillResponse
BILLDATE	日期	autoFillResponse
WRITE_TIME	写入时间	_autoFillResponse
READ_TIME	提取时间	autoFillResponse
EDIFLAG	接口标记	_autoFillResponse
RESULTS	问题原因	autoFillResponse
MODIFIERID_TRUENAME	修改人	_autoFillResponse
MODIFIEDDATE	修改时间	_autoFillResponse

金蝶云星空接口明细

API：batchSave
NAME：付款单新增
METHOD：POST

请求参数

接口字段	字段名称	预设值	描述
FBillNo	单据编号	{{DOCNO}}
FCURRENCYID	币别	PRE001
FDATE	业务日期	{{MODIFIEDDATE}}
FBillTypeID	单据类型	FKDLX01_SYS
FCONTACTUNITTYPE	往来单位类型	BD_Supplier
FCONTACTUNIT	往来单位	{{SUPPLIER}}
FRECTUNITTYPE	收款单位类型	BD_Supplier
FRECTUNIT	收款单位	{{SUPPLIER}}
FSETTLEORGID	结算组织	{{ORGANIZATION}}
FDepartment	部门
FPAYORGID	付款组织	_function case when 'FPAYORGID'>0 then 'FPAYORGID' else '{{ORGANIZATION}}' end
FPAYAMOUNTFOR	付款金额	{{reftables.PRICELIST}}
FEXCHANGETYPE	汇率类型	HLTX01_SYS
FSETTLECUR	结算币别	PRE001
FREMARK	备注	{{DESCRIPTION}}
FPAYBILLENTRY	付款单明细
FPAYBILLENTRY.FSETTLETYPEID	结算方式	JSFS01_SYS
FPAYBILLENTRY.FPAYTOTALAMOUNTFOR	付款金额	{{PAYMAT_AMT}}
FPAYBILLENTRY.FPURPOSEID	收付款用途	SFKYT09_SYS
FPAYBILLENTRY.FACCOUNTID	我方银行账号
FPAYBILLENTRY.FCOMMENT	备注	创建人：{{TRUENAME}} ；客户：{{CUSTOMER_CODE}}
FPAYBILLENTRY.FCOSTID	费用项目	{{FEETYPE}}
FPAYBILLENTRY.FEXPENSEDEPTID_E	费用承担部门
FPAYBILLENTRY.FSOURCETYPE	源单类型		文本
FPAYBILLENTRY.FSourceBillNo	源单编号	{{SOURCE_DOCNO}}	文本
FPAYBILLENTRY.F_WK_SKR	收款人	{{EMAIL}}
FPAYBILLENTRY.F_WK_KHH	对方开户行	{{DEPOSIT_BANK}}
FPAYBILLENTRY.F_WK_SKYHZH	收款银行账号	{{REMARK}}
FPAYBILLENTRY.FormId	业务对象表单Id	AP_PAYBILL	必须填写金蝶的表单ID如😛UR_PurchaseOrder
FPAYBILLENTRY.Operation	执行的操作	BatchSave
FPAYBILLENTRY.IsAutoSubmitAndAudit	提交并审核	false
FPAYBILLENTRY.IsVerifyBaseDataField	验证基础资料	false	是否验证所有的基础资料有效性，布尔类，默认false（非必录）

系统对接概况

将传统的统计分析转变为预测分析，从被动分析到主动分析，从非实时分析转变为实时分析，从结构化的数据变成多元化的数据。精准查询数据流同步状况，实时监管队列任务以及数据资产的有序管理。为业务赋能，降本增效，让企业能够更加合理的布局团队；结合业务需求实现与OA，CRM，WMS等系统之间的数据交流与同步，为企业定制自定义的数据管理方案，用技术拓展商业边界，为新业务、新部门提供成长空间。