API接口目录

苏宁有货业务

有货买家商品API
有货买家价格库存API
有货买家订单API
有货买家物流API
有货买家售后API
有货买家其他API
有货卖家商品API
家乐福供货平台API
异常码自查工具
suning.sngoods.aftersaleprogress.query 售后详情查询
¥免费

本接口供用户查询售后服务申请信息及当前处理进度,供API客户实时掌控售后服务当前状态

公共参数
请求参数
名称 类型 是否必须 示例值 描述
orderItemIdStringY00199812337601苏宁订单行号
响应参数
名称 类型 示例值 描述
orderItemIdString00199812337601苏宁订单行号
returnTypeString01-仅退款;02-退货退款;03-换货订单最新售后类型
skuIdString11784103280申请售后商品编码
productNameString小Biu国米空调Pro 1.5匹冷暖 超一级能效变频 家用挂机空调KFR-35GW/BU2(A1)WI申请售后名称
quantityString10申请数量
returnAmountString10000申请金额
reasonNameString不想要了申请原因
exchangeNodeInfoString
nodeNameString请求创建; 商家同意换;用户开始寄货;请求受理成功;货物寄送;开始退款(换货无);退款中(换货无);退款完成(换货为送新拖旧完成);请求关闭节点名称
nodeStateString0-暂未达成 1-已达成达成情况
updateTimeString2020-09-07 10:01:32达成时间
eventListString
updateTimeString2020-09-07 10:01:32事件发生时间
eventDescribeString退款中事件描述
descString正在为您办理退款,请耐心等待文案提示
mainImageUrlStringhttps://imgservice3.suning.cn/uimg1/b2c/image/L8_d0weG99w53LIMlyQerQ.jpg_210w_210h_4e商品主图
请求示例
  • XML示例
  • JSON示例
复制全部代码
                                <sn_request>
  <sn_body>
    <queryAftersaleprogress>
      <orderItemId>00199812337601</orderItemId>
    </queryAftersaleprogress>
  </sn_body>
</sn_request>

                                
                                {
  "sn_request": {
    "sn_body": {
      "queryAftersaleprogress": {
        "orderItemId": "00199812337601"
      }
    }
  }
}
                                
响应示例
  • XML示例
  • JSON示例
复制全部代码
                              <sn_responseContent>
  <sn_body>
    <queryAftersaleprogress>
      <reasonName>不想要了</reasonName>
      <quantity>10</quantity>
      <eventList>
        <updateTime>2020-09-07 10:01:32</updateTime>
        <desc>正在为您办理退款,请耐心等待</desc>
        <eventDescribe>退款中</eventDescribe>
      </eventList>
      <orderItemId>00199812337601</orderItemId>
      <mainImageUrl>https://imgservice3.suning.cn/uimg1/b2c/image/L8_d0weG99w53LIMlyQerQ.jpg_210w_210h_4e</mainImageUrl>
      <productName>小Biu国米空调Pro 1.5匹冷暖 超一级能效变频 家用挂机空调KFR-35GW/BU2(A1)WI</productName>
      <returnAmount>10000</returnAmount>
      <returnType>01-仅退款;02-退货退款;03-换货</returnType>
      <skuId>11784103280</skuId>
      <exchangeNodeInfo>
        <nodeName>请求创建; 商家同意换;用户开始寄货;请求受理成功;货物寄送;开始退款(换货无);退款中(换货无);退款完成(换货为送新拖旧完成);请求关闭</nodeName>
        <nodeState>0-暂未达成 1-已达成</nodeState>
        <updateTime>2020-09-07 10:01:32</updateTime>
      </exchangeNodeInfo>
    </queryAftersaleprogress>
  </sn_body>
</sn_responseContent>

                              
                              {
  "sn_responseContent": {
    "sn_body": {
      "queryAftersaleprogress": {
        "reasonName": "不想要了",
        "quantity": "10",
        "eventList": [
          {
            "updateTime": "2020-09-07 10:01:32",
            "desc": "正在为您办理退款,请耐心等待",
            "eventDescribe": "退款中"
          }
        ],
        "orderItemId": "00199812337601",
        "mainImageUrl": "https://imgservice3.suning.cn/uimg1/b2c/image/L8_d0weG99w53LIMlyQerQ.jpg_210w_210h_4e",
        "productName": "小Biu国米空调Pro 1.5匹冷暖 超一级能效变频 家用挂机空调KFR-35GW/BU2(A1)WI",
        "returnAmount": "10000",
        "returnType": "01-仅退款;02-退货退款;03-换货",
        "skuId": "11784103280",
        "exchangeNodeInfo": [
          {
            "nodeName": "请求创建; 商家同意换;用户开始寄货;请求受理成功;货物寄送;开始退款(换货无);退款中(换货无);退款完成(换货为送新拖旧完成);请求关闭",
            "nodeState": "0-暂未达成 1-已达成",
            "updateTime": "2020-09-07 10:01:32"
          }
        ]
      }
    }
  }
}
                              
异常示例
  • XML示例
  • JSON示例
复制全部代码

  
  	API异常码
  	异常码中文描述
  

                           	  
{
  "sn_responseContent": {
    "sn_error": {
      "error_code": "API异常码",
      "error_msg": "异常码中文描述"
    }
  }
}
                           		
业务异常码
异常码 错误描述 解决方案
biz.sngoods.queryaftersaleprogress.missing-parameter:* 参数必填 请检查此参数的值,*号表示参数字段名
biz.handler.data-get:no-result 查询没结果 请检查查询参数
isp.sys.service.unavailable.snyh 服务不可用 请联系苏宁技术人员
biz.sngoods.queryaftersaleprogress.invalid-biz:100 订单行信息不存在! 订单行信息不存在!
biz.sngoods.queryaftersaleprogress.invalid-biz:101 订单头信息不存在! 订单头信息不存在!
biz.sngoods.queryaftersaleprogress.invalid-biz:102 不匹配的配送类型! 不匹配的配送类型!
biz.sngoods.queryaftersaleprogress.invalid-biz:103 查询配送类型错误! 查询配送类型错误!
biz.sngoods.queryaftersaleprogress.invalid-biz:104 快递公司信息ID为空! 快递公司信息ID为空!
biz.sngoods.queryaftersaleprogress.invalid-biz:105 退换货请求ID为空! 退换货请求ID为空!
biz.sngoods.queryaftersaleprogress.invalid-biz:106 订单行ID为空! 订单行ID为空!
biz.sngoods.queryaftersaleprogress.invalid-biz:107 快递单号格式错误! 快递单号格式错误!
biz.sngoods.queryaftersaleprogress.invalid-biz:108 未查询到对应的快递公司信息! 未查询到对应的快递公司信息!
biz.sngoods.queryaftersaleprogress.invalid-biz:109 提交快递信息发生错误! 提交快递信息发生错误!
biz.sngoods.queryaftersaleprogress.invalid-biz:110 获取配送详情失败! 获取配送详情失败!
biz.sngoods.queryaftersaleprogress.invalid-biz:111 获取配送详情失败! 获取配送详情失败!
biz.sngoods.queryaftersaleprogress.invalid-biz:112 提交快递信息已过期! 提交快递信息已过期!
biz.sngoods.queryaftersaleprogress.invalid-biz:113 提交失败,请重试! 提交失败,请重试!
biz.sngoods.queryaftersaleprogress.invalid-biz:114 获取详情失败! 获取详情失败!
公共异常码
API工具
FAQ