金蝶云星空与吉客云对接集成分布式调入单查询连通创建入库申请单并入库(金蝶云星空分布式调入单对接吉客云其他入库测试)

接通系统:金蝶云星空
金蝶K/3Cloud(金蝶云星空)是移动互联网时代的新型ERP,是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”,旨在帮助企业打造面向新时代的生态互联与协同平台,围绕生态中的每个角色,提供随手可得的云服务,最终实现敏捷协同,智慧运营的企业运营新境界。整个产品采用SOA架构,完全基于BOS平台组建而成,业务架构上贯穿流程驱动与角色驱动思想,结合中国管理模式与中国管理实践积累,精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建,支持跨数据库应用,支持本地部署、私有云部署与公有云部署三种部署方式,同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业,其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。
对接目标系统:吉客云
吉客云是基于“网店管家”十五年电商ERP行业和技术积累基础上顺应产业发展需求,重新定位、全新设计推出的换代产品,从业务数字化和组织数字化两个方向出发,以构建流程的闭环为依归,致力于为企业的数字化升级提供落地工具。
数据集成方案配置
通过轻易云系统数据集成平台新增创建集成方案,然后在数据源平台中选择对应的源平台为:金蝶云星空,并且选择对应的连接器(关于金蝶云星空的接口连接器如何配置可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息)。选择对应的分布式调入单查询接口作为数据对接来源。然后再通过写入目标平台配置目标系统为吉客云,并且选择对应连接器。选择对应的创建入库申请单并入库接口作为数据写入动作,既可以完成第一步的数据对接配置;打破跨系统连接,让数据轻易互通成为现实。

金蝶云星空接口明细
- 调用接口:executeBillQuery
- 接口名称:分布式调入单查询
- 方法:POST
请求参数
| 字段 | 字段名称 | 类型 | 配置值 |
| FSTKTRSINENTRY_FEntryID | FEntryID | string | FSTKTRSINENTRY_FEntryID |
| FID | 实体主键 | string | FID |
| FBillNo | 单据编号 | string | FBillNo |
| FDocumentStatus | 单据状态 | string | FDocumentStatus |
| FStockOrgID_FNumber | 调入库存组织 | string | FStockOrgID.FNumber |
| FDate | 日期 | string | FDate |
| FBillTypeID | 单据类型 | string | FBillTypeID |
| FTransferDirect | 调拨方向 | string | FTransferDirect |
| FNOTE | 备注 | string | FNOTE |
| FCreateDate | 创建日期 | string | FCreateDate |
| FApproveDate | 审核日期 | string | FApproveDate |
| FTransferMode | 调拨方式 | string | FTransferMode |
| FTransferBizType | 调拨类型 | string | FTransferBizType |
| FBizType | 业务类型 | string | FBizType |
| FCustID_FNumber | 对应客户 | string | FCustID.FNumber |
| FSUPPLIERID_FNumber | 对应供应商 | string | FSUPPLIERID.FNumber |
| FThirdSystem | 第三方系统 | string | FThirdSystem |
| FThirdSrcId | 第三方源单内码 | string | FThirdSrcId |
| FThirdSrcBillNo | 第三方源单编码 | string | FThirdSrcBillNo |
| FMaterialID_FNumber | 物料编码 | string | FMaterialID.FNumber |
| FCMKBarCode | 零售条形码 | string | FCMKBarCode |
| FSrcStockID_FNumber | 调出仓库 | string | FSrcStockID.FNumber |
| FDestStockID_FNumber | 调入仓库 | string | FDestStockID.FNumber |
| FBaseQty | 基本单位调入数量 | string | FBaseQty |
| FPrice | 成本价 | string | FPrice |
| FAmount | 总成本 | string | FAmount |
| FBOMID | BOM版本 | string | FBOMID |
| FProduceDate | 生产日期 | string | FProduceDate |
| FEXPIRYDATE | 有效期至 | string | FEXPIRYDATE |
| FMaterialId_FExpPeriod | 保质期 | string | FMaterialId.FExpPeriod |
| FOwnerID_FNumber | 调入货主 | string | FOwnerID.FNumber |
| FUnitID | 单位 | string | FUnitID |
| FStockOutFlag | 出库库存更新标识 | string | FStockOutFlag |
| FStockInFlag | 入库库存更新标识 | string | FStockInFlag |
| FDestStockLocId | 调入仓位 | string | FDestStockLocId |
| FSRCStockLocId | 调出仓位 | string | FSRCStockLocId |
| FSrcBillType | 源单类型 | string | FSrcBillType |
| FSrcBillNo | 源单编号 | string | FSrcBillNo |
| FOwnerOutID_FNumber | 调出货主 | string | FOwnerOutID.FNumber |
| FLOT_FNumber | 调出批号 | string | FLOT.FNumber |
| FEntryNote | 备注 | string | FEntryNote |
| FSRCBILLNAME | 源单单据类型 | string | FSRCBILLNAME |
| FSrcBillDate | 源单日期 | string | FSrcBillDate |
| FDestLot_FNumber | 调入批号 | string | FDestLot.FNumber |
| FSrcMaterialId_FNumber | 调出物料 | string | FSrcMaterialId.FNumber |
| FSRCBOMID | 调出BOM | string | FSRCBOMID |
| FSrcProduceDate | 调出生产日期 | string | FSrcProduceDate |
| FSrcExpiryDate | 调出有效期至 | string | FSrcExpiryDate |
| FSRCMTONO | 调出计划跟踪号 | string | FSRCMTONO |
| FSrcProjectNo | 调出项目编号 | string | FSrcProjectNo |
| FPlanTransferQty | 计划调拨数量 | string | FPlanTransferQty |
| FBusinessDate | 入库日期 | string | FBusinessDate |
| FExtAuxUnitQty | 调入数量(辅单位) | string | FExtAuxUnitQty |
| FWayAuxUnitQty | 途损数量(辅单位) | string | FWayAuxUnitQty |
| FThirdSrcEntryId | 第三方源单分录编码 | string | FThirdSrcEntryId |
| FMaterialId_FPurchaseUnitId_FConvertDenominator | FMaterialId_FPurchaseUnitId_FConvertDenominator | string | |
| FMaterialId_FPurchaseUnitId_FConvertNumerator | FMaterialId_FPurchaseUnitId_FConvertNumerator | string | |
| FRemainInStockQty | 采购单位数量 | string | |
| Limit | 最大行数 | string | {{PAGINATION_PAGE_SIZE}} |
| StartRow | 开始行索引 | string | {{PAGINATION_START_ROW}} |
| TopRowCount | 返回总行数 | int | |
| FilterString | 过滤条件 | string | FApproveDate>='{{LAST_SYNC_TIME datetime}}' and FDestStockID.FNumber in ('01DS') |
| FieldKeys | 需查询的字段key集合 | array | |
| FormId | 业务对象表单Id | string | STK_TRANSFERIN |
响应参数
| 字段 | 字段名称 | 类型 | 配置值 |
| 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 | |
吉客云接口明细
- API:erp.stock.createandstockin
- NAME:创建入库申请单并入库
- METHOD:POST
请求参数
| 接口字段 | 字段名称 | 预设值 | 描述 |
| vendCode | 供应商编码 | | |
| applyDepartCode | 部门编码 | H04 | 部门编号和公司编号 要同时填否则部门信息会有偏差 |
| applyCompanyCode | 入库公司编码 | 103 | 公司编号和部门编号 要同时填否则公司信息会有偏差 |
| inWarehouseCode | 仓库编码 | {{FDestStockID_FNumber}} | |
| inType | 入库类型 | 101 | 入库类型 101=采购入库 102=调拨入库 103=盘盈入库 104=其他入库 |
| relDataId | 关联单据编号 | {{FBillNo}} | 可随机,保证不重复即可 |
| applyUserId | 申请人 | 1 | |
| applyUserName | 申请人姓名 | 吕修远 | 超级用户 |
| applyDate | 申请时间 | {{FApproveDate}} | |
| memo | 备注 | {{FBillNo}} | |
| operator | 制单人 | 吕修远 | |
| source | 写死:OPEN | OPEN | |
| logisticNo | 物流单号 | 1 | |
| logisticCode | 物流公司编号 | | |
| stockInDetailViews | 入库申请单明细 | details | |
| stockInDetailViews.skuBarcode | 货品编号 | {{details.FMaterialID_FNumber}} | 匹配货品信息的外部货品编号(按skuId>outSkuCode>skuBarcode匹配顺序,必传一个) |
| stockInDetailViews.relDetailId | 关联实际业务明细表的id | | |
| stockInDetailViews.skuCount | 入库数量 | {{details.FRemainInStockQty}} | |
| stockInDetailViews.isCertified | 是否正品 | 1 | 是否正品,1是0否 |
| stockInDetailViews.batchList | 批号明细 | | |
| stockInDetailViews.batchList.batchNo | 批号 | {{details.FDestLot_FNumber}} | 匹配货品信息的外部货品编号(按skuId>outSkuCode>skuBarcode匹配顺序,必传一个) |
| stockInDetailViews.batchList.quantity | 数量 | {{details.FRemainInStockQty}} | 匹配货品信息的外部货品编号(按skuId>outSkuCode>skuBarcode匹配顺序,必传一个) |
| stockInDetailViews.batchList.productionDate | 生产日期 | {{details.FProduceDate}} | 匹配货品信息的外部货品编号(按skuId>outSkuCode>skuBarcode匹配顺序,必传一个) |
| stockInDetailViews.batchList.expirationDate | 到期日期 | {{details.FEXPIRYDATE}} | 匹配货品信息的外部货品编号(按skuId>outSkuCode>skuBarcode匹配顺序,必传一个) |
| stockInDetailViews.batchList.shelfLife | 保质期 | function case '{{details.FMaterialId_FExpPeriod}}' when '0' then '' else {{details.FMaterialId_FExpPeriod}} end | 匹配货品信息的外部货品编号(按skuId>outSkuCode>skuBarcode匹配顺序,必传一个) |
| stockInDetailViews.batchList.shelfLiftUnit | 保质期单位 | _findCollection find FExpUnit from 44da707b-4d02-3e20-ad97-fdd69ff7a37d where FNumber={{details.FMaterialID_FNumber}} | 匹配货品信息的外部货品编号(按skuId>outSkuCode>skuBarcode匹配顺序,必传一个) |
系统数据对接
使用全界面可视化配置集成流,快速应对企业的集成需求使得金蝶云星空与吉客云之间的数据接口一站式的快速集成能力,构建企业数据通道,解决数据孤岛问题。快速构建企业元数据标准、主数据标准、业财数据标准,完成数据的采集、统一、分发、清洗、归集等,帮助企业建立高质量的数据中台。目前轻易云平台已经支持300+系统,同时具备快速适配新系统的能力,集成海量接口数据。无论是对接ERP还是MES、OA、CRM、WMS、OMS等等系统,都可以通过接口相互集成。
