Name 

Required 

Type 

Description 

sellerProductId 

O 

Number 

Registered product ID 
Registered product ID displayed once product creation is complete (data) 

displayCategoryCode 

O 

Number 

Display category code 
Check by either using category list query API or downloading the category info excel. displayCategoryCode  
※ If you do not enter the displayCategoryCode, click here for the category auto matching service. 

After product is registered, sellers cannot modify it themselves 

sellerProductName 

O 

String 

Product name for registration 
Product name used for PO. 
max length: 100 characters 

vendorId 

O 

String 

VendorID 
Unique code issued to vendor by Coupang. Can be found in Wing after log-in. 

saleStartedAt 

O 

String 

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

saleEndedAt 

O 

String 

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

displayProductName 

String 

Product name for display 
Actual product name to be displayed on Coupang product detail page. 
[brand]+[generalProductName] format is encouraged. Product can still be registered with this field left empty. If left empty, either [brand]+[generalProductName] or [sellerProductName] format will be displayed instead. 
  
max length: 100 characters 

brand 

String 

Brand 
Input the official brand name in Korean/ English with no space in between and no special characters. 

generalProductName 

String 

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

productGroup 

String 

Product category 
Represents the product type. You may refer to display category's final leaf category name. No need to input this if identical with product name [generalProductName]. 

marketplaceShippingAndReturnInfo 

Delivery and return information are modifiable for Marketplace items only.  

deliveryMethod 

O 

String 

Delivery method 

 
For fresh food, you must select fresh frozen type, not normal delivery.  

deliveryCompanyCode 

O 

String 

Courier code 
link for courier code 

deliveryChargeType 

O 

String 

Delivery fee type 

 
● 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. 

deliveryCharge 

O 

Number 

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

freeShipOverAmount 

O 

Number 

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]. 
※ can only input in 100 won units or more 
※ input 0 for free delivery 

deliveryChargeOnReturn 

O 

Number 

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

remoteAreaDeliverable 

O 

String 

Remote area delivery possible or not 

unionDeliveryType 

O 

String 

Bundled delivery possible or not 

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

returnCenterCode 

O 

String 

Return location center code 
Extract and input return location center code after creating return location. 
● return location can be created through WING or return location creation API. 
● if you are unable to create return location, input "NO_RETURN_CENTERCODE" to manually add return location info. 
※ Auto return integration service (Goodsflow) is available only if you have a contracted courier. Return location center code is mandatory. 
※ For overseas shipping, you must input Korean return location address and the contracted courier code to generate return location center code. *overseas shipping return location guide (Click) 

returnChargeName 

O 

String 

Return location name 
Check on Coupang Wing or by registering return location through Return location query API. 
'query return location and input display value of shippingPlaceName' 

companyContactNumber 

O 

String 

Return location contact number 
Check on Coupang Wing or by registering return location through Return location query API 

returnZipCode 

O 

String 

Return location postal code 
Check on Coupang Wing or by registering return location through return location query API 

returnAddress 

O 

String 

Return location address 
Check on Coupang Wing or by registering return location through return location query API 

returnAddressDetail 

O 

String 

Return location detail address 
Check on Coupang Wing or by registering Return location through return location query API 

returnCharge 

O 

Number 

Return shipping fee 
One-way delivery fee for picking up return. 
*can only input value 100%-150% of initial shipping fee on return. 

outboundShippingPlaceCode 

O 

Number 

Shipping location address code 
Mandatory when selecting bundled delivery. Check by using shipping location query API. 
When selecting Overseas Purchasing Agency (AGENT_BUY), only overseas addresses can be entered. 

vendorUserId 

O 

String 

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

requested 

O 

Boolean 

Request for automatic approval or not 
Choose auto approve or not when registering a product 
● false : only save the uploaded contents and do not request for approval yet. (To start selling an item, you must request for sales through Wing or product approval request API) 
● true : save and automatically request approval for sales 

items 

O 

List 

Vendor item option list 
Can add up to max 200 options. 

itemName 

O  

String 

Vendor item option name 
Input for each item so that there is no overlap. 
This is not the option name displayed on the site and may change depending on the buying option. 
max length: 150 characters 

maximumBuyForPerson 

O  

Number 

Max order quantity per person 
Maximum quantity a person can order for that product.  
input '0' if no limit needs to be applied. 
ex) if max order quantity per person is set to 100 and max order quantity period is set at 3, then one person can buy maximum 100 for 3 days total. 

maximumBuyForPersonPeriod 

O  

Number 

Max order quantity period 
Time period for the max order quantity limit. 
input '1' if no time period needs to be applied. 
ex) if max order quantity per person is set to 100 and max order quantity period is set at 3, then one person can buy maximum 100 for 3 days total. 

outboundShippingTimeDay 

O  

Number 

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

unitCount 

O  

Number 

Unit count 
Input the number of units included in product. Then, (sale price ÷ unit count) will be calculated to display (price per 1 unit, #,000 won). Input '0' for products that don't need unit price. 

adultOnly 

O  

String 

19 or older 

taxType 

O  

String 

Taxable or not 

parallelImported 

O  

String 

Parallel import or not 

※ For parallel import products, Certificate of Import Declaration URL should be included when creating product - Guide on how to register (Click) 

overseasPurchased 

O  

String 

Overseas purchasing agency or not 

※ For purchasing agencies, invoice receipt URL should be included when creating product - How to register (Click)  

pccNeeded 

O  

Boolean 

PCC(personal customs clearance code) required or not 
In the case of overseas purchasing agency(AGENT_BUY), the product PCC must be entered as true. 
- default value: not required (false) 

extraProperties 

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

Key 

String 

Value 

certifications 

List 

Product certification info 
Product certification info 

certificationType 

String 

Certification info type 
Use Category meta data querying API to find the right type. 
For categories that do not require certification: NOT_REQUIRED 

certificationCode 

String 

Certification info code 
Code issued by certification authority. 

certificationAttachments 

List<Map<String,String>> 

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

searchTags 

List 

Keywords 
Can repeatedly input as much as needed. ["keyword1","keyword2"] 
Can input max 20 keywords with each max length of 20 characters. Cannot enter special characters aside from !@#$%^&*-+;:’.  

images 

O  

List 

Image list 
Can input repeatedly as much as needed. 

imageOrder 

O  

Number 

Image display order 
0,1,2... 

imageType 

O  

String 

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

cdnPath 

O  

String 

Coupang CDN path 
Directly input if uploaded to Coupang CDN. At least one of vendorPath or cdnPath is required. 
max length: 200 characters 

vendorPath 

O  

String 

Vendor image path 
Image path used by vendor. If path begins with http://, it will be automatically downloaded and added to Coupang CDN. At least one of vendorPath or cdnPath is required. 
Only 80, 443 port image path can be used. 
max length: 200 characters 

notices 

List 

Display info list 
Can check and choose necessary display info by  using Category meta data query API or the All categories list excel file. 

noticeCategoryName 

String 

Display info category name 
Input one of the product display info category for each category. 
Can check and choose necessary display info by  using Category meta data query API or the All categories list excel file. 

noticeCategoryDetailName 

String 

Display info category detail name 

content 

String 

Content 

attributes 

O  

List 

Option list (attributes) 
Object to input option list as predefined by each category level. 
Can input as many buying options as needed. 
Cannot be added if all values of buying option (attribute exposed) are the same. 
Mandatory to input at least one value. For attributes you don't prefer to input, either remove from attributes list or enter and send attributeValueName as "". 

attributeTypeName 

O  

String 

Option type name 
Can check and select the appropriate option type name by either using Category meta data query API or All category list excel file. 
max length: 25 characters 

attributeValueName 

O  

String 

Option value 
Input unit and the value corresponding to option type name [attributeTypeName] 
Ex) "200ml" 
max length: 30 characters 

contents 

O  

List 

Contents list 
Can input repeatedly as much as needed. 

contentsType 

O  

String 

Contents type 

contentDetails 

O  

List 

Detail content list 

content 

O  

String 

Content 

detailType 

O  

String 

Detailed type 

offerCondition 

String 

Product condition 
Cannot change offerCondition once product is created. 
Can choose from below values based on display category code. If left empty, it will be handled as NEW. 

offerDescription 

String 

Used item detailed description 
Describe condition of used item, max 700 characters. 
Can only write when offerCondition is entered as used. 

rocketGrowthItemData 

sellerProductItemId 

O 

Number 

Vendor item option ID 

vendorItemId 

O 

Number 

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

barcode 

String 

Barcode 
Valid standard product code attached to product. 

Modification for barcode is only enabled if inbound has not been created. If an inbound has been created, barcode information is not modifiable. 

emptyBarcodeReason 

String 

Modification for barcode is only enabled if inbound has not been created. If an inbound has been created, barcode information is not modifiable. 

Reason for no barcode 
max length: 100 characters 

If you would like to generate Coupang generated barcode, provide “AUTO_GENERATED” as reason 

emptyBarcode 

Boolean 

Modification for barcode is only enabled if inbound has not been created. If an inbound has been created, barcode information is not modifiable. 

externalVendorSku 

String 

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. 

May be passed as null 

modelNo

String 

Model Number 

May be passed as null

priceData 

O 

originalPrice 

O 

Number 

Original base price for discount (list price) 
Price before discount that is used to calculate discount rate (%). If same price with sale price is inputted, it will be displayed as "Coupang price". use [change option level original base price] API to change this post-approval. 

salePrice 

O 

Number 

Sale price 
Input sale price. 
During "initial" product registration, sale price can only be entered before product approval request. Once approved, sale price can be changed through [change option level price] API. 

skuInfo 

sku information is modifiable only until inbound creation. If inbound creation request is created, sku information cannot be modified.                     

During update, if skuInfo/barcode is not provided with the request, the skuInfo/barcode existing in Coupang database(if it exists) will be reused for the productId/itemId(s) in the request. 

fragile 

Boolean 

Whether it is a fragile product true or false 

weight 

Number 

The default weight unit is g. 

netWeight 

Number 

The default unit of net weight is g. 

width 

Number 

The default unit of width is mm. 

length 

Number 

The default unit of length is mm.  

height 

Number 

Height, the default unit is mm. 

quantityPerBox 

Number 

quantityPerBox should be 1 for Rocket Growth all the time. 

distributionPeriod 

Number 

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 

expiredAtManaged 

Boolean 

True if when we have distributionPeriod > 0 

False if distributionPeriod = 0 

marketplaceItemData 

sellerProductItemId 

O 

Number 

Vendor item option ID 

vendorItemId 

O 

Number 

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

externalVendorSku 

String 

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. 

maximumBuyCount 

Number

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

modelNo 

String 

Model Number 

emptyBarcode 

Boolean 

No barcode 
True when there is no barcode 

barcode 

String 

Barcode 
Valid standard product code attached to product. 

emptyBarcodeReason 

String 

Reason for no barcode 
max length: 100 characters 

priceData 

O 

originalPrice 

O 

Number 

Original base price for discount (list price) 
Price before discount that is used to calculate discount rate (%). If same price with sale price is inputted, it will be displayed as "Coupang price". use [change option level original base price] API to change this post-approval. 

salePrice 

O 

Number 

Sale price 
Input sale price. 
During "initial" product registration, sale price can only be entered before product approval request. Once approved, sale price can be changed through [change option level price] API. 

requiredDocuments 

List 

Input if required documents are mandatory 
Can input doc with file size up to 5MB (PDF, HWP, DOC, DOCX, TXT, PNG, JPG, JPEG) 

templateName 

String 

Required document template name 
Can check through Category meta data querying API 

documentPath 

String 

Required document Coupang CDN path 
At least one of documentPath or vendorDocumentPath is required. 
max length: 150 characters 

vendorDocumentPath 

String 

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. 
max length: 150 characters 

extraInfoMessage 

String 

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

manufacture 

String 

Manufacturer 
If cannot input exact manufacturer info, then input same info as [brand]. 

additionalInformationForRocketGrowth 

O 

 
 
 
rfmInboundName 

String 

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

legalAgreement 

O 

String 

This field indicates the Rocket Growth legal agreement for handling Rocket Growth products. Any value for this key other than "AGREE" would result in no action taken.