吉客云对接打通金蝶云星空分页查询出库单接口与盘亏单新增接口

接通系统：吉客云

“吉客云”是一站式企业数字化解决方案系统，可实现业务、财务、办公、人事等一体化管理。相对于传统多套软件系统的集成方案，“吉客云”具有业务流程更流畅，数据共享更充分，使用成本更低廉等优势。不仅如此，通过“吉链”，可以快捷的与您的合作伙伴进行系统对接。同时“吉客云”还打造了供销关系、仓储委托关系、生产委外加工关系、物流代发关系等多种企业间数字化协作通道，数据对接就像加微信好友一样方便！

对接目标系统:金蝶云星空

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

系统对接接口配置

通过轻易云系统数据集成平台新增创建集成方案，然后在数据源平台中选择对应的源平台为：吉客云，并且选择对应的连接器（关于吉客云的接口连接器如何配置可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息）。选择对应的分页查询出库单接口作为数据对接来源。然后再通过写入目标平台配置目标系统为金蝶云星空，并且选择对应连接器。选择对应的盘亏单新增接口作为数据写入动作，既可以完成第一步的数据对接配置；打破跨系统连接，让数据轻易互通成为现实。

吉客云接口明细

API：erp.storage.goodsdocout
NAME：分页查询出库单
METHOD：POST

请求参数

接口字段字段名称预设值描述 pageIndex分页页码 pageSize分页页数50 goodsDocNo入库单号 gmtModifiedStart修改时间的起始时间function from_unixtime(({{LAST_SYNC_TIME}}-86400),'%Y-%m-%d %H:%i:%s') gmtModifiedEnd修改时间的结束时间_function from_unixtime(({{CURRENT_TIME}}-86400),'%Y-%m-%d %H:%i:%s') inouttype入库类型203201-销售出库 202调拨出库 203 = 盘亏出库 204-其他出库 205采购退货 206生产领料 207组装拆卸出库 208翻新出库 209报废出库 210残次品出库 211倒冲出库 212 包材出库 215维修还厂 231成本调整出库 warehouseId仓库ID warehouseCode仓库编号 vendId供应商ID(往来单位) vendCode供应商编号(往来单位) billNo上游单据号(关联单号) userName创建人名称

响应参数

接口字段字段名称预设值描述 recId入库单ID goodsdocNo入库单号 billNo上游单据号(关联单号) inOutDate入库时间 gmtCreate创建时间 inouttype入库类型入库类型(100-期初库存101-采购入库102-调拨入库103-盘盈入库104-其他入库105-销售退货106-完工入库107-组装拆卸入库108-翻新入库109-报废入库110-残次品入库111-成本调整112-即采即入113-退料入库114-调拨退回115-维修返厂返还) inouttypeName入库类型入库类型(100-期初库存101-采购入库102-调拨入库103-盘盈入库104-其他入库105-销售退货106-完工入库107-组装拆卸入库108-翻新入库109-报废入库110-残次品入库111-成本调整112-即采即入113-退料入库114-调拨退回115-维修返厂返还) vendCustomerCode往来单位编号 vendCustomerName往来单位名称 currencyCode币种编号 currencyRate币种汇率 userName业务员名字 warehouseCode仓库编号 warehouseName仓库名字 comment备注 memo收货备注 logisticName物流公司 logisticNo物流单号 companyId公司id companyName公司名称 logisticType物流类型物流类型1-普通快递2-上门自提3-门店配送5-无需配送6-线下配送 logisticCode物流公司编码 inOutReason入库原因 sourceBillNo来源单号 channelId渠道ID channelCode渠道编号 channelName渠道名称 redStatus红冲状态：1蓝单（未红冲）；2被冲蓝单；9红冲单 field1自定义字段1 field2自定义字段2 field3自定义字段3 field4自定义字段4 field5自定义字段5 financeBillStatus财务状态财务状态：1：未成本计算；11部分成本计算；21：已成本计算；25已财务记账；31不成本计算 goodsDocDetailList入库单详情 goodsDocDetailList.recId入库单明细ID goodsDocDetailList.goodsId货品ID goodsDocDetailList.goodsNo货品编号 goodsDocDetailList.goodsName货品名称 goodsDocDetailList.skuId规格ID goodsDocDetailList.skuName规格名称 goodsDocDetailList.skuBarcode条码 goodsDocDetailList.unitName单位 goodsDocDetailList.cuPrice单价 goodsDocDetailList.cuValue金额 goodsDocDetailList.caseNumber箱号 goodsDocDetailList.rowRemark明细备注 goodsDocDetailList.assistUnit辅助单位显示 goodsDocDetailList.estCost含税金额 goodsDocDetailList.estTax税额 goodsDocDetailList.estPrice含税单价 goodsDocDetailList.estPriceNoTax含税单价 goodsDocDetailList.estCostNoTax无税金额 goodsDocDetailList.taxRate税率 goodsDocDetailList.batchNo批次编号 goodsDocDetailList.serialNo序列号 goodsDocDetailList.productionDate生产日期 goodsDocDetailList.expirationDate到期日期 goodsDocDetailList.shelfLife质保期 goodsDocDetailList.shelfLiftUnit质保期单位 goodsDocDetailList.sourceDetailId来源单据明细Id goodsDocDetailList.transNoTaxPrice无税单价（原币种） goodsDocDetailList.transNoTaxAmount无税金额（原币种） goodsDocDetailList.transHasTaxPrice含税单价（原币种） goodsDocDetailList.transHasTaxAmount含税金额（原币种） goodsDocDetailList.transTaxAmount税额（原币种） goodsDocDetailList.detailField1自定义字段1 goodsDocDetailList.detailField2自定义字段2 goodsDocDetailList.detailField3自定义字段3 goodsDocDetailList.detailField4自定义字段4 goodsDocDetailList.detailField5自定义字段5 goodsDocDetailList.isCertified是否正品0 goodsDocDetailList.registrationNumber批准文号 goodsDocDetailList.approvalDate批文有效期 goodsDocDetailList.productionDepart生产单位 goodsDocDetailList.batchNumber生产批号 goodsDocDetailList.quantity数量 goodsDocDetailList.applyCompanyId申请人公司ID goodsDocDetailList.applyCompanyName申请人公司名称 goodsDocDetailList.applyCompanyCode申请人公司编号 goodsDocDetailList.applyDepartId申请人部门id goodsDocDetailList.applyDepartName申请人部门名称 goodsDocDetailList.outBillNo外部单号

金蝶云星空接口明细

API：batchSave
NAME：盘亏单新增
METHOD：POST

请求参数

接口字段字段名称预设值描述 FBillNo单据编号{{goodsdocNo}}单据编号 FBillTypeID单据类型QTCKD01_SYS单据类型 FStockOrgId库存组织{{companyCode}}组织 FPickOrgId领用组织{{companyCode}}组织 FStockDirect库存方向GENERAL下拉列表 FDate日期_function FROM_UNIXTIME( ( {{inOutDate}} / 1000 ) ,'%Y-%m-%d %T' )日期 FDeptId领料部门BM000016基础资料 FOwnerTypeIdHead货主类型BD_OwnerOrg多类别基础资料列表 FOwnerIdHead货主{{companyCode}}多类别基础资料 FNote备注多行文本 F_LSJC_Text关联单号{{billNo}}多行文本 F_LSJC_Text1来源单号{{sourceBillNo}}多行文本 F_LSJC_Text2收货单号{{deliveryNo}}多行文本 F_LSJC_Text4入库类型{{inouttypeName}}多行文本 F_LSJC_Text11备注{{memo}}多行文本 FEntity明细信息goodsDocDetailList FEntity.FMaterialId物料编码{{goodsDocDetailList.goodsNo}}基础资料 FEntity.FCMKBarCode零售条形码文本 FEntity.FQty实发数量{{goodsDocDetailList.quantity}}数量 FEntity.FStockId发货仓库{{companyCode}}基础资料 FEntity.FPrice成本价{{goodsDocDetailList.cuPrice}}单价 FEntity.FAmount总成本{{goodsDocDetailList.cuValue}}金额 FEntity.FLot批号01批次 FEntity.FOwnerTypeId货主类型BD_OwnerOrg多类别基础资料列表 FEntity.FOwnerId货主{{companyCode}}多类别基础资料 FEntity.FEntryNote备注多行文本 FEntity.F_LSJC_Text3条码{{goodsDocDetailList.skuBarcode}}多行文本 FEntity.FormId业务对象表单IdSTK_MisDelivery必须填写金蝶的表单ID如😛UR_PurchaseOrder FEntity.IsAutoSubmitAndAudit提交并审核true FEntity.IsVerifyBaseDataField验证基础资料false是否验证所有的基础资料有效性，布尔类，默认false（非必录） FEntity.Operation执行的操作Save

系统对接概况

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

吉客云对接打通金蝶云星空分页查询出库单接口与盘亏单新增接口