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

平台业务

商品API
价格API
库存API
销售准备API
交易API
退货退款API（新）
财务API
店铺API
物流API
促销API
分销API
发票API
招商API
换货API
互动营销API
退货退款API
客服API
平台营销API
风控API
会员通API
账房API
财务记账API
异常码自查工具
suning.custom.orderevaluate.query 订单评价批量查询（三个月内）
￥基础

通过此接口可批量查询三个月内订单评价。


公共参数
请求参数
名称 类型 是否必须 示例值 描述
pageNoStringN1页码。当前页码，1到99999之间，当前页码或者每页数量其中一个不填则当前页码默认1，每页数量默认为10
pageSizeStringN10每页条数。每页数量，1到100之间，当前页码或者每页数量其中一个不填则当前页码默认1，每页数量默认为10
evaluateLevelStringN1评价等级。商品评价等级 0-全部,1-差评,2-中评,3-好评
startTimeStringY2020-06-17或者2020-06-17 12:00:09查询开始时间。查询订单评价开始时间。格式:yyyy-MM-dd或者yyyy-MM-dd HH:mm:ss若输入则开始时间和结束时间必须同时出现
endTimeStringY2020-06-17或者2020-06-17 12:00:09查询结束时间。查询订单评价结束时间。格式:yyyy-MM-dd或者yyyy-MM-dd HH:mm:ss若输入则开始时间和结束时间必须同时出现
isAddCommentsStringN1是否追评。0-无 1-有 不填写表示查询全部
isReplyStringN1是否回复。0-无 1-有 不填写表示查询全部
响应参数
名称 类型 示例值 描述
orderCodeString2000813514订单号。
productNameString佐丹奴男 猫须舒适直筒洗水牛仔裤01114059001 02蓝色 32码苏宁商品名称。
productCodeString100544542苏宁商品编码。
custStarString4商品评分。1-一星，2-二星、3-三星，4-四星，5-五星。 差评：一星；中评：二星/三星；好评：四星/五星
attitudeStarString5服务评分。1-一星，2-二星、3-三星，4-四星，5-五星。 差评：一星；中评：二星/三星；好评：四星/五星
deliverySpeedStarString5物流评分。1-一星，2-二星、3-三星，4-四星，5-五星。 差评：一星；中评：二星/三星；好评：四星/五星
userNameStringJessica880买家名称。
custEvaluateContentString很好的卖家，下次一定再来顾客评价内容。
custEvaluateTimeString2015-01-16 09:40:38顾客评价时间。格式：YYYY-MM-DD HH:mm:ss
custEvaluateIdString111111顾客评价ID。
custAddEvaluateContentString很好的卖家，下次一定再来顾客追评。
custAddEvaluateTimeString2015-02-16 09:40:38顾客追评时间。格式：YYYY-MM-DD HH:mm:ss
custAddEvaluateIdString222222顾客追评ID。
shopReplyContentString亲，感谢您光临小店，也请亲能够继续关注小店！商家回复。
shopReplyTimeString2015-01-16 09:45:38商家回复时间
shopReplyIdString10001113商家回复ID
shopCanReplyString1商家是否可以回复。值：0-否；1-是。若用户有一条评价，商家可回复，不久用户又追加了一条评价，商家还可以继续回复；若商家同时看到用户的评价和追加评价，则只能回复一次，属于对追评的回复
请求示例
  • XML示例
  • JSON示例
复制全部代码 
                                
<sn_request>
  <sn_body>
    <queryOrderEvaluate>
      <evaluateLevel>1</evaluateLevel>
      <isAddComments>1</isAddComments>
      <pageNo>1</pageNo>
      <pageSize>10</pageSize>
      <startTime>2020-06-17或者2020-06-17 12:00:09</startTime>
      <endTime>2020-06-17或者2020-06-17 12:00:09</endTime>
      <isReply>1</isReply>
    </queryOrderEvaluate>
  </sn_body>
</sn_request>

			
                                
                                
{
  "sn_request": {
    "sn_body": {
      "queryOrderEvaluate": {
        "evaluateLevel": "1",
        "isAddComments": "1",
        "pageNo": "1",
        "pageSize": "10",
        "startTime": "2020-06-17或者2020-06-17 12:00:09",
        "endTime": "2020-06-17或者2020-06-17 12:00:09",
        "isReply": "1"
      }
    }
  }
}
响应示例
  • XML示例
  • JSON示例
复制全部代码 
                              
<sn_responseContent>
  <sn_head>
    <totalSize>1</totalSize>
    <pageTotal>1</pageTotal>
    <pageNo>1</pageNo>
    <returnMessage>biz.handler.data-get:success</returnMessage>
  </sn_head>
  <sn_body>
    <queryOrderEvaluate>
      <deliverySpeedStar>5</deliverySpeedStar>
      <shopCanReply>1</shopCanReply>
      <custEvaluateContent>很好的卖家，下次一定再来</custEvaluateContent>
      <shopReplyContent>亲，感谢您光临小店，也请亲能够继续关注小店！</shopReplyContent>
      <custEvaluateTime>2015-01-16 09:40:38</custEvaluateTime>
      <custAddEvaluateId>222222</custAddEvaluateId>
      <shopReplyTime>2015-01-16 09:45:38</shopReplyTime>
      <custAddEvaluateContent>很好的卖家，下次一定再来</custAddEvaluateContent>
      <userName>Jessica880</userName>
      <productName>佐丹奴男 猫须舒适直筒洗水牛仔裤01114059001 02蓝色 32码</productName>
      <custStar>4</custStar>
      <productCode>100544542</productCode>
      <custEvaluateId>111111</custEvaluateId>
      <custAddEvaluateTime>2015-02-16 09:40:38</custAddEvaluateTime>
      <shopReplyId>10001113</shopReplyId>
      <attitudeStar>5</attitudeStar>
      <orderCode>2000813514</orderCode>
    </queryOrderEvaluate>
  </sn_body>
</sn_responseContent>

			
                              
                              
{
  "sn_responseContent": {
    "sn_head": {
      "totalSize": "1",
      "pageTotal": "1",
      "pageNo": "1",
      "returnMessage": "biz.handler.data-get:success"
    },
    "sn_body": {
      "queryOrderEvaluate": [
        {
          "deliverySpeedStar": "5",
          "shopCanReply": "1",
          "custEvaluateContent": "很好的卖家，下次一定再来",
          "shopReplyContent": "亲，感谢您光临小店，也请亲能够继续关注小店！",
          "custEvaluateTime": "2015-01-16 09:40:38",
          "custAddEvaluateId": "222222",
          "shopReplyTime": "2015-01-16 09:45:38",
          "custAddEvaluateContent": "很好的卖家，下次一定再来",
          "userName": "Jessica880",
          "productName": "佐丹奴男 猫须舒适直筒洗水牛仔裤01114059001 02蓝色 32码",
          "custStar": "4",
          "productCode": "100544542",
          "custEvaluateId": "111111",
          "custAddEvaluateTime": "2015-02-16 09:40:38",
          "shopReplyId": "10001113",
          "attitudeStar": "5",
          "orderCode": "2000813514"
        }
      ]
    }
  }
}
异常示例
  • XML示例
  • JSON示例
复制全部代码 

  
  	API异常码
  	异常码中文描述
  

                           	  
{
  "sn_responseContent": {
    "sn_error": {
      "error_code": "API异常码",
      "error_msg": "异常码中文描述"
    }
  }
}
业务异常码
异常码 错误描述 解决方案
isp.sys.service.unavailable.laf 服务不可用 请联系苏宁技术人员
biz.custom.queryorderevaluate.missing-parameter:* 参数必填 请检查此参数的值,*号表示参数字段名
biz.custom.queryorderevaluate.enumeration-error:* 参数的可选值错误 请检查此参数的值,*号表示参数字段名
biz.custom.queryorderevaluate.format-error:* 参数格式错误 请检查此参数的值,*号表示参数字段名
biz.handler.data-get:no-result 查询没结果 请检查查询参数
isp.sys.service.unavailable.moms 服务不可用 请联系苏宁技术人员
biz.custom.queryorderevaluate.invalid-biz:100 开始时间，结束时间不能为空 开始时间，结束时间不能为空
biz.custom.queryorderevaluate.invalid-biz:101 开始时间格式有误 开始时间格式有误
biz.custom.queryorderevaluate.invalid-biz:102 结束时间格式有误 结束时间格式有误
公共异常码
API工具
API TOOLS 在线测试工具异常码查询工具SDK调用示例SDK下载
FAQ

Q：订单评价批量查询（三个月内）接口如何使用？

A：通过此接口可订单评价批量查询（三个月内）