MySQL和吉客云单据接口集成

对接源平台:吉客云

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

对接系统：MySQL

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

数据对接方案

集成方案是整个轻易云集成平台的核心，每一个集成方案代表一种业务的对接策略（对接方案借鉴可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息），用户可以根据业务的不同新建多个不同规则的集成方案。比如：采购订单同步，线上销售出库同步，线下销售出库同步。一个集成方案必须要配置源系统：吉客云，源系统 API：查询采购订单，目标系统：MySQL，目标系统 API执行操作-v1。在新增集成方案之前需要确定两个系统的连接器都已经配置完成。数据管道ETL：构建一体化的数据融合平台。高级数据转换：支持公式转换数据格式、支持脚本直接进行数据转换、支持可视化多维度数据处理。高性能实时处理：针对不同数据节点类型提供TB级吞吐量，秒级延迟的增量数据处理能力。自动将旧版web服务转变为基于云端微服务的API，统一接口输出标准。支持接口开放服务，实现内外部能力接入。

吉客云接口明细

调用接口：erp.storage.goodsdocout
接口名称：查询采购订单
方法：POST

请求参数

字段字段名称类型配置值 pageIndex分页页码string pageSize分页页数string20 goodsDocNo出库单号string startDate创建时间的起始时间string_function DATE_FORMAT(DATE_ADD(NOW(),INTERVAL - 3 DAY),'%Y-%m-%d 00:00:00') endDate创建时间的结束时间string{{CURRENT_TIME datetime}} inouttype类型string205 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

MySQL接口明细

API：execute
NAME：执行操作-v1
METHOD：POST

请求参数

接口字段名称预设值 main_params主参数 main_params.bill_no单据编号{{billNo}} main_params.status状态{{redStatus}} main_params.stock_org_id退货组织findCollection find textField_l2ib4q9s from 2bcf5aa6-6c81-39a8-b8a2-b97d6432bff9 where textField_l2ib4q9p={{warehouseCode}} main_params.date退货日期{{inOutDate}} main_params.bill_type_id单据类型{{inouttype}} main_params.owner_type_id_head货主类型BD_OwnerOrg main_params.owner_id_head货主_findCollection find textField_l2ib4q9s from 2bcf5aa6-6c81-39a8-b8a2-b97d6432bff9 where textField_l2ib4q9p={{warehouseCode}} main_params.supplier_id供应商{{vendCustomerCode}} main_params.purchase_dept_id采购部门null main_params.purchaser_id采购员null main_params.purchase_org_id采购组织findCollection find textField_l2ib4q9s from 2bcf5aa6-6c81-39a8-b8a2-b97d6432bff9 where textField_l2ib4q9p={{warehouseCode}} main_params.type退货类型A main_params.way退货方式B main_params.reason退货原因{{inOutReason}} main_params.remark备注{{comment}} main_params.create_time创建时间_function FROM_UNIXTIME( ( {{gmtCreate}} / 1000 ) ,'%Y-%m-%d %T' ) main_params.created_by创建者{{userName}} main_params.update_time更新时间_function FROM_UNIXTIME( ( {{gmtModified}} / 1000 ) ,'%Y-%m-%d %T' ) main_params.updated_by更新者{{userName}} main_params.extend_params_11:1扩展参数goodsDocDetailList main_params.extend_params_1.lastInsertId主表ID:lastInsertId main_params.extend_params_1.material_id物料编码{{goodsDocDetailList.goodsNo}} main_params.extend_params_1.stock_id仓库{{goodsDocDetailList.warehouseCode}} main_params.extend_params_1.stock_status_id库存状态1 main_params.extend_params_1.cost成本{{goodsDocDetailList.estCostNoTax}} main_params.extend_params_1.total_cost总成本{{goodsDocDetailList.transHasTaxAmount}} main_params.extend_params_1.price单价{{goodsDocDetailList.cuPrice}} main_params.extend_params_1.tax_price含税单价{{goodsDocDetailList.estPrice}} main_params.extend_params_1.real_qty实退数量{{goodsDocDetailList.quantity}} main_params.extend_params_1.price_unit_id计价单价{{goodsDocDetailList.estPrice}} main_params.extend_params_1.unit_id库存单位Psc main_params.extend_params_1.carry_unit_id采购单位{{goodsDocDetailList.unitName}} main_params.extend_params_1.total_amount价税合计{{goodsDocDetailList.transHasTaxAmount}} main_params.extend_params_1.remark备注{{goodsDocDetailList.rowRemark}} main_params.extend_params_1.source_id源单idnull main_params.extend_params_1.source_detail_id源单明细id{{goodsDocDetailList.sourceDetailId}} main_params.extend_params_1.source_code源单号{{sourceBillNo}} main_params.extend_params_1.source_type源单类型null main_params.extend_params_1.main_sql主语句INSERT INTO lehua.wh_purchase_out ( bill_no, status, stock_org_id, date, bill_type_id, owner_type_id_head, owner_id_head, supplier_id, purchase_dept_id, purchaser_id, purchase_org_id, type, way, reason, remark, create_time, created_by, update_time, updated_by) VALUES ( <{bill_no: }>, <{status: }>, <{stock_org_id: }>, <{date: CURRENT_TIMESTAMP}>, <{bill_type_id: }>, <{owner_type_id_head: }>, <{owner_id_head: }>, <{supplier_id: }>, <{purchase_dept_id: }>, <{purchaser_id: }>, <{purchase_org_id: }>, <{type: }>, <{way: }>, <{reason: }>, <{remark: }>, <{create_time: 0000-00-00 00:00:00}>, <{created_by: }>, <{update_time: 0000-00-00 00:00:00}>, <{updated_by: }>); main_params.extend_params_1.extend_sql_11:1扩展语句INSERT INTO lehua.wh_purchase_out_detail ( order_id, material_id, stock_id, stock_status_id, cost, total_cost, price, tax_price, real_qty, price_unit_id, unit_id, carry_unit_id, total_amount, remark, source_id, source_detail_id, source_code, source_type) VALUES ( <{lastInsertId: }>, <{material_id: }>, <{stock_id: }>, <{stock_status_id: }>, <{cost: }>, <{total_cost: }>, <{price: }>, <{tax_price: }>, <{real_qty: }>, <{price_unit_id: }>, <{unit_id: }>, <{carry_unit_id: }>, <{total_amount: }>, <{remark: }>, <{source_id: }>, <{source_detail_id: }>, <{source_code: }>, <{source_type: }>);

系统数据对接

从API服务总线层面解决企业烟囱式业务系统集成现状相互连接企业各业务系统，实现流程端到端打通，复用已有的业务系统能力，让集成架构、服务关系更清晰使用统一的API管理平台，对API进行显性化、可视化，使所有API服务成为企业的数字资产，提升API利用率，发挥业务系统价值，实现企业IT资产的可插拔、可复用、可组成。

MySQL和吉客云单据接口集成