退出
热词搜索：
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.isvitemlist.query 商品筛选列表
￥免费

可通过此接口批量查询商品筛选列表信息。
1、可通过输入商家编码、品牌编码、商品四级类目编码、删除标识、商品类型、商品所属店内分类（必须传最底层）、商品一级类目编码、苏宁商品编码、销售状态、商品二级类目编码、商家商品编码、商品三级类目编码、商品名称，无值时传*号、关键词、商品标题、最近编辑时间-开始时间、最近编辑时间-结束时间、价格搜索条件范围、价格搜索条件范围、o2o标识、排序逻辑 条件批量查询商品筛选列表信息，若只输入商家编码查询条件，默认查询所有的商品。
2、查询结果返回商品的商家商品编码、 销售状态、四级类目编码、商家编码、近30天销量、四级类目名称、商品名称、商品编码、商品标题、创建时间、商品类型、品牌编码。
3、pageNo（页码）、pageSize（每页条数）必须组合查询，否则，系统默认返回第一页的10条数据。
4、返回结果分页展示，通过输入的页码可以定位到具体第几页，每页条数控制每页返回的条数。

公共参数
请求参数
名称 类型 是否必须 示例值 描述
brandCodeStringN00000000品牌编码
categoryCodeStringN1商品四级类目编码
delFlagStringN00删除标识：00-未删除，01-删除
catentryTypeStringN01商品类型：00，01
groupCodesStringN12商品所属店内分类（必须传最底层）
fcateCodeStringN432556商品一级类目编码
productCodeStringN100002496,100004184苏宁商品编码
saleStatusStringN1,7,8销售状态：1-在售 2-待售（商家自己下架） 3-强制下架 4-违规下架 5-从未上架 6-违规删除下架 7-无货下架 8-价格异常下架
scateCodeStringN342224,5322商品二级类目编码
supplierCmmdtyCodeStringN100000016,100000017,100000018商家商品编码
tcateCodeStringN432556商品三级类目编码
productNameStringN*商品名称，无值时传*号
keyWordStringN关键词文胸
cmTitleStringN金圭内胆商品标题
editBeginTimeStringN最近编辑时间-开始时间最近编辑时间-开始时间
editEndTimeStringN最近编辑时间-结束时间最近编辑时间-结束时间
mixPriceStringN1.2价格搜索条件范围
pageStringY1当前页数
maxPriceStringN6.7价格搜索条件范围
pagenumStringY1每页显示商品数量
orderTypeStringN1排序逻辑 orderType . 1.销量升序[默认]， 2.销量降序， 3.时间升序 4时间降序， 5.价格升序 6价格降序
响应参数
名称 类型 示例值 描述
totalRecordsString2总数
pageString2页数
resultListString
brandNameString文胸品牌名称
supplierCmmdtyCodeString00000000商家商品编码
saleStatusString1销售状态：1-在售 2-待售（商家自己下架） 3-强制下架 4-违规下架 5-从未上架 6-违规删除下架 7-无货下架 8-价格异常下架
categoryCodeString432556四级类目编码
supplierCodeString00000000商家编码
saleCountsString1近30天销量
categoryNameString四级类目名称四级类目名称
productNameString衬衫商品名称
productCodeString432556商品编码
cmTitleString好衬衫商品标题
createTimeString创建时间创建时间
cmmdtyTypeString商品类型:00:单一 01：通码00
brandCodeString00品牌编码
picUrlString图片链接地址
请求示例
  • XML示例
  • JSON示例
复制全部代码 
                                

<sn_request>
  <sn_body>
    <queryIsvitemlist>
      <orderType>1</orderType>
      <supplierCmmdtyCode>100000016,100000017,100000018</supplierCmmdtyCode>
      <groupCodes>12</groupCodes>
      <tcateCode>432556</tcateCode>
      <editBeginTime>最近编辑时间-开始时间</editBeginTime>
      <categoryCode>1</categoryCode>
      <saleStatus>1,7,8</saleStatus>
      <delFlag>00</delFlag>
      <pagenum>1</pagenum>
      <editEndTime>最近编辑时间-结束时间</editEndTime>
      <productName>*</productName>
      <keyWord>关键词</keyWord>
      <productCode>100002496,100004184</productCode>
      <cmTitle>金圭内胆</cmTitle>
      <fcateCode>432556</fcateCode>
      <catentryType>01</catentryType>
      <maxPrice>6.7</maxPrice>
      <page>1</page>
      <mixPrice>1.2</mixPrice>
      <brandCode>00000000</brandCode>
      <scateCode>342224,5322</scateCode>
    </queryIsvitemlist>
  </sn_body>
</sn_request>

			
			
                                
                                

{
  "sn_request": {
    "sn_body": {
      "queryIsvitemlist": {
        "orderType": "1",
        "supplierCmmdtyCode": "100000016,100000017,100000018",
        "groupCodes": "12",
        "tcateCode": "432556",
        "editBeginTime": "最近编辑时间-开始时间",
        "categoryCode": "1",
        "saleStatus": "1,7,8",
        "delFlag": "00",
        "pagenum": "1",
        "editEndTime": "最近编辑时间-结束时间",
        "productName": "*",
        "keyWord": "关键词",
        "productCode": "100002496,100004184",
        "cmTitle": "金圭内胆",
        "fcateCode": "432556",
        "catentryType": "01",
        "maxPrice": "6.7",
        "page": "1",
        "mixPrice": "1.2",
        "brandCode": "00000000",
        "scateCode": "342224,5322"
      }
    }
  }
}
响应示例
  • XML示例
  • JSON示例
复制全部代码 
                              

<sn_responseContent>
  <sn_body>
    <queryIsvitemlist>
      <totalRecords>2</totalRecords>
      <page>2</page>
      <resultList>
        <brandName>文胸</brandName>
        <supplierCmmdtyCode>00000000</supplierCmmdtyCode>
        <categoryCode>432556</categoryCode>
        <saleStatus>1</saleStatus>
        <supplierCode>00000000</supplierCode>
        <saleCounts>1</saleCounts>
        <categoryName>四级类目名称</categoryName>
        <productName>衬衫</productName>
        <picUrl>null</picUrl>
        <productCode>432556</productCode>
        <cmTitle>好衬衫</cmTitle>
        <createTime>创建时间</createTime>
        <cmmdtyType>商品类型:00:单一 01：通码</cmmdtyType>
        <brandCode>00</brandCode>
      </resultList>
    </queryIsvitemlist>
  </sn_body>
</sn_responseContent>

			
			
                              
                              

{
  "sn_responseContent": {
    "sn_body": {
      "queryIsvitemlist": {
        "totalRecords": "2",
        "page": "2",
        "resultList": [
          {
            "brandName": "文胸",
            "supplierCmmdtyCode": "00000000",
            "categoryCode": "432556",
            "saleStatus": "1",
            "supplierCode": "00000000",
            "saleCounts": "1",
            "categoryName": "四级类目名称",
            "productName": "衬衫",
            "picUrl": "null",
            "productCode": "432556",
            "cmTitle": "好衬衫",
            "createTime": "创建时间",
            "cmmdtyType": "商品类型:00:单一 01：通码",
            "brandCode": "00"
          }
        ]
      }
    }
  }
}
异常示例
  • XML示例
  • JSON示例
复制全部代码 

  
  	API异常码
  	异常码中文描述
  

                           	  
{
  "sn_responseContent": {
    "sn_error": {
      "error_code": "API异常码",
      "error_msg": "异常码中文描述"
    }
  }
}
业务异常码
异常码 错误描述 解决方案
biz.custom.queryisvitemlist.format-error:* 参数格式错误 请检查此参数的值,*号表示参数字段名
biz.custom.queryisvitemlist.missing-parameter:* 参数必填 请检查此参数的值,*号表示参数字段名
biz.custom.queryisvitemlist.length-overlong:* 参数的值超过规定长度 请检查此参数的值,*号表示参数字段名
biz.handler.data-get:no-result 查询没结果 请检查查询参数
isp.sys.service.unavailable.mcmp 服务不可用 请联系苏宁技术人员
公共异常码
API工具
API TOOLS 在线测试工具异常码查询工具SDK调用示例SDK下载
FAQ