退出
热词搜索：
API接口目录

拼购业务

拼购商品API
异常码自查工具
suning.integrate.itemsale.query LPG商品销售情况查询
￥免费

商户通过此接口查询商品的销售状态。
1、 商户可通过输入苏宁商品名称、苏宁商品编码（只可输入苏宁主商品编码）、采购目录编码、价格区间、商品销售状态任一或多个查询条件查询商品的销售状态。
2、 pageNo（页码）、pageSize（每页条数）必须组合查询，否则，系统默认返回第一页的10条数据。
3、查询结果返回商品名称、商品编码及商品销售状态。返回结果分页展示，通过输入的页码可以定位到具体第几页，每页条数控制每页返回的条数。

公共参数
请求参数
名称 类型 是否必须 示例值 描述
pageNoStringN1页码
pageSizeStringN10每页条数
productNameStringN女装外套苏宁商品名称。可通过平台业务-商品服务-获取我的商品库信息接口获取。根据接口输入内容进行精确查询,可输入中文。
productCodeStringN102609882苏宁商品编码。可通过平台业务-商品服务-获取我的商品库信息接口获取。根据接口输入内容进行精确查询。
categoryCodeStringNR2701002苏宁底层采购目录编码。可由平台业务-商品服务获取商品采购目录信息接口获得。根据接口输入内容进行精确查询,不可输入中文。
saleStatusStringN1商品销售状态。0-停售； 1-在售； 2-待售；3-强制下架；4-违规下架；5-从未上架。
cmTitleStringN夏装新款文艺棉质T恤商品标题
响应参数
名称 类型 示例值 描述
productNameString女装外套苏宁商品名称。
productCodeString102609882苏宁商品编码。
itemCodeString111商家商品编码。
priceString300.00系统价格。单位：元。精确到小数点后2位。
invQtyString99999系统库存。单位：件。
publishedString2015-10-18 17:18:26商品系统提交时间，精确到秒
saleDateString2015-12-11商品设定开始销售时间，精确到日
saleStatusString1商品销售状态。0-停售； 1-在售； 2-待售；3-强制下架；4-违规下架；5-从未上架。
cmTitleString夏装新款文艺棉质T恤商品标题
supplierImg1UrlStringhttp://1.jpg商家商品图片地址url
sellChannelString11销售渠道。01：线上 10：线下 11：线上线下
pingouPriceString20拼购价
请求示例
  • XML示例
  • JSON示例
复制全部代码 
                                <sn_request>
  <sn_body>
    <itemSale>
      <cmTitle>夏装新款文艺棉质T恤</cmTitle>
      <saleStatus>1</saleStatus>
      <productCode>102609882</productCode>
      <pageNo>1</pageNo>
      <pageSize>10</pageSize>
      <categoryCode>R2701002</categoryCode>
      <productName>女装外套</productName>
    </itemSale>
  </sn_body>
</sn_request>

                                
                                {
  "sn_request": {
    "sn_body": {
      "itemSale": {
        "cmTitle": "夏装新款文艺棉质T恤",
        "productCode": "102609882",
        "saleStatus": "1",
        "pageNo": "1",
        "categoryCode": "R2701002",
        "pageSize": "10",
        "productName": "女装外套"
      }
    }
  }
}
响应示例
  • XML示例
  • JSON示例
复制全部代码 
                              <sn_responseContent>
  <sn_body>
    <itemSale>
      <cmTitle>夏装新款文艺棉质T恤</cmTitle>
      <supplierImg1Url>http://1.jpg</supplierImg1Url>
      <price>300.00</price>
      <invQty>99999</invQty>
      <saleStatus>1</saleStatus>
      <productCode>102609882</productCode>
      <sellChannel>11</sellChannel>
      <pingouPrice>20</pingouPrice>
      <saleDate>2015-12-11</saleDate>
      <published>2015-10-18 17:18:26</published>
      <productName>女装外套</productName>
      <itemCode>111</itemCode>
    </itemSale>
  </sn_body>
  <sn_head>
    <pageTotal>1</pageTotal>
    <pageNo>1</pageNo>
    <totalSize>1</totalSize>
    <returnMessage>biz.handler.data-get:success</returnMessage>
  </sn_head>
</sn_responseContent>

                              
                              {
  "sn_responseContent": {
    "sn_head": {
      "pageTotal": "1",
      "pageNo": "1",
      "totalSize": "1",
      "returnMessage": "biz.handler.data-get:success"
    },
    "sn_body": {
      "itemSale": [
        {
          "cmTitle": "夏装新款文艺棉质T恤",
          "price": "300.00",
          "supplierImg1Url": "http://1.jpg",
          "invQty": "99999",
          "productCode": "102609882",
          "saleStatus": "1",
          "sellChannel": "11",
          "saleDate": "2015-12-11",
          "pingouPrice": "20",
          "published": "2015-10-18 17:18:26",
          "productName": "女装外套",
          "itemCode": "111"
        }
      ]
    }
  }
}
异常示例
  • XML示例
  • JSON示例
复制全部代码 

  
  	API异常码
  	异常码中文描述
  

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