吉客云对接打通MySQL销售单查询接口与执行操作-v1接口

数据源平台:吉客云

吉客云是基于“网店管家”十五年电商ERP行业和技术积累基础上顺应产业发展需求，重新定位、全新设计推出的换代产品，从业务数字化和组织数字化两个方向出发，以构建流程的闭环为依归，致力于为企业的数字化升级提供落地工具。

接入系统：MySQL

mysql是一个关系数据库管理系统（RDBMS），所谓的关系型数据库，是建立在关系模型基础上的数据库，借助于集合代数等数学概念和方法来处理数据库中的数据。

接口方案配置

数据集成平台对应的配置吉客云与MySQL的对接只要三步就能完成两个系统之间的数据对接。第一步根据吉客云的接口参数要求记录在轻易云集成平台。第二步配置吉客云与MySQL之间的字段对应关系（更多方案可借鉴轻易云数据集成社区论坛中找到相关方案信息）第三步完成方案的检查参数设置：传递时间、重试次数、是否启动、前置条件等上线运行。

吉客云接口明细

• 接口：jackyun.tradenotsensitiveinfos.list.get

• 接口名称：销售单查询

• 接口方法：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
main_params.bill_no	单据编号	string	{{TradeNo}}
main_params.bill_type	单据类型	string	{{TradeType}}
main_params.date	日期	string	{{TradeTime}}
main_params.status	状态	string	{{InvoiceStatus}}
main_params.sale_org_id	销售组织	string	{{DepartName}}
main_params.stock_org_id	库存组织	string	{{WarehouseName}}
main_params.return_customer_id	退货客户	string	{{CustomerCode}}
main_params.stocker_id	仓管员	string	{{Auditor}}
main_params.remark	备注	string	{{sellerMemo}}
main_params.create_time	创建时间	string	{{GmtCreate}}
main_params.created_by	创建者	string	{{Register}}
main_params.update_time	更新时间	string	{{GmtCreate}}
main_params.updated_by	更新者	string	{{reviewer}}
main_params.extend_params_1	1:1扩展参数	object
main_params.extend_params_1.lastInsertId	主表ID	string	:lastInsertId
main_params.extend_params_1.lastInsertId	order_id	string	:lastInsertId
main_params.extend_params_1.material_id	物料编码	string	{{SourceTradeNo}}
main_params.extend_params_1.unit_id	库存单位	string	{{Unit}}
main_params.extend_params_1.cost	成本	string	{{goodsDetail.cost}}
main_params.extend_params_1.total_cost	总成本	string
main_params.extend_params_1.price	单价	string	{{sellPrice}}
main_params.extend_params_1.tax_price	含税单价	string
main_params.extend_params_1.tax_rate	税率	string	{{taxRate}}
main_params.extend_params_1.discount_rate	折扣率	string
main_params.extend_params_1.discount	折扣额	string
main_params.extend_params_1.should_qty	应退数量	string
main_params.extend_params_1.real_qty	实退数量	string
main_params.extend_params_1.amount	金额	string
main_params.extend_params_1.total_amount	价税合计	string
main_params.extend_params_1.stock_id	仓库	string	{{warehouseCode}}
main_params.extend_params_1.stock_status_id	库存状态	string
main_params.extend_params_1.owner_type_id	货主类型	string
main_params.extend_params_1.owner_id	货主	string
main_params.extend_params_1.is_gift	是否赠品	string	{{isGift}}
main_params.extend_params_1.remark	备注	string	{{goodsMemo}}
main_params.extend_params_1.source_id	source_id	string
main_params.extend_params_1.source_detail_id	source_detail_id	string	{{subTradeId}}
main_params.extend_params_1.source_code	source_code	string
main_params.extend_params_1.source_type	source_type	string
main_params.extend_params_1.main_sql	主语句	string	INSERT INTO wh_sale_return_in ( bill_no, bill_type, date, status, sale_org_id, stock_org_id, return_customer_id, stocker_id, remark, create_time, created_by, update_time, updated_by) VALUES ( <{bill_no: }>, <{bill_type: }>, <{date: }>, <{status: }>, <{sale_org_id: }>, <{stock_org_id: }>, <{return_customer_id: }>, <{stocker_id: }>, <{remark: }>, <{create_time: }>, <{created_by: }>, <{update_time: }>, <{updated_by: }>);
main_params.extend_params_1.extend_sql_1	1:1扩展语句	string	INSERT INTO lehua.wh_sale_return_in_detail ( order_id, material_id, unit_id, cost, total_cost, price, tax_price, tax_rate, discount_rate, discount, should_qty, real_qty, 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: }>, <{cost: }>, <{total_cost: }>, <{price: }>, <{tax_price: }>, <{tax_rate: 0}>, <{discount_rate: 0}>, <{discount: }>, <{should_qty: }>, <{real_qty: }>, <{amount: }>, <{total_amount: }>, <{stock_id: }>, <{stock_status_id: }>, <{owner_type_id: }>, <{owner_id: }>, <{is_gift: 0}>, <{remark: }>, <{source_id: }>, <{source_detail_id: }>, <{source_code: }>, <{source_type: }>);

系统打通概况

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