吉客云和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 类型 204 201-销售出库 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 状态 string 1 main_params.stock_org_id 库存组织 string findCollection 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 单据类型 string QTCKD01_SYS main_params.owner_type_id_head 货主类型 string BD_OwnerOrg main_params.owner_id_head 货主 string {{companyCode}} main_params.stock_direction 库存方向 string GENERAL 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 创建时间 string function 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_1 1:1扩展参数 array goodsDocDetailList main_params.extend_params_1.lastInsertId order_id string :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 库存状态 string 1 main_params.extend_params_1.owner_type_id 货主类型 string BD_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 单位id string Pcs 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?? string null 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 源单类型?? string null main_params.extend_params_1.main_sql 主语句 string INSERT 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_1 1:1扩展语句 string INSERT 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接口打通对接实战

文森特

吉客云和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	类型	204	201-销售出库 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	状态	string	1
main_params.stock_org_id	库存组织	string	findCollection 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	单据类型	string	QTCKD01_SYS
main_params.owner_type_id_head	货主类型	string	BD_OwnerOrg
main_params.owner_id_head	货主	string	{{companyCode}}
main_params.stock_direction	库存方向	string	GENERAL
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	创建时间	string	function 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_1	1:1扩展参数	array	goodsDocDetailList
main_params.extend_params_1.lastInsertId	order_id	string	: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	库存状态	string	1
main_params.extend_params_1.owner_type_id	货主类型	string	BD_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	单位id	string	Pcs
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??	string	null
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	源单类型??	string	null
main_params.extend_params_1.main_sql	主语句	string	INSERT 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_1	1:1扩展语句	string	INSERT 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资产的可插拔、可复用、可组成。