商品 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/orders2609170000

火箭仓订单API（列表查询）

KRTW

# 01

简介

火箭仓订单API（列表查询）

# 02

详细内容

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

韩国本地火箭仓订单API（Rocket Growth Order API）可帮助您以编程方式检索订单信息。该API可让您在订单同步、订单研究和基于需求的决策支持工具等领域开发快速、灵活、自定义的应用程序。Order API支持[发布日期] 之后的订单。

注意此接口每分钟限制调用50次。

路径

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

示例端点

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

# 03

Path 参数

Name	Type	Description
vendorId*	string	卖家代码

# 04

Query 参数

Name	Type	Description
paidDateFrom*	string	查询开始日期（例如：20240709）
paidDateTo*	string	查询结束日期（例如：20240809）
nextToken	string	所生成的字符串列表用于检索结果的下一页。如果返回nextToken，则将nextToken的值传递给下一个请求。如果未返回nextToken，则没有更多内容要返回。

# 05

响应体

响应消息

Name	Type	Description
code	integer	服务器响应代码
message	string	服务器响应消息
data	object[]	结果列表。没有结果时返回空列表。
vendorId data[].vendorId	string	卖家ID
orderId data[].orderId	integer	订单号
paidAt data[].paidAt	integer	支付日期和时间（时间戳）
orderItems data[].orderItems	object[]	订单信息列表
vendorItemId data[].orderItems[].vendorItemId	integer	选项ID
productName data[].orderItems[].productName	string	商品名称
salesQuantity data[].orderItems[].salesQuantity	integer	产品销售数量
unitSalesPrice data[].orderItems[].unitSalesPrice	string	产品的单位销售价格
currency data[].orderItems[].currency	string	销售价格的货币
nextToken	string	用于检索下一页结果的令牌

Response Example

{
  "code": 200,
  "message": "SUCCESS",
  "data": [
    {
      "vendorId": "A00123456",
      "orderId": 70000000000,
      "paidAt": 1746093162000,
      "orderItems": [
        {
          "vendorItemId": 0,
          "productName": "Nike running shoe size 7",
          "salesQuantity": 1,
          "unitSalesPrice": "27800",
          "currency": "KRW"
        }
      ]
    },
    {
      "vendorId": "A00123456",
      "orderId": 70000000001,
      "paidAt": 1746093162000,
      "orderItems": [
        {
          "vendorItemId": 0,
          "productName": "Nike running shoe size 8",
          "salesQuantity": 2,
          "unitSalesPrice": "24900",
          "currency": "KRW"
        }
      ]
    }
  ],
  "nextToken": "17189443970001139254740404666368"
}

# 06

错误码

HTTP	代码	消息
400	HTTP_400	Bad Request

错误说明

HTTP	类型	错误消息	解决方案
400	400 (确认请求参数)	请求缺少参数或者参数无效，无法解析。	请补充相对应参数
400	400 (确认请求参数)	订单号无效。	请确认您输入的订单号是否正确。
400	400 (确认请求参数)	无法查询其他卖家的订单。	请确认您输入的卖家ID (vendorId)是否正确。