提交售后(退货)订单获取任务接口
POST
https://api.kuaidi100.com/ent/refundOrder/task用户提交指定时间范围内的售后订单获取任务,快递100根据时间范围拆分出多个售后订单获取的任务列表,返回任务列表给用户。后续快递100会根据任务列表获取售后订单信息,任务获取结束后会把获取结果推送到用户的回调地址中。 任务列表中,每个任务查询失败,隔5分钟后重试,连续3次重试都失败则会终止查询并且推送一条queryStatus=Abort的消息告知用户。
param数据结构
参数名称 | 数据类型 | 是否必填 | 参数描述 |
---|---|---|---|
shopType | string | 是 | 店铺类型,TAOBAO:淘宝,TOUTIAO:抖店。 |
shopId | string | 是 | 店铺ID |
orderStatus | string | 是 | 订单状态,WAIT_SELLER_AGREE:买家已经申请退款,等待卖家同意;WAIT_BUYER_RETURN_GOODS:卖家已经同意退款,等待买家退货; WAIT_SELLER_CONFIRM_GOODS:买家已经退货,等待卖家确认收货; SELLER_REFUSE_BUYER:卖家拒绝退款; CLOSED:退款关闭; SUCCESS:退款成功 |
updateAtMin | string | 是 | 订单更新的最小时间,格式:yyyy-MM-dd HH:mm:ss |
updateAtMax | string | 是 | 订单更新的最大时间,格式:yyyy-MM-dd HH:mm:ss |
callbackUrl | string | 否 | 回调地址,默认仅支持http |
salt | string | 是 | 回调参数sign的加密参数,非空时回调才会有sign参数 |
请求参数
Body 参数application/x-www-form-urlencoded
key
string
必需
授权码,请申请企业版获取
sign
string
必需
32位大写,签名,用于验证身份,按MD5 (param + key + secret)的顺序进行MD5加密,不需要加上“+”号
param
string
由其他参数拼接
示例代码
返回响应
成功(200)
HTTP 状态码: 200
内容格式: JSONapplication/json
数据结构
result
boolean
提交结果
true表示成功
returnCode
integer
返回编码
message
string
返回报文描述
data
object
业务数据
total
integer
任务总数
tasks
array [object {3}]
任务类别
示例
{
"result": true,
"returnCode": 200,
"message": "SUCCESS",
"data": {
"total": 2,
"tasks": [
{
"taskId": "61a8b60a9ac14514bd854318ac9a53ab",
"updateAtMin": "2021-11-12 16:00:00",
"updateAtMax": "2021-11-12 16:30:00"
},
{
"taskId": "94261f0d24c54c34a6552584a0dd4197",
"updateAtMin": "2021-11-12 16:30:00",
"updateAtMax": "2021-11-12 17:00:00"
}
]
}
}
最后修改时间: 2 年前