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

查詢商品

# 01

簡介

消費者市場:韓國、台灣 您可以使用已註冊的商品 ID(sellerProductId)查詢已註冊的商品資訊。 您也可以查詢用於修改商品價格/庫存/銷售狀態所需的選項 ID(vendorItemId)。此外,透過查詢商品資訊,您可以取得用於修改商品的詳細資料。

# 02

詳細內容

消費者市場:韓國、台灣

您可以使用已註冊的商品 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) 固定為以下兩者,且僅需擇一提供:

  1. vendorPath:若圖片非來自 Coupang CDN 伺服器

  2. cdnPath:若圖片已上傳至 Coupang CDN 伺服器

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

  1. 行動通訊證書

  2. 認證標誌

範例:

"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