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

对接系统吉客云

杭州吉客云网络技术有限公司是经国家认定的高新技术企业，是国内领先的SaaSERP软件服务商，致力于为企业提供安全稳定、高可用性和高扩展性的一站式数字化解决方案。

接入系统：金蝶云星空

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

数据接口配置

系统对接前期需要通过调研公司的业务，规划出最便捷，效率最高的整体流程。通过流程我们需要建立对应的方案来吧这些流程一一的落地，轻易云集成平台开箱即用的、可视化拖、拉、拽实现接口服务编排与聚合。只需要根据指引设定好对应的参数即可启动使用。设定好源平台：吉客云的接口参数设置，以及设定好目标平台：金蝶云星空的映射，即可启动方案进行测试

吉客云接口明细

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

请求参数

字段字段名称类型配置值 pageIndex分页页码string pageSize分页页数string50 goodsDocNo出库单号string startDate创建时间的起始时间string2022-01-22 00:00:00 endDate创建时间的结束时间string2022-01-22 23:59:59 inouttype类型string202 sourceBillNo来源单号string warehouseCode仓库编号string vendCode供应商编号(往来单位)string billNo上游单据号(关联单号)string userName创建人名称string

响应参数

字段字段名称类型配置值 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

金蝶云星空接口明细

API：batchSave
NAME：其他出库新增
METHOD：POST

请求参数

接口字段字段名称预设值描述 FBillNo单据编号{{goodsdocNo}}单据编号 FBillTypeID单据类型QTCKD08_SYS单据类型 FStockOrgId库存组织findCollection find textField_kvgbyy6b from ba7b4c50-b81c-315d-835f-9e07995df2a1 where textField_kvgbyy68={{warehouseCode}}组织 FPickOrgId领用组织_findCollection find textField_kvgbyy6b from ba7b4c50-b81c-315d-835f-9e07995df2a1 where textField_kvgbyy68={{warehouseCode}}组织 FStockDirect库存方向GENERAL下拉列表 FDate日期function FROM_UNIXTIME( ( {{inOutDate}} / 1000 ) ,'%Y-%m-%d %T' )日期 FBizType业务类型下拉列表 FOwnerIdHead货主{{companyCode}}多类别基础资料 FNote备注{{comment}}多行文本 FEntity明细信息goodsDocDetailList FEntity.FMaterialId物料编码{{goodsDocDetailList.goodsNo}}基础资料 FEntity.FCMKBarCode零售条形码文本 FEntity.FQty实发数量{{goodsDocDetailList.quantity}}数量 FEntity.FStockStatusId库存状态 FEntity.FStockId发货仓库{{warehouseCode}}基础资料 FEntity.FStockLocId仓位维度关联字段 FEntity.FAmount总成本金额 FEntity.FPrice成本价{{goodsDocDetailList.cuPrice}}单价 FEntity.FLot批号批次 FEntity.FSrcBillTypeId源单类型源单类型 FEntity.FSrcBillNo源单编号源单编号 FEntity.FOwnerTypeId货主类型多类别基础资料列表 FEntity.FOwnerId货主多类别基础资料 FEntity.FEntryNote备注{{goodsDocDetailList.rowRemark}}多行文本 FEntity.F_JKBillNo吉客云单据编号{{sourceBillNo}} FEntity.FDeptId领料部门_findCollection find textField_kvrpwy79 from ba7b4c50-b81c-315d-835f-9e07995df2a1 where textField_kvgbyy6b={{companyCode}} FEntity.FormId业务对象表单IdSTK_MisDelivery必须填写金蝶的表单ID如😛UR_PurchaseOrder FEntity.IsAutoSubmitAndAudit提交并审核false FEntity.IsVerifyBaseDataField验证基础资料false是否验证所有的基础资料有效性，布尔类，默认false（非必录） FEntity.Operation执行的操作Save

数据对接价值

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

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