吉客云和金蝶云星空单据接口集成
对接系统金蝶云星空
金蝶K/3Cloud（金蝶云星空）是移动互联网时代的新型ERP，是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”，旨在帮助企业打造面向新时代的生态互联与协同平台，围绕生态中的每个角色，提供随手可得的云服务，最终实现敏捷协同，智慧运营的企业运营新境界。整个产品采用SOA架构，完全基于BOS平台组建而成，业务架构上贯穿流程驱动与角色驱动思想，结合中国管理模式与中国管理实践积累，精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建，支持跨数据库应用，支持本地部署、私有云部署与公有云部署三种部署方式，同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业，其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。
对接目标平台:吉客云
吉客云是基于“网店管家”十五年电商ERP行业和技术积累基础上顺应产业发展需求，重新定位、全新设计推出的换代产品，从业务数字化和组织数字化两个方向出发，以构建流程的闭环为依归，致力于为企业的数字化升级提供落地工具。
配置集成方案
数据集成平台对应的配置金蝶云星空与吉客云的对接只要三步就能完成两个系统之间的数据对接。第一步根据金蝶云星空的接口参数要求记录在轻易云集成平台。第二步配置金蝶云星空与吉客云之间的字段对应关系（更多方案可借鉴轻易云数据集成社区论坛中找到相关方案信息）第三步完成方案的检查参数设置：传递时间、重试次数、是否启动、前置条件等上线运行。
金蝶云星空接口明细
- API：executeBillQuery
- NAME：调拨单查询
- METHOD：POST
请求参数
| 接口字段 | 字段名称 | 预设值 | 描述 |
|---|
| FBillEntry_FEntryID | FEntryID | FBillEntry_FEntryID | |
| FID | 实体主键 | FID | |
| FBillNo | 单据编号 | FBillNo | |
| FDocumentStatus | 单据状态 | FDocumentStatus | |
| FStockOrgId_FNumber | 调入库存组织 | FStockOrgId.FNumber | |
| FDate | 日期 | FDate | |
| FBillTypeID_FNumber | 单据类型 | FBillTypeID.FNumber | |
| FTransferBizType | 调拨类型 | FTransferBizType | |
| FStockOutOrgId_FNumber | 调出库存组织 | FStockOutOrgId.FNumber | |
| FTransferDirect | 调拨方向 | FTransferDirect | |
| FNote | 备注 | FNote | |
| FBizType | 业务类型 | FBizType | |
| FSaleOrgId_FNumber | 销售组织 | FSaleOrgId.FNumber | |
| FSettleOrgId_FNumber | 结算组织 | FSettleOrgId.FNumber | |
| FCustID_FNumber | 对应客户 | FCustID.FNumber | |
| FSUPPLIERID_FNumber | 对应供应商 | FSUPPLIERID.FNumber | |
| FThirdSrcId | 第三方源单内码 | FThirdSrcId | |
| FThirdSrcBillNo | 第三方源单编码 | FThirdSrcBillNo | |
| FThirdSystem | 第三方系统 | FThirdSystem | |
| FMaterialId_FNumber | 物料编码 | FMaterialId.FNumber | |
| FLot | 调出批号 | FLot.fnumber | |
| FSrcStockId_FNumber | 调出仓库 | FSrcStockId.FNumber | |
| FSrcStockLocId | 调出仓位 | FSrcStockLocId | |
| FDestStockId_FNumber | 调入仓库 | FDestStockId.FNumber | |
| FDestStockLocId | 调入仓位 | FDestStockLocId | |
| FBaseQty | 调拨数量 | FBaseQty | |
| FPrice | 成本价 | FPrice | |
| FAmount | 总成本 | FAmount | |
| FBomId | BOM版本 | FBomId | |
| FProduceDate | 生产日期 | FProduceDate | |
| FExpiryDate | 有效期至 | FExpiryDate | |
| FMaterialId_FExpPeriod | 保质期 | FMaterialId.FExpPeriod | |
| FSrcStockStatusId | 调出库存状态 | FSrcStockStatusId | |
| FDestStockStatusId | 调入库存状态 | FDestStockStatusId | |
| FOwnerId_FNumber | 调入货主 | FOwnerId.FNumber | |
| FOwnerOutId_FNumber | 调出货主 | FOwnerOutId.FNumber | |
| FSrcBillTypeId | 源单类型 | FSrcBillTypeId | |
| FSrcSeq | 源单行号 | FSrcSeq | |
| FOrderNo | 订单编号 | FOrderNo | |
| FNoteEntry | 备注 | FNoteEntry | |
| FSrcBillNo | 源单编号 | FSrcBillNo | |
| FBFLowId | 业务流程 | FBFLowId | |
| FConsignPrice | 单价 | FConsignPrice | |
| FTaxPrice | 含税单价 | FTaxPrice | |
| FTaxRate | 税率% | FTaxRate | |
| FDestLot | 调入批号 | FDestLot.fnumber | |
| FQmEntryId | 库存请检单EntryId | FQmEntryId | |
| FConvertEntryId | 库存状态转换EntryId | FConvertEntryId | |
| FSOEntryId | 销售订单EntryId | FSOEntryId | |
| FThirdSrcEntryId | 第三方源单分录编码 | FThirdSrcEntryId | |
| FISFREE | 赠品 | FISFREE | |
| FMaterialId_FPurchaseUnitId_FConvertDenominator | FMaterialId_FPurchaseUnitId_FConvertDenominator | | |
| FMaterialId_FPurchaseUnitId_FConvertNumerator | FMaterialId_FPurchaseUnitId_FConvertNumerator | | |
| FRemainInStockQty | 采购单位数量 | | |
| Limit | 最大行数 | {{PAGINATION_PAGE_SIZE}} | 金蝶的查询分页参数 |
| FieldKeys | 需查询的字段key集合 | | 金蝶分录主键ID格式：FPOOrderEntry_FEntryId,其它格式 FPurchaseOrgId.FNumber |
| TopRowCount | 返回总行数 | | 金蝶的查询分页参数 |
| FilterString | 过滤条件 | FApproveDate>='{{LAST_SYNC_TIME dateTime}}' and FDestStockId.FNumber ='01DS' and FSrcStockId.FNumber='24DS' and FCreatorId.fname <> 'GYERP管易对接账号' | 示例写法 FSupplierId.FNumber = 'VEN00010' and FApproveDate>= |
| FormId | 业务对象表单Id | STK_TransferDirect | 必须填写金蝶的表单ID如😛UR_PurchaseOrder |
| StartRow | 开始行索引 | {{PAGINATION_START_ROW}} | 金蝶的查询分页参数 |
响应参数
| 接口字段 | 字段名称 | 预设值 | 描述 |
|---|
| FBillEntry_FEntryID | FEntryID | | |
| FID | 实体主键 | | |
| FBillNo | 单据编号 | | |
| FDocumentStatus | 单据状态 | | |
| FStockOrgId_FNumber | 调入库存组织 | | |
| FDate | 日期 | | |
| FBillTypeID_FNumber | 单据类型 | | |
| FTransferBizType | 调拨类型 | | |
| FStockOutOrgId_FNumber | 调出库存组织 | | |
| FTransferDirect | 调拨方向 | | |
| FNote | 备注 | | |
| FBizType | 业务类型 | | |
| FSaleOrgId_FNumber | 销售组织 | | |
| FSettleOrgId_FNumber | 结算组织 | | |
| FCustID_FNumber | 对应客户 | | |
| FSUPPLIERID_FNumber | 对应供应商 | | |
| FThirdSrcId | 第三方源单内码 | | |
| FThirdSrcBillNo | 第三方源单编码 | | |
| FThirdSystem | 第三方系统 | | |
| FMaterialId_FNumber | 物料编码 | | |
| FLot | 调出批号 | | |
| FSrcStockId_FNumber | 调出仓库 | | |
| FSrcStockLocId | 调出仓位 | | |
| FDestStockId_FNumber | 调入仓库 | | |
| FDestStockLocId | 调入仓位 | | |
| FBaseQty | 调拨数量 | | |
| FPrice | 成本价 | | |
| FAmount | 总成本 | | |
| FBomId | BOM版本 | | |
| FProduceDate | 生产日期 | | |
| FExpiryDate | 有效期至 | | |
| FMaterialId_FExpPeriod | 保质期 | | |
| FSrcStockStatusId | 调出库存状态 | | |
| FDestStockStatusId | 调入库存状态 | | |
| FOwnerId_FNumber | 调入货主 | | |
| FOwnerOutId_FNumber | 调出货主 | | |
| FSrcBillTypeId | 源单类型 | | |
| FSrcSeq | 源单行号 | | |
| FOrderNo | 订单编号 | | |
| FNoteEntry | 备注 | | |
| FSrcBillNo | 源单编号 | | |
| FBFLowId | 业务流程 | | |
| FConsignPrice | 单价 | | |
| FTaxPrice | 含税单价 | | |
| FTaxRate | 税率% | | |
| FDestLot | 调入批号 | | |
| FQmEntryId | 库存请检单EntryId | | |
| FConvertEntryId | 库存状态转换EntryId | | |
| FSOEntryId | 销售订单EntryId | | |
| FThirdSrcEntryId | 第三方源单分录编码 | | |
| FISFREE | 赠品 | | |
| FMaterialId_FPurchaseUnitId_FConvertDenominator | FMaterialId_FPurchaseUnitId_FConvertDenominator | | |
| FMaterialId_FPurchaseUnitId_FConvertNumerator | FMaterialId_FPurchaseUnitId_FConvertNumerator | | |
| FRemainInStockQty | 采购单位数量 | | |
吉客云接口明细
- 调用接口：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 | {{FDate}} |
| memo | 备注 | string | {{FNOTE}} |
| 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}} |
| 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资产的可插拔、可复用、可组成。
