售后（退货）订单获取结果推送接口

POST/

用户提交订单获取任务的时候，使用到callbackUrl才会有获取结果推送。每条消息推送用户接收和保存成功后，应该返回这样的响应报文：{"result":true,"returnCode":200,"message":"成功"}，我方根据result等于true作为推送成功标识，其他均为推送失败。推送失败会隔半小时后重推，连续3次重推都失败则放弃该条消息的推送。任务列表中，每个任务查询失败，隔5分钟后重试，连续3次重试都失败则会终止查询并且推送一条queryStatus=Abort的消息告知用户。

5.2 请求地址
由贵司在提交售后（退货）订单获取任务请求中通过callbackUrl字段提供

param数据结构

参数名称	数据类型	参数描述
taskId	string	任务ID
queryStatus	string	查询状态，Fail：查询失败；Empty：查无结果；Success：查询成功；Abort：终止，连续多次查询都失败
reason	string	订单获取不到的原因
orders	array[object]	订单列表

orders数据结构

参数名称	数据类型	参数描述
shopType	string	店铺类型，TAOBAO：淘宝，TOUTIAO：抖店。
shopId	string	店铺ID
shopName	string	店铺名称
refundNo	string	售后单号
refundType	Integer	售后类型，1：仅退款；2：退货退款
refundStatus	string	退款状态，WAIT_SELLER_AGREE：买家已经申请退款，等待卖家同意；WAIT_BUYER_RETURN_GOODS：卖家已经同意退款，等待买家退货； WAIT_SELLER_CONFIRM_GOODS：买家已经退货，等待卖家确认收货； SELLER_REFUSE_BUYER：卖家拒绝退款； CLOSED：退款关闭； SUCCESS：退款成功
orderNo	string	订单号
goodsName	string	商品名称
goodsNo	string	商品编码
refundNums	Integer	退货数量
refundAmount	BigDecimal	退货金额
expressCompany	string	售后快递公司
refundWaybillno	string	售后快递单号
applyTime	string	售后申请时间，格式：yyyy-MM-dd HH:mm:ss
modifiedTime	string	售后更新时间，格式：yyyy-MM-dd HH:mm:ss

请求参数

Body 参数application/x-www-form-urlencoded

sign

string

可选

32位大写，提交订单获取任务salt非空时才会有该参数。签名，用于验证身份，按MD5 (param + salt)的顺序进行MD5加密，不需要加上“+”号

param

array[string]

由其他参数拼接

必需

示例代码

返回响应

查询无结果的回调param(200)

查询有记录的回调param(200)

HTTP 状态码: 200

内容格式: JSONapplication/json

taskId

string

任务ID

必需

queryStatus

string

查询状态，Fail：查询失败；Empty：查无结果；Success：查询成功；Abort：终止，连续多次查询都失败

必需

reason

string

订单获取不到的原因

必需

orders

array[string]

订单列表

必需

{
  "taskId": "bb8122cb5a3f48c9be2724e7f3fb2813",
  "queryStatus": "Empty",
  "reason": "查询无结果",
  "orders": []
}

最后修改时间： 2 年前