退出
热词搜索：
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.itemparameters.query 获取商品参数模板
￥基础

获取商品参数模板

公共参数
请求参数
名称 类型 是否必须 示例值 描述
categoryCodeStringYR6151002类目编码
pageNoStringN1页码
pageSizeStringN10每页条数
targetChannelStringN1线上线下标识。1，线上；2，线下
响应参数
名称 类型 示例值 描述
categoryCodeStringR6151002类目编码
dataTypeStringCHAR数值类型。CURR 货币型。 TIME 时间型。 CHAR 字符型 长度100。DATE。DATE-YM。DATE-Y。DATE-S。 NUM 数字型 长度13.（最多两位小数）。 备注：其中，DATE：年月日，示例：2020-09-09；DATE-YM：年月，示例：2020-09；DATE-Y：年，示例：2020；DATE-S：日期区间，示例：2020-09-01~2020-09-11；
isMustStringX是否必填
paraTemplateCodeString0000346参数模板代码
paraTemplateDescString商品缺省参数模板参数模板名称
parCodeString000036参数代码
parNameString大小参数名称
parOptionString
parOptionCodeString01选项值编码
parOptionDescString支持选项值描述
parTypeString1参数类型。1：单选；2：多选；3：手工输入；
parUnitStringM单位
请求示例
  • XML示例
  • JSON示例
复制全部代码 
                                
<sn_request>
  <sn_body>
    <itemParameters>
      <pageNo>1</pageNo>
      <pageSize>10</pageSize>
      <categoryCode>R6151002</categoryCode>
      <targetChannel>1</targetChannel>
    </itemParameters>
  </sn_body>
</sn_request>

			
                                
                                
{
  "sn_request": {
    "sn_body": {
      "itemParameters": {
        "pageNo": "1",
        "pageSize": "10",
        "categoryCode": "R6151002",
        "targetChannel": "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>
    <itemParameters>
      <paraTemplateCode>0000346</paraTemplateCode>
      <parType>1</parType>
      <isMust>X</isMust>
      <parName>大小</parName>
      <dataType>CHAR</dataType>
      <parCode>000036</parCode>
      <categoryCode>R6151002</categoryCode>
      <parUnit>M</parUnit>
      <paraTemplateDesc>商品缺省参数模板</paraTemplateDesc>
      <parOption>
        <parOptionCode>01</parOptionCode>
        <parOptionDesc>支持</parOptionDesc>
      </parOption>
    </itemParameters>
  </sn_body>
</sn_responseContent>

			
                              
                              
{
  "sn_responseContent": {
    "sn_head": {
      "totalSize": "1",
      "pageTotal": "1",
      "pageNo": "1",
      "returnMessage": "biz.handler.data-get:success"
    },
    "sn_body": {
      "itemParameters": [
        {
          "paraTemplateCode": "0000346",
          "parType": "1",
          "isMust": "X",
          "parName": "大小",
          "dataType": "CHAR",
          "parCode": "000036",
          "categoryCode": "R6151002",
          "parUnit": "M",
          "paraTemplateDesc": "商品缺省参数模板",
          "parOption": [
            {
              "parOptionCode": "01",
              "parOptionDesc": "支持"
            }
          ]
        }
      ]
    }
  }
}
异常示例
  • XML示例
  • JSON示例
复制全部代码 

  
  	API异常码
  	异常码中文描述
  

                           	  
{
  "sn_responseContent": {
    "sn_error": {
      "error_code": "API异常码",
      "error_msg": "异常码中文描述"
    }
  }
}
业务异常码
异常码 错误描述 解决方案
biz.custom.queryitemparameters.missing-parameter:* 参数必填 请检查此参数的值,*号表示参数字段名
biz.handler.data-get:no-result 查询没结果 请检查查询参数
isp.sys.service.unavailable.mcmp 服务不可用 请联系苏宁技术人员
biz.custom.queryitemparameters.invalid-biz:100 类目代码不正确 请检查所填写的类目代码
biz.custom.queryitemparameters.invalid-biz:101 线上线下标识填写错误 请检查填写的线上线下标识
公共异常码
API工具
API TOOLS 在线测试工具异常码查询工具SDK调用示例SDK下载
FAQ

Q：参数类型介绍、说明

A：根据采购目录的不同，获取的商品参数模板不同。参数类型分为基本参数、动态参数、通用参数三种。 基本参数：所有类型商品都会用到的参数，包括毛重、体积、产地等； 动态参数：各采购类目对应的可配置的参数，由我司运营业务调整配置。例如衣服领子的形状，圆领、V领； 通用参数：含有子商品的商品所需填写的参数，包括尺寸、颜色等。产品申请时，通用参数维护在子商品节点内。