伯俊ERP与金蝶云星空对接集成表头表体组合查询打通销售出库新增来源系统:伯俊ERP 伯俊科技拥有近千人的团队、出色的本地化服务能力及强劲的研发创新实力，在深耕零售行业24年中，成功研发企业级ERP系统、OMS订单管理系统、门店收银系统、门店管理软硬件一体机等。探索零售行业数字化的进程中，伯俊科技成功落地百余全渠道项目，积累丰富的业务中台、数据中台落地经验。对接目标系统:金蝶云星空金蝶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 条件 1 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_RETAIL params.command 操作命令 Query params.reftables 关联表 5191 {"name":"StringToArray","params":","} 响应参数接口字段字段名称预设值描述 OWNERID 创建人 autoFillResponse CREATIONDATE 创建时间 _autoFillResponse BILLDATE 单据日期 autoFillResponse EDIFLAG 接口标记 _autoFillResponse WRITE_DATE 写入时间 autoFillResponse ORGANIZATION 财务组织 _autoFillResponse DESCRIPTION 备注 autoFillResponse BILLTYPE 单据类型 _autoFillResponse DOCNO 单据编号 autoFillResponse ORIGNMAE 零售店仓 reftables reftables _autoFillResponse reftables.DOCNO 单据编号 autoFillResponse reftables.NO 款号 _autoFillResponse reftables.PRICELIST 标准价 autoFillResponse reftables.KD_DISCOUNT 组织折扣 _autoFillResponse reftables.QTY 数量 autoFillResponse reftables.PRICEACTUAL 成交价 _autoFillResponse reftables.TOT_AMT_ACTUAL 成交金额 autoFillResponse reftables.DISCOUNT 折扣 _autoFillResponse reftables.WRITE_TIME 写入时间 autoFillResponse reftables.READ_TIME 提取时间 _autoFillResponse reftables.EDIFLAG 接口标记 autoFillResponse reftables.RESULTS 问题原因 _autoFillResponse reftables.CUSTOMER_ORGANIZE 销售组织金蝶云星空接口明细 API： batchSave NAME：销售出库新增 METHOD： POST 请求参数接口字段字段名称预设值描述 FBillTypeID 单据类型 XSCKD01_SYS 单据类型 FBillNo 单据编号 {{DOCNO}} 单据编号 FDate 日期 {{BILLDATE}} 日期 FSaleOrgId 销售组织 {{CUSTOMER_ORGANIZE}} 组织 FCustomerID 客户 {{ORIGNMAE}} 基础资料 FStockOrgId 发货组织 {{ORGANIZATION}} 组织 FNote 备注多行文本 FOwnerTypeIdHead 货主类型多类别基础资料列表 FOwnerIdHead 货主多类别基础资料 SubHeadEntity 财务信息 SubHeadEntity.FSettleOrgID 结算组织 {{ORGANIZATION}} 组织 SubHeadEntity.FEntity 明细信息 reftables SubHeadEntity.FEntity.FMaterialID 物料编码 {{reftables.NO}} 基础资料 SubHeadEntity.FEntity.FRealQty 实发数量 {{reftables.QTY}} 数量 SubHeadEntity.FEntity.FPrice 单价 function abs({{reftables.PRICEACTUAL}}) 单价 SubHeadEntity.FEntity.FTaxPrice 含税单价 _function abs({{reftables.PRICEACTUAL}}) 单价 SubHeadEntity.FEntity.FEntryTaxRate 税率% 小数 SubHeadEntity.FEntity.FEntryTaxAmount 税额金额 SubHeadEntity.FEntity.FAmount 金额 {{reftables.TOT_AMT_ACTUAL}} 金额 SubHeadEntity.FEntity.FAllAmount 价税合计 {{reftables.TOT_AMT_ACTUAL}} 金额 SubHeadEntity.FEntity.FStockID 仓库 function case when '{{CK_NEW}}'='' then '{{ORIGNMAE}}' else '{{CK_NEW}}' end 基础资料 SubHeadEntity.FEntity.FStockStatusID 库存状态 KCZT01_SYS 基础资料 SubHeadEntity.FEntity.FEntrynote 备注文本 SubHeadEntity.FEntity.FDiscountRate 折扣率% 小数 SubHeadEntity.FEntity.FIsFree 是否赠品复选框 SubHeadEntity.FEntity.F_wk_zk 折扣 {{reftables.KD_DISCOUNT}} SubHeadEntity.FEntity.F_wk_DPJ 标准价 {{reftables.PRICELIST}} SubHeadEntity.FEntity.F_wk_ZKL 组织折扣 {{reftables.KD_DISCOUNT}} SubHeadEntity.FEntity.FOwnerTypeID 货主类型 BD_OwnerOrg SubHeadEntity.FEntity.FOwnerID 货主 _findCollection find FCreateOrgId_FNumber from 0b1afab3-a35b-3ee4-8a26-3dd62dfa8739 where FNumber={{reftables.NO}} _endFind SubHeadEntity.FEntity.FormId 业务对象表单Id SAL_OUTSTOCK 必须填写金蝶的表单ID如😛UR_PurchaseOrder SubHeadEntity.FEntity.Operation 执行的操作 Save SubHeadEntity.FEntity.IsAutoSubmitAndAudit 提交并审核 true SubHeadEntity.FEntity.IsVerifyBaseDataField 验证基础资料 TRUE 是否验证所有的基础资料有效性，布尔类，默认false（非必录） SubHeadEntity.FEntity.SubSystemId 系统模块 21 默认仓库模块 SubHeadEntity.FEntity.InterationFlags InterationFlags STK_InvCheckResult 系统打通概况全新的API数据集成模式，赋能企业业务创新传统企业集成主要采用点对点或ESB集成方式，基于全新API战略中台的API新型集成方式通过解耦系统资源，降低系统间对接难度，实现快速业务需求响应，提升对接效率，助力企业满足快速业务交付需求，实现业务创新。通过构建API生态，助力能力开放与共享基于API战略中台梳理并整合内部API资源与IT资产，可实现内部资源共享，满足内部开发人员资源使用需求，例如：金蝶云星空与伯俊ERP之间数据集成；并将API资源对外可控开放，打造面向开发者的生态服务，为您打通自身和上下游合作伙伴，创造共赢价值链。开展API战略中台，重塑IT 帮助您基于内部资源构建不同业务能力中心，打造企业统一API战略中台，赋能企业发展，实现对业务频繁变化的快速响应。同时您在能力中心基础上构建新业务时，无需从“零”组建各业务模块，提升开发效率，重塑IT组织及交付能力。

伯俊ERP与金蝶云星空对接集成表头表体组合查询打通销售出库新增

庄颜_qeasy

伯俊ERP与金蝶云星空对接集成表头表体组合查询打通销售出库新增

来源系统:伯俊ERP

伯俊科技拥有近千人的团队、出色的本地化服务能力及强劲的研发创新实力，在深耕零售行业24年中，成功研发企业级ERP系统、OMS订单管理系统、门店收银系统、门店管理软硬件一体机等。探索零售行业数字化的进程中，伯俊科技成功落地百余全渠道项目，积累丰富的业务中台、数据中台落地经验。

对接目标系统:金蝶云星空

金蝶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	条件	1
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_RETAIL
params.command	操作命令	Query
params.reftables	关联表	5191	{"name":"StringToArray","params":","}

响应参数

接口字段	字段名称	描述
OWNERID	创建人	autoFillResponse
CREATIONDATE	创建时间	_autoFillResponse
BILLDATE	单据日期	autoFillResponse
EDIFLAG	接口标记	_autoFillResponse
WRITE_DATE	写入时间	autoFillResponse
ORGANIZATION	财务组织	_autoFillResponse
DESCRIPTION	备注	autoFillResponse
BILLTYPE	单据类型	_autoFillResponse
DOCNO	单据编号	autoFillResponse
ORIGNMAE	零售店仓
reftables	reftables	_autoFillResponse
reftables.DOCNO	单据编号	autoFillResponse
reftables.NO	款号	_autoFillResponse
reftables.PRICELIST	标准价	autoFillResponse
reftables.KD_DISCOUNT	组织折扣	_autoFillResponse
reftables.QTY	数量	autoFillResponse
reftables.PRICEACTUAL	成交价	_autoFillResponse
reftables.TOT_AMT_ACTUAL	成交金额	autoFillResponse
reftables.DISCOUNT	折扣	_autoFillResponse
reftables.WRITE_TIME	写入时间	autoFillResponse
reftables.READ_TIME	提取时间	_autoFillResponse
reftables.EDIFLAG	接口标记	autoFillResponse
reftables.RESULTS	问题原因	_autoFillResponse
reftables.CUSTOMER_ORGANIZE	销售组织

金蝶云星空接口明细

API：batchSave
NAME：销售出库新增
METHOD：POST

请求参数

接口字段	字段名称	预设值	描述
FBillTypeID	单据类型	XSCKD01_SYS	单据类型
FBillNo	单据编号	{{DOCNO}}	单据编号
FDate	日期	{{BILLDATE}}	日期
FSaleOrgId	销售组织	{{CUSTOMER_ORGANIZE}}	组织
FCustomerID	客户	{{ORIGNMAE}}	基础资料
FStockOrgId	发货组织	{{ORGANIZATION}}	组织
FNote	备注		多行文本
FOwnerTypeIdHead	货主类型		多类别基础资料列表
FOwnerIdHead	货主		多类别基础资料
SubHeadEntity	财务信息
SubHeadEntity.FSettleOrgID	结算组织	{{ORGANIZATION}}	组织
SubHeadEntity.FEntity	明细信息	reftables
SubHeadEntity.FEntity.FMaterialID	物料编码	{{reftables.NO}}	基础资料
SubHeadEntity.FEntity.FRealQty	实发数量	{{reftables.QTY}}	数量
SubHeadEntity.FEntity.FPrice	单价	function abs({{reftables.PRICEACTUAL}})	单价
SubHeadEntity.FEntity.FTaxPrice	含税单价	_function abs({{reftables.PRICEACTUAL}})	单价
SubHeadEntity.FEntity.FEntryTaxRate	税率%		小数
SubHeadEntity.FEntity.FEntryTaxAmount	税额		金额
SubHeadEntity.FEntity.FAmount	金额	{{reftables.TOT_AMT_ACTUAL}}	金额
SubHeadEntity.FEntity.FAllAmount	价税合计	{{reftables.TOT_AMT_ACTUAL}}	金额
SubHeadEntity.FEntity.FStockID	仓库	function case when '{{CK_NEW}}'='' then '{{ORIGNMAE}}' else '{{CK_NEW}}' end	基础资料
SubHeadEntity.FEntity.FStockStatusID	库存状态	KCZT01_SYS	基础资料
SubHeadEntity.FEntity.FEntrynote	备注		文本
SubHeadEntity.FEntity.FDiscountRate	折扣率%		小数
SubHeadEntity.FEntity.FIsFree	是否赠品		复选框
SubHeadEntity.FEntity.F_wk_zk	折扣	{{reftables.KD_DISCOUNT}}
SubHeadEntity.FEntity.F_wk_DPJ	标准价	{{reftables.PRICELIST}}
SubHeadEntity.FEntity.F_wk_ZKL	组织折扣	{{reftables.KD_DISCOUNT}}
SubHeadEntity.FEntity.FOwnerTypeID	货主类型	BD_OwnerOrg
SubHeadEntity.FEntity.FOwnerID	货主	_findCollection find FCreateOrgId_FNumber from 0b1afab3-a35b-3ee4-8a26-3dd62dfa8739 where FNumber={{reftables.NO}} _endFind
SubHeadEntity.FEntity.FormId	业务对象表单Id	SAL_OUTSTOCK	必须填写金蝶的表单ID如😛UR_PurchaseOrder
SubHeadEntity.FEntity.Operation	执行的操作	Save
SubHeadEntity.FEntity.IsAutoSubmitAndAudit	提交并审核	true
SubHeadEntity.FEntity.IsVerifyBaseDataField	验证基础资料	TRUE	是否验证所有的基础资料有效性，布尔类，默认false（非必录）
SubHeadEntity.FEntity.SubSystemId	系统模块	21	默认仓库模块
SubHeadEntity.FEntity.InterationFlags	InterationFlags	STK_InvCheckResult

系统打通概况

全新的API数据集成模式，赋能企业业务创新传统企业集成主要采用点对点或ESB集成方式，基于全新API战略中台的API新型集成方式通过解耦系统资源，降低系统间对接难度，实现快速业务需求响应，提升对接效率，助力企业满足快速业务交付需求，实现业务创新。通过构建API生态，助力能力开放与共享基于API战略中台梳理并整合内部API资源与IT资产，可实现内部资源共享，满足内部开发人员资源使用需求，例如：金蝶云星空与伯俊ERP之间数据集成；并将API资源对外可控开放，打造面向开发者的生态服务，为您打通自身和上下游合作伙伴，创造共赢价值链。开展API战略中台，重塑IT 帮助您基于内部资源构建不同业务能力中心，打造企业统一API战略中台，赋能企业发展，实现对业务频繁变化的快速响应。同时您在能力中心基础上构建新业务时，无需从“零”组建各业务模块，提升开发效率，重塑IT组织及交付能力。