API接口目录

苏宁有货业务

有货买家商品API
有货买家价格库存API
有货买家订单API
有货买家物流API
有货买家售后API
有货买家其他API
有货卖家商品API
家乐福供货平台API
异常码自查工具
suning.sngoods.itemdetail.query 获取我的商品详情信息
¥免费

获取我的商品详情信息

公共参数
请求参数
名称 类型 是否必须 示例值 描述
productCodeStringY1商品编码
响应参数
名称 类型 示例值 描述
productNameString女装外套苏宁商品名称
productCodeString102608836苏宁商品编码
categoryNameString日用百货苏宁商品采购目录名称
categoryCodeStringR2701002苏宁商品采购目录编码
brandNameString东盛苏宁商品品牌名称
brandCodeString000C苏宁商品品牌编码
sellPointString0元购商品商家商品卖点
itemCodeString123商家主商品编码
introductionString内容详情非图书类填写,商家商品介绍。可接收富文本,将html内容以字段形式传输,传输时所涉及的图片不得使用外部url。允许写入CSS(禁止引用外部CSS)不支持JS。图书类商品,此字段不展示。
saleSetString1商家商品销售设定。1:立即(上架状态);0:设定日期;2:放入仓库(下架状态)。
supplierImg1UrlStringhttp://...商家商品图片1地址url
statusString2处理状态。1:正在处理;2:处理成功;3:处理失败。
supplierImg2UrlStringhttp://...商家商品图片2地址url
supplierImg3UrlStringhttp://...商家商品图片3地址url
supplierImg4UrlStringhttp://...商家商品图片4地址url
supplierImg5UrlStringhttp://...商家商品图片5地址url
saleDateString2018-10-10商家设定的销售日期。仅在销售设定为0时展示。
sourceCountryString中国来源地中文名称
parsString
parCodeStringBRGEW苏宁商品参数编码。若有多个参数则循环展示。
parNameString单品毛重苏宁商品参数名称。若有多个参数则循环展示。
parValueString4.000苏宁商品参数值。若有多个参数则循环展示。
parUnitStringkg苏宁商品参数单位。若有多个参数则循环展示。
childItemString
productNameString风衣,黑色,XXXLproductName
productCodeString104001741子商品的商品编码。如无子商品,则不展示此字段。
barcodeString1子商品的商品国标码。如无子商品,则不展示此字段。
itemCodeString1子商品的商家商品编码。如无子商品,则不展示此字段。
priceString12.00子商品的价格。如无子商品,则不展示此字段。
invQtyString999子商品的库存。如无子商品,则不展示此字段。
alertQtyString1子商品的库存预警值。如无子商品,则不展示此字段。
supplierImg1UrlStringhttp://...商家商品图片1地址url
supplierImg2UrlStringhttp://...商家商品图片2地址url
supplierImg3UrlStringhttp://...商家商品图片3地址url
supplierImg4UrlStringhttp://...商家商品图片4地址url
supplierImg5UrlStringhttp://...商家商品图片5地址url
parsString
parCodeStringBRGEW苏宁商品参数编码。若有多个参数则循环展示。
parNameString单品毛重苏宁商品参数名称。若有多个参数则循环展示。
parValueString4.000苏宁商品参数值。若有多个参数则循环展示。
parUnitStringkg苏宁商品参数单位。若有多个参数则循环展示。
suggestedRetailPriceString12.00子商品的建议零售价。如无子商品,则不展示此字段。
privateFlagString1 私密商品 0 普通商品私密商品标识
minNumString11最小起订量
priceString456.00商家商品价格。如含有子商品,此字段不展示。
invQtyString798商家商品库存。如含有子商品,此字段不展示。
alertQtyString132商家商品库存预警值。如含有子商品,此字段不展示。
cmTitleString恩恩商品标题
suggestedRetailPriceString456.00商家商品建议零售价。如含有子商品,此字段不展示。
请求示例
  • XML示例
  • JSON示例
复制全部代码
                                
<sn_request>
  <sn_body>
    <itemDetail>
      <productCode>1</productCode>
    </itemDetail>
  </sn_body>
</sn_request>

			
                                
                                
{
  "sn_request": {
    "sn_body": {
      "itemDetail": {
        "productCode": "1"
      }
    }
  }
}
			
                                
响应示例
  • XML示例
  • JSON示例
复制全部代码
                              
<sn_responseContent>
  <sn_body>
    <itemDetail>
      <sourceCountry>中国</sourceCountry>
      <childItem>
        <pars>
          <parValue>4.000</parValue>
          <parName>单品毛重</parName>
          <parCode>BRGEW</parCode>
          <parUnit>kg</parUnit>
        </pars>
        <itemCode>1</itemCode>
        <productName>风衣,黑色,XXXL</productName>
        <supplierImg2Url>http://...</supplierImg2Url>
        <alertQty>1</alertQty>
        <productCode>104001741</productCode>
        <invQty>999</invQty>
        <supplierImg5Url>http://...</supplierImg5Url>
        <price>12.00</price>
        <suggestedRetailPrice>12.00</suggestedRetailPrice>
        <supplierImg1Url>http://...</supplierImg1Url>
        <supplierImg3Url>http://...</supplierImg3Url>
        <supplierImg4Url>http://...</supplierImg4Url>
        <barcode>1</barcode>
      </childItem>
      <sellPoint>0元购商品</sellPoint>
      <pars>
        <parValue>4.000</parValue>
        <parName>单品毛重</parName>
        <parCode>BRGEW</parCode>
        <parUnit>kg</parUnit>
      </pars>
      <itemCode>123</itemCode>
      <saleSet>1</saleSet>
      <saleDate>2018-10-10</saleDate>
      <categoryName>日用百货</categoryName>
      <productName>女装外套</productName>
      <cmTitle>恩恩</cmTitle>
      <supplierImg5Url>http://...</supplierImg5Url>
      <price>456.00</price>
      <suggestedRetailPrice>456.00</suggestedRetailPrice>
      <supplierImg1Url>http://...</supplierImg1Url>
      <supplierImg3Url>http://...</supplierImg3Url>
      <introduction>内容详情</introduction>
      <brandCode>000C</brandCode>
      <brandName>东盛</brandName>
      <categoryCode>R2701002</categoryCode>
      <minNum>11</minNum>
      <supplierImg2Url>http://...</supplierImg2Url>
      <privateFlag>1 私密商品 0 普通商品</privateFlag>
      <alertQty>132</alertQty>
      <productCode>102608836</productCode>
      <invQty>798</invQty>
      <supplierImg4Url>http://...</supplierImg4Url>
      <status>2</status>
    </itemDetail>
  </sn_body>
</sn_responseContent>

			
                              
                              
{
  "sn_responseContent": {
    "sn_body": {
      "itemDetail": {
        "sourceCountry": "中国",
        "childItem": [
          {
            "pars": [
              {
                "parValue": "4.000",
                "parName": "单品毛重",
                "parCode": "BRGEW",
                "parUnit": "kg"
              }
            ],
            "itemCode": "1",
            "productName": "风衣,黑色,XXXL",
            "supplierImg2Url": "http://...",
            "alertQty": "1",
            "productCode": "104001741",
            "invQty": "999",
            "supplierImg5Url": "http://...",
            "price": "12.00",
            "suggestedRetailPrice": "12.00",
            "supplierImg1Url": "http://...",
            "supplierImg3Url": "http://...",
            "supplierImg4Url": "http://...",
            "barcode": "1"
          }
        ],
        "sellPoint": "0元购商品",
        "pars": [
          {
            "parValue": "4.000",
            "parName": "单品毛重",
            "parCode": "BRGEW",
            "parUnit": "kg"
          }
        ],
        "itemCode": "123",
        "saleSet": "1",
        "saleDate": "2018-10-10",
        "categoryName": "日用百货",
        "productName": "女装外套",
        "cmTitle": "恩恩",
        "supplierImg5Url": "http://...",
        "price": "456.00",
        "suggestedRetailPrice": "456.00",
        "supplierImg1Url": "http://...",
        "supplierImg3Url": "http://...",
        "introduction": "内容详情",
        "brandCode": "000C",
        "brandName": "东盛",
        "categoryCode": "R2701002",
        "minNum": "11",
        "supplierImg2Url": "http://...",
        "privateFlag": "1 私密商品 0 普通商品",
        "alertQty": "132",
        "productCode": "102608836",
        "invQty": "798",
        "supplierImg4Url": "http://...",
        "status": "2"
      }
    }
  }
}
			
                              
异常示例
  • XML示例
  • JSON示例
复制全部代码

  
  	API异常码
  	异常码中文描述
  

                           	  
{
  "sn_responseContent": {
    "sn_error": {
      "error_code": "API异常码",
      "error_msg": "异常码中文描述"
    }
  }
}
                           		
业务异常码
异常码 错误描述 解决方案
biz.sngoods.queryitemdetail.missing-parameter:* 参数必填 请检查此参数的值,*号表示参数字段名
biz.custom.queryitemdetail.missing-parameter:* 参数必填 请检查此参数的值,*号表示参数字段名
biz.handler.data-get:no-result 查询没结果 请检查查询参数
isp.sys.service.unavailable.mcmp 服务不可用 请联系苏宁技术人员
公共异常码
API工具
FAQ