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.itemdetail.query 获取我的商品详情信息
¥免费

获取我的商品详情信息

公共参数
请求参数
名称 类型 是否必须 示例值 描述
productCodeStringY1商品编码
响应参数
名称 类型 示例值 描述
productNameString女装外套苏宁商品名称
productCodeString102608836苏宁商品编码
categoryNameString日用百货苏宁商品采购目录名称
categoryCodeStringR2701002苏宁商品采购目录编码
brandNameString东盛苏宁商品品牌名称
brandCodeString000C苏宁商品品牌编码
sellPointString0元购商品商家商品卖点
freightTemplateIdString570d3cb7a387447eb8b8c7e748e80bc9商家商品运费模板
itemCodeString123商家主商品编码
introductionString内容详情非图书类填写,商家商品介绍。可接收富文本,将html内容以字段形式传输,传输时所涉及的图片不得使用外部url。允许写入CSS(禁止引用外部CSS)不支持JS。图书类商品,此字段不展示。
afterSaleServiceDecString323432商家商品售后服务描述
saleSetString1商家商品销售设定。1:立即(上架状态);0:设定日期;2:放入仓库(下架状态)。
supplierImg1UrlStringhttp://...商家商品图片1地址url
statusString2处理状态。1:正在处理;2:处理成功;3:处理失败。
supplierImg2UrlStringhttp://...商家商品图片2地址url
assortNameString店铺分类一店铺商品分类中文名称
supplierImg3UrlStringhttp://...商家商品图片3地址url
supplierImg4UrlStringhttp://...商家商品图片4地址url
supplierImg5UrlStringhttp://...商家商品图片5地址url
saleDateString2018-10-10商家设定的销售日期。仅在销售设定为0时展示。
sourceCountryString中国来源地中文名称
mobileDetailStringhttp://...手机详情
parsString
parCodeStringBRGEW苏宁商品参数编码。若有多个参数则循环展示。
parNameString单品毛重苏宁商品参数名称。若有多个参数则循环展示。
parValueString4.000苏宁商品参数值。若有多个参数则循环展示。
parUnitStringkg苏宁商品参数单位。若有多个参数则循环展示。
packingListString
packingListNameString外套苏宁商品装箱清单中物品名称。若有多个物品则循环展示。
packingListQtyString1苏宁商品装箱清单中物品数量。若有多个物品则循环展示。
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苏宁商品参数单位。若有多个参数则循环展示。
priceString456.00商家商品价格。如含有子商品,此字段不展示。
invQtyString798商家商品库存。如含有子商品,此字段不展示。
alertQtyString132商家商品库存预警值。如含有子商品,此字段不展示。
cmTitleString恩恩商品标题
mobileNewDetailString
moduleString
moduleNameString模板1模块名称
moduleStatusString1模块启用状态。1:启用;0:禁用
imgUrlStringhttp://...商品图片模块与自定义模块,所填的图片url
tuijianIdString111商家推荐id(通过查询接口可得)
couponIdString111优惠券id(通过查询接口可得)
couponNameString22优惠券名称
tuijianNameString11商家推荐名称
mpfourUrlStringhttp://商品视频MP4地址
mainPicMpfourUrlStringhttp://主图视频mp4地址
highlightWordHeString123;123;123亮点词合
verticalPicStringhttp://1.jpg竖图
请求示例
  • 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>
        <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>
      <mainPicMpfourUrl>http://</mainPicMpfourUrl>
      <saleDate>2018-10-10</saleDate>
      <mobileDetail>http://...</mobileDetail>
      <categoryName>日用百货</categoryName>
      <highlightWordHe>123;123;123</highlightWordHe>
      <productName>女装外套</productName>
      <packingList>
        <packingListName>外套</packingListName>
        <packingListQty>1</packingListQty>
      </packingList>
      <cmTitle>恩恩</cmTitle>
      <mpfourUrl>http://</mpfourUrl>
      <supplierImg5Url>http://...</supplierImg5Url>
      <price>456.00</price>
      <supplierImg1Url>http://...</supplierImg1Url>
      <afterSaleServiceDec>323432</afterSaleServiceDec>
      <supplierImg3Url>http://...</supplierImg3Url>
      <mobileNewDetail>
        <module>
          <imgUrl>http://...</imgUrl>
          <couponName>22</couponName>
          <moduleStatus>1</moduleStatus>
          <moduleName>模板1</moduleName>
          <tuijianName>11</tuijianName>
          <couponId>111</couponId>
          <tuijianId>111</tuijianId>
        </module>
      </mobileNewDetail>
      <introduction>内容详情</introduction>
      <brandCode>000C</brandCode>
      <brandName>东盛</brandName>
      <freightTemplateId>570d3cb7a387447eb8b8c7e748e80bc9</freightTemplateId>
      <assortName>店铺分类一</assortName>
      <categoryCode>R2701002</categoryCode>
      <supplierImg2Url>http://...</supplierImg2Url>
      <alertQty>132</alertQty>
      <productCode>102608836</productCode>
      <invQty>798</invQty>
      <supplierImg4Url>http://...</supplierImg4Url>
      <verticalPic>http://1.jpg</verticalPic>
      <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",
            "supplierImg1Url": "http://...",
            "supplierImg3Url": "http://...",
            "supplierImg4Url": "http://...",
            "barcode": "1"
          }
        ],
        "sellPoint": "0元购商品",
        "pars": [
          {
            "parValue": "4.000",
            "parName": "单品毛重",
            "parCode": "BRGEW",
            "parUnit": "kg"
          }
        ],
        "itemCode": "123",
        "saleSet": "1",
        "mainPicMpfourUrl": "http://",
        "saleDate": "2018-10-10",
        "mobileDetail": "http://...",
        "categoryName": "日用百货",
        "highlightWordHe": "123;123;123",
        "productName": "女装外套",
        "packingList": [
          {
            "packingListName": "外套",
            "packingListQty": "1"
          }
        ],
        "cmTitle": "恩恩",
        "mpfourUrl": "http://",
        "supplierImg5Url": "http://...",
        "price": "456.00",
        "supplierImg1Url": "http://...",
        "afterSaleServiceDec": "323432",
        "supplierImg3Url": "http://...",
        "mobileNewDetail": [
          {
            "module": [
              {
                "imgUrl": "http://...",
                "couponName": "22",
                "moduleStatus": "1",
                "moduleName": "模板1",
                "tuijianName": "11",
                "couponId": "111",
                "tuijianId": "111"
              }
            ]
          }
        ],
        "introduction": "内容详情",
        "brandCode": "000C",
        "brandName": "东盛",
        "freightTemplateId": "570d3cb7a387447eb8b8c7e748e80bc9",
        "assortName": "店铺分类一",
        "categoryCode": "R2701002",
        "supplierImg2Url": "http://...",
        "alertQty": "132",
        "productCode": "102608836",
        "invQty": "798",
        "supplierImg4Url": "http://...",
        "verticalPic": "http://1.jpg",
        "status": "2"
      }
    }
  }
}
			
                              
异常示例
  • XML示例
  • JSON示例
复制全部代码

  
  	API异常码
  	异常码中文描述
  

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

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

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

Q:能否通过获取我的商品详情信息获取商品价格和库存?

A:不可以。此接口返回的库存和价格是进行产品申请时,填写的价格和库存。不能准确的反馈实际的库存和价格。库存可通过平台业务-库存API-库存查询(单个)接口查询;价格可通过平台业务-价格API-价格查询(单个)接口查询。

Q:苏宁商品编码(productCode)、商家商品编码(itemCode)之间的关系和区别

A:1)苏宁商品编码(productCode)是商家在进行产品申请时,由苏宁系统生成的,商家商品编码(itemCode)是商户在产品申请、商品内容维护时,手工填写,并可进行修改; 2)苏宁商品编码(productCode)与商家商品编码(itemCode)一一对应,若商家申请的商品,无子商品,则一个商家商品编码(itemCode)对应一个苏宁商品编码(productCode);若商家申请的商品有子商品,则此商品本身对应一个苏宁主商品编码(productCode),每个子商品的商家商品编码(itemCode)一一对应一个苏宁子商品编码(productCode)。

Q:获取商品信息时,处理状态的含义?

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