金蝶云星空和吉客云接口打通对接实战

金蝶云星空和吉客云接口打通对接实战

来源系统:金蝶云星空

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

写入目标:吉客云

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

多系统对接方案配置

集成方案是整个轻易云集成平台的核心，每一个集成方案代表一种业务的对接策略（对接方案借鉴可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息），用户可以根据业务的不同新建多个不同规则的集成方案。比如：采购订单同步，线上销售出库同步，线下销售出库同步。一个集成方案必须要配置源系统：金蝶云星空，源系统 API：调拨单查询，目标系统：吉客云，目标系统 API创建入库申请单并入库。在新增集成方案之前需要确定两个系统的连接器都已经配置完成。

金蝶云星空接口明细

• 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 FSrcStockId_FNumber调出仓库FSrcStockId.FNumber FSrcStockLocId调出仓位FSrcStockLocId FDestStockId_FNumber调入仓库FDestStockId.FNumber FDestStockLocId调入仓位FDestStockLocId FQty调拨数量FQty FPrice成本价FPrice FAmount总成本FAmount FBomIdBOM版本FBomId FProduceDate生产日期FProduceDate FExpiryDate有效期至FExpiryDate FMtoNo计划跟踪号FMtoNo 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 FQmEntryId库存请检单EntryIdFQmEntryId FConvertEntryId库存状态转换EntryIdFConvertEntryId FSOEntryId销售订单EntryIdFSOEntryId FThirdSrcEntryId第三方源单分录编码FThirdSrcEntryId FISFREE赠品FISFREE F_TANT_Price结算单价F_TANT_Price F_TANT_Amount结算金额F_TANT_Amount FCreatorId_FName创建人名称FCreatorId.FName Limit最大行数{{PAGINATION_PAGE_SIZE}}金蝶的查询分页参数 FieldKeys需查询的字段key集合金蝶分录主键ID格式：FPOOrderEntry_FEntryId,其它格式 FPurchaseOrgId.FNumber TopRowCount返回总行数金蝶的查询分页参数 FilterString过滤条件FApproveDate>='{{LAST_SYNC_TIME dateTime}}' and FDestStockId.F_TANT_CheckBox=1示例写法 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调入仓位 FQty调拨数量 FPrice成本价 FAmount总成本 FBomIdBOM版本 FProduceDate生产日期 FExpiryDate有效期至 FMtoNo计划跟踪号 FSrcStockStatusId调出库存状态 FDestStockStatusId调入库存状态 FOwnerId_FNumber调入货主 FOwnerOutId_FNumber调出货主 FSrcBillTypeId源单类型 FSrcSeq源单行号 FOrderNo订单编号 FNoteEntry备注 FSrcBillNo源单编号 FBFLowId业务流程 FConsignPrice单价 FTaxPrice含税单价 FTaxRate税率% FDestLot调入批号 FQmEntryId库存请检单EntryId FConvertEntryId库存状态转换EntryId FSOEntryId销售订单EntryId FThirdSrcEntryId第三方源单分录编码 FISFREE赠品 F_TANT_Price结算单价 F_TANT_Amount结算金额 FCreatorId_FName创建人名称

吉客云接口明细

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

请求参数

字段名称类型描述 vendCode供应商编码string applyDepartCode部门编码string部门编号和公司编号 要同时填否则部门信息会有偏差 applyCompanyCode入库公司编码string公司编号和部门编号 要同时填否则公司信息会有偏差 inWarehouseCode仓库编码string inType入库类型string入库类型 101=采购入库 102=调拨入库 103=盘盈入库 104=其他入库 relDataId关联单据编号string可随机，保证不重复即可 applyUserId申请人string applyUserName申请人姓名string超级用户 applyDate申请时间string memo备注string operator制单人string source写死：OPENstring logisticNo物流单号string logisticCode物流公司编号string stockInDetailViews入库申请单明细array stockInDetailViews.skuBarcode货品编号string匹配货品信息的外部货品编号(按skuId>outSkuCode>skuBarcode匹配顺序，必传一个) stockInDetailViews.relDetailId关联实际业务明细表的idstring stockInDetailViews.skuCount入库数量string stockInDetailViews.isCertified是否正品string是否正品，1是0否 stockInDetailViews.skuPrice入库价格string stockInDetailViews.totalAmount入库金额string

数据对接效果

通过轻易云集成平台系列产品线可以协助企业轻易快捷的构建基于微服务架构的新一代企业服务总线，传统基于SOA架构的ESB产品主要解决的数据集成和协议转换等基础功能，已完全不能满足基于微服务架构、混合云集成架构、跨组织、跨单位的总线解决方案。 而轻易云集成平台的每个产品线都是新一代的按照最新的互联网架构模式进行研发的产品线，能快速协助企业从传统的SOA架构转向微服务架构的服务总线解决方案。