吉客云与MySQL对接集成销售单查询连通执行操作-v1(销售退货单据测试)

数据源系统:吉客云

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

对接目标系统:MySQL

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

系统对接接口配置

使用轻易云系统数据集成平台对应的模块：数据集成方案。然后选择开始创建数据集成方案。在方案配置表单中选择对应的源业务系统：吉客云，然后选择对应的连接器。选择对应的销售单查询作为数据对接来源。然后再通过写入目标平台配置目标系统为MySQL,并且选择对应连接器（关于MySQL的接口如何配置可以在轻易云数据集成社区论坛中找到相关信息,选择好对应的执行操作-v1接口作为数据写入动作，既可以完成第一步的数据对接配置。

吉客云接口明细

• 调用接口：oms.trade.fullinfoget

• 接口名称：销售单查询

• 方法：POST

请求参数

字段	字段名称	类型	配置值
modified_begin	起始时间	string	{{LAST_SYNC_TIME datetime}}
modified_end	结束时间	string	{{CURRENT_TIME datetime}}
startModified	最后修改时间（起始）	string	{{LAST_SYNC_TIME datetime}}
endModified	最后修改时间（截止）	string	{{CURRENT_TIME datetime}}
tradeNo	销售单号，多个用半角逗号分隔	string
pageSize	每页记录数，默认50，最大1000	string	{{PAGINATION_PAGE_SIZE}}
pageIndex	页码，0为第1页	string	{{PAGINATION_START_PAGE}}
hasTotal	默认返回，首次调用时可以传1获取总记录数	string	1
startCreated	创建时间（起始）	string
endCreated	创建时间（截止）	string
startAuditTime	审核时间（起始）	string
endAuditTime	审核时间（截止）	string
startConsignTime	发货时间（起始）	string
endConsignTime	发货时间（截止）	string
tradeStatus	订单状态	string
tradeType	订单类型	string
sourceTradeNos	网店订单号	string
shopIds	店铺id	string
fields	需要返回字段列表逗号分隔	string	checkTotal,tradeNo,postFee,otherFee,chargeCurrency,accountName,payType,payNo,sellerMemo,buyerMemo,goodsDetail,goodsDetail.goodsNo,goodsDetail.goodsName,goodsDetail.specName,goodsDetail.barcode,goodsDetail.sellCount,goodsDetail.unit,goodsDetail.sellPrice,goodsDetail.sellTotal,goodsDetail.cost,goodsDetail.discountTotal,goodsDetail.discountPoint,goodsDetail.taxFee,goodsDetail.shareFavourableFee,goodsDetail.estimateWeight,goodsDetail.goodsMemo,goodsDetail.cateName,goodsDetail.brandName,goodsDetail.goodsTags,goodsDetail.isFit,goodsDetail.isGift,goodsDetail.discountFee,goodsDetail.taxRate,goodsDetail.estimateGoodsVolume,goodsDetail.isPresell,goodsDetail.customerPrice,goodsDetail.customerTotal,goodsDetail.tradeGoodsNo,goodsDetail.tradeGoodsName,goodsDetail.tradeGoodsSpec,goodsDetail.tradeGoodsUnit,goodsDetail.sourceTradeNo,goodsDetail.sourceSubtradeNo,goodsDetail.platCode,goodsDetail.platGoodsId,goodsDetail.subTradeId,appendMemo,tradeFrom,register,seller,auditor,reviewer,estimateWeight,packageWeight,tradeCount,goodsTypeCount,freezeReason,abnormalDescription,onlineTradeNo,goodslist,gmtCreate,gmtModified,stockoutNo,confirmTime,departName,lastShipTime,payStatus,chargeCurrencyCode,chargeExchangeRate,tradeStatus,grossProfit,estimateVolume,customerName,customerTypeName,customerGradeName,customerTags,customerCode,customerDiscount,specialReminding,blackList,tradeTime,country,state,city,district,town,zip,payTime,countryCode,cityCode,invoiceType,payerName,payerRegno,payerBankAccount,payerPhone,auditTime,payerAddress,invoiceNo,invoiceCode,invoiceStatus,payerBankName,preTypedetail,firstPayment,finalPayment,firstPaytime,finalPaytime,reviewTime,activationTime,customerTotalFee,customerDiscountFee,notifyPickTime,consignTime,orderNo,customerPostFee,shopId,shopName,tradeOrderPayList,tradeOrderPayList.chargeType,tradeOrderPayList.chargeCurrency,tradeOrderPayList.chargeAccount,tradeOrderPayList.accountName,tradeOrderPayList.payType,tradeOrderPayList.payNo,tradeOrderPayList.payment,tradeOrderPayList.chargeCurrencyCode,tradeOrderPayList.chargeExchangeRate,customerPayment,companyName,tradeOrderColumnExt,tradeOrderColumnExt.tradeId,tradeOrderColumnExt.customizeTradeColumn1,tradeOrderColumnExt.customizeTradeColumn2,tradeOrderColumnExt.customizeTradeColumn3,tradeOrderColumnExt.customizeTradeColumn4,tradeOrderColumnExt.customizeTradeColumn5,tradeOrderColumnExt.customizeTradeColumn6,tradeOrderColumnExt.customizeTradeColumn7,tradeOrderColumnExt.customizeTradeColumn8,tradeOrderColumnExt.customizeTradeColumn9,tradeOrderColumnExt.customizeTradeColumn10,isBillCheck,warehouseCode,warehouseName,logisticName,tradeId,billDate,logisticType,mainPostid,tradeType,totalFee,taxFee,receivedPostFee,discountFee,payment,couponFee,receivedTotal,isDelete,flagIds,flagNames,shopCode
warehouseIds	仓库id	string

响应参数

字段	字段名称	类型	配置值
checkTotal	对账金额	string
tradeNo	订单编号	string
postFee	实际邮资	string
otherFee	其它费用	string
chargeCurrency	结算币种	string
accountName	收款账户	string
payType	支付方式	string
payNo	支付单号	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.taxFee	税额	string
goodsDetail.shareFavourableFee	分摊金额	string
goodsDetail.estimateWeight	预估重量	string
goodsDetail.goodsMemo	货品备注	string
goodsDetail.cateName	货品类别	string
goodsDetail.brandName	品牌	string
goodsDetail.goodsTags	货品标签	string
goodsDetail.isFit	组合装标记	string
goodsDetail.isGift	赠品标记	string
goodsDetail.discountFee	优惠	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.appendMemo	追加备注	string
goodsDetail.tradeFrom	订单来源	string
goodsDetail.register	登记人	string
goodsDetail.seller	业务员	string
goodsDetail.auditor	审核人	string
goodsDetail.reviewer	复核人	string
goodsDetail.estimateWeight	预估重量	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.chargeCurrencyCode	结算币种编码	string
goodsDetail.chargeExchangeRate	结算汇率	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

MySQL接口明细

• API：execute

• NAME：执行操作-v1

• METHOD：POST

请求参数

接口字段	字段名称	预设值	描述
main_params	主参数
main_params.dispatch_id	发货单号	{{orderNo}}
main_params.return_status	退货状态	1
main_params.return_reason	退货原因	{{sellerMemo}}
main_params.receive_cust_id	收货方	{{customerCode}}
main_params.receive_phone	收货人电话
main_params.receive_address	收货地址	{{payerAddress}}
main_params.delivery_date	退货日期	{{consignTime}}
main_params.date	date	{{consignTime}}
main_params.extend_params_1	1:1扩展参数
main_params.extend_params_1.lastInsertId	id	:lastInsertId
main_params.extend_params_1.goods_id	货品编码id	{{goodsDetail.goodsNo}}
main_params.extend_params_1.must_qty	应退数量	{{goodsDetail.sellCount}}
main_params.extend_params_1.real_qty	实退数量	{{goodsDetail.sellCount}}
main_params.extend_params_1.unit_id	数量单位	{{goodsdetail.unit}}
main_params.extend_params_1.stock_id	仓库	{{warehouseCode}}
main_params.extend_params_1.stock_status	库存状态	{{tradeStatus}}
main_params.extend_params_1.create_time	date	{{consignTime}}
main_params.extend_params_1.main_sql	主语句	INSERT INTO lehua.sale_return ( dispatch_id, return_status, return_reason, receive_cust_id, receive_phone, receive_address, delivery_date, date) VALUES ( <{dispatch_id: }>, <{return_status: }>, <{return_reason: }>, <{receive_cust_id: }>, <{receive_phone: }>, <{receive_address: }>, <{delivery_date: }>, <{date: }>);
main_params.extend_params_1.extend_sql_1	1:1扩展语句	INSERT INTO lehua.sale_return_detail (id, goods_id, must_qty, real_qty, unit_id, stock_id, stock_status, create_time) VALUES (<{lastInsertId: }>, <{goods_id: }>, <{must_qty: }>, <{real_qty: }>, <{unit_id: }>, <{stock_id: }>, <{stock_status: }>, <{create_time: }>);

数据对接价值

大部分的企业都可能只用一套系统组织架构复杂，业务流程繁琐，内部同时有OA系统、BI系统、ERP系统......且各个系统都需要独立登陆，造成IT部门数据监管困难！如何在同一套中台系统上关联多管理系统呢？系统集成平台，就可以无缝集成各个业务系统，主数不统一、交易数据来回导出导入、业务融合等问题。通过轻易云系统集成平台完美结合：打破企业内部数据孤岛，无需繁琐的处理工序，与数据集成服务完美结合，让数据真正通起来。 资源互补：汇集各种行业解决方案，资源互补，企业管理融合提升。让对接开箱即用的、可视化拖、拉、拽实现接口服务编排与聚合。