coupang
API 文件
商品 API品類 API運輸 / 訂單 API退貨 API物流資訊客服 / 諮詢
POST/v2/providers/seller_api/apis/api/v1/marketplace/seller-productsv1

商品創建

# 01

簡介

台灣賣家 目前僅支援以下商品類別： 服飾、時尚配件、廚房／文具／辦公用品／居家／運動、休閒用品／玩具、嗜好用品／汽車配件、傢俱/傢飾、图书。 消費者市場：韓國、台灣 用於在 Coupang 註冊販售商品的 API。 創建商品時，您必須提供符合 Coupang 規範的資訊，例如配送/退貨地址、產品類別、Koshi 資訊以及選項資訊。 ※ 請將產品建立和修改API的呼叫次數限制為每秒不超過10次,否則將會出現429的報錯。

# 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

參數需求

主體參數

名稱 必要 類型 敘述
displayCategoryCode O Number

顯示類別代碼


 

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


 

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

註冊商品名稱

商品名稱用於採購訂單。

最多字元：100 個字元
vendorId O String

供應商ID

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

銷售開始日期

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

銷售結束日期

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

顯示給消費者的商品名稱


 

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


 

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


 

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

最多字元：100 個字元
brand String

品牌


 

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


 

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

商品名稱


 

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

僅限韓國


 

產品類別


 

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

僅限韓國


 

配送方式

參數名稱 狀態
SEQUENCIAL

正常配送

（依序交貨）
COLD_FRESH 新鮮冷凍
MAKE_ORDER 客製化
AGENT_BUY 採購代理
VENDOR_DIRECT 安裝交付或由供應商直接交付

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


 

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

物流代碼


 

韓國： 物流代碼連結

台灣：TWL_KERRY,  TW_HCT

* 請將此值設為預設值。
multiShippingInfos O List

僅限台灣

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

String



 

僅限台灣


 

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

 

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

 

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


 
  deliveryCompanyCode O

String


 

僅限台灣


 

deliveryCompanyCode可參考以下數值：

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


 
deliveryChargeType O 

String



 

僅限台灣

 

運費類型：

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


 

● 免運:

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

● 非免運:

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

● 有條件免運:

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

● 貨到付款:

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


 

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

僅限台灣
 

標準運費

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

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

僅限台灣


有條件免運金額

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

※ 若為免運，請輸入 0。
  deliveryChargeOnReturn O Number

僅限台灣


退貨時的初始運費

顧客退回免費配送商品時需支付的運費。
  deliveryMethod O String 在台灣，配送方式僅接受「(SEQUENCIAL)」。
  outboundShippingPlaceId O Number

僅限台灣


配送地點地址代碼 

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

僅限台灣

預計出貨天數（小時）

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

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

僅限台灣


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

String


 

僅限台灣

 

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

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

 

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

 
  pickUpBranchId   Number

僅限台灣


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

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

僅限台灣

TWL_KERRY, TWL_FM，TWL_711
  returnCenterCode O

String



 

僅限台灣

退貨地址中心代碼


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

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

- 如果您無法建立退貨地址，請輸入 "NO_RETURN_CENTERCODE" 來手動新增退貨地址資訊。
  returnChargeName O String

返回位置名稱

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

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

台灣

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

僅限台灣

退貨地址聯絡電話


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

String


 

僅限台灣

 

退貨地址郵遞區號

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

僅限台灣

退貨地址

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

僅限台灣

退貨詳細地址

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

僅限台灣

退貨運費
 

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

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

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

配送費用種類
 

參數名稱 狀態
FREE 免運
NOT_FREE 非免運
CHARGE_RECEIVED

貨到付款

(僅適用於韓國)
CONDITIONAL_FREE 有條件免運


 

適用台灣：

  • 如果 multiShippingInfos 列表中只有一組配送資訊，請直接使用該組資訊中的 deliveryChargeType 值

  • 如果 multiShippingInfos 列表中有兩組配送資訊，請依照以下規則選取：
     

     

  1. 若 deliveryChargeType 不同：請依照以下優先順序選擇其中一個：FREE > CONDITIONAL_FREE > NOT_FREE
  2. 若相同：可任選一個值。
     

●免運:

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

● 非免運:

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

● 有條件免運:

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

● 貨到付款： 

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


 

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

標準運費


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

 

適用台灣, 

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

有條件免運金額
 

● 範例：

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

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

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

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


 

台灣, 

  • 如果 multiShippingInfos 列表中只有一組配送資訊，請直接使用該組資訊中的 deliveryChargeType 值。

  • 如果 multiShippingInfos 列表中有兩組配送資訊，請依照以下規則選擇：


     

  1. 若 deliveryChargeType 不同：請依照以下優先順序選擇 deliveryCharge：FREE> CONDITIONAL_FREE > NOT_FREE
  2. 若 deliveryChargeType 相同：請選擇列表中運費最低的 freeShipOverAmount 值


 
deliveryChargeOnReturn O Number

退貨時的初始運費
 

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

僅限韓國
 

偏遠地區是否可送貨
 

參數名稱 狀態

Y


 

 偏遠地區可送貨

N


 

 偏遠地區無法送貨


 
unionDeliveryType O String

僅限韓國


 

可否合併配送
 

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

 

※ 合併配送條件：

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

不能不支援貨到付款選項。
returnCenterCode O String

返回位置中心代碼


 

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

 

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

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

 

韓國

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

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

 

台灣

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

返回位置名稱

 

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

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

 

台灣

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

退貨地址聯絡電話
 

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

 

台灣

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

退貨地址郵遞區號
 

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

 

台灣

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

退貨地址地址

 

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

 

台灣

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

退貨地址詳細地址

 

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

 

台灣

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

退貨運費

 

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

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

 

台灣

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

出貨地點地址代碼


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

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

 

適用台灣用戶：

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

實際使用者ID（Coupang Wing ID）


 

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

是否請求自動批准


 

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

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

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

供應商商品選項列表

 

最多可新增 200 個選項。
itemName O String

供應商商品選項名稱


 

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

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

最多字元：150個字元
originalPrice O Number

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

 

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

售價

輸入銷售價格。

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

可銷售數量


 

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

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

最大值：99999
maximumBuyForPerson O Number

每人最大購買數量


 

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

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

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

最大購買數量期限


 

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

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

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

出貨天數（天）


 

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

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

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

 

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

單位數量

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

19歲或以上

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


 
taxType O String

是否應納稅


 

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


 
parallelImported O String

僅限韓國

 

是否平行輸入
 

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

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

僅限韓國
 

是否海外代購

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

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

僅限韓國
 

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

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

- 預設值：不需要（false）

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

 
externalVendorSku String

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

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

條碼

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

無條碼

沒有條碼時為 True
emptyBarcodeReason String

沒有條碼的原因

最多字元：100 個字元
modelNo String 型號
extraProperties

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

可以根據需要以Key:Value格式重複輸入。
Key String 價值
certifications List

僅適用韓國

產品認證資訊

產品認證資訊
certificationType String

僅限韓國

認證資訊類型

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

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

僅限韓國

認證資訊代碼

認證機構發行的代碼。
certificationAttachments List<Map<String,String>>

僅限韓國

認證資訊附件


 

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

1. vendorPath：如果圖片不是來自 Coupang CDN 伺服器

2. cdnPath：如果圖片已經上傳到 Coupang CDN 伺服器

 

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

1.行動通訊證書

2. 證明商標

例子：

"認證": [

    {

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

      "certificationCode": "",

      "認證附件": [

        {

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

        }，

        {

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

}

      ]

    }

]
searchTags List

關鍵字

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

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

圖片列表

可依需要重複輸入。
imageOrder O Number

圖片顯示順序

0,1,2...
imageType O String

圖片類型

代表圖片類型

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


 

● 必要

表現形式：方形主圖

● 可選

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

USED​​_PRODUCT：二手商品狀況圖片（最多可上傳 4 張圖片）
cdnPath O String

Coupang CDN 路徑

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

最多字元：200 個字元
vendorPath O String

供應商圖片路徑

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

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

最多字元：200 個字元
notices List

顯示資訊列表

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

顯示資訊類別名稱

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

可以透過類別元資料查詢API或所有類別列表excel檔案來檢查並選擇必要的顯示資訊。
noticeCategoryDetailName String 顯示資訊類別詳細資料名稱
content String 內容
attributes 是 List

選項列表（屬性）

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

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

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

必須輸入至少一個值。

 

※在韓國，飲料類別僅可註冊在品類別元資料中定義的必填購買選項，未設定或未提供免費購買選項的商品，將無法建立。

 

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

選項類型名稱

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

最多字數：25 個字元
attributeValueName 是 String

選項值

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

例如: “200毫升”

最多字元：30個字元
contents 是 List

內容列表

可依需要重複輸入。
contentsType 是 String

內容類型

參數名稱 狀態
IMAGE 圖片
IMAGE_NO_SPACE 圖片（無法再上傳）
TEXT 文字
IMAGE_TEXT 圖文
TEXT_IMAGE 文字-圖片
IMAGE_IMAGE 圖片-圖片
TEXT_TEXT 文字-文字
TITLE 標題
HTML HTML
contentDetails O List 詳細內容列表
content O String 內容
detailType O String

詳細類型

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

 
offerCondition String

僅限韓國

 

商品狀態
 

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

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

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


 
offerDescription String

僅限韓國

 

二手商品詳細描述

 

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

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

僅限韓國
 

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

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

僅限韓國
 

所需文件範本名稱

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

僅限韓國
 

所需檔案 Coupang CDN 路徑

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

最多字元：150 個字元
vendorDocumentPath String

僅限韓國
 

必填供應商文件

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

最多字元：150 個字元
extraInfoMessage String

僅限韓國

 

客製化商品訊息。

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

製造商

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

僅限韓國

 

組合商品
bundleType String

僅限韓國
 

組合商品類型

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

● AB ：混合組成商品

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

 

請求範例

{
    "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
            }
    ]
}

錯誤響應

名稱 類型 描述
code String 結果代碼
成功／錯誤
message String
訊息
 
data Long
已註冊的商品 ID
=sellerProductId
即賣家商品編號

響應範例

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

錯誤規格

市場  HTTP 狀態代碼 (錯誤類型) 錯誤訊息 解決方式
台灣 400 (check request parameter)

此類別無法透過 API 上架。


 

 可透過 API 來檢查上架的分類編號列表 (Click here)
韓國, 台灣 400 (check request parameter) 缺少屬性 請透過Category Meta Query API 確認所需的屬性類型，依此進行商品註冊。
韓國 400 (check request parameter) 不允許的屬性 此類別的購買選項設定受到限制，請輸入必要的屬性。
韓國, 台灣 400 (check request parameter) 無效的屬性 資料格式或單位數值無效。請透過商品類別查詢 API ，檢查有效的值屬性。
韓國  400 (check request parameter) attributeValueName 的數值不正確。請依照錯誤規格指南輸入正確的數值

請確認輸入的尿布資訊階段是否正確。
可輸入的數值僅為以下項目，且每個庫存ID最多只能新增一個數值。

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

收到產品成功創建的訊息後，我們建議您使用[商品列表部分查詢API]或 WING 檢查產品狀態是否為「已核准」。

  • 如果狀態為“批准被拒絕”，請檢查拒絕原因並在修改後重新送出。

您可以在 WING 的狀態變更歷史記錄中尋找「已被拒絕」的原因，或使用【商品狀態變更歷史查詢API】。

Attachments