伯俊ERP和金蝶云星空接口打通对接实战
对接系统伯俊ERP
未来，伯俊科技也会砥砺前行，不断为品牌提供更全面的零售终端致胜利器。伯俊科技始终坚持创新发展，探索大零售行业发力方向及突破机会，不断总结提炼当前及未来的新场景新玩法，优化升级自身体系的同时陪伴客户持续性发展。
对接目标系统:金蝶云星空
金蝶K/3Cloud（金蝶云星空）是移动互联网时代的新型ERP，是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”，旨在帮助企业打造面向新时代的生态互联与协同平台，围绕生态中的每个角色，提供随手可得的云服务，最终实现敏捷协同，智慧运营的企业运营新境界。整个产品采用SOA架构，完全基于BOS平台组建而成，业务架构上贯穿流程驱动与角色驱动思想，结合中国管理模式与中国管理实践积累，精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建，支持跨数据库应用，支持本地部署、私有云部署与公有云部署三种部署方式，同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业，其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。
数据接口配置方案
通过轻易云系统数据集成平台新增创建集成方案，然后在数据源平台中选择对应的源平台为：伯俊ERP，并且选择对应的连接器（关于伯俊ERP的接口连接器如何配置可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息）。选择对应的表头表体组合查询接口作为数据对接来源。然后再通过写入目标平台配置目标系统为金蝶云星空，并且选择对应连接器。选择对应的应收单新增接口作为数据写入动作，既可以完成第一步的数据对接配置；打破跨系统连接，让数据轻易互通成为现实。
伯俊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条件5
params.expr1.expr2.column字段BILLTYPE
params.expr1.expr2.combine组合关系AND“and” “or” “and not” “or not”，若设置，必填expr1和expr2属性，忽略 column和condition。
params.table表名KD_RECEIVABLE
params.command操作命令Query
params.reftables关联表5196
响应参数
接口字段字段名称预设值描述
SOURCE_DOCNOSOURCE_DOCNO
autoFillResponse
OWNERID创建人_autoFillResponse
CREATIONDATE创建时间
autoFillResponse
FEETYPEFEETYPE_autoFillResponse
BILLDATE单据日期
autoFillResponse
MODIFIEDDATEMODIFIEDDATE_autoFillResponse
EDIFLAG接口标记
autoFillResponse
WRITE_TIMEWRITE_TIME_autoFillResponse
ORGANIZATION财务组织
autoFillResponse
AMT_RECEIVABLEAMT_RECEIVABLE_autoFillResponse
DESCRIPTION备注
autoFillResponse
MODIFIERIDMODIFIERID_autoFillResponse
BILLTYPEBILLTYPE
autoFillResponse
DOCNO单据编号_autoFillResponse
IDID
autoFillResponse
reftablesreftables_autoFillResponse
reftables.DOCNO单据编号
autoFillResponse
reftables.NO款号_autoFillResponse
reftables.PRICELIST标准价
autoFillResponse
reftables.QTY数量_autoFillResponse
reftables.DISCOUNT折扣
autoFillResponse
reftables.PRICEACTUAL成交价_autoFillResponse
reftables.TOT_AMT_ACTUAL成交金额
autoFillResponse
reftables.OWNERID_TRUENAME创建人_autoFillResponse
reftables.CREATIONDATE创建时间
autoFillResponse
reftables.MODIFIERID_TRUENAME修改人_autoFillResponse
reftables.MODIFIEDDATE修改时间_autoFillResponse
金蝶云星空接口明细
- 调用接口：batchSave
- 接口名称：应收单新增
- 方法：POST
请求参数
字段字段名称类型配置值
FID实体主键string
FBillNo单据编号string{{DOCNO}}
FDATE业务日期string{{BILLDATE}}
FCURRENCYID币别stringPRE001
FBillTypeID单据类型stringJTK
FENDDATE_H到期日string{{CREATIONDATE}}
FCUSTOMERID客户string{{CUSTOMER_CODE}}
FBUSINESSTYPE业务类型stringBZ
FEntityDetail明细arrayreftables
FEntityDetail.FMATERIALID物料编码string{{reftables.NO}}
FEntityDetail.FTaxPrice含税单价string_function abs({{TOT_AMT_ACTUAL}})
FEntityDetail.FPriceQty计价数量string{{reftables.QTY}}
FEntityDetail.FComment备注string创建人：{{TRUENAME}} ；客户：{{CUSTOMER_CODE}}
FEntityDetail.FSOURCETYPE源单类型stringSAL_OUTSTOCK
FEntityDetail.FSourceBillNo源单编号string{{SOURCE_DOCNO}}
FEntityDetail.FLot批号string
FEntityDetail.FCOSTID费用项目编码string
FEntityDetail.FCOSTNAME费用项目名称string
FEntityDetail.FCOSTDEPARTMENTID费用承担部门string
FEntityDetail.FSalUnitId销售单位string
FEntityDetail.FSalQty销售数量string
FEntityDetail.F_WK_BZJ标准价string{{reftables.PRICELIST}}
FEntityDetail.FEntryTaxRate税率string
FEntityDetail.FALLAMOUNTFOR_D价税合计string{{reftables.TOT_AMT_ACTUAL}}
FEntityDetail.FNoTaxAmountFor_D不含税金额string{{reftables.TOT_AMT_ACTUAL}}
FEntityDetail.FSETTLEORGID结算组织string{{ORGANIZATION}}
FEntityDetail.FPAYORGID付款组织string{{ORGANIZATION}}
FEntityDetail.FREMARK备注string{{DESCRIPTION}}
FEntityDetail.FormId业务对象表单IdstringAR_receivable
FEntityDetail.Operation执行的操作stringBatchSave
FEntityDetail.IsAutoSubmitAndAudit提交并审核boolfalse
FEntityDetail.IsVerifyBaseDataField验证基础资料boolfalse
系统对接概况
采集并引入全业务、多终端、多形态的数据，经过处理以及对应平台接口的数据结构适配，形成以业务核心为对象为中心的连接和标签体系。配合企业根据自身的实际情况以及业务需求完成方案的规划、部署与实施，将沉淀的业务数据进入到平台进行体系化的加工，再以服务化的方式支持业务平台上的应用。达成高效支持业务敏捷创新的高质量和标准化的数据服务组合。
