从吉客云到MySQL通过接口配置打通数据

对接系统：吉客云

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

对接目标平台:MySQL

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

配置集成方案

通过轻易云系统数据集成平台：数据集成方案。选择开始创建数据集成方案菜单。在方案配置表单中选择对应的源业务系统：吉客云，然后选择对应的连接器。选择对应的oms.trade.fullinfoget作为数据对接来源。然后再写入目标平台配置目标系统为MySQL，并且选择对应连接器（关于MySQL的接口如何连接可以在轻易云数据集成社区论坛bbs.qeasy.cloud中找到相关信息）。选择好对应的execute接口作为数据写入动作完成第一步的接口配置。

吉客云接口明细

• 接口：oms.trade.fullinfoget

• 接口名称：销售单查询

• 接口方法：POST

请求参数

字段	名称	类型	描述
modified_begin	起始时间	string	修改起始时间，和结束时间必须同时存在，时间间隔不能超过七天，与线上单号不能同时为空
modified_end	结束时间	string	修改结束时间，和起始时间必须同时存在，时间间隔不能超过七天，与线上单号不能同时为空
startModified	最后修改时间（起始）	string
endModified	最后修改时间（截止）	string
tradeNo	销售单号，多个用半角逗号分隔	string
pageSize	每页记录数，默认50，最大1000	string
pageIndex	页码，0为第1页	string
hasTotal	默认返回，首次调用时可以传1获取总记录数	string
startCreated	创建时间（起始）	string
endCreated	创建时间（截止）	string
startAuditTime	审核时间（起始）	string
endAuditTime	审核时间（截止）	string
startConsignTime	发货时间（起始）	string
endConsignTime	发货时间（截止）	string
tradeStatus	订单状态	string
tradeType	订单类型	string
sourceTradeNos	网店订单号	string
shopIds	店铺id	string
fields	需要返回字段列表逗号分隔	string
warehouseIds	仓库id	string

响应参数

字段	名称	类型	描述
checkTotal	对账金额	string
tradeNo	订单编号	string
postFee	实际邮资	string
otherFee	其它费用	string
sellerMemo	备注	string
buyerMemo	买家备注	string
goodsDetail	货品详情	array
goodsDetail.goodsNo	货品编号	string
goodsDetail.goodsName	货品名称	string
goodsDetail.specName	规格名称	string
goodsDetail.barcode	条码	string
goodsDetail.sellCount	数量	string
goodsDetail.unit	单位	string
goodsDetail.sellPrice	单价	string
goodsDetail.sellTotal	总金额	string
goodsDetail.cost	货品成本	string
goodsDetail.discountTotal	优惠金额	string
goodsDetail.discountPoint	抵扣积分	string
goodsDetail.shareFavourableFee	分摊金额	string
goodsDetail.goodsMemo	货品备注	string
goodsDetail.cateName	货品类别	string
goodsDetail.brandName	品牌	string
goodsDetail.goodsTags	货品标签	string
goodsDetail.isFit	组合装标记	string
goodsDetail.isGift	赠品标记	string
goodsDetail.taxRate	税率	string
goodsDetail.estimateGoodsVolume	预估体积（单个货品）	string
goodsDetail.isPresell	是否预售货品标记1是0否	string
goodsDetail.customerPrice	终端销售单价	string
goodsDetail.customerTotal	终端销售金额	string
goodsDetail.tradeGoodsNo	交易编号	string
goodsDetail.tradeGoodsName	交易名称	string
goodsDetail.tradeGoodsSpec	交易规格	string
goodsDetail.tradeGoodsUnit	交易单位	string
goodsDetail.sourceTradeNo	网店订单号	string
goodsDetail.sourceSubtradeNo	网店子订单好	string
goodsDetail.platCode	平台代码	string
goodsDetail.platGoodsId	平台商品id	string
goodsDetail.subTradeId	商品明细id（唯一）	string
goodsDetail.taxFee	税额	string
goodsDetail.estimateWeight	预估重量	string
goodsDetail.discountFee	优惠金额	string
goodsDetail.appendMemo	追加备注	string
goodsDetail.tradeFrom	订单来源	string
goodsDetail.register	登记人	string
goodsDetail.seller	业务员	string
goodsDetail.auditor	审核人	string
goodsDetail.reviewer	复核人	string
goodsDetail.packageWeight	包裹重量	string
goodsDetail.tradeCount	订单总数量	string
goodsDetail.goodsTypeCount	商品样数	string
goodsDetail.freezeReason	冻结原因	string
goodsDetail.abnormalDescription	问题单具体描述	string
goodsDetail.onlineTradeNo	网店订单号	string
goodsDetail.goodslist	货品摘要	string
goodsDetail.gmtCreate	创建时间	string
goodsDetail.gmtModified	最后修改时间	string
goodsDetail.stockoutNo	出库单号	string
goodsDetail.confirmTime	确认时间	string
goodsDetail.departName	部门名称	string
goodsDetail.lastShipTime	承诺发货时间	string
goodsDetail.payStatus	付款状态：未付款、部分付款、已付款	string
goodsDetail.tradeStatus	订单状态	string
goodsDetail.grossProfit	毛利	string
goodsDetail.estimateVolume	订单预估体积	string
goodsDetail.customerName	客户名称	string
goodsDetail.customerTypeName	客户类型	string
goodsDetail.customerGradeName	客户等级	string
goodsDetail.customerTags	客户标签	string
goodsDetail.customerCode	客户编号	string
goodsDetail.customerDiscount	折扣	string
goodsDetail.specialReminding	特别提醒	string
goodsDetail.blackList	黑名单	string
goodsDetail.tradeTime	下单时间	string
goodsDetail.country	国家	string
goodsDetail.state	省	string
goodsDetail.city	城市	string
goodsDetail.district	区县	string
goodsDetail.town	街道	string
goodsDetail.zip	邮编	string
goodsDetail.payTime	支付时间	string
goodsDetail.countryCode	国家编码	string
goodsDetail.cityCode	城市编码	string
goodsDetail.invoiceType	发票类型	string
goodsDetail.payerName	购方名称	string
goodsDetail.payerRegno	购方税号	string
goodsDetail.payerBankAccount	购方开户行及帐号	string
goodsDetail.payerPhone	购方电话	string
goodsDetail.auditTime	审核时间	string
goodsDetail.payerAddress	购方地址	string
goodsDetail.invoiceNo	发票号码	string
goodsDetail.invoiceCode	发票代码	string
goodsDetail.invoiceStatus	发票开具状态	string
goodsDetail.payerBankName	购方开户行	string
goodsDetail.preTypedetail	预定类别描述	string
goodsDetail.firstPayment	付首款金额	string
goodsDetail.finalPayment	付尾款金额	string
goodsDetail.firstPaytime	付首款时间	string
goodsDetail.finalPaytime	付尾款时间	string

MySQL接口明细

• 调用接口：execute

• 接口名称：执行操作-v1

• 方法：POST

请求参数

字段	字段名称	类型	配置值
main_params	主参数	object	{{TradeTime}}
main_params.bill_no	单据编号	string	{{tradeNo}}
main_params.bill_type_id	单据类型	string	XSCKD07_SYS
main_params.status	状态	string	{{tradeStatus}}
main_params.sale_org_id	销售组织	string	findCollection find textField_l2iazxw0 from a7cb0b9d-2aef-342a-bcb9-7d02e747f1d8 where textField_l2iazxvw={{shopCode}}
main_params.date	日期	string	{{consignTime}}
main_params.stock_org_id	库存id	string	_findCollection find textField_l2ib4q9s from 0ce3a160-9fb2-36e5-a2ac-57f5ad0f3c72 where textField_l2ib4q9p={{warehouseCode}}
main_params.customer_id	客户编号	string	findCollection find textField_l2iazxvz from a7cb0b9d-2aef-342a-bcb9-7d02e747f1d8 where textField_l2iazxvw={{shopCode}}
main_params.stocker_id	仓管员	string	{{auditor}}
main_params.owner_type_id_head	货主类型	string	BD_OwnerOrg
main_params.owner_id_head	货主	string	_findCollection find textField_l2ib4q9s from 0ce3a160-9fb2-36e5-a2ac-57f5ad0f3c72 where textField_l2ib4q9p={{warehouseCode}}
main_params.remark	备注	string	{{buyerMemo}}
main_params.logistics_no	物流单号	string	{{mainPostid}}
main_params.logistics_company	物流公司	string	{{logisticName}}
main_params.shop_number	网店单号	string	{{onlineTradeNo}}
main_params.weight	重量	string	{{packageWeight}}
main_params.create_time	创建时间	string	{{gmtCreate}}
main_params.created_by	创建者	string	{{auditor}}
main_params.updated_time	更新时间	string
main_params.updated_by	更新者	string	{{auditor}}
main_params.extend_params_1	1:1扩展参数	array	goodsDetail
main_params.extend_params_1.lastInsertId	主表ID	string	:lastInsertId
main_params.extend_params_1.material_id	物料编码	string	{{goodsDetail.goodsNo}}
main_params.extend_params_1.unit_id	库存单位	string	Pcs
main_params.extend_params_1.should_qty	应发数量	string	{{goodsDetail.sellCount}}
main_params.extend_params_1.real_qty	实发数量	string	{{goodsDetail.sellCount}}
main_params.extend_params_1.cost	成本	string	{{goodsDetail.cost}}
main_params.extend_params_1.total_cost	总成本	string	null
main_params.extend_params_1.price	单价	string	{{goodsDetail.sellPrice}}
main_params.extend_params_1.tax_price	含税单价	string	{{goodsDetail.sellPrice}}
main_params.extend_params_1.discount_rate	折扣率	string	{{customerDiscountFee}}
main_params.extend_params_1.discount	折扣额	string	{{goodsDetail.discountFee}}
main_params.extend_params_1.tax_rate	税率	string	null
main_params.extend_params_1.amount	金额	string	{{receivedTotal}}
main_params.extend_params_1.total_amount	价税合计	string	{{customerPayment}}
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	_findCollection find textField_l2ib4q9s from 0ce3a160-9fb2-36e5-a2ac-57f5ad0f3c72 where textField_l2ib4q9p={{warehouseCode}}
main_params.extend_params_1.is_gift	是否赠品	string	{{goodsDetail.isGift}}
main_params.extend_params_1.remark	备注	string	{{sellerMemo}}
main_params.extend_params_1.source_id	源id	string	{{goodsDocDetailList.sourceDetailId}}
main_params.extend_params_1.source_detail_id	源详细信息 ID	string	null
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_sale_out ( bill_no, bill_type_id, status, sale_org_id, date, stock_org_id, customer_id, stocker_id, owner_type_id_head, owner_id_head, remark, logistics_no, logistics_company, shop_number, weight, create_time, created_by, updated_time, updated_by) VALUES ( <{bill_no: }>, <{bill_type_id: }>, <{status: }>, <{sale_org_id: }>, <{date: CURRENT_TIMESTAMP}>, <{stock_org_id: }>, <{customer_id: }>, <{stocker_id: }>, <{owner_type_id_head: }>, <{owner_id_head: }>, <{remark: }>, <{logistics_no: }>, <{logistics_company: }>, <{shop_number: }>, <{weight: }>, <{create_time: 0000-00-00 00:00:00}>, <{created_by: }>, <{updated_time: 0000-00-00 00:00:00}>, <{updated_by: }>);
main_params.extend_params_1.extend_sql_1	1:1扩展语句	string	INSERT INTO lehua.wh_sale_out_detail ( order_id, material_id, unit_id, should_qty, real_qty, cost, total_cost, price, tax_price, discount_rate, discount, tax_rate, amount, total_amount, stock_id, stock_status_id, owner_type_id, owner_id, is_gift, remark, source_id, source_detail_id, source_code, source_type) VALUES ( <{lastInsertId: }>, <{material_id: }>, <{unit_id: }>, <{should_qty: }>, <{real_qty: }>, <{cost: }>, <{total_cost: }>, <{price: }>, <{tax_price: }>, <{discount_rate: }>, <{discount: }>, <{tax_rate: 0}>, <{amount: }>, <{total_amount: }>, <{stock_id: }>, <{stock_status_id: }>, <{owner_type_id: }>, <{owner_id: }>, <{is_gift: }>, <{remark: }>, <{source_id: }>, <{source_detail_id: }>, <{source_code: }>, <{source_type: }>);

系统数据对接

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