查詢商品

消費者市場：韓國、台灣

您可以使用已註冊的商品 ID（sellerProductId）查詢已註冊的商品資訊。

您也可以查詢用於修改商品價格／庫存／銷售狀態所需的選項 ID（vendorItemId）。此外，透過查詢商品資訊，您可以取得用於修改商品的詳細資料。

通路

GET

/v2/providers/seller_api/apis/api/v1/marketplace/seller-products/{sellerProductId}

請求範例端點

https://api-gateway.coupang.com/v2/providers/seller_api/apis/api/v1/marketplace/seller-products/{sellerProductId}

參數需求

路徑參數

名稱					必須	類型	說明
sellerProductId					O	Number	產品建立後顯示產品 ID

請求範例

不需要請求主體

響應消息

名稱類型說明

code

String

Result code

SUCCES/ERROR

message String

data

sellerProductId Number 註冊用產品編號

statusName

String

已註冊產品狀態

심사중/ 임시저장/ 승인대기중/ 승인완료/ 부분승인완료/ 승인반려/ 상품삭제

對應的狀態含義為：審核中 / 暫存 / 等待核准 / 已核准 / 部分核准 / 核准被拒 / 商品已刪除

displayCategoryCode Number 可透過分類清單查詢 API，或下載分類資訊 Excel 進行確認

sellerProductName String 用於採購單（PO）的商品名稱

vendorId

String

Vendor ID

由 Coupang 核發給賣家的唯一識別碼

saleStartedAt

String

銷售開始日期

"yyyy-MM-dd'T'HH:mm:ss" format

saleEndedAt

String

銷售截止日期

"yyyy-MM-dd'T'HH:mm:ss" format, *can input up to 2099

displayProductName

String

商品顯示名稱

實際顯示於 Coupang 商品詳情頁的商品名稱；可能因品牌、商品名稱或商品系列變更而調整

brand

String

品牌

請輸入官方品牌名稱（中文／英文）

generalProductName

String

商品名稱

不包含購買選項（屬性顯示）資訊的商品名稱（例如：尺寸、顏色等）

productGroup

String

商品分類

代表商品類型；可參考顯示分類中的最終葉節點分類名稱。若與商品名稱（generalProductName）相同，則無需輸入

deliveryMethod String 配送方式

參數名稱狀態

SEQUENCIAL 一般配送

（依序配送）

COLD_FRESH

MAKE_ORDER

AGENT_BUY

VENDOR_DIRECT

deliveryCompanyCode

String

Courier code

物流碼

deliveryChargeType String Delivery fee type

參數名稱狀態

FREE 免運配送

NOT_FREE 付費配送

CHARGE_RECEIVED 到貨付款（運費到付）

CONDITIONAL_FREE 條件式免運

● 若為免運配送：

請設定退貨時的初始配送費（單程）[deliveryChargeOnReturn] 以及退貨運費（單程）[returnCharge]。

● 若為付費配送：

請設定標準配送費 [deliveryCharge] 以及退貨運費（單程）。

● 若為條件式免運配送：

請設定標準配送費及退貨運費（單程）。

● 若為到貨付款：

適用到貨付款的商品類別已預先定義，並由賣家支援中心提供指引給商家。

※ 針對【CONDITIONAL_FREE】，您可自行設定免運條件金額。

deliveryCharge

Number

標準運費

若為付費配送或條件式免運，請輸入單程配送費用金額。

freeShipOverAmount

Number

免運配送的條件金額

例如：若要設定消費滿 10,000 NTD即可免運，請將 [deliveryChargeType] 設為「CONDITIONAL_FREE」，並於 [freeShipOverAmount] 輸入 10000。

※ 僅可輸入 100 NTD為單位或以上的金額

※ 輸入 0 表示免運配送

deliveryChargeOnReturn

Number

退貨時的初始配送費用

免運配送情況下，由顧客負擔的退貨運費。

remoteAreaDeliverable

String

偏遠地區配送可行性

參數名稱	狀態
Y	YES
N	NO

unionDeliveryType String 是否可進行合併配送

參數名稱狀態

UNION_DELIVERY 可合併配送

NOT_UNION_DELIVERY 不可合併配送

※ 合併配送條件：

出貨地點資訊為必填，僅限出貨地點相同的商品可進行合併配送。

不可限制到貨付款選項。

returnCenterCode

String

退貨倉儲中心代碼 (退貨倉代碼 / 退貨中心編號)

請於 Coupang Wing 登記出貨地點後進行確認

returnChargeName

String

退貨地點名稱

請於 Coupang Wing 登記出貨地點後進行確認

companyContactNumber

String

退貨地點聯絡電話

請於 Coupang Wing 登記出貨地點後進行確認

returnZipCode

String

退貨地點郵遞區號

請於 Coupang Wing 登記出貨地點後進行確認

returnAddress

String

退貨地點地址

請於 Coupang Wing 登記出貨地點後進行確認

returnAddressDetail

String

退貨地點詳細地址

請於 Coupang Wing 登記出貨地點後進行確認

returnCharge

Number

退貨運費

退貨取貨單程運費

outboundShippingPlaceCode

Number

出貨地點地址代碼

選取「合併配送」時為必填。請透過「出貨地點查詢 API」進行確認

vendorUserId

String

實際使用者 ID (Coupang Wing ID)

隸屬於供應商的使用者 ID

requested Boolean 申請自動審核 (是/否)

TRUE 是

FALSE 否

items List 供應商商品選項

sellerProductItemId Number 商品選項ID

isAutoGenerated

String

自動產生選項 (true 或 false)

若為自動產生之選項，則顯示為 true。

vendorItemId

Number

選項 ID

若商品為暫存狀態，此值將為 null。商品審核通過後即可顯示。

itemName String 供應商商品選項名稱

originalPrice

Number

折扣前原始定價

用於計算折價率 (%) 的折扣前價格。若輸入價格與售價相同，將顯示為「酷澎價」。審核通過後，可使用 [修改選項層級原始定價] API 進行變更。

salePrice

Number

售價

輸入銷售價格。在「初始」產品註冊期間，僅能在申請產品審核前輸入售價。審核通過後，需透過 [修改選項層級價格] API 變更售價。

maximumBuyCount

Number

可販售數量

輸入可供販售的庫存數量。在「初始」產品註冊期間，僅能在申請產品審核前輸入販售數量。審核通過後，需透過 [修改選項層級價格] API 變更。

maximumBuyForPerson

Number

每人限購數量

每人最高可訂購數量。若無限制請輸入「0」。例：若每人限購數量設為 100，限購週期設為 3，則單人在 3 天內最多可購買 100 件。

maximumBuyForPersonPeriod

Number

限購數量週期

購買最高限購數量的限制週期。若無限制請輸入「1」。例：若每人限購數量設為 100，限購週期設為 3，則單人在 3 天內最多可購買 100 件

outboundShippingTimeDay

Number

出貨天數 (天)

輸入訂單成立後 (D-day) 幾天內出貨。例：若為隔日出貨 (D+1)，請輸入「1」。

adultOnly

String

19歲或以上

參數名稱	狀態
ADULT_ONLY	限 19 歲以上顧客購買
EVERYONE	全年齡段皆可購買（預設）

taxType

String

應稅 / 免稅

參數名稱	狀態
TAX	應稅
FREE	免稅

parallelImported

String

是否平行進口

參數名稱	狀態
PARALLEL_IMPORTED	平行進口
NOT_PARALLEL_IMPORTED	非平行進口

overseasPurchased

String

是否跨境購買

參數名稱	狀態
OVERSEAS_PURCHASED	跨境購買
NOT_OVERSEAS_PURCHASED	非跨境購買（預設）

pccNeeded

Boolean

需要個人報關碼 (PCC) 是/否

海外購買商品是否需要提供個人報關碼預設值：

不需要 (false)；

若值為「true」則必須輸入個人報關碼，否則不需輸入

bestPriceGuaranteed3P

Boolean

最低價保證是/否

true/false

externalVendorSku

String

供應商產品代碼 (供應商 SKU 碼)

可自行設定供應商唯一的商品代碼值；此值將包含在採購單 (PO) 查詢 API 的回覆內容中

barcode

String

條碼

emptyBarcode

Boolean

是否有條碼

若無條碼請設定為 True

emptyBarcodeReason String 沒有條碼的理由 (最大 100 字符)

modelNo String 型號

extraProperties

供應商商品選項附加資訊

可根據需求以 Key : Value (鍵：值) 格式重複輸入

Key String 值

certifications List 商品證書信息

certificationType

String

產品認證資訊類型

您可以透過類別詮釋資料 (Category Meta Data) 查詢 API 找到相對應的類型。

對於不需要認證的類別：請輸入 NOT_REQUIRED

certificationCode

String

產品認證資訊代碼

由認證機構核發的代碼

certificationAttachments

List<Map<String,String>>

認證資訊附件 Map 的鍵 (Key) 固定為以下兩者，且僅需擇一提供：

vendorPath：若圖片非來自 Coupang CDN 伺服器
cdnPath：若圖片已上傳至 Coupang CDN 伺服器

備註：註冊手機類別商品時（顯示類別代碼 displayCategoryCode = 62600，消費電子產品 > 手機/平板電腦/配件 > 手機/平板電腦 > 手機 > 未註冊手機），可透過在附件中設定圖片網址來上傳下列文件：

行動通訊證書
認證標誌

範例：

"certifications": [

{

"certificationType": "MOBILE_DEVICE_DEALER_PERMIT",

"certificationCode": "",

"certificationAttachments": [

{

"vendorPath": "http://vendor.com/image/vendoritem/3001519145/cert.jpg"

{

"vendorPath": "http://vendor.com/image/vendoritem/3001519145/logo.jpg"

}

]

}

]

searchTags

List

關鍵字

可根據需求重複輸入 ['關鍵字1', '關鍵字2']

images

List

圖片清單

可根據需求重複輸入

imageOrder

Number

圖片顯示順序

0, 1, 2...

imageType

String

圖片類型

代表圖類型可上傳 3MB 以下的 JPG、PNG 格式正方形圖片（最小 500 x 500px，最大 5000 x 5000px）

● 必填

REPRESENTATION：正方形主圖

● 選填

DETAIL：其他圖片（最多可上傳 9 張）

USED_PRODUCT：二手商品狀況圖（最多可上傳 4 張）

cdnPath

String

Coupang CDN 路徑

若已上傳至 Coupang CDN 則直接輸入。vendorPath 或 cdnPath 至少需擇一填寫。

vendorPath

String

供應商圖片路徑

供應商使用的圖片路徑。若路徑以 http:// 開頭，系統將自動下載並新增至 Coupang CDN。vendorPath 或 cdnPath 至少需擇一填寫。

notices List 產品文案資訊清單

noticeCategoryName

String

產品文案資訊類別名稱

請為每個類別輸入對應的產品文案資訊類別

noticeCategoryDetailName String 產品文案資訊類別詳細名稱

content String 內容

attributes

List

選項清單 (屬性)

由各類別層級預定義的輸入屬性清單。在審核通過前，僅能查詢已輸入的屬性。審核通過後，可查詢所有建議用於在 Coupang 目錄中展示該產品的屬性。未輸入的屬性，其 attributeValueName 將顯示為 ""。此外，Coupang 系統可能會自動提取並新增產品屬性。（請參考回應範例）

attributeTypeName String 屬性類型名稱

attributeValueName String 屬性值

exposed

String

購買選項/搜尋選項檢查欄位

EXPOSED：購買選項

NONE：搜尋選項

editable

String

可編輯性檢查欄位

true：可編輯

false：不可編輯

contents

List

內容清單

可根據需求重複輸入

contentsType

String

內容類型

參數名稱	狀態
IMAGE	Image
IMAGE_NO_SPACE	Image (no space)
TEXT	Text
IMAGE_TEXT	Image-Text
TEXT_IMAGE	Text-Image
IMAGE_IMAGE	Image-Image
TEXT_TEXT	Text-Text
TITLE	Title
HTML	HTML

contentDetails List 詳細內容清單

content String 內容

detailType String 細節類型

Parameter Name Status

IMAGE Image

TEXT Text

offerCondition

String

商品狀態

商品建立後即無法變更 offerCondition。

參數名稱	含義
NEW	新商品
REFURBISHED	整新品
USED_BEST	used item (best)
USED_GOOD	used item (good)
USED_NORMAL	used item (normal)

offerDescription

String

二手商品詳細說明

描述二手商品的狀況（最多 700 個字元）

僅在 offerCondition 設定為二手 (used) 時才可輸入

requiredDocuments List 若需檢附必要文件時輸入

templateName String 必要文件範本名稱

documentPath

String

必要文件 Coupang CDN 路徑

documentPath 或 vendorDocumentPath 至少需擇一填寫

vendorDocumentPath

String

必要文件供應商路徑

若必要文件路徑以 http:// 開頭，系統將自動下載並新增至 Coupang CDN。documentPath 或 vendorDocumentPath 至少需擇一填寫

extraInfoMessage

String

訂製商品資訊訊息

當顧客選擇「訂製商品」配送類型時所顯示的訊息

manufacture String 製造商

status

String

上架商品狀態

參數名稱	狀態
IN_REVIEW	審核中
SAVED	暫存
APPROVING	待審核
APPROVED	已核准
PARTIAL_APPROVED	部分核准
DENIED	拒絕核准
DELETED	商品已刪除

bundleInfo Map<String,String> 組合商品

bundleType

String

組合商品類型

● SINGLE：同款組合商品（預設值）

● AB：混搭組合商品

註冊混搭組合商品時，無法配置選項；新增組合商品資訊後，亦無法修改組合商品數值。此操作將視同註冊新商品並據此套用。

回應範例

{
 "code": "SUCCESS",
 "message": "",
 "data": {
   "sellerProductId": 123459542,
   "sellerProductName": "test_潔顏油_管理用_商品名稱",
   "displayCategoryCode": 56137,
   "categoryId": 1617,
   "productId": 131023672,
   "vendorId": "A0001235",
   "mdId": "NLUP",
   "mdName": "dummy",
   "saleStartedAt": "2019-01-09T18:41:14",
   "saleEndedAt": "2099-01-01T23:59:59",
   "displayProductName": "Happy Bath 皂莓潔顏油",
   "brand": "Happy Bath",
   "generalProductName": "皂莓潔顏油",
   "productGroup": "潔顏油",
   "statusName": "審核完成",
   "deliveryMethod": "VENDOR_DIRECT",
   "deliveryCompanyCode": "KDEXP",
   "deliveryChargeType": "FREE",
   "deliveryCharge": 0,
   "freeShipOverAmount": 0,
   "deliveryChargeOnReturn": 2500,
   "deliverySurcharge": 0,
   "remoteAreaDeliverable": "N",
   "bundlePackingDelivery": 0,
   "unionDeliveryType": "UNION_DELIVERY",
   "returnCenterCode": "1234274592",
   "returnChargeName": "退貨地點_1",
   "companyContactNumber": "02-1234-678",
   "returnZipCode": "06168",
   "returnAddress": "首爾特別市 江南區 三成洞",
   "returnAddressDetail": "1-23 19樓",
   "returnCharge": 2500,
   "outboundShippingPlaceCode": 74010,
   "vendorUserId": "wing_loginId_123",
   "requested": false,
   "items": [
     {
       "offerCondition": "NEW",
       "offerDescription": null,
       "sellerProductItemId": 1271845812,
       "vendorItemId": 4279191312,
       "itemId": 362266710,
       "itemName": "200ml_1入_(可能會變更)",
       "originalPrice": 0,
       "salePrice": 1280960,
       "supplyPrice": 1111873,
       "maximumBuyCount": 1,
       "maximumBuyForPerson": 0,
       "outboundShippingTimeDay": 2,
       "maximumBuyForPersonPeriod": 1,
       "unitCount": 1,
       "adultOnly": "EVERYONE",
       "freePriceType": null,
       "taxType": "TAX",
       "parallelImported": "NOT_PARALLEL_IMPORTED",
       "overseasPurchased": "NOT_OVERSEAS_PURCHASED",
       "externalVendorSku": "0001",
       "pccNeeded": false,
       "bestPriceGuaranteed3P": false,
       "emptyBarcode": true,
       "emptyBarcodeReason": "商品無法確認_無條碼原因",
       "barcode": null,
       "saleAgentCommission": 9,
       "modelNo": "171717",
       "images": [
         {
           "imageOrder": 0,
           "imageType": "REPRESENTATION",
           "cdnPath": "vendor_inventory/images/2019/01/09/18/9/3c1cee6d-9ab1-454a-8742-de94215cab1b.jpg",
           "vendorPath": "151009021007000006.jpg"
         },
         {
           "imageOrder": 1,
           "imageType": "DETAIL",
           "cdnPath": "vendor_inventory/images/2019/01/09/18/4/b43651a8-974e-4965-a650-9238ea1ecc15.jpg",
           "vendorPath": "plg27673_0000004440.jpg"
         }
       ],
       "notices": [
         {
           "noticeCategoryName": "化妝品",
           "noticeCategoryDetailName": "容量（重量）",
           "content": "請參考詳細頁面"
         },
         {
           "noticeCategoryName": "化妝品",
           "noticeCategoryDetailName": "產品主要規格",
           "content": "請參考詳細頁面"
         },
         {
           "noticeCategoryName": "化妝品",
           "noticeCategoryDetailName": "使用期限或開封後使用期限",
           "content": "請參考詳細頁面"
         },
         {
           "noticeCategoryName": "化妝品",
           "noticeCategoryDetailName": "使用方法",
           "content": "請參考詳細頁面"
         },
         {
           "noticeCategoryName": "化妝品",
           "noticeCategoryDetailName": "製造商及製造銷售商",
           "content": "請參考詳細頁面"
         },
         {
           "noticeCategoryName": "化妝品",
           "noticeCategoryDetailName": "製造國",
           "content": "請參考詳細頁面"
         },
         {
           "noticeCategoryName": "化妝品",
           "noticeCategoryDetailName": "依化妝品法規定需標示之全成分",
           "content": "請參考詳細頁面"
         },
         {
           "noticeCategoryName": "化妝品",
           "noticeCategoryDetailName": "是否需食品藥品安全處審核",
           "content": "請參考詳細頁面"
         },
         {
           "noticeCategoryName": "化妝品",
           "noticeCategoryDetailName": "使用注意事項",
           "content": "請參考詳細頁面"
         },
         {
           "noticeCategoryName": "化妝品",
           "noticeCategoryDetailName": "品質保證標準",
           "content": "產品如有異常，將依公平交易委員會公告之消費者爭議解決標準進行補償。"
         },
         {
           "noticeCategoryName": "化妝品",
           "noticeCategoryDetailName": "消費者諮詢電話",
           "content": "請參考詳細頁面"
         }
       ],
       "attributes": [
         { "attributeTypeName": "膚質", "attributeValueName": "", "exposed": "NONE", "editable": true },
         { "attributeTypeName": "肌膚困擾", "attributeValueName": "", "exposed": "NONE", "editable": true },
         { "attributeTypeName": "數量", "attributeValueName": "1入", "exposed": "EXPOSED", "editable": true },
         { "attributeTypeName": "單件重量", "attributeValueName": "", "exposed": "EXPOSED", "editable": true },
         { "attributeTypeName": "使用部位", "attributeValueName": "", "exposed": "NONE", "editable": true },
         { "attributeTypeName": "單件容量", "attributeValueName": "200ml", "exposed": "EXPOSED", "editable": true }
       ],
       "certifications": [{ "certificationType": "NOT_REQUIRED", "certificationCode": "" }],
       "extraProperties": {
         "transactionType": "manufacturer",
         "onlineSalePriceForBooks": "10000",
         "coupangSalePrice": "5000",
         "businessType": "Beauty"
       },
       "searchTags": ["搜尋詞1", "搜尋詞2"]
     },
     {
       "offerCondition": "NEW",
       "offerDescription": null,
       "sellerProductItemId": 1271845813,
       "vendorItemId": 4279191317,
       "itemId": 385617482,
       "itemName": "200ml_2入 (可能會變更)",
       "originalPrice": 13000,
       "salePrice": 10000,
       "supplyPrice": 8680,
       "maximumBuyCount": 1,
       "maximumBuyForPerson": 0,
       "outboundShippingTimeDay": 2,
       "maximumBuyForPersonPeriod": 1,
       "unitCount": 1,
       "adultOnly": "EVERYONE",
       "freePriceType": null,
       "taxType": "TAX",
       "parallelImported": "NOT_PARALLEL_IMPORTED",
       "overseasPurchased": "NOT_OVERSEAS_PURCHASED",
       "externalVendorSku": "0001",
       "pccNeeded": false,
       "bestPriceGuaranteed3P": false,
       "emptyBarcode": true,
       "emptyBarcodeReason": "無法確認商品_無條碼原因",
       "barcode": null,
       "saleAgentCommission": 9,
       "modelNo": "171717",
       "images": [
         {
           "imageOrder": 0,
           "imageType": "REPRESENTATION",
           "cdnPath": "vendor_inventory/images/2019/01/09/18/7/17173ab4-db79-48ab-8d29-4e1a7126abbf.jpg",
           "vendorPath": "151009021007000006.jpg"
         },
         {
           "imageOrder": 1,
           "imageType": "DETAIL",
           "cdnPath": "vendor_inventory/images/2019/01/09/18/3/a455fe6a-ea81-40e8-85ca-547db8d27c16.jpg",
           "vendorPath": "plg27673_0000004440.jpg"
         }
       ],
       "notices": [
         { "noticeCategoryName": "化妝品", "noticeCategoryDetailName": "容量（重量）", "content": "請參考詳細頁面" },
         { "noticeCategoryName": "化妝品", "noticeCategoryDetailName": "品質保證標準", "content": "請參考詳細頁面" },
         { "noticeCategoryName": "化妝品", "noticeCategoryDetailName": "消費者諮詢電話", "content": "請參考詳細頁面" }
       ],
       "attributes": [
         { "attributeTypeName": "數量", "attributeValueName": "2入", "exposed": "EXPOSED", "editable": true },
         { "attributeTypeName": "單件容量", "attributeValueName": "200ml", "exposed": "EXPOSED", "editable": true }
       ],
       "contents": [
         {
           "contentsType": "TEXT",
           "contentDetails": [
             {
               "content": "<div></div> <div> <img src=\"http://img1a.coupangcdn.com/image/vendor_inventory/images/2019/01/09/18/7/0338f9a4-d6cb-4713-9948-5f49c4a61f27.jpeg\"> <div></div> </div>",
               "detailType": "TEXT"
             }
           ]
         }
       ],
       "certifications": [{ "certificationType": "NOT_REQUIRED", "certificationCode": "" }],
       "extraProperties": {
         "transactionType": "manufacturer",
         "onlineSalePriceForBooks": "10000",
         "coupangSalePrice": "5000",
         "businessType": "Beauty"
       },
       "searchTags": ["搜尋詞1", "搜尋詞2"]
     }
   ],
   "requiredDocuments": [],
   "extraInfoMessage": null,
   "manufacture": "製造商_測試",
   "bundleInfo": {
     "bundleType": "SINGLE"
   }
 }
}

錯誤說明

HTTP Status Code (Error Type)	Error Message	Solution
400 (Check request variable)	Product information is being registered or modified. Please try again later. [1320***883]	請於申請商品註冊後 10 分鐘再次嘗試。
400 (Check request variable)	Seller[A00123456] cannot query product information of another seller[A0011***5].	請確認已註冊的商品 ID（sellerProductId）是否正確。
400 (Check request variable)	No data found for this product(123456789).	請確認已註冊的商品 ID（sellerProductId）是否正確。
400 (Check request variable)	Seller product ID [null] must be written in number format only.	請確認已註冊的商品 ID（sellerProductId）是否正確。

URL API Name

GET_PRODUCT_BY_PRODUCT_ID

OPENAPI 관련 안내

此段落內的文章

通路

請求範例端點

參數需求

請求範例

響應消息

回應範例

錯誤說明

URL API Name

OPENAPI 관련 안내

此段落內的文章

通路

請求範例端點

參數需求

請求範例

響應消息

回應範例

錯誤說明

URL API Name

相關文章