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

商品 API

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

商品創建

# 01

簡介

商品創建

# 02

詳細內容

台灣賣家目前僅支援以下商品類別：

服飾、時尚配件、廚房／文具／辦公用品／居家／運動、休閒用品／玩具、嗜好用品／汽車配件、傢俱/傢飾、图书。

消費者市場：韓國、台灣

用於在 Coupang 註冊販售商品的 API。

創建商品時，您必須提供符合 Coupang 規範的資訊，例如配送/退貨地址、產品類別、Koshi 資訊以及選項資訊。

※ 請將產品建立和修改API的呼叫次數限制為每秒不超過10次,否則將會出現429的報錯。

路徑

POST/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

# 03

請求內容

請求參數

請求內容參數

Name Type Description

displayCategoryCode*

integer

顯示類別代碼

可以使用excel 類別列表進行檢查。（點這裡）

※ 如果沒有輸入displayCategoryCode，請點選這裡進行類別自動匹配服務。

sellerProductName*

string

註冊商品名稱

商品名稱用於採購訂單。

最多字元：100 個字元

vendorId*

string

供應商ID

Coupang 給予商家的獨立代碼。登入 Wing 後即可查看。

saleStartedAt*

string

銷售開始日期

“yyyy-MM-dd'T'HH:mm:ss”格式

saleEndedAt*

string

銷售結束日期

「yyyy-MM-dd'T'HH:mm:ss」格式，*可輸入最長至2099年的長週期。

displayProductName

string

顯示給消費者的商品名稱

實際商品名稱將顯示在 Coupang 產品詳細資料頁面上。

建議使用[品牌]+[商品名稱]的格式。即使此欄位留空，仍可註冊商品。

如果留空，則會顯示 [品牌]+[通用商品名稱] 或 [賣家商品名稱] 格式。

最多字元：100 個字元

brand

string

品牌

韓國：用韓文/英文輸入官方品牌名稱，中間不要有空格，也不要有特殊字元。

台灣：請輸入繁體中文/英文的官方品牌名稱，中間不要有空格，也不要有特殊字元。

generalProductName

string

商品名稱

不包含購買選項的商品名稱[屬性公開]資訊（例如尺寸、顏色等）。可新增型號名稱。

productGroup

string

僅限韓國

產品類別

產品類型，可參考展示類別最末端的子類別名稱。若與商品名稱 [generalProductName] 相同，則無需填寫。

deliveryMethod*

string

僅限韓國

配送方式

參數名稱	狀態
SEQUENCIAL	正常配送（依序交貨）
COLD_FRESH	新鮮冷凍
MAKE_ORDER	客製化
AGENT_BUY	採購代理
VENDOR_DIRECT	安裝交付或由供應商直接交付

對於新鮮食品，您必須選擇新鮮冷凍類型，而不是普通配送。

台灣，僅可使用「SEQUENCIAL」作為配送方式。

deliveryCompanyCode*

string

物流代碼

韓國：物流代碼連結

台灣：TWL_KERRY, TW_HCT

請將此值設為預設值。

multiShippingInfos*

object[]

僅限台灣

允許列出以下值：HOME_DELIVERY, CVS。
HOME_DELIVERY 為必填項目。

deliveryCompanyType*

multiShippingInfos[].deliveryCompanyType

string

僅限台灣

請選擇您想新增的配送方式。

HOME_DELIVERY (宅配) 類型為必選，而 CVS (超商為選填。

參數名稱	狀態
HOME_DELIVERY	宅配
CVS	超商

deliveryCompanyCode*

multiShippingInfos[].deliveryCompanyCode

string

僅限台灣

deliveryCompanyCode可參考以下數值：

Code	說明
TWL_KERRY	嘉里
TW_HCT	新竹
TWL_FM	全家
TWL_711	711

deliveryChargeType*

multiShippingInfos[].deliveryChargeType

string

僅限台灣

運費類型：

參數名稱	狀態
FREE	免運
NOT_FREE	非免運
CONDITIONAL_FREE	有條件免運

● 免運:

請設定「退貨時的初始運費（單趟）[deliveryChargeOnReturn]」與「退貨運費（單趟）[returnCharge]」

● 非免運:

若為非免運，請設定標準運費 [deliveryCharge] 和單趟退貨運費

● 有條件免運:

請設定標準運費和單趟退貨運費

● 貨到付款:

適用於貨到付款的商品類別已定義於規範總，賣家可參考賣家支援中心

※ 針對有條件免運 [CONDITIONAL_FREE]，您可以自由設定門檻金額。

deliveryCharge*

multiShippingInfos[].deliveryCharge

integer

僅限台灣

標準運費

針對付費配送和有條件免運，請輸入單趟運費金額。

針對宅配運費，僅允許填入以下列表中某個值：[65, 70, 90, 105, 135, 180, 285, 365]

freeShipOverAmount

multiShippingInfos[].freeShipOverAmount

integer

僅限台灣

有條件免運金額

您只能輸入 1 元新台幣或更高金額。

※ 若為免運，請輸入 0。

deliveryChargeOnReturn*

multiShippingInfos[].deliveryChargeOnReturn

integer

僅限台灣

退貨時的初始運費

顧客退回免費配送商品時需支付的運費。

deliveryMethod*

multiShippingInfos[].deliveryMethod

string

在台灣，配送方式僅接受「(SEQUENCIAL)」。

outboundShippingPlaceId*

multiShippingInfos[].outboundShippingPlaceId

integer

僅限台灣

配送地點地址代碼

選擇合併配送時為必填欄位。可使用「配送地點查詢 API」進行確認。

outboundShippingTime*

multiShippingInfos[].outboundShippingTime

integer

僅限台灣

預計出貨天數（小時）

請輸入從訂單日期（D 日）起算，商品預計多久後會出貨。

例如：若商品在隔天（D+1）出貨，請輸入「24」。

multiReturnInfos*

object[]

僅限台灣

可列出各種不同的 pickUpbranchType (取貨分店類型) 。列表中最多可包含 2 個元素。

pickUpBranchType*

multiReturnInfos[].pickUpBranchType

string

僅限台灣

請選擇您想新增的退貨類型。

Home (宅配收件) 類型為必填，而 CVS (超商) 則為選填。

參數名稱	狀態
HOME	宅配
CVS	超商

pickUpBranchId

multiReturnInfos[].pickUpBranchId

integer

僅限台灣

如果 pickUpBranchType 為 CVS (超商)，請將此欄位設為超商的 ID。

如果 pickUpBranchType 為 home (宅配)，請將此欄位留空。

pickUpBranchGroupCode*

multiReturnInfos[].pickUpBranchGroupCode

string

僅限台灣

TWL_KERRY, TWL_FM，TWL_711

returnCenterCode*

multiReturnInfos[].returnCenterCode

string

僅限台灣

退貨地址中心代碼

建立退貨地址後，請擷取並輸入退貨地址中心代碼。

退貨地址可透過 WING 或「退貨地址建立 API」建立。
如果您無法建立退貨地址，請輸入 "NO_RETURN_CENTERCODE" 來手動新增退貨地址資訊。

returnChargeName*

multiReturnInfos[].returnChargeName

string

返回位置名稱

在 Coupang Wing 上檢查或透過退貨地址查詢 API 註冊退貨地址。

'查詢返回地點並輸入shippingPlaceName的顯示值'

台灣

當 pickUpBranchType 為 HOME 時，請使用 multiReturnInfos 中的 returnChangeName 欄位值。

companyContactNumber*

multiReturnInfos[].companyContactNumber

string

僅限台灣

退貨地址聯絡電話

請透過 Coupang WING查詢或使用「退貨地址查詢 API」註冊退貨地址。

returnZipCode*

multiReturnInfos[].returnZipCode

string

僅限台灣

退貨地址郵遞區號

請透過 Coupang WING查詢或使用「退貨地址查詢 API」註冊退貨地址。

returnAddress*

multiReturnInfos[].returnAddress

string

僅限台灣

退貨地址

請透過 Coupang WING查詢或使用「退貨地址查詢 API」註冊退貨地址。

returnAddressDetail*

multiReturnInfos[].returnAddressDetail

string

僅限台灣

退貨詳細地址

請透過 Coupang WING查詢或使用「退貨地址查詢 API」註冊退貨地址。

returnCharge*

multiReturnInfos[].returnCharge

integer

僅限台灣

退貨運費

取回退貨商品的單趟運費。

僅能輸入退貨時的初始運費金額的 100% 至 150%。

請使用 multiReturnInfos 中 pickUpBranchType 為 HOME 的 returnCharge 值。

deliveryChargeType*

string

配送費用種類

參數名稱	狀態
FREE	免運
NOT_FREE	非免運
CHARGE_RECEIVED	貨到付款 (僅適用於韓國)
CONDITIONAL_FREE	有條件免運

適用台灣：

如果 multiShippingInfos 列表中只有一組配送資訊，請直接使用該組資訊中的 deliveryChargeType 值
如果 multiShippingInfos 列表中有兩組配送資訊，請依照以下規則選取：
若 deliveryChargeType 不同：請依照以下優先順序選擇其中一個：FREE > CONDITIONAL_FREE > NOT_FREE
若相同：可任選一個值。

●免運:

請設定「退貨時的初始運費（單趟）[deliveryChargeOnReturn]」和「退貨運費（單趟）[returnCharge]」的金額。

● 非免運:

請設定「標準運費[deliveryCharge]」和「退貨運費（單趟）[returnCharge]」的金額。

● 有條件免運:

請設定「標準運費」和「退貨運費（單趟）[returnCharge]」的金額。您也可以自由設定條件金額。

● 貨到付款：

適用於此服務的商品類別已預先定義。如有需要，賣家支援中心會提供相關指引。

※ 對於 [CONDITIONAL_FREE]，您可以自由設定條件金額。

deliveryCharge*

integer

標準運費

請輸入非免運和有條件免運的單趟運費金額。

適用台灣,

如果 multiShippingInfos 列表中只有一組配送資訊，請直接使用該組資訊中的 deliveryChargeType 值。
如果 multiShippingInfos 列表中有兩組配送資訊，請依照以下規則選擇：
若 deliveryChargeType 不同：請依照以下優先順序選擇 deliveryCharge：FREE> CONDITIONAL_FREE > NOT_FREE。
若 deliveryChargeType 相同：請選擇列表中金額最低的 deliveryCharge 值。

freeShipOverAmount*

integer

有條件免運金額

● 範例：

如果您想設定「消費滿 10,000 韓元免運」的條件，請將 [deliveryChargeType] 設為 'CONDITIONAL_FREE'，並在 [freeShipOverAmount] 輸入 10000。

※ 韓國：您只能輸入 100 韓元或更高金額。

※ 台灣：您只能輸入 1 元新台幣或更高金額。

※ 若為免費配送，請輸入 0

台灣,

如果 multiShippingInfos 列表中只有一組配送資訊，請直接使用該組資訊中的 deliveryChargeType 值。
如果 multiShippingInfos 列表中有兩組配送資訊，請依照以下規則選擇：
若 deliveryChargeType 不同：請依照以下優先順序選擇 deliveryCharge：FREE> CONDITIONAL_FREE > NOT_FREE
若 deliveryChargeType 相同：請選擇列表中運費最低的 freeShipOverAmount 值

deliveryChargeOnReturn*

integer

退貨時的初始運費

免費配送商品退貨時，由顧客支付運費。

remoteAreaDeliverable*

string

僅限韓國

偏遠地區是否可送貨

參數名稱	狀態
Y	偏遠地區可送貨
N	偏遠地區無法送貨

unionDeliveryType*

string

僅限韓國

可否合併配送

參數名稱	狀態
UNION_DELIVERY	可以合併配送
NOT_UNION_DELIVERY	無法合併配送

※ 合併配送條件：

出貨地點資訊為必填項目（只有出貨地點相同的產品才可以合併配送）。

不能不支援貨到付款選項。

returnCenterCode*

string

返回位置中心代碼

設立退貨地址後，提取並輸入退貨地址中心代碼。

● 退貨地址可透過 WING 或「退貨地址建立 API」建立。

● 若無法建立退貨地址，請輸入「NO_RETURN_CENTERCODE」手動新增退貨地址資訊。

韓國

※ 自動退貨整合服務 (Goodsflow) 僅限已簽約的快遞公司使用。退貨地址中心代碼為必填。

※ 海外寄送需輸入韓國退貨地址地址及簽約快遞公司代碼，方可產生退貨地址中心代碼。*海外寄送退貨地址指南（點擊）

台灣

當 pickUpBranchType 為 HOME 時，請使用 multiReturnInfos 中的 returnCenterCode 欄位值。

returnChargeName*

string

companyContactNumber*

string

退貨地址聯絡電話

在 Coupang Wing 上查詢或透過退貨地址查詢 API 註冊退貨地址

台灣

當 pickUpBranchType 為 HOME 時，請使用 multiReturnInfos 中的 companyContactNumber 欄位值。

returnZipCode*

string

退貨地址郵遞區號

在Coupang Wing上確認或透過返回地點查詢API註冊返回地點

台灣

當 pickUpBranchType 為 HOME 時，請使用 multiReturnInfos 中的 returnZipCode 欄位值。

returnAddress*

string

退貨地址地址

在Coupang Wing上確認或透過返回地點查詢API註冊返回地點

台灣

當 pickUpBranchType 為 HOME 時，請使用 multiReturnInfos 中的 returnAddress 欄位值。

returnAddressDetail*

string

退貨地址詳細地址

在Coupang Wing上確認或透過返回位置查詢API註冊返回位置

台灣

當 pickUpBranchType 為 HOME 時，請使用 multiReturnInfos 中的 returnAddressDetail 欄位值。

returnCharge*

integer

退貨運費

取回退貨需支付單程運費。

*退貨時只能輸入初始運費的 100%-150%。

台灣

當 pickUpBranchType 為 HOME 時，請使用 multiReturnInfos 中的 returnCharge 欄位值。

outboundShippingPlaceCode*

integer

出貨地點地址代碼

選擇合併配送時必填。請使用出貨地點查詢 API 進行檢查。

選擇海外代購（AGENT_BUY）時，僅可輸入海外地址。

適用台灣用戶：

在 multiShippingInfo 中，當 deliveryCompanyType 為 HOME_DELIVERY 時，取出 outboundShippingPlaceId 的值。

vendorUserId*

string

實際使用者ID（Coupang Wing ID）

隸屬於供應商的使用者 ID。

requested*

boolean

是否請求自動批准

註冊產品時選擇是否自動核准

● false ：僅儲存上傳內容，無需申請核准。（要開始銷售商品，您必須透過 Wing 或產品批准請求 API 申請銷售）

● true ：儲存並自動請求銷售批准

items*

object[]

供應商商品選項列表

最多可新增 200 個選項。

itemName*

items[].itemName

string

供應商商品選項名稱

輸入每個項目，以便不重疊。

這不是網站上顯示的選項名稱，並且可能會根據購買選項而變化。

最多字元：150個字元

originalPrice*

items[].originalPrice

integer

折扣後的原始價格（標價）

用於計算折扣率（%）的折扣前價格。如果輸入的價格與促銷價相同，則顯示為「Coupang價格」。審核後，請使用[更改選項等級原始基準價格] API進行變更。

salePrice*

items[].salePrice

integer

售價

輸入銷售價格。

在「初始」產品註冊期間，銷售價格只能在產品核准請求之前輸入。產品審批通過後，可以透過[更改選項等級價格] API 更改銷售價格。

maximumBuyCount*

items[].maximumBuyCount

integer

可銷售數量

輸入可供銷售的庫存數量。

在「初始」產品註冊期間，可用庫存只能在產品審批請求之前輸入。核准通過後，可透過[變更選項等級數量] API 變更可用庫存數量。

最大值：99999

maximumBuyForPerson*

items[].maximumBuyForPerson

integer

每人最大購買數量

一個人可以訂購該產品的最大數量。

如果不需要套用限制，請輸入「0」。

例如）如果每人的最大訂購數量設定為 100，最大訂購數量期限設定為 3，那麼一個人在 3 天內最多可以購買 100 個。

maximumBuyForPersonPeriod*

items[].maximumBuyForPersonPeriod

integer

最大購買數量期限

最大訂單數量限制的時間段。

如果不需要套用時間段，請輸入「1」。

例如）如果每人的最大訂購數量設定為 100，最大訂購數量期限設定為 3，那麼一個人在 3 天內最多可以購買 100 個。

outboundShippingTimeDay*

items[].outboundShippingTimeDay

integer

出貨天數（天）

輸入訂單日期（D-day）後幾天出庫。

例如）如果出站時間為第二天（D+1），則輸入“1”

台灣：請從 multiShippingInfo 列表中，選取 deliveryCompanyType 為 HOME_DELIVERY 的 outboudShippingPlaceId 值。

並將配送前置時間的單位從小時轉換為天（例如：24 小時轉換為 1 天），最大值為 144 小時。

unitCount*

items[].unitCount

integer

單位數量

unitCount 欄位定義了單個商品清單中所包含的獨立單位數量。系統將利用此數值來計算並向終端用戶顯示「單位價格」（例如：每克、每件或每毫升的價格），以確保批發或組合商品的價格透明度。若商品僅由單一單位組成，請將此值設為 1。

adultOnly*

items[].adultOnly

string

19歲或以上

參數名稱	狀態
ADULT_ONLY	銷售給 19 歲或以上人士的產品
EVERYONE	所有年齡層均可購買的產品（預設值）

taxType*

items[].taxType

string

是否應納稅

參數名稱	狀態
TAX	應稅（預設值）
FREE	免稅

parallelImported*

items[].parallelImported

string

僅限韓國

是否平行輸入

參數名稱	狀態
PARALLEL_IMPORTED	平行輸入
NOT_PARALLEL_IMPORTED	非平行輸入（預設值）

※ 對於平行進口產品，建立產品時應包含進口申報證明書URL -註冊指南（點擊）

overseasPurchased*

items[].overseasPurchased

string

僅限韓國

是否海外代購

參數名稱	狀態
OVERSEAS_PURCHASED	海外採購代理
NOT_OVERSEAS_PURCHASED	非海外代購（預設值）

※ 對於採購代理，建立產品時應包含發票收據 URL -如何註冊（點選）

pccNeeded*

items[].pccNeeded

boolean

僅限韓國

是否需要 PCC（個人清關代碼）

海外代購（AGENT_BUY）情況下，產品PCC必須輸入為true。

預設值：不需要（false）

true	客戶輸入PCC後即可購買（PCC包含在PO中）
false	顧客無需進入 PCC 即可購買

Parameter Name	Status
true
false

externalVendorSku

items[].externalVendorSku

string

供應商產品代碼（供應商SKU代碼）

可以任意設定供應商的唯一商品代碼值。該值將包含在採購訂單查詢 API 回應中。

barcode

items[].barcode

string

條碼

附於產品上的有效標準產品代碼。

emptyBarcode

items[].emptyBarcode

boolean

無條碼

沒有條碼時為 True

emptyBarcodeReason

items[].emptyBarcodeReason

string

沒有條碼的原因

最多字元：100 個字元

modelNo

items[].modelNo

string

型號

extraProperties

items[].extraProperties

object

供應商產品選項附加資訊。

可以根據需要以Key:Value格式重複輸入。

Key

items[].extraProperties.Key

string

價值

certifications

items[].certifications

object[]

僅適用韓國

產品認證資訊

產品認證資訊

certificationType

items[].certifications[].certificationType

string

僅限韓國

認證資訊類型

使用類別元資料查詢 API 來找到正確的類型。

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

certificationCode

items[].certificationCode

string

僅限韓國

認證資訊代碼

認證機構發行的代碼。

certificationAttachments

items[].certificationCode.certificationAttachments

object[]

僅限韓國

認證資訊附件

Map的key固定為以下兩個，且只需要其中一個：

vendorPath：如果圖片不是來自 Coupang CDN 伺服器
cdnPath：如果圖片已經上傳到 Coupang CDN 伺服器

注意：對於註冊類別為（displayCategoryCode = 62600，消費性電子產品>手機/平板電腦/配件>手機/平板電腦>手機>未註冊手機）的手機，您可以透過在附件中設定影像網址來上傳以下檔案。

1.行動通訊證書

證明商標

例子：

"認證": [

{

"certificationType": "行動裝置經銷商授權",

"certificationCode": "",

"認證附件": [

{

「供應商路徑」：http://vendor.com/image/vendoritem/3001519145/cert.jpg“

}，

{

「供應商路徑」：http://vendor.com/image/vendoritem/3001519145/logo.jpg“

}

]

}

]

searchTags

items[].searchTags

object[]

關鍵字

可依需要重複輸入。 ["關鍵字1","關鍵字2"]

最多可輸入 20 個關鍵字，每個關鍵字最多 20 個字元。除 !@#$%^&*-+;:’ 外，不能輸入特殊符號。

images*

items[].images

object[]

圖片列表

可依需要重複輸入。

imageOrder*

items[].images[].imageOrder

integer

圖片顯示順序

0,1,2...

imageType*

items[].images[].imageType

string

圖片類型

代表圖片類型

可以上傳 3MB 以下的 JPG 和 PNG 格式的方形影像（最小 500 x 500px，最大 5000 x 5000px）

● 必要

表現形式：方形主圖

● 可選

詳細資訊：其他圖片（最多可上傳 9 張圖片）

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

cdnPath*

items[].images[].cdnPath

string

Coupang CDN 路徑

如果上傳到 Coupang CDN，則直接輸入。至少需要vendorPath 和 cdnPath 其中一個。

最多字元：200 個字元

vendorPath*

items[].images[].vendorPath

string

供應商圖片路徑

供應商使用的圖片路徑。如果路徑以http://,它將自動下載並新增至 Coupang CDN。 vendorPath 和 cdnPath 至少需要一個。

僅可使用80、443埠鏡像路徑。

最多字元：200 個字元

notices

items[].notices

object[]

顯示資訊列表

可以透過類別元資料查詢API或所有類別列表excel檔案來檢查並選擇必要的顯示資訊。

noticeCategoryName

items[].notices[].noticeCategoryName

string

顯示資訊類別名稱

為每個類別輸入一個產品顯示資訊類別。

可以透過類別元資料查詢API或所有類別列表excel檔案來檢查並選擇必要的顯示資訊。

noticeCategoryDetailName

items[].notices[].noticeCategoryDetailName

string

顯示資訊類別詳細資料名稱

content

items[].notices[].content

string

內容

attributes*

items[].attributes

object[]

選項列表（屬性）

物件輸入每個商品類別層級，已預先定義的選項列表。

可以根據需要輸入多個購買選項。

如果所有購買選項（屬性）的值都相同，則無法新增。

必須輸入至少一個值。

※ 台灣地區Softline類別僅可註冊在商品類別元資料中定義的必填購買選項。如何查看必選/必填選項？點擊此處

attributeTypeName*

items[].attributes[].attributeTypeName

string

選項類型名稱

可以透過「商品分類元資料查詢 API」或「所有商品分類列表 Excel 檔案」來查詢並選擇適當的選項類型名稱。

最多字數：25 個字元

attributeValueName*

items[].attributes[].attributeValueName

string

選項值

請輸入單位及對應「選項類型名稱」[attributeTypeName]的數值。

例如: “200毫升”

最多字元：30個字元

contents*

items[].contents

object[]

內容列表

可依需要重複輸入。

contentsType*

items[].contents[].contentsType

string

內容類型

參數名稱	狀態
IMAGE	圖片
IMAGE_NO_SPACE	圖片（無法再上傳）
TEXT	文字
IMAGE_TEXT	圖文
TEXT_IMAGE	文字-圖片
IMAGE_IMAGE	圖片-圖片
TEXT_TEXT	文字-文字
TITLE	標題
HTML	HTML

contentDetails*

items[].contents[].contentDetails

object[]

詳細內容列表

content*

items[].contents[].contentDetails[].content

string

內容

detailType*

items[].contents[].contentDetails[].detailType

string

詳細類型

參數名稱	狀態
IMAGE	圖片
TEXT	文字

offerCondition

items[].offerCondition

string

僅限韓國

商品狀態

產品一旦創建就無法更改 offerCondition。

可根據顯示類別代碼從以下值選擇。如果留空，則將視為 NEW。

參數名稱	定義
NEW	新的
REFURBISHED	翻新
USED_BEST	二手（最佳）
USED_GOOD	二手（好）
USED_NORMAL	二手（正常）

offerDescription

items[].offerDescription

string

僅限韓國

二手商品詳細描述

描述所用商品的狀況，最多 700 個字元。

只有當 offerCondition 輸入為 used 時才可填寫。

requiredDocuments

object[]

僅限韓國

必填項目若為文件所需，請填寫

可輸入檔案大小最大為 5MB 的文件（PDF、HWP、DOC、DOCX、TXT、PNG、JPG、JPEG）

templateName

requiredDocuments[].templateName

string

僅限韓國

所需文件範本名稱

可透過類別資料以API進行查詢

documentPath

requiredDocuments[].documentPath

string

僅限韓國

所需檔案 Coupang CDN 路徑

documentPath 或 vendorDocumentPath 中至少有一個是必填的。

最多字元：150 個字元

vendorDocumentPath

requiredDocuments[].vendorDocumentPath

string

僅限韓國

必填供應商文件

如果必填文件路徑的開頭為http://,則會自動下載並新增至 Coupang CDN。 documentPath 和 vendorDocumentPath 至少要有一個為必填資訊。

最多字元：150 個字元

extraInfoMessage

string

僅限韓國

客製化商品訊息。

當客戶選擇「客製化商品」的配送類型時，將會顯示此訊息。

manufacture

string

製造商

如果無法輸入準確的製造商訊息，則輸入[品牌]的資訊即可。

bundleInfo

object

僅限韓國

組合商品

bundleType

bundleInfo.bundleType

string

僅限韓國

組合商品類型

● SINGLE ：相同組成商品（預設值）

● AB ：混合組成商品

註冊混合組成商品時，無法設定商品選項；且新增商品組合資訊後，無法修改該組合商品的屬性與類型。此操作相同於註冊新商品，因此系統會依新商品的設定邏輯進行處理。

請求範例application/json

{
  "sellerProductName": "Test Product 001",
  "displayCategoryCode": 86324,
  "vendorId": "A15800030N",
  "saleStartedAt": "2025-01-15T10:45:46",
  "saleEndedAt": "2099-12-30T22:00:00",
  "displayProductName": "Test Product 001",
  "brand": "A-Brand",
  "generalProductName": "Test Product 001",
  "productGroup": "",
  "deliveryMethod": "SEQUENCIAL",
  "deliveryCompanyCode": "TWL_KERRY",
  "deliveryChargeType": "FREE",
  "deliveryCharge": 0,
  "freeShipOverAmount": 0,
  "deliveryChargeOnReturn": 60,
  "returnCenterCode": "1002043483",
  "returnChargeName": "退货测试",
  "companyContactNumber": "010-1234-5678",
  "returnZipCode": "41550",
  "returnAddress": "大邱广域市北区城北路",
  "returnAddressDetail": "(山东针) 9街3号",
  "returnCharge": 60,
  "outboundShippingPlaceCode": 3001800430,
  "vendorUserId": "twtest",
  "requested": true,
  "registrationType": "NORMAL",
  "items": [
    {
      "offerCondition": "NEW",
      "offerDescription": "",
      "itemName": "1包 500g",
      "originalPrice": 9999981,
      "salePrice": 9999991,
      "maximumBuyCount": 0,
      "maximumBuyForPerson": 0,
      "outboundShippingTimeDay": 1,
      "maximumBuyForPersonPeriod": 1,
      "unitCount": 1,
      "adultOnly": "EVERYONE",
      "taxType": "TAX",
      "externalVendorSku": "",
      "emptyBarcode": true,
      "emptyBarcodeReason": "COUPANG",
      "barcode": "",
      "modelNo": "",
      "images": [
        {
          "imageOrder": 0,
          "imageType": "REPRESENTATION",
          "cdnPath": "TW_vendor_inventory/f98e/bbcfa7a590a069b5a0a7ee67eb58426aeacedac68ba73f3553dcba67205b.jpg",
          "vendorPath": "bbcfa7a590a069b5a0a7ee67eb58426aeacedac68ba73f3553dcba67205b.jpg"
        },
        {
          "imageOrder": 0,
          "imageType": "DETAIL",
          "cdnPath": "TW_vendor_inventory/f98e/bbcfa7a590a069b5a0a7ee67eb58426aeacedac68ba73f3553dcba67205b.jpg",
          "vendorPath": "bbcfa7a590a069b5a0a7ee67eb58426aeacedac68ba73f3553dcba67205b.jpg"
        }
      ],
      "notices": [
        {
          "noticeCategoryName": "Import_Food",
          "noticeCategoryDetailName": "食品添加物",
          "content": "Check the detail"
        },
        {
          "noticeCategoryName": "Import_Food",
          "noticeCategoryDetailName": "廠商名稱/廠商聯絡方式",
          "content": "Check the detail"
        },
        {
          "noticeCategoryName": "Import_Food",
          "noticeCategoryDetailName": "原產地",
          "content": "Check the detail"
        },
        {
          "noticeCategoryName": "Import_Food",
          "noticeCategoryDetailName": "製造日期、有效期或保質期",
          "content": "Check the detail"
        },
        {
          "noticeCategoryName": "Import_Food",
          "noticeCategoryDetailName": "營養標示",
          "content": "Check the detail"
        },
        {
          "noticeCategoryName": "Import_Food",
          "noticeCategoryDetailName": "含基因改造食品原料",
          "content": "Check the detail"
        },
        {
          "noticeCategoryName": "Import_Food",
          "noticeCategoryDetailName": "牛肉/豬肉原料原產地",
          "content": "Check the detail"
        }
      ],
      "attributes": [
        {
          "attributeTypeName": "數量",
          "attributeValueName": "1包"
        },
        {
          "attributeTypeName": "每份重量",
          "attributeValueName": "500g"
        }
      ],
      "contents": [
        {
          "contentsType": "IMAGE_NO_SPACE",
          "contentDetails": [
            {
              "content": "vendor_inventory/d5c1/df410c249d830dfeb6080587333e30b82ca598675c7cda85c193b24456a9.jpg",
              "detailType": "IMAGE"
            }
          ]
        }
      ],
      "certifications": [
        {
          "certificationType": "NOT_REQUIRED",
          "certificationCode": "",
          "certificationAttachments": []
        }
      ],
      "extraProperties": null,
      "searchTags": []
    },
    {
      "offerCondition": "NEW",
      "offerDescription": "",
      "itemName": "1包 350g",
      "originalPrice": 9999981,
      "salePrice": 9999991,
      "maximumBuyCount": 0,
      "maximumBuyForPerson": 0,
      "outboundShippingTimeDay": 1,
      "maximumBuyForPersonPeriod": 1,
      "unitCount": 1,
      "adultOnly": "EVERYONE",
      "taxType": "TAX",
      "externalVendorSku": "",
      "emptyBarcode": true,
      "emptyBarcodeReason": "COUPANG",
      "barcode": "",
      "modelNo": "",
      "images": [
        {
          "imageOrder": 0,
          "imageType": "REPRESENTATION",
          "cdnPath": "TW_vendor_inventory/f98e/bbcfa7a590a069b5a0a7ee67eb58426aeacedac68ba73f3553dcba67205b.jpg",
          "vendorPath": "bbcfa7a590a069b5a0a7ee67eb58426aeacedac68ba73f3553dcba67205b.jpg"
        },
        {
          "imageOrder": 0,
          "imageType": "DETAIL",
          "cdnPath": "TW_vendor_inventory/f98e/bbcfa7a590a069b5a0a7ee67eb58426aeacedac68ba73f3553dcba67205b.jpg",
          "vendorPath": "bbcfa7a590a069b5a0a7ee67eb58426aeacedac68ba73f3553dcba67205b.jpg"
        }
      ],
      "notices": [
        {
          "noticeCategoryName": "Import_Food",
          "noticeCategoryDetailName": "食品添加物",
          "content": "Check the detail"
        },
        {
          "noticeCategoryName": "Import_Food",
          "noticeCategoryDetailName": "廠商名稱/廠商聯絡方式",
          "content": "Check the detail"
        },
        {
          "noticeCategoryName": "Import_Food",
          "noticeCategoryDetailName": "原產地",
          "content": "Check the detail"
        },
        {
          "noticeCategoryName": "Import_Food",
          "noticeCategoryDetailName": "製造日期、有效期或保質期",
          "content": "Check the detail"
        },
        {
          "noticeCategoryName": "Import_Food",
          "noticeCategoryDetailName": "營養標示",
          "content": "Check the detail"
        },
        {
          "noticeCategoryName": "Import_Food",
          "noticeCategoryDetailName": "含基因改造食品原料",
          "content": "Check the detail"
        },
        {
          "noticeCategoryName": "Import_Food",
          "noticeCategoryDetailName": "牛肉/豬肉原料原產地",
          "content": "Check the detail"
        }
      ],
      "attributes": [
        {
          "attributeTypeName": "數量",
          "attributeValueName": "1包"
        },
        {
          "attributeTypeName": "每份重量",
          "attributeValueName": "350g"
        }
      ],
      "contents": [
        {
          "contentsType": "IMAGE_NO_SPACE",
          "contentDetails": [
            {
              "content": "vendor_inventory/d5c1/df410c249d830dfeb6080587333e30b82ca598675c7cda85c193b24456a9.jpg",
              "detailType": "IMAGE"
            }
          ]
        }
      ],
      "certifications": [
        {
          "certificationType": "NOT_REQUIRED",
          "certificationCode": "",
          "certificationAttachments": []
        }
      ],
      "extraProperties": null,
      "searchTags": []
    }
  ],
  "requiredDocuments": [],
  "extraInfoMessage": "",
  "manufacture": "",
  "bundleInfo": {
    "bundleType": "SINGLE"
  },
  "multiShippingInfos": [
    {
      "deliveryChargeType": "FREE",
      "deliveryCompanyCode": "TWL_KERRY",
      "deliveryCharge": 65,
      "freeShipOverAmount": 0,
      "deliveryChargeOnReturn": 0,
      "deliveryMethod": "SEQUENCIAL",
      "outboundShippingPlaceId": 21962637,
      "deliveryCompanyType": "HOME_DELIVERY",
      "outboundShippingTime": 48
    },
    {
      "deliveryChargeType": "FREE",
      "deliveryCompanyCode": "TWL_FM",
      "deliveryCharge": 45,
      "freeShipOverAmount": 0,
      "deliveryChargeOnReturn": 0,
      "deliveryMethod": "SEQUENCIAL",
      "outboundShippingPlaceId": 21962637,
      "deliveryCompanyType": "CVS",
      "outboundShippingTime": 48
    }
  ],
  "multiReturnInfos": [
    {
      "pickUpBranchGroupCode": "TWL_KERRY",
      "pickUpBranchType": "HOME",
      "sellerProductId": 1190,
      "returnCenterCode": "1002043483",
      "returnChargeName": "测试地址",
      "companyContactNumber": "0919754091",
      "returnZipCode": "110",
      "returnAddress": "台北市 信義區",
      "returnAddressDetail": "信義路五段7號台北101大楼13樓",
      "returnCharge": 0
    },
    {
      "pickUpBranchId": 19399,
      "pickUpBranchGroupCode": "TWL_FM",
      "pickUpBranchType": "CVS",
      "returnCenterCode": "1002039470",
      "returnChargeName": "李儀家",
      "companyContactNumber": "0919754091",
      "returnZipCode": null,
      "returnAddress": "全家台北１０１店",
      "returnAddressDetail": "台北市信義區市府路45號B1(商場編號53)",
      "returnCharge": 0
    }
  ]
}

# 04

回應內容

回應訊息

Name	Type	Description
code	string	結果代碼成功／錯誤
message	string	訊息
data	object	已註冊的商品 ID =sellerProductId 即賣家商品編號
code data.code	string
message data.message	string
data data.data	integer

Response Example

{
  "code": "200",
  "message": "",
  "data": {
    "code": "SUCCESS",
    "message": "",
    "data": 427011919
  }
}

# 05

錯誤碼

HTTP	代碼	訊息
400	HTTP_400	Bad Request

錯誤說明

HTTP	類型	錯誤訊息	解決方案
400	400 (check request parameter)	此類別無法透過 API 上架。	可透過 API 來檢查上架的分類編號列表 (Click here)
400	400 (check request parameter)	缺少屬性	請透過Category Meta Query API 確認所需的屬性類型，依此進行商品註冊。
400	400 (check request parameter)	不允許的屬性	此類別的購買選項設定受到限制，請輸入必要的屬性。
400	400 (check request parameter)	無效的屬性	資料格式或單位數值無效。請透過商品類別查詢 API ，檢查有效的值屬性。
400	400 (check request parameter)	attributeValueName 的數值不正確。請依照錯誤規格指南輸入正確的數值	請確認輸入的尿布資訊階段是否正確。可輸入的數值僅為以下項目，且每個庫存ID最多只能新增一個數值。步驟 1、步驟 2、步驟 3、步驟 4、步驟 5、步驟 6、步驟 7、新生兒 (NB)、小號 (S)、中號 (M)、大號 (L)、特大號 (XL)、巨型 (2XL)、巨型以上 (3XL)
400	400 (check request parameter)	找不到類別的必填屬性。	如果沒有輸入必填屬性值會顯示錯誤。需要透過商品類別查詢 API 來檢查並輸入必填屬性。
400	400 (check request parameter)	輸入值錯誤。行：123	需要檢查請求JSON訊息中，對應行是否輸入了正確的參數、值和陣列格式。
400	400 (check request parameter)	請輸入正確的退貨地址代碼。	確認出貨地點和退貨地址查詢 API，是否輸入符合的出貨地點和退貨地址代碼。
400	400 (check request parameter)	java.lang.NullPointerException	請檢查送出的 JSON 訊息中是否有錯字。
400	400 (check request parameter)	必要顯示的資訊（例如製造商和供應商）和商品類別的資訊（例如化妝品）應有所不同。	當資訊發生問題時會顯示錯誤。需要檢查類別顯示的原始數據，並檢查其是否與您輸入的顯示資訊 (("notices": []) 相同。
400	400 (check request parameter)	如果運送方式設定為滿19,800韓元免運，系統會顯示消費滿19,800韓元享免運，且首購運費為0韓元。	如果設定滿額免運(免運金額大於:19,800韓元，請確認首購運費（deliveryChargeOnReturn）是否已設定為「0韓元」。
400	400 (check request parameter)	檢查[快遞代碼]。	使用偏遠地區配送服務時，只能輸入（remoteAreaDeliverable：「Y」），固定的貨運公司。
400	400 (check request parameter)	未經授權	因授權資訊不正確而導致錯誤。請確認是否已完成正常授權。
400	400 (check request parameter)	請檢查運送方式。	若選擇海外代理購買（AGENT_BUY），請確認收貨地址是否為海外收貨地址。無法選擇韓國國內收貨地址。
400	400 (check request parameter)	如果配送方式是代理購買（AGENT_BUY），Coupang 會強制要求顧客輸入 PCCC 進行配送。	如果選擇海外代理購買（AGENT_BUY），請檢查pccNeeded參數值是否設定為true。
400	400 (check request parameter)	註冊為混合組成品項時，無法設定多個選項。	註冊為混合組成品項時，請刪除顯示選項。
400	400 (check request parameter)	註冊為混合組成品項時，不能輸入屬性（attributeTypeName）。	註冊為混合組成品項時，請刪除該屬性（attributeTypeName）。
400	400 (check request parameter)	bundleInfo 中不允許此值。	bundleInfo中只允許SINGLE和AB值。

Attachments