Query Product (Rocket Growth or Rocket Growth/Marketplace Hybrid Products)

Result code
 
SUCCES/ERROR

Product ID for registration

Status of registered product
심사중/ 임시저장/ 승인대기중/ 승인완료/ 부분승인완료/ 승인반려/ 상품삭제
 
The corresponding meanings are Under review / Temporarily saved / Awaiting approval / Approved / Partially approved / Approval denied / Product deleted

Display category code
Check by using category list query API or downloading the category info excel

Product name for registration
Product name used in PO

Vendor ID
Unique code issued to vendor by Coupang

Starting date of sales
"yyyy-MM-dd'T'HH:mm:ss" format

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

Product name for display
Actual product name to be displayed on Coupang product detail page; subject to change due to changes in brand, product name or product family

Brand
Input official brand name in Korean/ English

Brand ID associated with the product. Returned when brand information exists.

Product name
Product name without buying option[Attribute exposed] info (e.g., size, color, etc.)

Product category
Represents product type; can refer to display category's final leaf category name. No need to input if identical with product name [generalProductName]

Delivery and return information will be provided for Marketplace items only. As for Rocket Growth, Coupang delivers and receive returns and hence this information will be provided null for items created for Rocket Growth only.

Delivery method

Parameter Name	Status
SEQUENCIAL	normal delivery (sequential delivery)
COLD_FRESH	fresh frozen
MAKE_ORDER	made to order
AGENT_BUY	purchase agent
VENDOR_DIRECT	installation delivery or delivered directly by vendor

Courier code
Link for courier codes

Delivery fee type

Parameter Name	Status
FREE	free delivery
NOT_FREE	paid delivery
CHARGE_RECEIVED	fee on arrival
CONDITIONAL_FREE	conditional fee delivery

● For free delivery:
set up amount for initial shipping fee on return (one-way)[deliveryChargeOnReturn] and return shipping fee (one-way)[returnCharge] 
● For paid delivery:
set up amount for standard shipping fee[deliveryCharge] and return shipping fee (one-way)
● For conditional free delivery:
set up amount for standard shipping fee and return shipping fee (one-way)
● For fee on arrival:
Categories applicable for fee on arrival are predefined and shared with seller support center to guide vendors.
※ For [CONDITIONAL_FREE], you may freely set a conditional amount.

Standard delivery fee
Input one-way delivery fee amount for paid delivery and conditional free delivery

Conditional amount for free delivery
● Ex) if you want to set condition of at least 10,000 won for free delivery, set [deliveryChargeType] to 'CONDITIONAL_FREE' and input 10000 for [freeShipOverAmount].
※ must input 100 won units or more
※ input 0 for free delivery

Initial shipping fee on return
Shipping fee paid by customer for free delivery return

Remote area deliverability

Parameter Name	Status
Y	Yes
N	No

Bundled delivery availability

Parameter Name	Status
UNION_DELIVERY	Yes
NOT_UNION_DELIVERY	No

※ Condition for bundled delivery:
shipping location info mandatory (only products with same shipping location can be bundle delivered)
Cannot block paid on arrival option

Return location center code
Check after registering delivery location in Coupang Wing

Return location name
Check after registering delivery location in Coupang Wing

Return location contact number
Check after registering delivery location in Coupang Wing

Return location postal code
Check after registering delivery location in Coupang Wing

Return location address
Check after registering delivery location in Coupang Wing

Return location detail address
Check after registering delivery location in Coupang Wing

Return shipping fee
One-way delivery fee for picking up return product

Shipping location address code
Mandatory when selecting bundled delivery. Check by using shipping location query API

Actual user ID (Coupang Wing ID)
User ID affiliated to the vendor

Request for automatic approval Y/N

true
false

Vendor item option list

Auto-generated option (true or false)
In case of Auto-generated option, it is displayed as true.

Vendor item option name

Max order quantity per person
Maximum orderable quantity per person
Input '0' if unlimited
ex) If max. order quantity per person is set to 100, max. order quantity period set at 3, one person can buy up to 100 units within a 3-day period

Max order quantity period
Maximum period for buying max order quantity
Input '1' if unlimited
ex) If max. order quantity per person is set to 100, max. order quantity period set at 3, one person can buy up to 100 units within a 3-day period

Outbound shipping day (day)
Input how many days after order date (D-day) will the order be outbounded
ex) input '1' if outbound is next day (D+1)

Aged 19 or higher

Parameter Name	Status
ADULT_ONLY	Sold to customers aged 19 or higher
EVERYONE	Sold to all age groups (default)

Tax/Free

Parameter Name	Status
TAX	Tax (default)
FREE	Free

Parallel import Y/N

Parameter Name	Status
PARALLEL_IMPORTED	Parallel import
NOT_PARALLEL_IMPORTED	Not parallel import (default)

Overseas purchased Y/N

Parameter Name	Status
OVERSEAS_PURCHASED	Overseas purchased
NOT_OVERSEAS_PURCHASED	Not overseas purchased (default)

PCC(personal customs clearance code) needed Y/N
Whether PCC is required for overseas purchased products
default value: not required (false); must input PCC if value is 'true', not needed otherwise

Lowest price guaranteed Y/N
true/false

Vendor product option additional info
Can repeatedly input in Key : Value format as needed

Value

Product certification info
Product certification info

Product certification info type
You can find the appropriate type by using the category meta data query API. 
For categories that do not require certification: NOT_REQUIRED

Product certification info code 
Code issued by certification authority

Certification info attachments

The key of Map is fixed with below two and there is only one of them is needed:

1. vendorPath: if the image is not from Coupang CDN Server
2. cdnPath: if the image is already uploaded to Coupang CDN Server

 
Note: for registering mobile phone with category (displayCategoryCode = 62600, Consumer Electronics>Cell Phone/Tablet PC/Accessories>Cell Phone/Tablet PC>Cell Phone>Unregistered Phones), you can upload below files by setting image url in the attachments.

1. Mobile communication certificate
2. Certification mark

Example:
"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"
          }
         ]
       }
]

Keywords
Can input repeatedly as needed 
['keyword1','keyword2']

Image list
Can input repeatedly as needed

Image display order
0,1,2...

Image type
Representative image type
Can upload square image under 3MB in JPG, PNG format (min 500 x 500px, max 5000 x 5000px)
 
● Mandatory
REPRESENTATION : square main image
● Optional
DETAIL : other images (can upload up to 9 images)
USED_PRODUCT: used item condition image (can upload up to 4 images)

Coupang CDN path
Direct input if uploaded to Coupang CDN. At least one of vendorPath or cdnPath is required

Vendor image path
Image path used by vendor. If path starts with http://, it will be automatically downloaded and added to Coupang CDN. At least one of vendorPath or cdnPath is required

Product notice info list

Product notice info category name 
Input one of the product notice info category for each category

Product notice info category detail name

Content

Option list (attributes)
List of input attributes as predefined by each category level. You can only query attributes that have been input before approval. Once approved, you can query all attributes recommended to expose the relevant product in Coupang catalog. Attributes that are not input will be displayed as "" as its attributeValueName. Additionally, product attributes can be automatically extracted and added by the Coupang system. (refer to Response Example)

Attribute type name

Attribute value

Field for checking purchase option/search option 
EXPOSED : purchase option
NONE : search option

Field for checking editability 
true : editable
false : not editable

Contents list
Can repeatedly input as needed

Contents type

Parameter Name	Status
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

Detailed content list

Content

Detailed type

Parameter Name	Status
IMAGE	Image
TEXT	Text

Product condition
Cannot change offerCondition after product is created

Parameter Name	Mean
NEW	new item
REFURBISHED	refurbished item
USED_BEST	used item (best)
USED_GOOD	used item (good)
USED_NORMAL	used item (normal)

Used item detailed description
Describe condition of used item (max. 700 characters)
Can input only if offerCondition is input as used

Vendor item option ID

Auto-generated option (true or false)
In case of Auto-generated option, it is displayed as true.

Option ID
This value will be null if item is temporarily saved. It will be displayed after item is approved.

Barcode
Valid standard product code attached to product.

Reason for no barcode
max length: 100 characters

No barcode
True when there is no barcode

Vendor product code (vendor SKU code)
Can arbitrarily set vendor's unique item code value. This value will be included in PO query API response.

Model Number

Original base price for discount (list price)

Sale price

Whether it is a fragile product true or false

The default weight unit is g.

The default unit of net weight is g.

The default unit of width is mm.

The default unit of length is mm.

Height, the default unit is mm.

quantityPerBox should be 1 for Rocket Growth all the time.

Distribution period(in days) which should indicate that the product needs to be consumed within. This field is required for categories where “isExpirationDateRequiredForRocketGrowth = true” according to Category Metadata Query API

True if when we have distributionPeriod > 0

False if distributionPeriod = 0

Vendor item option list

Auto-generated option (true or false)
In case of Auto-generated option, it is displayed as true.

Option ID
This value will be null if item is temporarily saved. It will be displayed after item is approved.

Vendor product code (vendor SKU code)

Quantity available for sale
Input inventory quantity available for sale.
During "initial" product registration, available inventory can only be entered before product approval request. Once approved, available inventory count can be changed through [change option level quantity] API.
max value: 99999

Model Number

No barcode
True when there is no barcode

Barcode
Valid standard product code attached to product.

Reason for no barcode
max length: 100 characters

Original base price for discount (list price)

Sale price

Input if required documents are mandatory

Required document template name

Required document Coupang CDN path
At least one of documentPath or vendorDocumentPath is required

Required document vendor path
If required document path starts with http://, then it will be automatically downloaded and added to Coupang CDN. At least one of documentPath or vendorDocumentPath is required.

Message with information on made to orders
Message to be displayed when customers select delivery type "made to order"

This field indicates the Rocket Growth logistics information name as part of inbounding information.

Manufacturer