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.selfreview.query 品牌商查询近三个月商品评价接口
¥基础

品牌商查询近三个月商品评价接口

公共参数
请求参数
名称 类型 是否必须 示例值 描述
pageNoStringN1页码。当前页码,1到99999之间,当前页码或者每页数量其中一个不填则当前页码默认1,每页数量默认为10
pageSizeStringN10每页条数。每页数量,1到100之间,当前页码或者每页数量其中一个不填则当前页码默认1,每页数量默认为10
startTimeStringY2020-06-17 12:00:09查询订单评价开始时间。格式:yyyy-MM-dd HH:mm:ss
endTimeStringY2020-06-17 12:00:09查询订单评价结束时间。格式:yyyy-MM-dd HH:mm:ss
evaluateLevelStringN0评价等级。商品评价等级 0-全部,1-差评,2-中评,3-好评
isAddCommentsStringN0是否追评。 0-无 1-有 不填写表示查询全部
isReplyStringN0是否回复。 0-无 1-有 不填写表示查询全部
snUnionIdStringN会员编码c9481ac075d1eab2ffa13e61033fc94841d0975d1eabdffa
响应参数
名称 类型 示例值 描述
orderCodeString2000813514销售单号
productNameString佐丹奴男 猫须舒适直筒洗水牛仔裤苏宁商品名称
productCodeString100544542苏宁商品编码
custStarString1商品评分。1-一星,2-二星、3-三星,4-四星,5-五星。
attitudeStarString1服务评分。1-一星,2-二星、3-三星,4-四星,5-五星。
deliverySpeedStarString1物流评分。1-一星,2-二星、3-三星,4-四星,5-五星。
userNameStringJessica880买家名称
custEvaluateContentString很好的卖家,下次一定再来顾客评价内容
custEvaluateTimeString2015-01-16 09:45:38顾客评价时间。格式:YYYY-MM-DD HH:mm:ss
custEvaluateIdString1111111111顾客评价ID
custAddEvaluateContentString很好的卖家,下次一定再来顾客追评
custAddEvaluateTimeString2015-01-16 09:45:38顾客追评时间。格式:YYYY-MM-DD HH:mm:ss
custAddEvaluateIdString222222顾客追评ID
shopReplyContentString亲,感谢您光临小店,也请亲能够继续关注小店!商家回复
shopReplyTimeString2020-01-16 11:45:38商家回复时间。格式:YYYY-MM-DD HH:mm:ss
shopReplyIdString10001113商家回复ID
shopCanReplyString1商家是否可以回复。值:0-否;1-是。
custEvaluatePicString//uimgpre.cnsuning.com/uimg/ZR/share_order/160032834884882678_640x640.jpg顾客评价图片
custEvaluateVideoStringhttp://m4.pptvyun.com/svod/b69e7/ChVSMtsEi3vW2Ibc3lkZsR7khKA/eyJkbCI6MTU3MTk3MzkxNywiZXMiOjYwNDgwMCwiaWQiOiJPQkJFd3oiLCJ2IjoiMS4wIn0/OBBEwz.mp4顾客评价上传视频
请求示例
  • XML示例
  • JSON示例
复制全部代码
                                
<sn_request>
  <sn_body>
    <querySelfreview>
      <evaluateLevel>0</evaluateLevel>
      <isAddComments>0</isAddComments>
      <pageNo>1</pageNo>
      <pageSize>10</pageSize>
      <startTime>2020-06-17 12:00:09</startTime>
      <endTime>2020-06-17 12:00:09</endTime>
      <isReply>0</isReply>
      <snUnionId>会员编码</snUnionId>
    </querySelfreview>
  </sn_body>
</sn_request>

			
                                
                                
{
  "sn_request": {
    "sn_body": {
      "querySelfreview": {
        "evaluateLevel": "0",
        "isAddComments": "0",
        "pageNo": "1",
        "pageSize": "10",
        "startTime": "2020-06-17 12:00:09",
        "endTime": "2020-06-17 12:00:09",
        "isReply": "0",
        "snUnionId": "会员编码"
      }
    }
  }
}
			
                                
响应示例
  • 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>
    <querySelfreview>
      <deliverySpeedStar>1</deliverySpeedStar>
      <shopCanReply>1</shopCanReply>
      <custEvaluateContent>很好的卖家,下次一定再来</custEvaluateContent>
      <shopReplyContent>亲,感谢您光临小店,也请亲能够继续关注小店!</shopReplyContent>
      <custEvaluateTime>2015-01-16 09:45:38</custEvaluateTime>
      <custAddEvaluateId>222222</custAddEvaluateId>
      <shopReplyTime>2020-01-16  11:45:38</shopReplyTime>
      <userName>Jessica880</userName>
      <custAddEvaluateContent>很好的卖家,下次一定再来</custAddEvaluateContent>
      <productName>佐丹奴男 猫须舒适直筒洗水牛仔裤</productName>
      <custEvaluatePic>//uimgpre.cnsuning.com/uimg/ZR/share_order/160032834884882678_640x640.jpg</custEvaluatePic>
      <custStar>1</custStar>
      <productCode>100544542</productCode>
      <custEvaluateId>1111111111</custEvaluateId>
      <custAddEvaluateTime>2015-01-16 09:45:38</custAddEvaluateTime>
      <shopReplyId>10001113</shopReplyId>
      <orderCode>2000813514</orderCode>
      <attitudeStar>1</attitudeStar>
      <custEvaluateVideo>http://m4.pptvyun.com/svod/b69e7/ChVSMtsEi3vW2Ibc3lkZsR7khKA/eyJkbCI6MTU3MTk3MzkxNywiZXMiOjYwNDgwMCwiaWQiOiJPQkJFd3oiLCJ2IjoiMS4wIn0/OBBEwz.mp4</custEvaluateVideo>
    </querySelfreview>
  </sn_body>
</sn_responseContent>

			
                              
                              
{
  "sn_responseContent": {
    "sn_head": {
      "totalSize": "1",
      "pageTotal": "1",
      "pageNo": "1",
      "returnMessage": "biz.handler.data-get:success"
    },
    "sn_body": {
      "querySelfreview": [
        {
          "deliverySpeedStar": "1",
          "shopCanReply": "1",
          "custEvaluateContent": "很好的卖家,下次一定再来",
          "shopReplyContent": "亲,感谢您光临小店,也请亲能够继续关注小店!",
          "custEvaluateTime": "2015-01-16 09:45:38",
          "custAddEvaluateId": "222222",
          "shopReplyTime": "2020-01-16  11:45:38",
          "userName": "Jessica880",
          "custAddEvaluateContent": "很好的卖家,下次一定再来",
          "productName": "佐丹奴男 猫须舒适直筒洗水牛仔裤",
          "custEvaluatePic": "//uimgpre.cnsuning.com/uimg/ZR/share_order/160032834884882678_640x640.jpg",
          "custStar": "1",
          "productCode": "100544542",
          "custEvaluateId": "1111111111",
          "custAddEvaluateTime": "2015-01-16 09:45:38",
          "shopReplyId": "10001113",
          "orderCode": "2000813514",
          "attitudeStar": "1",
          "custEvaluateVideo": "http://m4.pptvyun.com/svod/b69e7/ChVSMtsEi3vW2Ibc3lkZsR7khKA/eyJkbCI6MTU3MTk3MzkxNywiZXMiOjYwNDgwMCwiaWQiOiJPQkJFd3oiLCJ2IjoiMS4wIn0/OBBEwz.mp4"
        }
      ]
    }
  }
}
			
                              
异常示例
  • XML示例
  • JSON示例
复制全部代码

  
  	API异常码
  	异常码中文描述
  

                           	  
{
  "sn_responseContent": {
    "sn_error": {
      "error_code": "API异常码",
      "error_msg": "异常码中文描述"
    }
  }
}
                           		
业务异常码
异常码 错误描述 解决方案
biz.custom.queryselfreview.format-error:* 参数格式错误 请检查此参数的值,*号表示参数字段名
biz.custom.queryselfreview.missing-parameter:* 参数必填 请检查此参数的值,*号表示参数字段名
biz.handler.data-get:no-result 查询没结果 请检查查询参数
isp.sys.service.unavailable.laf 服务不可用 请联系苏宁技术人员
biz.custom.queryselfreview.invalid-biz:100 开始时间和结束时间必须同时出现 开始时间和结束时间必须同时出现
biz.custom.queryselfreview.invalid-biz:101 开始时间和结束时间 格式:yyyy-MM-dd HH:mm:ss 开始时间和结束时间 格式:yyyy-MM-dd HH:mm:ss
biz.custom.queryselfreview.invalid-biz:102 结束时间必须大于开始时间,并且时间跨度都在三个月内 结束时间必须大于开始时间,并且时间跨度都在三个月内
biz.custom.queryselfreview.invalid-biz:103 当前页码 pageNo 1到99999之间 当前页码 pageNo 1到99999之间
biz.custom.queryselfreview.invalid-biz:104 每页数量 pageSize 1到100之间 每页数量 pageSize 1到100之间
biz.custom.queryselfreview.invalid-biz:105 查询无结果 查询无结果
biz.custom.queryselfreview.invalid-biz:106 系统异常 系统异常
公共异常码
API工具
FAQ