文档

GetSelectionProduct - 查询选品池商品详情

更新时间:

查询选品池商品详情。

接口说明

通过商品 id 查询选品池商品详情,支持输入区域码查询商品区域库存。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

下表是API对应的授权信息,可以在RAM权限策略语句的Action元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:

  • 操作:是指具体的权限点。
  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:
    • 对于必选的资源类型,用背景高亮的方式表示。
    • 对于不支持资源级授权的操作,用全部资源表示。
  • 条件关键字:是指云产品自身定义的条件关键字。
  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作访问级别资源类型条件关键字关联操作
linkedmall:GetSelectionProduct
  • 全部资源
    acs:oss:oss-{#regionId}:{#accountId}:{#BucketName}

请求语法

GET /opensaas-s2b/opensaas-s2b-biz-trade/v2/selectionPool/products/{productId}

请求参数

名称类型必填描述示例值
productIdstring

商品 id

660460842235822080
purchaserIdstring

采购方 id

PID22000009
divisionCodestring

区域码(建议为五级乡镇/街道级地址 code)

330106109
{
  "productId": "660057403063402509",
  "purchaserId": "PID22000009",
  "divisionCode": "330106109"
}

返回参数

名称类型描述示例值
Product

商品详情

{
  "requestId": "EA2F57E7-94AF-1C51-B607-47EECC6CCAB2",
  "productId": "660057403063402509",
  "title": "西安/成都限购测试商品-yh-请勿下单千牛修改同步",
  "picUrl": "//img.alicdn.com/imgextra/i2/2214281521988/O1CN01mBXX711QYYFAxfNiX_!!2214281521988.jpg",
  "descPath": "//itemcdn.tmall.com/desc/icoss!0724961349057!11733929840",
  "categoryLeafId": 50022568,
  "images": [
    "//img.alicdn.com/imgextra/i2/2214281521988/O1CN01mBXX711QYYFAxfNiX_!!2214281521988.jpg",
    "//img.alicdn.com/imgextra/i1/2214281521988/O1CN011QYYFMQFeubcGuJ_!!2214281521988.jpg"
  ],
  "properties": [
    {
      "text": "品牌",
      "values": [
        "七情(鲜花)"
      ]
    },
    {
      "text": "颜色分类",
      "values": [
        "浅灰色",
        "黑色",
        "单 sku 商品 why111 千牛编辑同步"
      ]
    }
  ],
  "productSpecs": [
    {
      "keyId": 0,
      "key": "颜色分类",
      "values": [
        {
          "valueId": 0,
          "value": "浅灰色"
        },
        {
          "valueId": 0,
          "value": "黑色"
        },
        {
          "valueId": 0,
          "value": "单 sku 商品 why111 千牛编辑同步"
        }
      ]
    }
  ],
  "skus": [
    {
      "shopId": "21000017",
      "productId": "660057403063402509",
      "skuId": "660057403063402511",
      "title": "浅灰色",
      "picUrl": "//img.alicdn.com/imgextra/i2/2214281521988/O1CN01mBXX711QYYFAxfNiX_!!2214281521988.jpg",
      "skuSpecs": [
        {
          "keyId": 0,
          "key": "颜色分类",
          "valueId": 0,
          "value": "浅灰色"
        }
      ],
      "skuSpecsCode": "",
      "skuStatus": "Online",
      "canSell": true,
      "quantity": -1,
      "fuzzyQuantity": "有货",
      "price": 2,
      "markPrice": 777700,
      "platformPrice": 777700,
      "divisionCode": "330106109"
    },
    {
      "shopId": "21000017",
      "productId": "660057403063402509",
      "skuId": "660057403063402510",
      "title": "单 sku 商品 why111 千牛编辑同步",
      "picUrl": "//img.alicdn.com/imgextra/i2/2214281521988/O1CN01mBXX711QYYFAxfNiX_!!2214281521988.jpg",
      "skuSpecs": [
        {
          "keyId": 0,
          "key": "颜色分类",
          "valueId": 0,
          "value": "单 sku 商品 why111"
        }
      ],
      "skuSpecsCode": "",
      "skuStatus": "Online",
      "canSell": true,
      "quantity": -1,
      "fuzzyQuantity": "有货",
      "price": 1,
      "markPrice": 777700,
      "platformPrice": 777700,
      "divisionCode": "330106109"
    },
    {
      "shopId": "21000017",
      "productId": "660057403063402509",
      "skuId": "660057403063402512",
      "title": "黑色",
      "picUrl": "//img.alicdn.com/imgextra/i2/2214281521988/O1CN01mBXX711QYYFAxfNiX_!!2214281521988.jpg",
      "skuSpecs": [
        {
          "keyId": 0,
          "key": "颜色分类",
          "valueId": 0,
          "value": "黑色"
        }
      ],
      "skuSpecsCode": "",
      "skuStatus": "Online",
      "canSell": true,
      "quantity": -1,
      "fuzzyQuantity": "有货",
      "price": 9,
      "markPrice": 777700,
      "platformPrice": 777700,
      "divisionCode": "330106109"
    }
  ],
  "canSell": true,
  "productType": "Normal",
  "productStatus": "Online",
  "shopId": "21000017",
  "quantity": -1,
  "fuzzyQuantity": "有货",
  "taxRate": null,
  "taxCode": null,
  "categoryChain": [
    {
      "categoryId": 50020808,
      "name": "家居饰品",
      "parentId": 0,
      "level": 0,
      "isLeaf": false
    },
    {
      "categoryId": 50022568,
      "name": "其他工艺饰品",
      "parentId": 50020808,
      "level": 0,
      "isLeaf": true
    }
  ],
  "soldQuantity": "2",
  "divisionCode": "330106109"
}

示例

正常返回示例

JSON格式

{
  "categoryChain": [
    {
      "name": "名称测试",
      "isLeaf": false,
      "level": 0,
      "categoryId": 201792301,
      "parentId": 0
    }
  ],
  "images": [
    "[]"
  ],
  "quantity": -1,
  "skus": [
    {
      "quantity": -1,
      "productId": "660460842235822080",
      "canSell": true,
      "fuzzyQuantity": "有货",
      "skuStatus": "Online",
      "skuSpecsCode": "颜色分类:天蓝色",
      "platformPrice": 999900,
      "title": "天蓝色",
      "divisionCode": "110000",
      "picUrl": "https:////img.alicdn.com/imgextra///img.alicdn.com/imgextra/i2/2216003305543/O1CN010DEQCX1qokFYGRfPE_!!2216003305543.png",
      "markPrice": 999900,
      "skuSpecs": [
        {
          "keyId": 1000,
          "valueId": 1000,
          "value": "天蓝色",
          "key": "颜色分类",
          "valueAlias": "秘色"
        }
      ],
      "price": 19800,
      "shopId": "21000017",
      "skuId": "660460842235822081",
      "barcode": "6922454329176",
      "rankValue": 3
    }
  ],
  "productId": "660460842235822080",
  "canSell": true,
  "productSpecs": [
    {
      "keyId": 1000,
      "key": "颜色分类",
      "values": [
        {
          "value": "白色",
          "valueId": 1000,
          "valueAlias": "秘色"
        }
      ]
    }
  ],
  "fuzzyQuantity": "有货",
  "productStatus": "Online",
  "taxCode": "3040203000000000000",
  "title": "发财树",
  "soldQuantity": "100+",
  "divisionCode": "110000",
  "picUrl": "https://img.alicdn.com/imgextra/i3/2214281521988/O1CN01w4vomR1QYYEx6nyr5_!!2214281521988.jpg",
  "taxRate": 600,
  "categoryLeafId": 201856501,
  "requestId": "3239281273464326823",
  "descPath": "https://img.alicdn.com/descpath/O1CN01wciRDp22AEU14435dsf34",
  "shopId": "21000017",
  "productType": "Normal",
  "properties": [
    {
      "text": "颜色",
      "values": [
        "白色"
      ]
    }
  ],
  "brandName": "Apple/苹果",
  "extendProperties": [
    {
      "key": "ss_picture_scene",
      "value": "场景图"
    }
  ],
  "lmItemId": "21000017-4580902812"
}

错误码

访问错误中心查看更多错误码。

变更历史

变更时间变更内容概要操作
2024-03-29API 内部配置变更,不影响调用查看变更详情
2023-09-18API 内部配置变更,不影响调用查看变更详情