吉客云和金蝶云星空单据接口集成

对接系统金蝶云星空

金蝶K/3Cloud（金蝶云星空）是移动互联网时代的新型ERP，是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”，旨在帮助企业打造面向新时代的生态互联与协同平台，围绕生态中的每个角色，提供随手可得的云服务，最终实现敏捷协同，智慧运营的企业运营新境界。整个产品采用SOA架构，完全基于BOS平台组建而成，业务架构上贯穿流程驱动与角色驱动思想，结合中国管理模式与中国管理实践积累，精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建，支持跨数据库应用，支持本地部署、私有云部署与公有云部署三种部署方式，同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业，其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。

对接目标平台:吉客云

吉客云是基于“网店管家”十五年电商ERP行业和技术积累基础上顺应产业发展需求，重新定位、全新设计推出的换代产品，从业务数字化和组织数字化两个方向出发，以构建流程的闭环为依归，致力于为企业的数字化升级提供落地工具。

配置集成方案

数据集成平台对应的配置金蝶云星空与吉客云的对接只要三步就能完成两个系统之间的数据对接。第一步根据金蝶云星空的接口参数要求记录在轻易云集成平台。第二步配置金蝶云星空与吉客云之间的字段对应关系（更多方案可借鉴轻易云数据集成社区论坛中找到相关方案信息）第三步完成方案的检查参数设置：传递时间、重试次数、是否启动、前置条件等上线运行。

金蝶云星空接口明细

API：executeBillQuery
NAME：调拨单查询
METHOD：POST

请求参数

接口字段字段名称预设值描述 FBillEntry_FEntryIDFEntryIDFBillEntry_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 FBomIdBOM版本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库存请检单EntryIdFQmEntryId FConvertEntryId库存状态转换EntryIdFConvertEntryId FSOEntryId销售订单EntryIdFSOEntryId FThirdSrcEntryId第三方源单分录编码FThirdSrcEntryId FISFREE赠品FISFREE FMaterialId_FPurchaseUnitId_FConvertDenominatorFMaterialId_FPurchaseUnitId_FConvertDenominator FMaterialId_FPurchaseUnitId_FConvertNumeratorFMaterialId_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业务对象表单IdSTK_TransferDirect必须填写金蝶的表单ID如😛UR_PurchaseOrder StartRow开始行索引{{PAGINATION_START_ROW}}金蝶的查询分页参数

响应参数

接口字段字段名称预设值描述 FBillEntry_FEntryIDFEntryID 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总成本 FBomIdBOM版本 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_FConvertDenominatorFMaterialId_FPurchaseUnitId_FConvertDenominator FMaterialId_FPurchaseUnitId_FConvertNumeratorFMaterialId_FPurchaseUnitId_FConvertNumerator FRemainInStockQty采购单位数量

吉客云接口明细

调用接口：erp.stock.createandstockin
接口名称：创建入库申请单并入库
方法：POST

请求参数

字段字段名称类型配置值 vendCode供应商编码string applyDepartCode部门编码stringH04 applyCompanyCode入库公司编码string103 inWarehouseCode仓库编码string{{FDestStockId_FNumber}} inType入库类型string101 relDataId关联单据编号string{{FBillNo}} applyUserId申请人string1 applyUserName申请人姓名string吕修远 applyDate申请时间string{{FDate}} memo备注string{{FNOTE}} operator制单人string吕修远 source写死：OPENstringOPEN logisticNo物流单号string1 logisticCode物流公司编号string stockInDetailViews入库申请单明细arraydetails stockInDetailViews.skuBarcode货品编号string{{details.FMaterialId_FNumber}} stockInDetailViews.relDetailId关联实际业务明细表的idstring stockInDetailViews.skuCount入库数量string{{details.FRemainInStockQty}} stockInDetailViews.isCertified是否正品string1 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保质期stringfunction 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资产的可插拔、可复用、可组成。

吉客云和金蝶云星空单据接口集成