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

源系统:吉客云

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

对接系统：金蝶云星空

金蝶K/3Cloud在总结百万家客户管理最佳实践的基础上，提供了标准的管理模式；通过标准的业务架构：多会计准则、多币别、多地点、多组织、多税制应用框架等，有效支持企业的运营管理；K/3Cloud提供了标准的业务建模：35种标准ERP领域模型、1046种模型元素、21243种模型元素属性组合，288个业务服务构件，让企业及伙伴可快速构建出行业化及个性化的应用。

系统对接接口配置

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

吉客云接口明细

调用接口：erp.storage.goodsdocout
接口名称：分页查询出库单
方法：POST

请求参数

字段字段名称类型配置值 pageIndex分页页码string pageSize分页页数string50 goodsDocNo出库单号string startDate创建时间的起始时间string endDate创建时间的结束时间string inouttype类型string204 sourceBillNo来源单号string warehouseCode仓库编号string vendCode供应商编号(往来单位)string billNo上游单据号(关联单号)string userName创建人名称string gmtModifiedStart主表更新时间起始string{{LAST_SYNC_TIME datetime}} gmtModifiedEnd主表更新时间截至string{{CURRENT_TIME datetime}}

响应参数

字段字段名称类型配置值 goodsdocNo出库单号string billNo上游单据号(关联单号)string inOutDate出库时间string gmtCreate创建时间string inouttype出入库类型string inouttypeName出入库类型string vendCustomerName往来单位名称string currencyCode币种编号string currencyRate币种汇率string userName业务员名字string warehouseCode仓库编号string warehouseName仓库名字string comment备注string memo收货备注string logisticName物流公司string logisticNo物流单号string companyId公司idstring companyName公司名称string logisticType物流类型1-普通快递 2-上门自提 3-门店配送5-无需配送 6-线下配送string logisticCode物流公司编码string inOutReason出库原因string sourceBillNo来源单号string channelId渠道IDstring channelCode渠道编号string channelName渠道名称string redStatus红冲状态：1蓝单（未红冲）；2被冲蓝单；9红冲单string field1自定义字段1string field2自定义字段2string field3自定义字段3string field4自定义字段4string field5自定义字段5string financeBillStatus财务状态string goodsDocDetailList出库单详情array goodsDocDetailList.recId出库单明细IDstring goodsDocDetailList.goodsId货品IDstring goodsDocDetailList.goodsNo货品编号string goodsDocDetailList.goodsName货品名称string goodsDocDetailList.skuId规格IDstring goodsDocDetailList.skuName规格名称string goodsDocDetailList.skuBarcode条码string goodsDocDetailList.unitName单位string goodsDocDetailList.cuPrice单价string goodsDocDetailList.cuValue金额string goodsDocDetailList.caseNumber箱号string goodsDocDetailList.rowRemark明细备注string goodsDocDetailList.assistUnit辅助单位显示string goodsDocDetailList.estCost含税金额string goodsDocDetailList.estTax税额string goodsDocDetailList.estPrice含税单价string goodsDocDetailList.estPriceNoTax含税单价string goodsDocDetailList.estCostNoTax无税金额string goodsDocDetailList.taxRate税率string goodsDocDetailList.batchNo批次编号string goodsDocDetailList.serialNo序列号string goodsDocDetailList.productionDate生产日期string goodsDocDetailList.expirationDate到期日期string goodsDocDetailList.shelfLife质保期string goodsDocDetailList.shelfLiftUnit质保期单位string goodsDocDetailList.sourceDetailId来源单据明细Idstring goodsDocDetailList.transNoTaxPrice无税单价（原币种）string goodsDocDetailList.transNoTaxAmount无税金额（原币种）string goodsDocDetailList.transHasTaxPrice含税单价（原币种）string goodsDocDetailList.transHasTaxAmount含税金额（原币种）string goodsDocDetailList.transTaxAmount税额（原币种）string goodsDocDetailList.detailField1自定义字段1string goodsDocDetailList.detailField2自定义字段2string goodsDocDetailList.detailField3自定义字段3string goodsDocDetailList.detailField4自定义字段4string goodsDocDetailList.detailField5自定义字段5string goodsDocDetailList.isCertified是否正品 0-否 1-是string goodsDocDetailList.registrationNumber批准文号string goodsDocDetailList.approvalDate批文有效期 string goodsDocDetailList.productionDepart生产单位 string goodsDocDetailList.batchNumber生产批号string goodsDocDetailList.quantity数量string goodsDocDetailList.vendCustomerId往来单位的idstring goodsDocDetailList.applyDepartId申请人部门idstring goodsDocDetailList.applyDepartName申请人部门名称string goodsDocDetailList.outBillNo外部单号string

金蝶云星空接口明细

调用接口：batchSave
接口名称：分布式调出单新增
方法：POST

请求参数

字段字段名称类型配置值 FBillNo单据编号string{{goodsdocNo}} FOwnerTypeIdHead调出货主类型stringBD_OwnerOrg FBillTypeID单据类型stringFBDC01_SYS FTransferBizType调拨类型stringOverOrgTransfer FOwnerIdHead调出货主string103 FOwnerTypeInIdHead调入货主类型stringBD_OwnerOrg FTransferDirect调拨方向stringRETURN FOwnerInIdHead调入货主string101 FStockOrgID调出库存组织string103 FStockInOrgID调入库存组织string101 FDate日期stringfunction FROM_UNIXTIME( ( {{gmtModified}} / 1000 ) ,'%Y-%m-%d %T' ) FVESTONWAY在途归属stringA FNOTE备注string FBizType业务类型stringNORMAL FSTKTRSOUTENTRY明细信息arraygoodsDocDetailList FSTKTRSOUTENTRY.FMaterialID物料编码string{{goodsDocDetailList.goodsNo}} FSTKTRSOUTENTRY.FUnitID单位string_findCollection find FPurchaseUnitId_FNumber from 44da707b-4d02-3e20-ad97-fdd69ff7a37d where FNumber={{goodsDocDetailList.goodsNo}} FSTKTRSOUTENTRY.FQty数量string{{goodsDocDetailList.quantity}} FSTKTRSOUTENTRY.FSrcStockID调出仓库string{{warehouseCode}} FSTKTRSOUTENTRY.FDestStockID调入仓库string FSTKTRSOUTENTRY.FLOT批号string{{goodsDocDetailList.batchNo}} FSTKTRSOUTENTRY.FProduceDate生产日期string_function FROM_UNIXTIME( ( {{productionDate}} / 1000 ) ,'%Y-%m-%d %T' ) FSTKTRSOUTENTRY.FEXPIRYDATE有效期至string FSTKTRSOUTENTRY.FSrcStockStatusID调出库存状态stringKCZT01_SYS FSTKTRSOUTENTRY.FDestStockStatusID在途库存状态stringKCZT05_SYS FSTKTRSOUTENTRY.FOwnerTypeID调出货主类型stringBD_OwnerOrg FSTKTRSOUTENTRY.FOwnerID调出货主string103 FSTKTRSOUTENTRY.FOwnerTypeInID调入货主类型stringBD_OwnerOrg FSTKTRSOUTENTRY.FKeeperTypeInID调入保管者类型stringBD_KeeperOrg FSTKTRSOUTENTRY.FKeeperInID调入保管者string101 FSTKTRSOUTENTRY.FDestMaterialID调入物料string{{goodsDocDetailList.goodsNo}} FSTKTRSOUTENTRY.FKeeperTypeID调出保管者类型stringBD_KeeperOrg FSTKTRSOUTENTRY.FKeeperID调出保管者string103 FSTKTRSOUTENTRY.FormId业务对象表单IdstringSTK_TRANSFEROUT FSTKTRSOUTENTRY.Operation执行的操作stringBatchSave FSTKTRSOUTENTRY.IsAutoSubmitAndAudit提交并审核booltrue FSTKTRSOUTENTRY.IsVerifyBaseDataField验证基础资料boolfalse

系统数据集成价值

随着企业数字化业务的深入发展，对于企业的 IT 或者 CIO 来讲，正在面临一个愈发重要的问题——系统的结构太复杂了，尤其是头部企业，至少有十多套系统，这些系统之间的蛛网状的接口如果经常出问题。企业内部以及企业内部与外部建立起越来越多的业务应用系统，如何整合企业的现有IT资源，使企业中计算机孤岛式的应用向集体协作的方向发展，发挥资源效益的最大化，降低企业成本，正在逐渐成为企业关注的重要问题。用户希望企业内所有系统集成在一个平台上，操作统一，以节省培训时间。使用在轻易云应用集成平台 + MDM基础数据平台的解决方案中，轻易云应用集成平台负责实现异构、分布式系统之间互联互通，实现服务API治理以及数据传输交换。通过轻易云预置的各种适配器组件，连接现有各孤立应用系统，以图形化、拖拽方式构建集成流程和服务，提高应用系统集成工作效率，降低异构系统集成风险。针对未来可能出现的业务需求变更，在应用集成平台上进行动态调整，实现各应用系统之间的集成策略平滑升级。

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