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

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

对接系统吉客云

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

接入系统：金蝶云星空

金蝶K/3Cloud结合当今先进管理理论和数十万家国内客户最佳应用实践，面向事业部制、多地点、多工厂等运营协同与管控型企业及集团公司，提供一个通用的ERP服务平台。K/3Cloud支持的协同应用包括但不限于：集中/分散销售、集中/分散采购、B2B电商管理、B2C电商中心、供应商协同、多工厂计划、跨工厂领料、跨工厂加工、工厂间调拨、内部交易及结算、集团财务管理、阿米巴经营等。

数据接口配置

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

吉客云接口明细

• 接口：erp.storage.goodsdocin
• 接口名称：查询组装拆卸模板明细
• 接口方法：POST

请求参数

字段名称类型描述 pageIndex分页页码string pageSize分页页数string goodsDocNo入库单号string startDate创建时间的起始时间string endDate创建时间的结束时间string inouttype入库类型string入库类型(100-期初库存 101-采购入库 102-调拨入库 103-盘盈入库 104-其他入库 105-销售退货 106-完工入库 107-组装拆卸入库 108-翻新入库 109-报废入库 110-残次品入库111-成本调整 112-即采即入113-退料入库114-调拨退回115-维修返厂返还) warehouseId仓库IDstring warehouseCode仓库编号string vendId供应商ID(往来单位)string vendCode供应商编号(往来单位)string billNo上游单据号(关联单号)string userName创建人名称string gmtModifiedStart主表更新时间起始string gmtModifiedEnd主表更新时间截至string

响应参数

字段名称类型描述 goodsdocNo入库单号string billNo上游单据号(关联单号)string inOutDate入库时间string gmtCreate创建时间string inouttype入库类型string入库类型(100-期初库存 101-采购入库 102-调拨入库 103-盘盈入库 104-其他入库 105-销售退货 106-完工入库 107-组装拆卸入库 108-翻新入库 109-报废入库 110-残次品入库111-成本调整 112-即采即入113-退料入库114-调拨退回115-维修返厂返还) inouttypeName入库类型string入库类型(100-期初库存 101-采购入库 102-调拨入库 103-盘盈入库 104-其他入库 105-销售退货 106-完工入库 107-组装拆卸入库 108-翻新入库 109-报废入库 110-残次品入库111-成本调整 112-即采即入113-退料入库114-调拨退回115-维修返厂返还) vendCustomerCode往来单位编号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物流类型string物流类型1-普通快递 2-上门自提 3-门店配送5-无需配送 6-线下配送 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财务状态：1：未成本计算；11部分成本计算；21：已成本计算；25已财务记账；31不成本计算 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.applyCompanyId申请人公司IDstring goodsDocDetailList.applyCompanyName申请人公司名称string goodsDocDetailList.applyCompanyCode申请人公司编号string goodsDocDetailList.applyDepartId申请人部门idstring goodsDocDetailList.applyDepartName申请人部门名称string goodsDocDetailList.outBillNo外部单号string

金蝶云星空接口明细

• API：batchSave
• NAME：调拨单新增
• METHOD：POST

请求参数

接口字段字段名称预设值描述 FBillNo单据编号{{goodsdocNo}}单据编号 FBillTypeID单据类型QTRKD01_SYS单据类型 FStockOrgId库存组织{{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.FInStockType入库类型下拉列表 FEntity.FMATERIALID物料编码{{goodsDocDetailList.goodsNo}}基础资料 FEntity.FCMKBarCode零售条形码文本 FEntity.FStockStatusId库存状态 FEntity.FSTOCKID收货仓库{{companyCode}}基础资料 FEntity.FLOT批号01批次 FEntity.FQty实收数量{{goodsDocDetailList.quantity}}数量 FEntity.FPrice成本价{{goodsDocDetailList.cuPrice}}单价 FEntity.FEntryNote备注{{goodsDocDetailList.rowRemark}}多行文本 FEntity.F_LSJC_Text3条码{{skuBarcode}}源单编号 FEntity.FormId业务对象表单IdSTK_MISCELLANEOUS必须填写金蝶的表单ID如😛UR_PurchaseOrder FEntity.IsVerifyBaseDataField验证基础资料false是否验证所有的基础资料有效性，布尔类，默认false（非必录） FEntity.Operation执行的操作Save FEntity.IsAutoSubmitAndAudit提交并审核true

系统集成总览

数据集成中台设计中心Web界面以“拖拽”式交互设计，使用鼠标即可构建设计多异构系统数据集成流程，低代码平台大大降低流程设计者上手门槛。还有丰富的组件库快速满足复杂业务需求，结合不同模块即可生成不同业务流程，提升流程设计效率。平台支持多种高度灵活部署，高并发、高性能、高可用，可以通过多节点组成集群实现性能的横向扩展。适度集群配置其数据集成处理能力可达GB级/秒，为业务流提供更高数据吞吐量。平台已集成数据回压、优先级队列等能力，保障运行稳定性。完善的企业API运营管理机制帮助您构建“API生产者、API管理者、API消费者”三者结合的统一API数字化生态。支持市面上主流厂家软件如：金蝶、用友、SAP、泛微、蓝凌、旺店通、聚水潭、马帮、小满CRM等等。