金蝶云星空和吉客云集成接口设计

对接源平台:金蝶云星空
金蝶K/3Cloud在总结百万家客户管理最佳实践的基础上,提供了标准的管理模式;通过标准的业务架构:多会计准则、多币别、多地点、多组织、多税制应用框架等,有效支持企业的运营管理;K/3Cloud提供了标准的业务建模:35种标准ERP领域模型、1046种模型元素、21243种模型元素属性组合,288个业务服务构件,让企业及伙伴可快速构建出行业化及个性化的应用。
对接系统:吉客云
“吉客云”是一站式企业数字化解决方案系统,可实现业务、财务、办公、人事等一体化管理。相对于传统多套软件系统的集成方案,“吉客云”具有业务流程更流畅,数据共享更充分,使用成本更低廉等优势。不仅如此,通过“吉链”,可以快捷的与您的合作伙伴进行系统对接。同时“吉客云”还打造了供销关系、仓储委托关系、生产委外加工关系、物流代发关系等多种企业间数字化协作通道,数据对接就像加微信好友一样方便!
系统对接接口配置
数据集成平台对应的配置金蝶云星空与吉客云的对接只要三步就能完成两个系统之间的数据对接。第一步根据金蝶云星空的接口参数要求记录在轻易云集成平台。第二步配置金蝶云星空与吉客云之间的字段对应关系(更多方案可借鉴轻易云数据集成社区论坛中找到相关方案信息)第三步完成方案的检查参数设置:传递时间、重试次数、是否启动、前置条件等上线运行。数据管道ETL:构建一体化的数据融合平台。高级数据转换: 支持公式转换数据格式、支持脚本直接进行数据转换、支持可视化多维度数据处理。高性能实时处理:针对不同数据节点类型提供TB级吞吐量,秒级延迟的增量数据处理能力。自动将旧版web服务转变为基于云端微服务的API,统一接口输出标准。支持接口开放服务,实现内外部能力接入。



金蝶云星空接口明细
- 接口:executeBillQuery
- 接口名称:分布式调入单查询
- 接口方法:POST
请求参数
| 字段 | 名称 | 类型 |
| FOwnerOutID_FNumber | 调出货主 | string |
| FSrcMaterialId_FNumber | 调出物料 | string |
| FProduceDate | 生产日期 | string |
| FSrcBillType | 源单类型 | string |
| StartRow | 开始行索引 | string |
| FApproveDate | 审核日期 | string |
| FSrcProduceDate | 调出生产日期 | string |
| FBillNo | 单据编号 | string |
| FTransferMode | 调拨方式 | string |
| FStockOutFlag | 出库库存更新标识 | string |
| FDestStockID_FNumber | 调入仓库 | string |
| FMaterialId_FPurchaseUnitId_FConvertDenominator | FMaterialId_FPurchaseUnitId_FConvertDenominator | string |
| FilterString | 过滤条件 | string |
| FOwnerID_FNumber | 调入货主 | string |
| FThirdSystem | 第三方系统 | string |
| FWayAuxUnitQty | 途损数量(辅单位) | string |
| FMaterialId_FPurchaseUnitId_FConvertNumerator | FMaterialId_FPurchaseUnitId_FConvertNumerator | string |
| FSTKTRSINENTRY_FEntryID | FEntryID | string |
| FPlanTransferQty | 计划调拨数量 | string |
| FSRCBILLNAME | 源单单据类型 | string |
| FCreateDate | 创建日期 | string |
| FTransferBizType | 调拨类型 | string |
| TopRowCount | 返回总行数 | int |
| FDocumentStatus | 单据状态 | string |
| FAmount | 总成本 | string |
| FSrcBillNo | 源单编号 | string |
| FSrcExpiryDate | 调出有效期至 | string |
| FSRCBOMID | 调出BOM | string |
| FBusinessDate | 入库日期 | string |
| FBizType | 业务类型 | string |
| FSrcStockID_FNumber | 调出仓库 | string |
| FCustID_FNumber | 对应客户 | string |
| Limit | 最大行数 | string |
| FSRCStockLocId | 调出仓位 | string |
| FDestStockLocId | 调入仓位 | string |
| FPrice | 成本价 | string |
| FThirdSrcId | 第三方源单内码 | string |
| FNOTE | 备注 | string |
| FDate | 日期 | string |
| FEXPIRYDATE | 有效期至 | string |
| FSRCMTONO | 调出计划跟踪号 | string |
| FBOMID | BOM版本 | string |
| FExtAuxUnitQty | 调入数量(辅单位) | string |
| FStockInFlag | 入库库存更新标识 | string |
| FCMKBarCode | 零售条形码 | string |
| FieldKeys | 需查询的字段key集合 | array |
| FBillTypeID | 单据类型 | string |
| FEntryNote | 备注 | string |
| FSUPPLIERID_FNumber | 对应供应商 | string |
| FBaseQty | 基本单位调入数量 | string |
| FThirdSrcBillNo | 第三方源单编码 | string |
| FLOT_FNumber | 调出批号 | string |
| FUnitID | 单位 | string |
| FormId | 业务对象表单Id | string |
| FSrcBillDate | 源单日期 | string |
| FSrcProjectNo | 调出项目编号 | string |
| FThirdSrcEntryId | 第三方源单分录编码 | string |
| FMaterialId_FExpPeriod | 保质期 | string |
| FID | 实体主键 | string |
| FMaterialID_FNumber | 物料编码 | string |
| FStockOrgID_FNumber | 调入库存组织 | string |
| FDestLot_FNumber | 调入批号 | string |
| FTransferDirect | 调拨方向 | string |
| FRemainInStockQty | 采购单位数量 | string |
响应参数
| 字段 | 名称 | 类型 | 描述 |
| FSTKTRSINENTRY_FEntryID | FEntryID | string | |
| FID | 实体主键 | string | |
| FBillNo | 单据编号 | string | |
| FDocumentStatus | 单据状态 | string | |
| FStockOrgID_FNumber | 调入库存组织 | string | |
| FDate | 日期 | string | |
| FBillTypeID | 单据类型 | string | |
| FTransferDirect | 调拨方向 | string | |
| FNOTE | 备注 | string | |
| FCreateDate | 创建日期 | string | |
| FApproveDate | 审核日期 | string | |
| FTransferMode | 调拨方式 | string | |
| FTransferBizType | 调拨类型 | string | |
| FBizType | 业务类型 | string | |
| FCustID_FNumber | 对应客户 | string | |
| FSUPPLIERID_FNumber | 对应供应商 | string | |
| FThirdSystem | 第三方系统 | string | |
| FThirdSrcId | 第三方源单内码 | string | |
| FThirdSrcBillNo | 第三方源单编码 | string | |
| FMaterialID_FNumber | 物料编码 | string | |
| FCMKBarCode | 零售条形码 | string | |
| FSrcStockID_FNumber | 调出仓库 | string | |
| FDestStockID_FNumber | 调入仓库 | string | |
| FBaseQty | 基本单位调入数量 | string | |
| FPrice | 成本价 | string | |
| FAmount | 总成本 | string | |
| FBOMID | BOM版本 | string | |
| FProduceDate | 生产日期 | string | |
| FEXPIRYDATE | 有效期至 | string | |
| FMaterialId_FExpPeriod | 保质期 | string | |
| FOwnerID_FNumber | 调入货主 | string | |
| FUnitID | 单位 | string | |
| FStockOutFlag | 出库库存更新标识 | string | |
| FStockInFlag | 入库库存更新标识 | string | |
| FDestStockLocId | 调入仓位 | string | |
| FSRCStockLocId | 调出仓位 | string | |
| FSrcBillType | 源单类型 | string | |
| FSrcBillNo | 源单编号 | string | |
| FOwnerOutID_FNumber | 调出货主 | string | |
| FLOT_FNumber | 调出批号 | string | |
| FEntryNote | 备注 | string | |
| FSRCBILLNAME | 源单单据类型 | string | |
| FSrcBillDate | 源单日期 | string | |
| FDestLot_FNumber | 调入批号 | string | |
| FSrcMaterialId_FNumber | 调出物料 | string | |
| FSRCBOMID | 调出BOM | string | |
| FSrcProduceDate | 调出生产日期 | string | |
| FSrcExpiryDate | 调出有效期至 | string | |
| FSRCMTONO | 调出计划跟踪号 | string | |
| FSrcProjectNo | 调出项目编号 | string | |
| FPlanTransferQty | 计划调拨数量 | string | |
| FBusinessDate | 入库日期 | string | |
| FExtAuxUnitQty | 调入数量(辅单位) | string | |
| FWayAuxUnitQty | 途损数量(辅单位) | string | |
| FThirdSrcEntryId | 第三方源单分录编码 | string | |
| FMaterialId_FPurchaseUnitId_FConvertDenominator | FMaterialId_FPurchaseUnitId_FConvertDenominator | string | |
| FMaterialId_FPurchaseUnitId_FConvertNumerator | FMaterialId_FPurchaseUnitId_FConvertNumerator | string | |
| FRemainInStockQty | 采购单位数量 | string | |
吉客云接口明细
- 调用接口:erp.stock.createandstockin
- 接口名称:创建入库申请单并入库
- 方法:POST
请求参数
| 字段 | 字段名称 | 类型 | 配置值 |
| vendCode | 供应商编码 | string | |
| applyDepartCode | 部门编码 | string | H04 |
| applyCompanyCode | 入库公司编码 | string | 103 |
| inWarehouseCode | 仓库编码 | string | {{FDestStockID_FNumber}} |
| inType | 入库类型 | string | 101 |
| relDataId | 关联单据编号 | string | {{FBillNo}} |
| applyUserId | 申请人 | string | 1 |
| applyUserName | 申请人姓名 | string | 吕修远 |
| applyDate | 申请时间 | string | {{FApproveDate}} |
| memo | 备注 | string | {{FBillNo}} |
| operator | 制单人 | string | 吕修远 |
| source | 写死:OPEN | string | OPEN |
| logisticNo | 物流单号 | string | 1 |
| logisticCode | 物流公司编号 | string | |
| stockInDetailViews | 入库申请单明细 | array | details |
| stockInDetailViews.skuBarcode | 货品编号 | string | {{details.FMaterialID_FNumber}} |
| stockInDetailViews.relDetailId | 关联实际业务明细表的id | string | |
| stockInDetailViews.skuCount | 入库数量 | string | {{details.FRemainInStockQty}} |
| stockInDetailViews.isCertified | 是否正品 | string | 1 |
| stockInDetailViews.batchList | 批号明细 | array | |
| stockInDetailViews.batchList.batchNo | 批号 | string | {{details.FDestLot_FNumber}} |
| stockInDetailViews.batchList.quantity | 数量 | string | {{details.FRemainInStockQty}} |
| stockInDetailViews.batchList.productionDate | 生产日期 | string | {{details.FProduceDate}} |
| stockInDetailViews.batchList.expirationDate | 到期日期 | string | {{details.FEXPIRYDATE}} |
| stockInDetailViews.batchList.shelfLife | 保质期 | string | function case '{{details.FMaterialId_FExpPeriod}}' when '0' then '' else {{details.FMaterialId_FExpPeriod}} end |
| stockInDetailViews.batchList.shelfLiftUnit | 保质期单位 | string | _findCollection find FExpUnit from 44da707b-4d02-3e20-ad97-fdd69ff7a37d where FNumber={{details.FMaterialID_FNumber}} |
系统打通概况
从API服务总线层面解决企业烟囱式业务系统集成现状 相互连接企业各业务系统,实现流程端到端打通,复用已有的业务系统能力,让集成架构、服务关系更清晰 使用统一的API管理平台,对API进行显性化、可视化,使所有API服务成为企业的数字资产,提升API利用率,发挥业务系统价值,实现企业IT资产的可插拔、可复用、可组成。


