退出
热词搜索：
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.item.query 获取我的商品库信息
￥免费

可通过此接口批量查询我的商品库内的商品信息。
1、可通过输入品牌编码、采购目录编码、处理状态批量查询我的商品库内商品信息，若不输入任何查询条件，默认查询我的商品库内的所有的商品信息。
2、查询结果返回商品的基本信息及商品处理状态（正在处理、处理成功、处理失败、审核不通过）。若商品含有子商品，返回子商品名称、编码、图片。
3、pageNo（页码）、pageSize（每页条数）必须组合查询，否则，系统默认返回第一页的10条数据。
4、返回结果分页展示，通过输入的页码可以定位到具体第几页，每页条数控制每页返回的条数。

公共参数
请求参数
名称 类型 是否必须 示例值 描述
categoryCode String N R3301 采购目录编码。可由平台业务-商品服务-获取商品采购目录信息接口获取。非必填项，根据接口输入内容进行精确查询,不可输入中文。
brandCode String N R3301002 品牌编码，可由平台业务-商品服务-获取商品品牌信息接口获取。非必填项，根据接口输入内容进行精确查询,不可输入中文。
status String N 1 处理状态。1：正在处理；2：处理成功；3：处理失败；4：审核不通过。
startTime String N 2013-11-26 01:01:01 开始时间
endTime String N 2013-12-25 23:59:59 结束时间
pageNo String N 1 页码。取值范围:大于零的整数;默认值为1，即返回第一页数据。
pageSize String N 2 每页条数。取值范围:大于零的整数;最大值：50。默认值：10。
响应参数
名称 类型 示例值 描述
productName String 女装外套 苏宁商品名称
productCode String 102608836 苏宁商品编码
itemCode String 001 商家主商品编码。
categoryName String 日用百货 苏宁商品采购目录名称
categoryCode String R2701002 苏宁商品采购目录编码
brandName String 东盛 苏宁商品品牌名称。
brandCode String 000C 苏宁商品品牌编码。
status String 2 处理状态。1：正在处理；2：处理成功；3：处理失败；4：审核不通过。
published String 2015-08-05 18:53:57 卖家商品第一次提交时间。精确到秒，时间格式
img1Url String 商家商品图片1地址url。
editTime String 2015-08-05 18:53:57 最后修改时间
productName String 女装风衣 子商品的商品名称。如无子商品，则不展示此字段。
productCode String 102608855 子商品的商品编码。如无子商品，则不展示此字段。
itemCode String 00001 子商品的商家商品编码。如无子商品，则不展示此字段。
img1Url String null 商家子商品图片1地址url。如无子商品，则不展示此字段。
reason String null 审核不通过原因
cmTitle String 夏装新款绣花文艺棉质T恤 商品标题
请求示例
  • XML示例
  • JSON示例
复制全部代码 
                                
      	<sn_request>
	<sn_body>
		<item>
			<startTime>2013-11-26 01:01:01</startTime>
			<endTime>2013-12-25 23:59:59</endTime>
			<brandCode>000C</brandCode>
			<categoryCode>R2701002</categoryCode>
			<status>2</status>
			<pageNo>1</pageNo>
			<pageSize>2</pageSize>
		</item>
	</sn_body>
</sn_request>
	  
                                
                                
      	{
  "sn_request": {
    "sn_body": {
      "item": {
        "startTime": "2013-11-26 01:01:01",
        "endTime": "2013-12-25 23:59:59",
        "brandCode": "000C",
        "categoryCode": "R2701002",
        "status": "2",
        "pageNo": "1",
        "pageSize": "2"
      }
    }
  }
}
响应示例
  • XML示例
  • JSON示例
复制全部代码 
                              
      	非子商品：
<sn_responseContent>
	<sn_head>
		<pageNo>1</pageNo>
		<pageTotal>7</pageTotal>
		<returnMessage>biz.handler.data-get:success</returnMessage>
	</sn_head>
	<sn_body>
		<item>
			<cmTitle>夏装新款绣花文艺棉质T恤</cmTitle>
            <productName>女装外套</productName>
			<productCode>102608836</productCode>
			<itemCode>0</itemCode>
			<categoryName>日用百货</categoryName>
			<categoryCode>R2701002</categoryCode>
			<brandName>东盛</brandName>
			<brandCode>000C</brandCode>
			<status>2</status>
			<reason>审核不通过原因</reason>
			<img1Url>http://10.19.95.100/b2c/catentries/000000000102608836_1_800x800.jpg</img1Url>
			<published>2013-08-05 18:53:57</published>
			<editTime>2013-08-05 18:53:57</editTime>
		</item>
		<item>
			<cmTitle>夏装新款绣花文艺棉质T恤</cmTitle>
            <productName>女装风衣</productName>
			<productCode>102608855</productCode>
			<itemCode>0</itemCode>
			<categoryName>汤锅</categoryName>
			<categoryCode>R2701002</categoryCode>
			<brandName>东盛</brandName>
			<brandCode>000C</brandCode>
			<status>2</status>
			<reason>审核不通过原因</reason>
			<img1Url>http://10.19.95.100/b2c/catentries/000000000102608855_1_800x800.jpg</img1Url>
			<published>2013-08-05 20:32:04</published>
			<editTime>2013-08-05 18:53:57</editTime>
		</item>
	</sn_body>
</sn_responseContent>

含子商品：
<sn_responseContent>
	<sn_head>
		<pageNo>1</pageNo>
		<pageTotal>4</pageTotal>
		<returnMessage>biz.handler.data-get:success</returnMessage>
	</sn_head>
	<sn_body>
		<item>
			<cmTitle>夏装新款绣花文艺棉质T恤</cmTitle>
            <productName>女装外套</productName>
			<productCode>104001672</productCode>
			<itemCode>11111</itemCode>
			<categoryName>日用百货</categoryName>
			<categoryCode>R6152001</categoryCode>
			<brandName>东盛</brandName>
			<brandCode>000C</brandCode>
			<status>2</status>
			<reason>审核不通过原因</reason>
			<published>2013-11-12 10:34:30</published>
			<editTime>2013-08-05 18:53:57</editTime>
			<childItem>
				<productName>女装套 黑色,XXXL</productName>
				<productCode>104001741</productCode>
				<itemCode>1</itemCode>
				<img1Url>http://10.19.95.100/b2c/catentries/000000000104001672_1_800x800.jpg</img1Url>
			</childItem>
		</item>
	</sn_body>
</sn_responseContent>
      
                              
                              
      	非子商品：
{
  "sn_responseContent": {
    "sn_head": {
      "pageNo": "1",
      "pageTotal": "7",
      "returnMessage": "biz.handler.data-get:success"
    },
    "sn_body": {
      "item": [
        {
          "cmTitle":"夏装新款文艺棉质T恤",  
          "productName": "女装外套",
          "productCode": "102608836",
          "itemCode": "0",
          "categoryName": "日用百货",
          "categoryCode": "R2701002",
          "brandName": "东盛",
          "brandCode": "000C",
          "status": "2",
          "reason":"审核不通过原因",
          "img1Url": "http://10.19.95.100/b2c/catentries/000000000102608836_1_800x800.jpg",
          "published": "2013-08-05 18:53:57.144",
          "editTime": "2013-08-05 18:53:57"
        },
        {
          "cmTitle":"夏装新款文艺棉质T恤",
          "productName": "女装风衣",
          "productCode": "102608855",
          "itemCode": "0",
          "categoryName": "汤锅",
          "categoryCode": "R2701002",
          "brandName": "东盛",
          "brandCode": "000C",
          "status": "2",
          "reason":"审核不通过原因",
          "img1Url": "http://10.19.95.100/b2c/catentries/000000000102608855_1_800x800.jpg",
          "published": "2013-08-05 20:32:04.734",
          "editTime": "2013-08-05 18:53:57"
        }
      ]
    }
  }
}
含子商品：
{
  "sn_responseContent": {
    "sn_head": {
      "pageNo": "1",
      "pageTotal": "4",
      "returnMessage": "biz.handler.data-get:success"
    },
    "sn_body": {
      "item": {
        "cmTitle":"夏装新款文艺棉质T恤",
        "productName": "女装外套",
        "productCode": "104001672",
        "categoryName": "日用百货",
        "categoryCode": "R6152001",
        "brandName": "东盛",
        "brandCode": "000C",
        "status": "2",
        "reason":"审核不通过原因",
        "published": "2013-11-12 10:34:30.415",
        "editTime": "2013-08-05 18:53:57",
        "itemCode" : "111111",
        "childItem": {
          "productName": "女装外套 黑色,XXXL",
          "productCode": "104001741",
          "img1Url": "http://10.19.95.100/b2c/catentries/000000000104001672_1_800x800.jpg"
        }
      }
    }
  }
}
异常示例
  • XML示例
  • JSON示例
复制全部代码 

  
  	API异常码
  	异常码中文描述
  

                           	  
{
  "sn_responseContent": {
    "sn_error": {
      "error_code": "API异常码",
      "error_msg": "异常码中文描述"
    }
  }
}
业务异常码
异常码 错误描述 解决方案
biz.custom.item.invalid-biz:* *代表对应字段，含有中文 检查对应字段是否有中文
biz.custom.item.invalid-biz:startTime 开始时间格式有误 请检查输入
biz.custom.item.invalid-biz:endTime 1、结束时间格式有误2、开始时间和结束时间间隔超过30天 请检查输入
biz.custom.item.invalid-biz:time 开始时间和结束时间必须同时填写 请检查输入
biz.custom.item.invalid-biz:status 处理状态值非法 检查状态值
biz.handler.data-get:no-result 查询无结果 检查输入值
sys.check.request-params:error 请求参数格式有误 检查请求参数格式
公共异常码
API工具
API TOOLS 在线测试工具异常码查询工具SDK调用示例SDK下载
FAQ

Q： 获取商品信息时，若商品含有子商品，如何区分获取的苏宁商品编码(productCode)是主商品编码还是子商品编码？

A：返回的查询结果中，苏宁主商品编码(productCode)在报文的item节点里面，子商品编码（productCode）在 childitem节点里面。

Q：苏宁商品编码（productCode）、商家商品编码（itemCode）之间的关系和区别

A：1）苏宁商品编码（productCode）是商家在进行产品申请时，由苏宁系统生成的，商家商品编码（itemCode）是商户在产品申请、商品内容维护时，手工填写，并可通过商家后台或者商品内容修改接口进行修改； 2）苏宁商品编码（productCode）与商家商品编码（itemCode）一一对应，若商家申请的商品，无子商品，则一个商家商品编码（itemCode）对应一个苏宁商品编码（productCode）；若商家申请的商品有子商品，则此商品本身对应一个苏宁主商品编码（productCode），每个子商品的商家商品编码（itemCode）一一对应一个苏宁子商品编码（productCode）。

Q：如何判断某个商品是否含有子商品？

A：若商品有多个尺码、多种颜色，则该商品含有子商品。例如iphone5s，有黑色、白色、金色，iphone5s为主商品，iphone5s(黑色)、iphone5s(白色)、iphone5s(金色)则分别为子商品。

Q：获取商品信息时，处理状态的含义？

A：处理状态表示产品申请/商品内容维护/子商品新增时，申请处理的状态。1：正在处理，表示该申请正在处理中；2：处理成功，表示申请成功，对应商品信息维护成功；3：处理失败，表示申请处理失败。