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.saleareatemplateitemgroup.query 销售范围模板关联商品组批量查询
¥免费

通过此接口可批量查询销售范围模版关联商品组。

1、页码和每页条数必须同时填写方可生效,否则将默认返回第1页、10条内容;

2、返回结果分页展示,通过请求参数的页码可以定位到具体第几页,每页条数控制每页返回的条数。

公共参数
请求参数
名称 类型 是否必须 示例值 描述
pageNo String N 1 页码。取值范围:大于零的整数;默认值为1,即返回第一页数据。
pageSize String N 10 每页条数。取值范围:大于零的整数;最大值:50。默认值:10。
响应参数
名称 类型 示例值 描述
pageNo String null 当前页码。
pageTotal String null 总页码。
templateId String null 模板代码。
templateName String null 模板名称。
grade String null 商品组层级。数字型,没有长度
commodityGroupName String null 商品组代码。
请求示例
  • XML示例
  • JSON示例
复制全部代码
                                <sn_request>
	<sn_body>
		<saleAreaTemplateItemGroup>
			<pageNo>1</pageNo>
			<pageSize>10</pageSize>
		</saleAreaTemplateItemGroup>
	</sn_body>
</sn_request>
                                
                                {
  "sn_request": {
    "sn_body": {
      "saleAreaTemplateItemGroup": {
        "pageNo": "1",
        "pageSize": "10"
      }
    }
  }
}
                                
响应示例
  • XML示例
  • JSON示例
复制全部代码
                              <sn_responseContent> 
  <sn_head> 
    <pageTotal>1</pageTotal>  
    <pageNo>1</pageNo>  
    <returnMessage>biz.handler.data-get:success</returnMessage> 
  </sn_head>  
  <sn_body> 
    <saleAreaTemplateItemGroup> 
      <templateId>85ea99f4076a4cce9b2137b6a6c285376b27dcd7a5f34afb</templateId>  
      <templateName>测试1</templateName>  
      <lineComGroupInfoList> 
        <commodityGroupCode>R2400</commodityGroupCode>  
        <commodityGroupName>主营商品 &gt; 家居小电器</commodityGroupName>  
        <grade>2</grade> 
      </lineComGroupInfoList> 
    </saleAreaTemplateItemGroup>  
    <saleAreaTemplateItemGroup> 
      <templateId>0e072e92113b4b5a82011a48811f9aabad55014b851b447a</templateId>  
      <templateName>苏宁测试</templateName>  
      <lineComGroupInfoList> 
        <commodityGroupCode>R2703005</commodityGroupCode>  
        <commodityGroupName>咖啡器具</commodityGroupName>  
        <grade>4</grade> 
      </lineComGroupInfoList>  
      <lineComGroupInfoList> 
        <commodityGroupCode>R6095001</commodityGroupCode>  
        <commodityGroupName>花卉花艺</commodityGroupName>  
        <grade>4</grade> 
      </lineComGroupInfoList>  
      <lineComGroupInfoList> 
        <commodityGroupCode>R6107002</commodityGroupCode>  
        <commodityGroupName>其他整理用品</commodityGroupName>  
        <grade>4</grade> 
      </lineComGroupInfoList>  
      <lineComGroupInfoList> 
        <commodityGroupCode>R6095004</commodityGroupCode>  
        <commodityGroupName>日用饰品</commodityGroupName>  
        <grade>4</grade> 
      </lineComGroupInfoList>  
      <lineComGroupInfoList> 
        <commodityGroupCode>R6095003</commodityGroupCode>  
        <commodityGroupName>装饰摆件</commodityGroupName>  
        <grade>4</grade> 
      </lineComGroupInfoList> 
    </saleAreaTemplateItemGroup> 
  </sn_body> 
</sn_responseContent>
                              
                              {
  "sn_responseContent": {
    "sn_head": {
      "pageTotal": "1",
      "pageNo": "1",
      "returnMessage": "biz.handler.data-get:success"
    },
    "sn_body": {
      "saleAreaTemplateItemGroup": [
        {
          "templateId": "85ea99f4076a4cce9b2137b6a6c285376b27dcd7a5f34afb",
          "templateName": "测试1",
          "lineComGroupInfoList": {
            "commodityGroupCode": "R2400",
            "commodityGroupName": "主营商品 > 家居小电器",
            "grade": "2"
          }
        },
        {
          "templateId": "0e072e92113b4b5a82011a48811f9aabad55014b851b447a",
          "templateName": "苏宁测试",
          "lineComGroupInfoList": [
            {
              "commodityGroupCode": "R2703005",
              "commodityGroupName": "咖啡器具",
              "grade": "4"
            },
            {
              "commodityGroupCode": "R6095001",
              "commodityGroupName": "花卉花艺",
              "grade": "4"
            },
            {
              "commodityGroupCode": "R6107002",
              "commodityGroupName": "其他整理用品",
              "grade": "4"
            },
            {
              "commodityGroupCode": "R6095004",
              "commodityGroupName": "日用饰品",
              "grade": "4"
            },
            {
              "commodityGroupCode": "R6095003",
              "commodityGroupName": "装饰摆件",
              "grade": "4"
            }
          ]
        }
      ]
    }
  }
}
                              
异常示例
  • XML示例
  • JSON示例
复制全部代码

  
  	API异常码
  	异常码中文描述
  

                           	  
{
  "sn_responseContent": {
    "sn_error": {
      "error_code": "API异常码",
      "error_msg": "异常码中文描述"
    }
  }
}
                           		
业务异常码
异常码 错误描述 解决方案
sys.check.page-param:error 每页条数参数错误 请输入正确的条数
biz.handler.data-get:no-result 页码无结果 请输入正确的页码
sys.check.pagesize-format:error 每页条数格式错误 取值范围:大于零的整数;最大值:50;默认值:10
公共异常码
API工具
FAQ

Q:什么是商品组层级?

A:即为苏宁采购目录层级,当前接口可定义的商品组层级为固定值“4”。