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

零售云业务

采购API
订单API
库存API
价格API
商品API
报表API
消息服务API
基础数据API
物流API
零售商认证API
发票API
快修回收API
云仓API
异常码自查工具
suning.retailer.cmmdtypurchaseinfo.query 零售云商品采购信息详情查询接口
￥免费

零售云商品基本信息、寻源信息、价格信息、时效信息详情查询接口

公共参数
请求参数
名称 类型 是否必须 示例值 描述
appIdStringY111111调用方唯一标识
storeCodeStringY59021门店编码
cityCodeStringY025城市编码
districtCodeStringY01区域编码
townCodeStringN99镇编码
addressStringY详细地址详细地址
cmmdtyListStringN
itemNoStringY1商品行项目号（行唯一标识）
cmmdtyCodeStringY00000000063568966商品编码
distributorCodeStringY0000000000分销商编码
quantityStringY1数量
priceDateStringN2020-02-11查价日期，不填默认是当天（必须为yyyy-MM-dd格式 查询出的分销价有效起止日包含查询日期，查询日期只能为某天（可是过去、现在，过去的日期可以使两年内），不能是范围值）
响应参数
名称 类型 示例值 描述
respListString
itemNoString1商品行项目号
cmmdtyCodeString00000000096512商品编码
cmmdtyNameString商品名称商品名称
distributorCodeString0000000000分销商编码
externalEanCodeString69码69码
inventoryStatusString1库存状态(0-无货，1-现货，2-在途)
arrivalQuantityString1库存数量
arrivalDateString2020-02-20 21:19:00库存可用日期（仅在途可用）
unitCodeString001包装单位代码
productNumString11包装单位数量
unitNameString箱箱规单位描述
freightAfterDiscountString100运费[折扣后]
freighBeforeDiscountsString100运费[折扣前]
distributorPriceString100分销价
supplierNameString供应商供应商名称
supplierCodeString0066455供应商编码
distributorNameString苏宁分销商名称
supplyModeString1供货模式（1:仓配；2：日配）
failMsgString错误描述错误描述
failCodeString01错误编码（01:暂不销售 02:无货 03:库存不足 04:商品已下架 05:超出限额 07:已无配额 09:无配额 10:暂不销售 11：超出预定限额 12：已无预定限额 9999:暂不销售 1001：暂无商品基本信息 1002：暂无价格 1003：暂无运费 1004：暂无时效）
basicUnitDescString件基本单位名称（默认为件）
buCodeStringsc01品类编码
voucherAmountString1有函
imageUrlStringwww.baidu.com图片URL
请求示例
  • XML示例
  • JSON示例
复制全部代码 
                                
<sn_request>
  <sn_body>
    <queryCmmdtypurchaseinfo>
      <address>详细地址</address>
      <districtCode>01</districtCode>
      <priceDate>2020-02-11</priceDate>
      <townCode>99</townCode>
      <cityCode>025</cityCode>
      <appId>111111</appId>
      <cmmdtyList>
        <quantity>1</quantity>
        <cmmdtyCode>00000000063568966</cmmdtyCode>
        <distributorCode>0000000000</distributorCode>
        <itemNo>1</itemNo>
      </cmmdtyList>
      <storeCode>59021</storeCode>
    </queryCmmdtypurchaseinfo>
  </sn_body>
</sn_request>

			
                                
                                
{
  "sn_request": {
    "sn_body": {
      "queryCmmdtypurchaseinfo": {
        "address": "详细地址",
        "districtCode": "01",
        "priceDate": "2020-02-11",
        "townCode": "99",
        "cityCode": "025",
        "appId": "111111",
        "cmmdtyList": [
          {
            "quantity": "1",
            "cmmdtyCode": "00000000063568966",
            "distributorCode": "0000000000",
            "itemNo": "1"
          }
        ],
        "storeCode": "59021"
      }
    }
  }
}
响应示例
  • XML示例
  • JSON示例
复制全部代码 
                              
<sn_responseContent>
  <sn_body>
    <queryCmmdtypurchaseinfo>
      <respList>
        <freighBeforeDiscounts>100</freighBeforeDiscounts>
        <supplierName>供应商</supplierName>
        <unitName>箱</unitName>
        <externalEanCode>69码</externalEanCode>
        <cmmdtyCode>00000000096512</cmmdtyCode>
        <inventoryStatus>1</inventoryStatus>
        <voucherAmount>1</voucherAmount>
        <cmmdtyName>商品名称</cmmdtyName>
        <supplyMode>1</supplyMode>
        <distributorCode>0000000000</distributorCode>
        <distributorPrice>100</distributorPrice>
        <itemNo>1</itemNo>
        <productNum>11</productNum>
        <supplierCode>0066455</supplierCode>
        <buCode>sc01</buCode>
        <arrivalDate>2020-02-20 21:19:00</arrivalDate>
        <basicUnitDesc>件</basicUnitDesc>
        <distributorName>苏宁</distributorName>
        <freightAfterDiscount>100</freightAfterDiscount>
        <unitCode>001</unitCode>
        <imageUrl>www.baidu.com</imageUrl>
        <arrivalQuantity>1</arrivalQuantity>
        <failCode>01</failCode>
        <failMsg>错误描述</failMsg>
      </respList>
    </queryCmmdtypurchaseinfo>
  </sn_body>
</sn_responseContent>

			
                              
                              
{
  "sn_responseContent": {
    "sn_body": {
      "queryCmmdtypurchaseinfo": {
        "respList": [
          {
            "freighBeforeDiscounts": "100",
            "supplierName": "供应商",
            "unitName": "箱",
            "externalEanCode": "69码",
            "cmmdtyCode": "00000000096512",
            "inventoryStatus": "1",
            "voucherAmount": "1",
            "cmmdtyName": "商品名称",
            "supplyMode": "1",
            "distributorCode": "0000000000",
            "distributorPrice": "100",
            "itemNo": "1",
            "productNum": "11",
            "supplierCode": "0066455",
            "buCode": "sc01",
            "arrivalDate": "2020-02-20 21:19:00",
            "basicUnitDesc": "件",
            "distributorName": "苏宁",
            "freightAfterDiscount": "100",
            "unitCode": "001",
            "imageUrl": "www.baidu.com",
            "arrivalQuantity": "1",
            "failCode": "01",
            "failMsg": "错误描述"
          }
        ]
      }
    }
  }
}
异常示例
  • XML示例
  • JSON示例
复制全部代码 

  
  	API异常码
  	异常码中文描述
  

                           	  
{
  "sn_responseContent": {
    "sn_error": {
      "error_code": "API异常码",
      "error_msg": "异常码中文描述"
    }
  }
}
业务异常码
异常码 错误描述 解决方案
biz.retailer.querycmmdtypurchaseinfo.missing-parameter:* 参数必填 请检查此参数的值,*号表示参数字段名
biz.handler.data-get:no-result 查询没结果 请检查查询参数
isp.sys.service.unavailable.srcdss 服务不可用 请联系苏宁技术人员
biz.retailer.querycmmdtypurchaseinfo.invalid-biz:100 请求参数缺失或异常 请检查查询参数
biz.retailer.querycmmdtypurchaseinfo.invalid-biz:101 接口执行返回失败 请检查查询参数
biz.retailer.querycmmdtypurchaseinfo.invalid-biz:102 查询结果为空 请检查查询参数
biz.retailer.querycmmdtypurchaseinfo.invalid-biz:103 系统异常 请联系苏宁技术人员
biz.retailer.querycmmdtypurchaseinfo.invalid-biz:105 无效的AppId请求 请检查查询参数
公共异常码
API工具
API TOOLS 在线测试工具异常码查询工具SDK调用示例SDK下载
FAQ