退出
热词搜索：
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.book.itemdetail.query 获取我的商品库详情（文化制品类）
￥免费

可通过此接口获取我的商品详情信息
1、通过此接口精确查询我的商品库内的商品信息和处理状态。可通过苏宁商品编码、商家商品编码进行查询，至少输入其中一个查询条件。
2、查询结果返回商品的基本信息及商品处理状态（正在审核、正在处理、处理成功、处理失败）。

公共参数
请求参数
名称 类型 是否必须 示例值 描述
productCode String N 1000000001 苏宁商品编码。非必填项，根据接口输入内容进行精确查询。可由平台业务-商品服务-获取我的商品库信息（文化制品类）接口获取。
itemCode String N 商家商品编码(注：苏宁商品编码和商家商品编码只能输入一个)
响应参数
名称 类型 示例值 描述
productName String 说的方法 苏宁商品名称
productCode String 108521135 苏宁商品编码
categoryName String 时尚/美妆 苏宁商品采购目录名称
categoryCode String R9000169 苏宁商品采购目录编码
saleCatalogName String 哲学知识读物 销售目录名称
saleCatalogCode String 221173 销售目录编码
brandName String 北京十月文艺出版社 苏宁商品品牌/出版社名称
brandCode String 00BC 苏宁商品品牌/出版社编码
sellPoint String 7天包退的类型哦 商家商品卖点。 中文，最多可填写40个汉字。
freightTemplateId String a920cb2b09ab455ab3699c2a4af8bf7d 商家商品运费模板 编码 。
freightTemplateName String 按重量运费 商家商品运费模板名称
itemCode String 1342123 商家商品编码。
price String 59.00 商家商品价格。
invQty String 4546 商家商品库存。
alertQty String 67 商家商品库存预警值。
afterSaleServiceDec String 7天包退的类型哦 商家商品售后服务描述 。最多可填写254个字。
saleSet String 1 商家商品销售设定。1：立即；0：设定日期；2：放入仓库。
saleDate String null 商家设定的销售日期。仅在销售设定为0时展示。 格式YYYY-MM-DD
status String 2 处理状态。0：正在审核；1：正在处理；2：处理成功；3：处理失败
assortName String 店铺分类一 店铺商品分类中文名称
parCode String isbnCode 苏宁商品参数编码。若有多个参数则循环展示。
parName String null 苏宁商品参数名称。若有多个参数则循环展示。
parValue String 9787500774945 苏宁商品参数值。若有多个参数则循环展示。
parUnit String null 苏宁商品参数单位。若有多个参数则循环展示。
cmTitle String 商品标题
supplierImg1Url String 商家商品图片1地址url
supplierImg2Url String 商家商品图片2地址url
supplierImg3Url String 商家商品图片3地址url
supplierImg4Url String 商家商品图片4地址url
supplierImg5Url String 商家商品图片5地址url
请求示例
  • XML示例
  • JSON示例
复制全部代码 
                                
      	<sn_request>
	<sn_body>
		<itemDetail>
			<productCode>108521085</productCode>
			<itemCode/>
		</itemDetail>
	</sn_body>
</sn_request>
	  
                                
                                
      	{
  "sn_request": {
    "sn_body": {
      "itemDetail": {
        "productCode": "108521085",
        "itemCode": ""
      }
    }
  }
}
响应示例
  • XML示例
  • JSON示例
复制全部代码 
                              
      	<sn_responseContent>
	<sn_head/>
	<sn_body>
		<itemDetail>
			<productName>说的方法</productName>
			<productCode>108521135</productCode>
			<categoryName>时尚/美妆</categoryName>
			<categoryCode>R9000169</categoryCode>
			<saleCatalogName>哲学知识读物</saleCatalogName>
			<saleCatalogCode>221173</saleCatalogCode>
			<brandName>北京十月文艺出版社</brandName>
			<brandCode>00BC</brandCode>
            <cmTitle>aaaaaa</cmTitle>
			<supplierImg1Url>http://10.19.95.100/b2c/catentries/000000000108521135_1_800x800.jpg</supplierImg1Url>
			<supplierImg2Url>http://10.19.95.100/b2c/catentries/000000000108521135_2_800x800.jpg</supplierImg2Url>
			<supplierImg3Url>http://10.19.95.100/b2c/catentries/000000000108521135_3_800x800.jpg</supplierImg3Url>
			<supplierImg4Url>http://10.19.95.100/b2c/catentries/000000000108521135_4_800x800.jpg</supplierImg4Url>
			<supplierImg5Url>http://10.19.95.100/b2c/catentries/000000000108521135_5_800x800.jpg</supplierImg5Url>
			<sellPoint>7天包退的类型哦</sellPoint>
			<freightTemplateId>a920cb2b09ab455ab3699c2a4af8bf7d</freightTemplateId>
			<freightTemplateName>按重量运费</freightTemplateName>
			<itemCode>1342123</itemCode>
			<price>59.00</price>
			<invQty>4546</invQty>
			<alertQty>67</alertQty>
			<afterSaleServiceDec>7天包退的类型哦</afterSaleServiceDec>
			<saleSet>1</saleSet>
			<saleDate/>
			<status>2</status>
			<assortName>店铺分类一</assortName>
			<pars>
				<parCode>VOLUM</parCode>
				<parName/>
				<parValue>34566.000</parValue>
				<parUnit>cm3</parUnit>
			</pars>
			<pars>
				<parCode>BRGEW</parCode>
				<parName/>
				<parValue>3456.230</parValue>
				<parUnit>kg</parUnit>
			</pars>
			<pars>
				<parCode>isbnCode</parCode>
				<parName/>
				<parValue>9787500774945</parValue>
				<parUnit/>
			</pars>
		</itemDetail>
	</sn_body>
</sn_responseContent>
      
                              
                              
      	{
  "sn_responseContent": {
    "sn_body": {
      "itemDetail": {
        "productName": "说的方法",
        "productCode": "108521135",
        "categoryName": "时尚/美妆",
        "categoryCode": "R9000169",
        "saleCatalogName": "哲学知识读物",
        "saleCatalogCode": "221173",
        "brandName": "北京十月文艺出版社",
        "brandCode": "00BC",
        "cmTitle": "aaaaaaaa",
        "supplierImg1Url": "http://10.19.95.100/b2c/catentries/000000000108521135_1_800x800.jpg",
        "supplierImg2Url": "http://10.19.95.100/b2c/catentries/000000000108521135_2_800x800.jpg",
        "supplierImg3Url": "http://10.19.95.100/b2c/catentries/000000000108521135_3_800x800.jpg",
        "supplierImg4Url": "http://10.19.95.100/b2c/catentries/000000000108521135_4_800x800.jpg",
        "supplierImg5Url": "http://10.19.95.100/b2c/catentries/000000000108521135_5_800x800.jpg",
        "sellPoint": "7天包退的类型哦",
        "freightTemplateId": "a920cb2b09ab455ab3699c2a4af8bf7d",
        "freightTemplateName": "按重量运费",
        "itemCode": "1342123",
        "price": "59.00",
        "invQty": "4546",
        "alertQty": "67",
        "afterSaleServiceDec": "7天包退的类型哦",
        "saleSet": "1",
        "status": "2",
        "assortName":"店铺分类一",
        "pars": [
          {
            "parCode": "VOLUM",
            "parValue": "34566.000",
            "parUnit": "cm3"
          },
          {
            "parCode": "BRGEW",
            "parValue": "3456.230",
            "parUnit": "kg"
          },
          {
            "parCode": "isbnCode",
            "parValue": "9787500774945"
          }
        ]
      }
    }
  }
}
异常示例
  • XML示例
  • JSON示例
复制全部代码 

  
  	API异常码
  	异常码中文描述
  

                           	  
{
  "sn_responseContent": {
    "sn_error": {
      "error_code": "API异常码",
      "error_msg": "异常码中文描述"
    }
  }
}
业务异常码
异常码 错误描述 解决方案
biz.itemDetail.invalid-biz:productCode 1.苏宁商品编码、商家商品编码只能输入一个。 2.苏宁商品编码、商家商品编码都为空 。 检查对应参数
biz.handler.data-get:no-result 1.苏宁商品编码不存在 2.商家商品编码对应的苏宁商品编码不存在 检查输入值
公共异常码
API工具
API TOOLS 在线测试工具异常码查询工具SDK调用示例SDK下载
FAQ