Coupang Developer Center

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

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

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

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

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

Path

GET

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

Example Endpoint

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

Request Parameters

Path Segment Parameter

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

Request Example

无请求体参数要求

Response Message

Name			Type	Description
code			String	结果代码 SUCCESS/ERROR
message			String	结果信息
data			List	有效信息
	vendorId		String	卖家ID 酷澎分配给卖家的固有代码
	vendorItemId		String	单品ID
	`externalSkuId`		String	卖家端定义的skuid
	`inventoryDetails`			特定sku的库存详情。
		`totalOrderableQuantity`	Integer	商品的可订购单位总数。
	`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"
}

Error Spec

HTTP status code (error type)	Error message	How to resolve
400	Request has missing or invalid parameters and cannot be parsed.	请求缺少参数或者参数无效，无法解析。填写必要参数
429	Too Many Requests	请求太频繁

HTTP status code (error type)

Error message

How to resolve

400

Request has missing or invalid parameters and cannot be parsed.

请求缺少参数或者参数无效，无法解析。填写必要参数

429

Too Many Requests

请求太频繁

火箭仓库存API

简介

详细内容