退出
热词搜索：
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.category.query 获取商品采购目录信息
￥免费

可以通过此接口获取苏宁授权的采购目录信息。 1、 可以输入苏宁采购目录名称进行模糊查询，系统返回该商户操作权限下的采购目录名称均符合的所有采购目录信息。也可以不输入任何数据进行查询，系统返回商户操作权限下的所有采购目录信息。 2、 pageNo（页码）、pageSize（每页条数）必须组合查询，否则，系统默认返回第一页的10条数据。 3、返回结果分页展示，通过输入的页码可以定位到具体第几页，每页条数控制每页返回的条数。

公共参数
请求参数
名称 类型 是否必须 示例值 描述
categoryNameStringN服饰鞋帽苏宁采购目录名称。可输入中文，根据输入的信息进行关键字模糊查询。
pageNoStringN1页码
pageSizeStringN10每页条数
targetChannelStringN1线上线下标识。1，线上。2，线下。
响应参数
名称 类型 示例值 描述
categoryCodeStringR3301002当前采购目录编码。
categoryNameString工具箱当前采购目录名称。
descPathString家用视听设备及相关配件|工程音响|专业音响|专业音响采购目录层级描述
fourCategoryString
categoryCodeString四级类目编码四级类目编码
categoryNameString四级类目名称四级类目名称
descPathString家用视听设备及相关配件|工程音响|专业音响|专业音响采购目录层级描述
gradeString4当前采购目录层级。
isBottomStringX“X”表示无下级目录；“N”表示有下级目录。
gradeString4当前采购目录层级。
isBottomStringX“X”表示无下级目录；“N”表示有下级目录。
catIdStringR8229#R8303#R8742#R9001857类目编码
catNameString生活日用家庭清洁#清洁用品#衣物洗护#漂白剂类目名称
请求示例
  • XML示例
  • JSON示例
复制全部代码 
                                
<sn_request>
  <sn_body>
    <category>
      <pageNo>1</pageNo>
      <pageSize>10</pageSize>
      <targetChannel>1</targetChannel>
      <categoryName>服饰鞋帽</categoryName>
    </category>
  </sn_body>
</sn_request>

			
                                
                                
{
  "sn_request": {
    "sn_body": {
      "category": {
        "pageNo": "1",
        "pageSize": "10",
        "targetChannel": "1",
        "categoryName": "服饰鞋帽"
      }
    }
  }
}
响应示例
  • 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>
    <category>
      <catId>R8229#R8303#R8742#R9001857</catId>
      <grade>4</grade>
      <descPath>家用视听设备及相关配件|工程音响|专业音响|专业音响</descPath>
      <catName>生活日用家庭清洁#清洁用品#衣物洗护#漂白剂</catName>
      <categoryCode>R3301002</categoryCode>
      <fourCategory>
        <grade>4</grade>
        <descPath>家用视听设备及相关配件|工程音响|专业音响|专业音响</descPath>
        <categoryCode>四级类目编码</categoryCode>
        <categoryName>四级类目名称</categoryName>
        <isBottom>X</isBottom>
      </fourCategory>
      <categoryName>工具箱</categoryName>
      <isBottom>X</isBottom>
    </category>
  </sn_body>
</sn_responseContent>

			
                              
                              
{
  "sn_responseContent": {
    "sn_head": {
      "totalSize": "1",
      "pageTotal": "1",
      "pageNo": "1",
      "returnMessage": "biz.handler.data-get:success"
    },
    "sn_body": {
      "category": [
        {
          "catId": "R8229#R8303#R8742#R9001857",
          "grade": "4",
          "descPath": "家用视听设备及相关配件|工程音响|专业音响|专业音响",
          "catName": "生活日用家庭清洁#清洁用品#衣物洗护#漂白剂",
          "categoryCode": "R3301002",
          "fourCategory": [
            {
              "grade": "4",
              "descPath": "家用视听设备及相关配件|工程音响|专业音响|专业音响",
              "categoryCode": "四级类目编码",
              "categoryName": "四级类目名称",
              "isBottom": "X"
            }
          ],
          "categoryName": "工具箱",
          "isBottom": "X"
        }
      ]
    }
  }
}
异常示例
  • XML示例
  • JSON示例
复制全部代码 

  
  	API异常码
  	异常码中文描述
  

                           	  
{
  "sn_responseContent": {
    "sn_error": {
      "error_code": "API异常码",
      "error_msg": "异常码中文描述"
    }
  }
}
业务异常码
异常码 错误描述 解决方案
biz.handler.data-get:no-result 查询没结果 请检查查询参数
isp.sys.service.unavailable.mcmp 服务不可用 请联系苏宁技术人员
biz.custom.querycategory.format-error:* 格式错误,*表示字段名 请输入正确参数。
biz.custom.querycategory.missing-parameter:* 缺少必填参数,*表示字段名 请输入正确参数。
isp.sys.service.unavailable.MCMP 服务不可用（系统异常） 请联系苏宁技术人员。
biz.custom.querycategory.invalid-biz:100 线上线下标识错误 请检查线上线下标识
公共异常码
API工具
API TOOLS 在线测试工具异常码查询工具SDK调用示例SDK下载
FAQ

Q：什么是苏宁采购目录?

A：苏宁采购目录是指商户与苏宁签订合同时，合同规定的商户可在苏宁操作的采购目录。获取商品采购目录时，不输入苏宁采购目录名称，默认返回商户与苏宁签订合同中的所有采购目录。