快递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
/
用户提交订单获取任务的时候,使用到callbackUrl才会有获取结果推送。 每条消息推送用户接收和保存成功后,应该返回这样的响应报文:{"result":true,"returnCode":200,"message":"成功"},我方根据result等于true作为推送成功标识,其他均为推送失败。推送失败会隔半小时后重推,连续3次重推都失败则放弃该条消息的推送。任务列表中,每个任务查询失败,隔5分钟后重试,连续3次重试都失败则会终止查询并且推送一条queryStatus=Abort的消息告知用户。
5.2 请求地址
由贵司在提交售后(退货)订单获取任务请求中通过callbackUrl字段提供
param数据结构
参数名称数据类型参数描述
taskIdstring任务ID
queryStatusstring查询状态,Fail:查询失败;Empty:查无结果;Success:查询成功;Abort:终止,连续多次查询都失败
reasonstring订单获取不到的原因
ordersarray[object]订单列表
orders数据结构
参数名称数据类型参数描述
shopTypestring店铺类型,TAOBAO:淘宝,TOUTIAO:抖店。
shopIdstring店铺ID
shopNamestring店铺名称
refundNostring售后单号
refundTypeInteger售后类型,1:仅退款;2:退货退款
refundStatusstring退款状态,WAIT_SELLER_AGREE:买家已经申请退款,等待卖家同意;WAIT_BUYER_RETURN_GOODS:卖家已经同意退款,等待买家退货; WAIT_SELLER_CONFIRM_GOODS:买家已经退货,等待卖家确认收货; SELLER_REFUSE_BUYER:卖家拒绝退款; CLOSED:退款关闭; SUCCESS:退款成功
orderNostring订单号
goodsNamestring商品名称
goodsNostring商品编码
refundNumsInteger退货数量
refundAmountBigDecimal退货金额
expressCompanystring售后快递公司
refundWaybillnostring售后快递单号
applyTimestring售后申请时间,格式:yyyy-MM-dd HH:mm:ss
modifiedTimestring售后更新时间,格式:yyyy-MM-dd HH:mm:ss
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://poll.kuaidi100.com/' \
--data-urlencode 'param='
响应示例响应示例
200 - 查询无结果的回调param - 成功示例
{
    "taskId": "bb8122cb5a3f48c9be2724e7f3fb2813",
    "queryStatus": "Empty",
    "reason": "查询无结果",
    "orders": []
}

请求参数

Body 参数application/x-www-form-urlencoded
sign
string 
可选
32位大写,提交订单获取任务salt非空时才会有该参数。签名,用于验证身份,按MD5 (param + salt)的顺序进行MD5加密,不需要加上“+”号
param
array[string]
由其他参数拼接
必需

返回响应

🟢200查询无结果的回调param
application/json
Body
taskId
string 
任务ID
必需
queryStatus
string 
查询状态,Fail:查询失败;Empty:查无结果;Success:查询成功;Abort:终止,连续多次查询都失败
必需
reason
string 
订单获取不到的原因
必需
orders
array[string]
订单列表
必需
🟢200查询有记录的回调param

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

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

扫码加入交流群
上一页
提交售后(退货)订单获取任务接口
下一页
快递单号回传及订单发货接口
Built with