快递100 API
  1. 接口文档
快递100 API
  • 入门指南
    • 如何注册企业账号
    • 如何开通产品服务
    • 如何联系工作人员
    • 企业版和基础版的区别
  • 产品文档
    • 快递查询
      • 实时快递查询
        • 产品介绍
        • 接口文档
          • 实时快递查询接口
      • 快递信息推送服务
        • 产品介绍
        • 接口文档
          • 快递订阅查询快递api接口技术文档
          • 推送接口
      • 快递查询地图轨迹
        • 产品介绍
        • 接口文档
          • 快递查询地图轨迹技术文档
      • 地图轨迹推送服务
        • 产品介绍
        • 接口文档
          • 订阅接口
          • 推送接口
    • 电子面单与云打印
      • 电子面单
        • 产品介绍
        • 电子面单参数
        • 第三方平台账号授权
          • 第三方授权回调
          • 第三方平台网点&面单余额接口
          • 电子面单账号授权
        • 电子面单接口
          • 打印状态回调
          • 电子面单下单接口
          • 电子面单复打接口
        • 电子面单取消接口
      • 订单导入
        • 产品介绍
        • 接口文档
          • 提交售后(退货)订单获取任务接口
            POST
          • 售后(退货)订单获取结果推送接口
            POST
          • 快递单号回传及订单发货接口
            POST
          • 获取店铺授权超链接接口
            POST
          • 提交订单获取任务接口
            POST
          • 订单获取结果推送接口
            POST
      • 自定义打印
        • 产品介绍
        • 自定义模板打印
          • 自定义模板打印接口
          • 自定义模板打印复打接口
          • 打印状态回调
          • 硬件状态查询接口
        • 附件打印
          • 附件打印接口
          • 附件打印复打接口
          • 打印状态回调
          • 硬件状态查询接口
        • 指令打印
          • 指令打印接口
          • 指令打印复打接口
          • 打印状态回调
          • 硬件状态查询接口
      • 发货单
        • 产品介绍
        • 接口文档
          • 发货单接口
          • 打印回调接口
    • 物流服务
      • 商家寄件
        • 产品介绍
        • 接口文档
          • 快递公司编码
          • 商家寄件下单接口
          • 下单回调接口
          • 商家寄件下单取消接口
          • 商家寄件下单价格接口
          • 快递信息推送接口
          • 商家寄件订单详情查询接口
          • 电子面单复打接口
      • 同城配送
        • 产品介绍
        • 参数字典
        • 同城配送接账号授权
          • 授权回调接口
          • 同城配送账号授权接口
        • 同城配送下单
          • 下单回调接口
          • 同城配送下单
        • 同城配送查询订单
        • 同城配送取消下单接口
      • C端寄件
        • 产品文档
        • 接口文档
          • C端寄件下单接口
          • 下单回调接口
          • C端寄件下单取消接口
          • C端寄件价格查询接口
          • 快递信息推送接口
    • 跨境服务
      • 国际电子面单API
        • 产品介绍
        • 参考数字典
        • 接口文档
          • 国际电子面单下单API
          • 预约取件API
          • 取消预约PI
    • 增值服务
      • 短信提醒发送
        • 产品介绍
        • 接口文档
          • 快递100短信回调请求
          • 快递100短信发送接口
      • 智能单号识别
        • 产品介绍
        • 智能识别接口说明
      • 快递面单OCR识别
        • 产品介绍
        • 快递面单OCR识别接口
      • 快递可用性查询
        • 产品介绍
        • 快递可用性接口
  • 常见问题
    • 查询类问题
      • 实时快递查询
      • 快递信息推送服务
      • 智能单号识别
      • 短信提醒发送
      • Excel表格批量查询
    • 电子面单类问题
      • 电子面单
      • 快递面单模板
      • 参数配置
      • 云打印机/云盒
    • 地图轨迹类问题
      • 快递查询地图轨迹
    • 物流类服务
      • 同城配送
      • 商家寄件
      • 个人寄件
    • 云打印类问题
      • 自定义打印
      • 云打印
      • 发货单
    • 申请与审核
      • 企业版
      • 基础版
    • 支付与支票
      • 产品价格
      • 账单与充值
      • 发票问题
    • 政策与规范
      • 商家寄件服务协议
      • 用户协议
      • 授权声明
      • 隐私政策
      • 增值服务
      • 服务协议
      • 保密协议
    • 账号与密码
      • 账号密码
      • 授权问题
    • 快递公司入驻
      • 入驻资料及审核
      • 电子面单接口示例
      • 快递公司接入快递100实时查询接口
      • 快递公司接入快递100订阅推送接口
      • 手机app快递查询接口
  1. 接口文档

提交售后(退货)订单获取任务接口

POST
https://api.kuaidi100.com/ent/refundOrder/task
用户提交指定时间范围内的售后订单获取任务,快递100根据时间范围拆分出多个售后订单获取的任务列表,返回任务列表给用户。后续快递100会根据任务列表获取售后订单信息,任务获取结束后会把获取结果推送到用户的回调地址中。 任务列表中,每个任务查询失败,隔5分钟后重试,连续3次重试都失败则会终止查询并且推送一条queryStatus=Abort的消息告知用户。
param数据结构
参数名称数据类型是否必填参数描述
shopTypestring是店铺类型,TAOBAO:淘宝,TOUTIAO:抖店。
shopIdstring是店铺ID
orderStatusstring是订单状态,WAIT_SELLER_AGREE:买家已经申请退款,等待卖家同意;WAIT_BUYER_RETURN_GOODS:卖家已经同意退款,等待买家退货; WAIT_SELLER_CONFIRM_GOODS:买家已经退货,等待卖家确认收货; SELLER_REFUSE_BUYER:卖家拒绝退款; CLOSED:退款关闭; SUCCESS:退款成功
updateAtMinstring是订单更新的最小时间,格式:yyyy-MM-dd HH:mm:ss
updateAtMaxstring是订单更新的最大时间,格式:yyyy-MM-dd HH:mm:ss
callbackUrlstring否回调地址,默认仅支持http
saltstring是回调参数sign的加密参数,非空时回调才会有sign参数
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.kuaidi100.com/ent/refundOrder/task' \
--data-urlencode 'key=' \
--data-urlencode 'sign=' \
--data-urlencode 'param='
响应示例响应示例
{
    "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"
            }
        ]
    }
}

请求参数

Body 参数application/x-www-form-urlencoded
key
string 
必需
授权码,请申请企业版获取
sign
string 
必需
32位大写,签名,用于验证身份,按MD5 (param + key + secret)的顺序进行MD5加密,不需要加上“+”号
param
string 
由其他参数拼接
必需

返回响应

🟢200成功
application/json
Body
result
boolean 
提交结果
必需
true表示成功
returnCode
integer 
返回编码
必需
message
string 
返回报文描述
必需
data
object 
业务数据
必需
total
integer 
任务总数
必需
tasks
array [object {3}] 
任务类别
必需

【快递100】API开发者 微信交流群

用微信扫右侧二维码,加入【快递100】API开发者 交流群,互助沟通

扫码加入交流群
上一页
产品介绍
下一页
售后(退货)订单获取结果推送接口
Built with