韩国本地火箭仓订单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/A00123456/rg/orders
请求参数
|
名称 |
是否必须 |
类型 |
描述 |
|
vendorId |
O |
字符串 |
卖家代码 用于查询卖家订单的卖家ID。 |
|
paidDateFrom |
O |
字符串 |
查询开始日期（例如：UTC时区的 20240709） |
|
paidDateTo |
O |
字符串 |
查询结束日期（例如：UTC时区的 20240809） |
|
nextToken |
|
字符串 |
所生成的字符串列表用于检索结果的下一页。如果返回nextToken，则将nextToken的值传递给下一个请求。如果未返回nextToken，则没有更多内容要返回。 |
请求体
无
返回消息
| Name | Type | Description | ||||
|---|---|---|---|---|---|---|
| code | 数值 |
服务器返回码
|
||||
| message | 字符串 |
服务器返回消息
|
||||
| data | 数组 |
结果列表
若没有结果，则返回空白列表 |
||||
| orderId | 数值 |
订单号码
|
||||
| vendorId | 字符串 |
卖家代码
|
||||
| paidAt | 字符串 |
付款完成时的日期/时间
yyyy-MM-dd'T'HH:mm:ss
|
||||
| data | 数组 |
订单信息列表
|
||||
| vendorItemId | 数值 |
产品单项ID/OptionID
|
||||
| productName | 字符串 |
产品名称
|
||||
| salesQuantity | 数值 |
商品的销售数量
|
||||
| salesPrice | 字符串 |
商品的销售单价。
|
||||
| currency | 字符串 |
销售单价的货币。
|
||||
返回消息示例
{"code":200,"message":"SUCCESS","data": [{"vendorId":"A00123456","orderId":70000000000,"paidAt":"2024-06-02T17:13:27Z""orderItems": {"vendorItemId":0,"productName":"Nike running shoe size 7","salesQuantity":1,"unitSalesPrice":27800,"currency":"KRW"}},{"vendorId":"A00123456","orderId":70000000001,"paidAt":"2024-06-02T17:13:27Z""orderItems": {"vendorItemId":0,"productName":"Nike running shoe size 8","salesQuantity":2,"unitSalesPrice":24900,"currency":"KRW"}}],"nextToken":"17189443970001139254740404666368"}
错误代码
|
HTTP状态代码(错误类型) |
错误信息 |
解决方案 |
|
400 (确认请求参数) |
请求缺少参数或者参数无效，无法解析。 |
补充对应参数 |
|
400 (确认请求参数) |
订单号无效。 |
请确认您输入的订单号是否正确。 |
|
400 (确认请求参数) |
无法查询其他卖家的订单。 |
请确认您输入的卖家ID (vendorId)是否正确。 |