API接口目录

苏宁有货业务

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

查询苏宁订单行支持售后服务类型,苏宁将通过本接告知客户订单行可支持退货、换货和仅退款中哪些售后服务。

公共参数
请求参数
名称 类型 是否必须 示例值 描述
orderItemIdStringY00199812337601苏宁订单行号
响应参数
名称 类型 示例值 描述
orderItemIdString00199812337601苏宁订单行号
srvListString
srvStatusString1、2、3售后服务类型
srvNameString退货 、换货 、仅退款售后服务类型名称
permitRetStatusStringA-不能退 B-可部分退 C-需全部退 D-自由退货退货服务支持能力
permitRetNumString10可退货商品数量
productRetMoneyString1000单个商品可退金额
permitChgStatusStringA-不能换 B-可部分换 C-需全部换换货服务支持能力
permitChgNumString3可换货数量
enjoyMoneyString10000最大可退金额
permitRefStatusStringA-支持 B-不支持仅退款服务服务支持能力
reasonListString
reasonCodeString101003售后原因编码
reasonNameString选购失误售后原因描述
deliveryModeString0邮寄方式,0-顾客寄送,1-上门取件,2-其他
logisticsListString
logisticsCodeString01包装情况编码
logisticsDescString未开包装未使用包装完好包装情况描述
请求示例
  • XML示例
  • JSON示例
复制全部代码
                                <sn_request>
  <sn_body>
    <queryAftersaleservice>
      <orderItemId>00199812337601</orderItemId>
    </queryAftersaleservice>
  </sn_body>
</sn_request>

                                
                                {
  "sn_request": {
    "sn_body": {
      "queryAftersaleservice": {
        "orderItemId": "00199812337601"
      }
    }
  }
}
                                
响应示例
  • XML示例
  • JSON示例
复制全部代码
                              <sn_responseContent>
  <sn_body>
    <queryAftersaleservice>
      <orderItemId>00199812337601</orderItemId>
      <logisticsList>
        <logisticsCode>01</logisticsCode>
        <logisticsDesc>未开包装未使用包装完好</logisticsDesc>
      </logisticsList>
      <srvList>
        <productRetMoney>1000</productRetMoney>
        <deliveryMode>0</deliveryMode>
        <enjoyMoney>10000</enjoyMoney>
        <permitChgNum>3</permitChgNum>
        <permitRefStatus>A-支持 B-不支持</permitRefStatus>
        <srvName>退货 、换货 、仅退款</srvName>
        <permitRetNum>10</permitRetNum>
        <srvStatus>1、2、3</srvStatus>
        <reasonList>
          <reasonName>选购失误</reasonName>
          <reasonCode>101003</reasonCode>
        </reasonList>
        <permitChgStatus>A-不能换 B-可部分换 C-需全部换</permitChgStatus>
        <permitRetStatus>A-不能退 B-可部分退 C-需全部退 D-自由退货</permitRetStatus>
      </srvList>
    </queryAftersaleservice>
  </sn_body>
</sn_responseContent>

                              
                              {
  "sn_responseContent": {
    "sn_body": {
      "queryAftersaleservice": {
        "orderItemId": "00199812337601",
        "logisticsList": [
          {
            "logisticsCode": "01",
            "logisticsDesc": "未开包装未使用包装完好"
          }
        ],
        "srvList": [
          {
            "productRetMoney": "1000",
            "deliveryMode": "0",
            "enjoyMoney": "10000",
            "permitChgNum": "3",
            "permitRefStatus": "A-支持 B-不支持",
            "srvName": "退货 、换货 、仅退款",
            "permitRetNum": "10",
            "srvStatus": "1、2、3",
            "reasonList": [
              {
                "reasonName": "选购失误",
                "reasonCode": "101003"
              }
            ],
            "permitChgStatus": "A-不能换 B-可部分换 C-需全部换",
            "permitRetStatus": "A-不能退 B-可部分退 C-需全部退 D-自由退货"
          }
        ]
      }
    }
  }
}
                              
异常示例
  • XML示例
  • JSON示例
复制全部代码

  
  	API异常码
  	异常码中文描述
  

                           	  
{
  "sn_responseContent": {
    "sn_error": {
      "error_code": "API异常码",
      "error_msg": "异常码中文描述"
    }
  }
}
                           		
业务异常码
异常码 错误描述 解决方案
biz.sngoods.queryaftersaleservice.missing-parameter:* 参数必填 请检查此参数的值,*号表示参数字段名
biz.handler.data-get:no-result 查询没结果 请检查查询参数
isp.sys.service.unavailable.snyh 服务不可用 请联系苏宁技术人员
公共异常码
API工具
FAQ