吉客云和MySQL接口打通对接实战

数据源系统:吉客云

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

接通系统：MySQL

MySQL是最流行的数据库之一，是一个免费开源的关系型数据库管理系统，但也不意味着该数据库是完全免费的。MySQL由瑞典MySQLAB公司开发，目前属于Oracle公司。MySQL适合中小型软件，被个人用户以及中小企业青睐。

配置集成方案

通过轻易云系统数据集成平台新增创建集成方案，通过轻易云的方案市场可以一键复制，并且可以借鉴其他的方案配置完成方案制作，方案制作只需要两步，第一步先确定好对应的数据来源；源系统：吉客云接口：分页查询出库单通过请求调度者配置对应的请求参数即可获取到对应的数据。目标系统：MySQL接口：执行操作-v1，通过写入调度者匹配获取到的数据和写入的映射关系，即可自动生成符合目标系统：MySQL写入的数据自动产生写入队列，通过运行概况，系统会自动帮你诊断方案的运行情况。实时监控到方案的运行情况

吉客云接口明细

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

请求参数

接口字段字段名称预设值描述 pageIndex分页页码 pageSize分页页数50 goodsDocNo出库单号 startDate创建时间的起始时间{{DAYS_AGO_1 datetime}} endDate创建时间的结束时间{{CURRENT_TIME datetime}} inouttype类型204201-销售出库 202调拨出库 203 = 盘亏出库 204-其他出库 205采购退货 206生产领料 207组装拆卸出库 208翻新出库 209报废出库 210残次品出库 211倒冲出库 212 包材出库 215维修还厂 231成本调整出库 sourceBillNo来源单号 warehouseCode仓库编号 vendCode供应商编号(往来单位) billNo上游单据号(关联单号) userName创建人名称

响应参数

接口字段字段名称预设值描述 goodsdocNo出库单号 billNo上游单据号(关联单号) inOutDate出库时间 gmtCreate创建时间 inouttype出入库类型出入库类型(201-销售出库 202调拨出库 204-其他出库 205采购退货 206生产领料 207组装拆卸出库 208翻新出库 209报废出库 210残次品出库 211倒冲出库 212 包材出库 215维修还厂 299可用库存修正 231成本调整出库) inouttypeName出入库类型出入库类型(201-销售出库 202调拨出库 204-其他出库 205采购退货 206生产领料 207组装拆卸出库 208翻新出库 209报废出库 210残次品出库 211倒冲出库 212 包材出库 215维修还厂 299可用库存修正 231成本调整出库) 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-否 1-是 goodsDocDetailList.registrationNumber批准文号 goodsDocDetailList.approvalDate批文有效期 goodsDocDetailList.productionDepart生产单位 goodsDocDetailList.batchNumber生产批号 goodsDocDetailList.quantity数量 goodsDocDetailList.vendCustomerId往来单位的id goodsDocDetailList.applyDepartId申请人部门id goodsDocDetailList.applyDepartName申请人部门名称 goodsDocDetailList.outBillNo外部单号

MySQL接口明细

调用接口：execute
接口名称：执行操作-v1
方法：POST

请求参数

字段字段名称类型配置值 main_params主参数object main_params.bill_no单据编号string{{goodsdocNo}} main_params.status状态string1 main_params.stock_org_id库存组织stringfindCollection find textField_l2ib4q9s from 0ce3a160-9fb2-36e5-a2ac-57f5ad0f3c72 where textField_l2ib4q9p={{warehouseCode}} main_params.date日期string_function FROM_UNIXTIME( ( {{inOutDate}} / 1000 ) ,'%Y-%m-%d %T' ) main_params.bill_type_id单据类型stringQTCKD01_SYS main_params.owner_type_id_head货主类型stringBD_OwnerOrg main_params.owner_id_head货主string{{companyCode}} main_params.stock_direction库存方向stringGENERAL main_params.dept_id领料部门string{{departCode}} main_params.picker_id领料人string{{userName}} main_params.stocker_id仓管员string{{userName}} main_params.remark备注string{{comment}} main_params.create_time创建时间stringfunction FROM_UNIXTIME( ( {{gmtCreate}} / 1000 ) ,'%Y-%m-%d %T' ) main_params.created_by创建者string{{userName}} main_params.update_time更新时间string_function FROM_UNIXTIME( ( {{gmtModified}} / 1000 ) ,'%Y-%m-%d %T' ) main_params.updated_by更新者string{{userName}} main_params.inOutReason出库原因string{{inOutReason}} main_params.extend_params_11:1扩展参数arraygoodsDocDetailList main_params.extend_params_1.lastInsertIdorder_idstring:lastInsertId main_params.extend_params_1.material_id物料编码string{{goodsDocDetailList.goodsNo}} main_params.extend_params_1.stock_id仓库string{{warehouseCode}} main_params.extend_params_1.stock_status_id库存状态string1 main_params.extend_params_1.owner_type_id货主类型stringBD_OwnerOrg main_params.extend_params_1.owner_id货主string{{companyCode}} main_params.extend_params_1.qty数量string{{goodsDocDetailList.quantity}} main_params.extend_params_1.price价格string{{goodsDocDetailList.cuPrice}} main_params.extend_params_1.unit_id单位idstringPcs main_params.extend_params_1.base_unit_id基础单位string{{goodsDocDetailList.assistUnit}} main_params.extend_params_1.total_amount总成本string main_params.extend_params_1.source_id源单id??stringnull main_params.extend_params_1.source_detail_id源单明细行id??string{{goodsDocDetailList.sourceDetailId}} main_params.extend_params_1.source_code源单单号??string{{sourceBillNo}} main_params.extend_params_1.source_type源单类型??stringnull main_params.extend_params_1.main_sql主语句stringINSERT INTO lehua.wh_other_out ( bill_no, status, stock_org_id, date, bill_type_id, owner_type_id_head, owner_id_head, stock_direction, dept_id, picker_id, stocker_id, remark, create_time, created_by, update_time, updated_by, inOutReason) VALUES ( <{bill_no: }>, <{status: }>, <{stock_org_id: }>, <{date: CURRENT_TIMESTAMP}>, <{bill_type_id: }>, <{owner_type_id_head: }>, <{owner_id_head: }>, <{stock_direction: }>, <{dept_id: }>, <{picker_id: }>, <{stocker_id: }>, <{remark: }>, <{create_time: 0000-00-00 00:00:00}>, <{created_by: }>, <{update_time: 0000-00-00 00:00:00}>, <{updated_by: }>, <{inOutReason: }>); main_params.extend_params_1.extend_sql_11:1扩展语句stringINSERT INTO lehua.wh_other_out_detail ( order_id, material_id, stock_id, stock_status_id, owner_type_id, owner_id, qty, price, unit_id, base_unit_id, total_amount, source_id, source_detail_id, source_code, source_type) VALUES ( <{lastInsertId: }>, <{material_id: }>, <{stock_id: }>, <{stock_status_id: }>, <{owner_type_id: }>, <{owner_id: }>, <{qty: }>, <{price: }>, <{unit_id: }>, <{base_unit_id: }>, <{total_amount: }>, <{source_id: }>, <{source_detail_id: }>, <{source_code: }>, <{source_type: }>);

系统打通概况

当企业规模逐渐增大时，作为支撑业务运营的IT建设也变得越来越重要，不过往往企业的IT建设过程中会发现某一家软件供应商基本不能完全覆盖企业所有的业务运营流程，这样的结果就是，企业上的IT系统很多很全，从ERP到HR、CRM、PDM、OA等，貌似所有的业务都覆盖到了，但实际上因为这些系统的不集成，而形成了企业很多新的信息孤岛，非常不利于企业的后续的管理和战略发展。从现今和往后的发展趋势来看，也不可避免会遇到上述问题，毕竟企业经营的多样化，并不是所有的业务都能在一个系统中完成，所以我们必须在产品架构上支持更好的与外部系统进行协同。通过轻易云集成平台统一的API管理平台，对API进行显性化、可视化，使所有API服务成为企业的数字资产，提升API利用率，发挥业务系统价值，实现企业IT资产的可插拔、可复用、可组成。

吉客云和MySQL接口打通对接实战