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

Rocket Growth

GET/v2/providers/seller_api/apis/api/v1/marketplace/seller-products2609170000

商品列表分页查询 (Rocket Growth 与 Rocket Growth/Marketplace 同步运营产品)

KRTW

# 01

简介

# 02

详细内容

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

分页搜索已注册产品列表。通过在现有商品列表分页搜索接口的端点URL中添加参数，只能单独搜索Rocket Growth产品，新参数请参见绿色文字。

路径

GET/v2/providers/seller_api/apis/api/v1/marketplace/seller-products

示例端点

https://api-gateway.coupang.com/v2/providers/seller_api/apis/api/v1/marketplace/seller-products?vendorId={vendorId}&nextToken={nextToken}&maxPerPage={maxPerPage}&sellerProductId={sellerProductId}&sellerProductName={sellerProductName}&status={status}&manufacture={manufacture}&createdAt={createdAt}&businessTypes={businessTypes}

URL API Name

GET_PRODUCTS_BY_QUERY

# 03

Query 参数

Name	Type	Description
vendorId*	string	卖家ID。示例：A00012345
nextToken	integer	用于调用下一页的键值。第一页可以不填写，或输入1。
maxPerPage	integer	每页数量。默认值：10，最大值：100。
sellerProductId	integer	商品ID
sellerProductName	string	商品名称。搜索长度不超过20个字符。
status	string	卖家商品状态
manufacture	string	制造商
createdAt	string	商品注册日期。请使用 yyyy-MM-dd 格式。
businessTypes*	array	使用“rocketGrowth”参数时，将查询Rocket Growth商品，或同时包含Marketplace和Rocket Growth商品的Hybrid商品。不使用该参数时，按照现有格式查询Marketplace商品，或同时包含Marketplace和Rocket Growth商品的Hybrid商品。

# 04

响应体

响应消息

Name

Type

Description

code

string

结果代码
SUCCES/ERROR

message

string

nextToken

string

data

object[]

sellerProductId

data[].sellerProductId

integer

显示商品ID

sellerProductName

data[].sellerProductName

string

显示商品名

displayCategoryCode

data[].displayCategoryCode

integer

显示品类代码

categoryId

data[].categoryId

integer

品类ID

productId

data[].productId

number

商品Id

vendorId

data[].vendorId

string

卖家ID

saleStartedAt

data[].saleStartedAt

string

销售开始日期

格式为"yyyy-MM-dd'T'HH:mm:ss" *年份可选择至2099年

saleEndedAt

data[].saleEndedAt

string

销售结束日期

格式为"yyyy-MM-dd'T'HH:mm:ss" , *年份可选择至2099年

brand

data[].brand

string

品牌

输入品牌的韩文/英文标准名称

statusName

data[].statusName

string

注册商品状态

审核中 / 临时保存 / 待审核 / 已审核 / 部分审核 / 审核被拒 / 商品已删除

Parameter Name	Status
IN_REVIEW
SAVED
APPROVING
APPROVED
PARTIAL_APPROVED
DENIED
DELETED

createdAt

data[].createdAt

string

商品上架的日期/时间

格式为"yyyy-MM-dd'T'HH:mm:ss"

items

data[].items

object[]

itemName

data[].items[].itemName

string

卖家商品属性名

marketPlaceItemData

data[].items[].marketPlaceItemData

object

物流公司代码
物流公司代码链接

sellerProductItemId

data[].items[].marketPlaceItemData.sellerProductItemId

object

卖家商品属性ID

vendorItemId

data[].items[].marketPlaceItemData.vendorItemId

object

属性ID

如果临时保存商品，则此值为空。商品审核通过将显示。

rocketGrowthItemData

data[].items[].rocketGrowthItemData

object

sellerProductItemId

data[].items[].rocketGrowthItemData.sellerProductItemId

object

卖家商品属性ID

vendorItemId

data[].items[].rocketGrowthItemData.vendorItemId

object

属性ID

如果临时保存商品，则此值为空。商品审核通过将显示。

Response Example

{
  "code": "SUCCESS",
  "message": "",
  "nextToken": " 30100307028",
  "data": [
    {
      "items": [
        {
          "itemName": "RED",
          "marketPlaceItem": null,
          "rocketGrowthItem": {
            "vendorInventoryItemId": 30100601902,
            "vendorItemId": 123333333
          }
        }
      ],
      "sellerProductId": 30100307028,
      "sellerProductName": "RG test",
      "displayCategoryCode": 78361,
      "categoryId": 2357,
      "productId": null,
      "vendorId": "A00159255",
      "mdId": null,
      "mdName": null,
      "saleStartedAt": "2024-06-26T09:00:00",
      "saleEndedAt": "2099-12-31T09:00:00",
      "brand": "",
      "statusName": "승인반려",
      "createdAt": "2024-06-26T13:58:37",
      "registrationType": "RFM"
    }
  ]
}

# 05

错误码

HTTP	代码	消息
400	HTTP_400	Bad Request

错误说明

HTTP	类型	错误消息	解决方案
400	400 (check request parameter)	卖家代码必须输入。	查看卖家 ID (vendorId) 是否输入正确。
400	400 (check request parameter)	createdAt的格式是`yyyy- MM-dd`	查看输入的商品注册日期 (createdAt) 值是否输入正确。格式要为“yyyy-MM-dd”。

HTTP

类型

错误消息

解决方案

400

400 (check request parameter)

卖家代码必须输入。

查看卖家 ID (vendorId) 是否输入正确。

400

400 (check request parameter)

createdAt的格式是`yyyy-

MM-dd`

查看输入的商品注册日期 (createdAt) 值是否输入正确。格式要为“yyyy-MM-dd”。