退出
热词搜索：
API接口目录

电商能力输出业务

商品API
商品API
价格API
订单API
营销API
基础数据API
物流API
促销API
同城帮定制API
优惠券定制业务API
会员API
客服沟通咨询API
三方库存API
账单API
异常码自查工具
suning.online.refundstatus.query 退款状态查询
￥免费

退款状态查询

公共参数
请求参数
名称 类型 是否必须 示例值 描述
reOrderItemIdStringY99992017120601平台逆向订单行号
orderItemIdStringY99992017120601平台订单行号
snReturnQuestIdStringN202008260001苏宁退货请求号
typeStringN0101-退货 02-换货 03-贵就赔 04-仅退款（为空时默认退货）
响应参数
名称 类型 示例值 描述
reOrderItemIdString99992017120601平台逆向订单行号
retOperationCodeString0/1/20:拒绝退款 1:允许退款 2:处理中 3:退货待处理 4:顾客待寄货 5:退货待上门揽件 6:退款待处理 7:审核完成可退款 8:已完成 9:已取消(审核失败)(用户取消) 10：退款审核通过 11：退款审核失败 12：退款处理中(仅退款)
returnMessageString商品破损拒绝退款原因
itemCodeStringY/N查询结果
itemMsgString服务不可用失败原因
contentString
pictureStringwww.baidu.com/1.jpg拒绝退货/款凭证图片
returnModeString0101 厂家上门取件 02 顾客寄件
sellerNameString王三卖家联系人
sellerPhoneNumberString13312341234卖家联系方式
addressString地址卖家提供的退货地址
countdownTimeString2019-01-10 11:11:11倒计时时间
dragTimeString2019-01-10 11:11:11上门时间
contactNameString李四联系人
contactNumberString13312341234联系方式
snReturnQuestIdString202008260001苏宁退货请求号（04仅退款,03贵就赔时有值）
snRetOrderItemIdString202008260001苏宁逆向OMS行号（当仅退款和贵就赔可退时有值， 逆向同步账单数据的时候需要给此参数）
refundAmountString10.00退款金额
retReasonString仅退款申请退款原因申请退款原因（贵就赔/仅退款的申请原因）
pictureStringwww.picture1.com,www.picture2.com图片（贵就赔/仅退款的申请图片，多张以逗号分隔）
请求示例
  • XML示例
  • JSON示例
复制全部代码 
                                <sn_request>
  <sn_body>
    <queryRefundstatus>
      <orderItemId>99992017120601</orderItemId>
      <reOrderItemId>99992017120601</reOrderItemId>
      <type>01</type>
      <snReturnQuestId>202008260001</snReturnQuestId>
    </queryRefundstatus>
  </sn_body>
</sn_request>

                                
                                {
  "sn_request": {
    "sn_body": {
      "queryRefundstatus": {
        "orderItemId": "99992017120601",
        "reOrderItemId": "99992017120601",
        "type": "01",
        "snReturnQuestId": "202008260001"
      }
    }
  }
}
响应示例
  • XML示例
  • JSON示例
复制全部代码 
                              <sn_responseContent>
  <sn_body>
    <queryRefundstatus>
      <sellerPhoneNumber>13312341234</sellerPhoneNumber>
      <address>地址</address>
      <returnMode>01</returnMode>
      <contactName>李四</contactName>
      <countdownTime>2019-01-10 11:11:11</countdownTime>
      <itemCode>Y/N</itemCode>
      <returnMessage>商品破损</returnMessage>
      <sellerName>王三</sellerName>
      <retReason>仅退款申请退款原因</retReason>
      <retOperationCode>0/1/2</retOperationCode>
      <itemMsg>服务不可用</itemMsg>
      <picture>www.picture1.com,www.picture2.com</picture>
      <content>
        <picture>www.baidu.com/1.jpg</picture>
      </content>
      <snReturnQuestId>202008260001</snReturnQuestId>
      <dragTime>2019-01-10 11:11:11</dragTime>
      <contactNumber>13312341234</contactNumber>
      <reOrderItemId>99992017120601</reOrderItemId>
      <snRetOrderItemId>202008260001</snRetOrderItemId>
      <refundAmount>10.00</refundAmount>
    </queryRefundstatus>
  </sn_body>
</sn_responseContent>

                              
                              {
  "sn_responseContent": {
    "sn_body": {
      "queryRefundstatus": {
        "sellerPhoneNumber": "13312341234",
        "address": "地址",
        "returnMode": "01",
        "contactName": "李四",
        "countdownTime": "2019-01-10 11:11:11",
        "itemCode": "Y/N",
        "returnMessage": "商品破损",
        "sellerName": "王三",
        "retReason": "仅退款申请退款原因",
        "retOperationCode": "0/1/2",
        "itemMsg": "服务不可用",
        "picture": "www.picture1.com,www.picture2.com",
        "content": [
          {
            "picture": "www.baidu.com/1.jpg"
          }
        ],
        "snReturnQuestId": "202008260001",
        "dragTime": "2019-01-10 11:11:11",
        "contactNumber": "13312341234",
        "reOrderItemId": "99992017120601",
        "snRetOrderItemId": "202008260001",
        "refundAmount": "10.00"
      }
    }
  }
}
异常示例
  • XML示例
  • JSON示例
复制全部代码 

  
  	API异常码
  	异常码中文描述
  

                           	  
{
  "sn_responseContent": {
    "sn_error": {
      "error_code": "API异常码",
      "error_msg": "异常码中文描述"
    }
  }
}
业务异常码
异常码 错误描述 解决方案
biz.online.queryrefundstatus.length-overlong:* 参数的值超过规定长度 请检查此参数的值,*号表示参数字段名
isp.sys.service.unavailable.pangu 服务不可用 请联系苏宁技术人员
biz.online.queryrefundstatus.missing-parameter:* 参数必填 请检查此参数的值,*号表示参数字段名
biz.handler.data-get:no-result 查询没结果 请检查查询参数
isp.sys.service.unavailable.poas 服务不可用 请联系苏宁技术人员
biz.online.queryrefundstatus.invalid-biz:100 json转换异常 请检查查询参数
biz.online.queryrefundstatus.invalid-biz:101 未查询到平台配置信息 请检查查询参数
公共异常码
API工具
API TOOLS 在线测试工具异常码查询工具SDK调用示例SDK下载
FAQ