商品 API 品类 API 品牌 API 运输 / 订单 API 退货 API 换货 API 促销 / 优惠券物流信息客服 / 咨询结算 CGF / CGF lite Rocket Growth

Rocket Growth

GET/v2/providers/rg_open_api/apis/api/v1/vendors/{vendorId}/rg/inventory/summaries2609170000

火箭仓库存API

# 01

简介

火箭仓库存API

# 02

详细内容

API支持的买家用户地区：韩国

韩国本地火箭仓库存API（Rocket Growth Inventory Summary API）可让您以编码开发对接方式检索酷澎物流网络中的火箭仓商品库存信息。

返回库存摘要列表。所返回的摘要取决于是否存在vendorIdItemId参数：

省略vendorIdItemId参数时，将返回所有具有可用详细信息的库存摘要。
如果提供了vendorIdItemId参数，操作将只返回指定的vendorIdItemId的库存摘要。nextToken参数将被忽略。如果提供了vendorId和nextToken参数，操作将返回从nextToken开始的所有库存的库存摘要。

特别注意：调用此API频次请控制在每分钟50次内，否则会导致过频请求报错

路径

GET/v2/providers/rg_open_api/apis/api/v1/vendors/{vendorId}/rg/inventory/summaries

示例端点

https://api-gateway.coupang.com/v2/providers/rg_open_api/apis/api/v1/vendors/{vendorId}/rg/inventory/summaries

# 03

Path 参数

Name	Type	Description
vendorId*	string	卖家id

# 04

Query 参数

Name	Type	Description
vendorItemId	string	用于查询指定卖家SKU库存摘要的单个vendorItemId
nextToken	string	您上一个请求响应中返回的字符串翻页令牌（String token）。

# 05

响应体

响应消息

Name	Type	Description
code	integer	结果代码 SUCCESS/ERROR
message	string	结果信息
data	object[]	有效信息
vendorId data[].vendorId	string	卖家ID 酷澎分配给卖家的固有代码
vendorItemId data[].vendorItemId	integer	单品ID
externalSkuId data[].externalSkuId	integer	卖家端定义的skuid
inventoryDetails data[].inventoryDetails	object	特定sku的库存详情。
totalOrderableQuantity data[].inventoryDetails.totalOrderableQuantity	integer	商品的可订购单位总数。
salesCountMap data[].salesCountMap	object	出售信息
SALES_COUNT_LAST_THIRTY_DAYS data[].salesCountMap.SALES_COUNT_LAST_THIRTY_DAYS	integer	过去30天卖了多少
nextToken	string	翻页标签

Response Example

{
  "code": 200,
  "message": "SUCCESS",
  "data": [
    {
      "vendorId": "A00123456",
      "vendorItemId": 70000000000,
      "externalSkuId": 10012345,
      "inventoryDetails": {
        "totalOrderableQuantity": 10
      },
      "salesCountMap": {
        "SALES_COUNT_LAST_THIRTY_DAYS": 15
      }
    },
    {
      "vendorId": "A00123456",
      "vendorItemId": 70000000001,
      "externalSkuId": 10012346,
      "inventoryDetails": {
        "totalOrderableQuantity": 20
      },
      "salesCountMap": {
        "SALES_COUNT_LAST_THIRTY_DAYS": 25
      }
    }
  ],
  "nextToken": "2"
}

# 06

错误码

HTTP	代码	消息
400	HTTP_400	Bad Request

错误说明

HTTP	类型	错误消息	解决方案
400	400	Request has missing or invalid parameters and cannot be parsed.	请求缺少参数或者参数无效，无法解析。填写必要参数
429	429	Too Many Requests	请求太频繁