API接口目录

苏宁有货业务

有货买家商品API
有货买家价格库存API
有货买家订单API
有货买家物流API
有货买家售后API
有货买家其他API
有货卖家商品API
家乐福供货平台API
异常码自查工具
suning.sngoods.currenteventoperation.query 查询当前节点操作及展示信息
¥免费

本接口供用户查询当前订单所需执行的售后操

公共参数
请求参数
名称 类型 是否必须 示例值 描述
orderItemIdStringY00199812337601苏宁订单行号
响应参数
名称 类型 示例值 描述
orderItemIdString00199812337601苏宁订单行号
displayListString
returnModeString01-上门取件 02-顾客寄件退换货方式
receiverNameString李四,returnMode=02顾客寄件时返回退货收件人姓名
receiverPhoneString157XXXXXXXX退货收件人联系电话
returngoodsAddressString北京市朝阳区慈云寺北里118号苏宁易购广场,returnMode=02顾客寄件时返回退货地址
courierNameString王五,returnMode=01:上门取件时返回取件员姓名
courierPhoneString137XXXXXXXX,returnMode=01:上门取件时返回取件员联系电话
dragTimeString2020-01-14,returnMode=01:上门取件时返回上门取件时间
expressCompanyNameString苏宁物流货物寄回快递公司
expressOrderIdString12345678910货物寄回快递单号
logisticsTraceDescString货物已被签收最新物流信息
logisticsTraceTimeString2020-01-15 20:15:01最新物流消息更新时间
reasonAgreenString商品破损,无法换货审核不通过原因
remarkContentString商品损坏商家留言
pictureCodesSupplierString//image2.suning.cn/uimg/cms/img/159292977092829380.jpg_231w_140h_4e图片描述
serviceStatusString10-申请售后,1-同意申请,2-货物寄回,3-开始退款,4-退款中,5-已完成,6-请求关闭,7-退款失败
operationListString
operationTypeString0-无需进行操作; 1-撤销申请; 2-提交退换货物流; 3-确认收货支持售后操作类型
countdownTimeString2020-10-10 20:58:00截止时间
expressListString
expressidString1物流公司编码
expressNameString苏宁物流物流公司名称
请求示例
  • XML示例
  • JSON示例
复制全部代码
                                <sn_request>
  <sn_body>
    <queryCurrenteventoperation>
      <orderItemId>00199812337601</orderItemId>
    </queryCurrenteventoperation>
  </sn_body>
</sn_request>

                                
                                {
  "sn_request": {
    "sn_body": {
      "queryCurrenteventoperation": {
        "orderItemId": "00199812337601"
      }
    }
  }
}
                                
响应示例
  • XML示例
  • JSON示例
复制全部代码
                              <sn_responseContent>
  <sn_body>
    <queryCurrenteventoperation>
      <operationList>
        <countdownTime>2020-10-10 20:58:00</countdownTime>
        <expressList>
          <expressName>苏宁物流</expressName>
          <expressid>1</expressid>
        </expressList>
        <operationType>0-无需进行操作; 1-撤销申请; 2-提交退换货物流; 3-确认收货</operationType>
      </operationList>
      <orderItemId>00199812337601</orderItemId>
      <displayList>
        <returnMode>01-上门取件 02-顾客寄件</returnMode>
        <reasonAgreen>商品破损,无法换货</reasonAgreen>
        <expressOrderId>12345678910</expressOrderId>
        <receiverName>李四,returnMode=02顾客寄件时返回</receiverName>
        <logisticsTraceDesc>货物已被签收</logisticsTraceDesc>
        <expressCompanyName>苏宁物流</expressCompanyName>
        <courierName>王五,returnMode=01:上门取件时返回</courierName>
        <receiverPhone>157XXXXXXXX</receiverPhone>
        <remarkContent>商品损坏</remarkContent>
        <dragTime>2020-01-14,returnMode=01:上门取件时返回</dragTime>
        <logisticsTraceTime>2020-01-15 20:15:01</logisticsTraceTime>
        <serviceStatus>1</serviceStatus>
        <returngoodsAddress>北京市朝阳区慈云寺北里118号苏宁易购广场,returnMode=02顾客寄件时返回</returngoodsAddress>
        <courierPhone>137XXXXXXXX,returnMode=01:上门取件时返回</courierPhone>
        <pictureCodesSupplier>//image2.suning.cn/uimg/cms/img/159292977092829380.jpg_231w_140h_4e</pictureCodesSupplier>
      </displayList>
    </queryCurrenteventoperation>
  </sn_body>
</sn_responseContent>

                              
                              {
  "sn_responseContent": {
    "sn_body": {
      "queryCurrenteventoperation": {
        "operationList": [
          {
            "countdownTime": "2020-10-10 20:58:00",
            "expressList": [
              {
                "expressName": "苏宁物流",
                "expressid": "1"
              }
            ],
            "operationType": "0-无需进行操作; 1-撤销申请; 2-提交退换货物流; 3-确认收货"
          }
        ],
        "orderItemId": "00199812337601",
        "displayList": [
          {
            "returnMode": "01-上门取件 02-顾客寄件",
            "reasonAgreen": "商品破损,无法换货",
            "expressOrderId": "12345678910",
            "receiverName": "李四,returnMode=02顾客寄件时返回",
            "logisticsTraceDesc": "货物已被签收",
            "expressCompanyName": "苏宁物流",
            "courierName": "王五,returnMode=01:上门取件时返回",
            "receiverPhone": "157XXXXXXXX",
            "remarkContent": "商品损坏",
            "dragTime": "2020-01-14,returnMode=01:上门取件时返回",
            "logisticsTraceTime": "2020-01-15 20:15:01",
            "serviceStatus": "1",
            "returngoodsAddress": "北京市朝阳区慈云寺北里118号苏宁易购广场,returnMode=02顾客寄件时返回",
            "courierPhone": "137XXXXXXXX,returnMode=01:上门取件时返回",
            "pictureCodesSupplier": "//image2.suning.cn/uimg/cms/img/159292977092829380.jpg_231w_140h_4e"
          }
        ]
      }
    }
  }
}
                              
异常示例
  • XML示例
  • JSON示例
复制全部代码

  
  	API异常码
  	异常码中文描述
  

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