商品 API 品類 API 運輸 / 訂單 API 退貨 API 換貨 API 物流資訊客服 / 諮詢

商品 API

GET/v2/providers/seller_api/apis/api/v1/marketplace/seller-products/external-vendor-sku-codes/{externalVendorSkuCode}2609170000

查詢商品資訊摘要

# 01

簡介

查詢商品資訊摘要

# 02

詳細內容

消費者市場：韓國、台灣

可使用於商品建立／修改時所輸入的賣場商品代（externalVendorSku）來查詢。

請務必在商品創建完成 1 分鐘後，再調用此 API 進行查詢

路徑

GET/v2/providers/seller_api/apis/api/v1/marketplace/seller-products/external-vendor-sku-codes/{externalVendorSkuCode}

範例端點

https://api-gateway.coupang.com/v2/providers/seller_api/apis/api/v1/marketplace/seller-products/external-vendor-sku-codes/{externalVendorSkuCode}

URL API Name

GET_PRODUCT_BY_EXTERNAL_SKU

# 03

Path 參數

Name	Type	Description
externalVendorSkuCode*	string	賣家商品編號(vendor product code)

# 04

回應內容

回應訊息

Name

Type

Description

code

string

結果代碼
SUCCESS/ERROR

message

string

結果資訊

data

object[]

賣家商品註冊

查詢的賣家商品數量，重複 N 次

sellerProductId

data[].sellerProductId

integer

註冊商品 ID

sellerProductName

data[].sellerProductName

string

註冊商品名稱

搜尋註冊商品名稱（20 字以內）

displayCategoryCode

data[].displayCategoryCode

number

顯示分類代碼

vendorId

data[].vendorId

string

賣家 ID

由酷澎分配給賣家的專屬代碼

saleStartedAt

data[].saleStartedAt

string

銷售開始時間

格式：「yyyy-MM-dd'T'HH:mm:ss」

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	商品已刪除

Parameter Name	Status
IN_REVIEW
SAVED
APPROVING
APPROVED
PARTIAL_APPROVED
DENIED
DELETED

createdAt

data[].createdAt

string

註冊銷售時間
格式：「yyyy-MM-dd'T'HH:mm:ss」

Response Example

{
  "code": "SUCCESS",
  "message": "",
  "data": [
    {
      "sellerProductId": 123,
      "sellerProductName": "",
      "displayCategoryCode": null,
      "categoryId": 5555,
      "productId": 3333,
      "vendorId": "A0xxxxx",
      "mdId": "jxxx@",
      "mdName": "xxx",
      "saleStartedAt": "2015-12-28T06:00:00",
      "saleEndedAt": "2099-01-01T00:00:00",
      "brand": null,
      "statusName": "已核准",
      "createdAt": "2015-12-28T18:57:34"
    }
  ]
}

# 05

錯誤碼

HTTP	代碼	訊息
400	HTTP_400	Bad Request

錯誤說明

HTTP	類型	錯誤訊息	解決方案
500	500 (check request parameter)	HTTP://seller-listingsearch.coupang.net:80/vendor/vendorinventories/scroll (5d0cb26d7122730022da07f9) API 呼叫失敗，狀態代碼 500。	伺服器錯誤。請確認所輸入的賣家商品代碼（externalVendorSkuCode）值是否正確，並於稍後重新嘗試。