coupang
API Documentation
ProductsCategoriesBrandsShipments & OrdersReturnsExchangesPromotions & CouponsLogistics InfoCustomer ServiceSettlementCGF / CGF liteRocket Growth
POST/v2/providers/seller_api/apis/api/v1/marketplace/seller-productsv1

Product Creation (Rocket Growth & Rocket Growth/Marketplace Hybrid Products)

# 01

Summary

Available buyer market: Korean API to register products sold on Coupang.

# 02

Details

Available buyer market: Korean
API to register products sold on Coupang.
 
In case of Rocket Growth product creation, to successfully call the API, first go to WING platform > seller information menu > additional information menu > "OPEN API key issuance" area and click "Agree to use and review criteria for Rocket Growth product creation API" on the right side to consent and then use.
 
If you use the Marketplace product creation API, you can create Rocket Growth products or Rocket Growth & Marketplace hybrid products with the same endpoint, but you must use the new schema in this document. You can refer to the green text for the parameters added/changed in the existing product creation API. If you add a Rocket Growth product to an existing Marketplace product, you can add it using the product modification API.
 
In order to create a product, you must include information such as shipping/return locations, category, koshi info, option info that complies to Coupang's guides.
Please download the product registration guide below for further details:
[Download] Coupang OPENAPI Product Registration Guide

 

Path

POST

/v2/providers/seller_api/apis/api/v1/marketplace/seller-products

Example Endpoint

https://api-gateway.coupang.com/v2/providers/seller_api/apis/api/v1/marketplace/seller-products

Request Parameters

Body Parameter

Name Required Type Description
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.
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.
brandId   String Brand ID associated with the product. Returned when brand information exists.
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 is required for creating Marketplace items. As for Rocket Growth, Coupang delivers and receive returns and hence this information may be null for creating Rocket Growth listing only.
deliveryMethod O String

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

 
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

Parameter Name Status
FREE free delivery
NOT_FREE paid delivery
CHARGE_RECEIVED fee on arrival
CONDITIONAL_FREE conditional free 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.

 
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

Parameter Name Status
Y remote area delivery possible
N remote area delivery not possible

 
unionDeliveryType O String

Bundled delivery possible or not

Parameter Name Status
UNION_DELIVERY bundled delivery possible
NOT_UNION_DELIVERY bundled delivery not possible

 
※ 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

Parameter Name Status
ADULT_ONLY product sold to age 19 or older
EVERYONE product buyable by all ages (default value)

 
taxType O  String

Taxable or not

Parameter Name Status
TAX taxable (default value)
FREE non-taxable

 
parallelImported O  String

Parallel import or not

Parameter Name Status
PARALLEL_IMPORTED parallel import
NOT_PARALLEL_IMPORTED not parallel import (default value)

※ 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

Parameter Name Status
OVERSEAS_PURCHASED overseas purchasing agency
NOT_OVERSEAS_PURCHASED not overseas purchasing agency(default value)

※ 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)

true Customer can buy after entering PCC (PCC is included in PO) 
false Customer can buy without entering PCC

 
 

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

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

 
contentDetails O  List Detail content list
content O  String Content
detailType O  String

Detailed type

Parameter Name Status
IMAGE image
TEXT text

 
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.

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

 
offerDescription String Used item detailed description 
Describe condition of used item, max 700 characters. 
Can only write when offerCondition is entered as used.
rocketGrowthItemData O All parameters of this object are required, except external VendorSku, ModelNo. If requesting sku creation of Rocket Growth items or for both Rocket Growth and Marketplace items. If the request is for creating Marketplace item only, these parameters should be null.
barcode String

Barcode 
Valid standard product code attached to product.

 

Below cases are considered valid barcode:

  • Does not have lower case 
  • Barcode is no longer than 19 digits (8, 12, 13, 14, 18 digits are allowed)
  • No DoubleSpaces
  • No spaces before and after characters
emptyBarcodeReason String

Reason for no barcode 
max length: 100 characters

 

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

If sku information will be provided through Create Product API, barcode should be provided as required information

 

Parameter Name Meaning

TRUE

 

 No sku information will be provided
FALSE or null No barcode information. Please provide “AUTO_GENERATED”  under “emptyBarcodeReason” item to generate Coupang barcode

 
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

This is an optional object when requesting item creation. These information may be provided during item creation or when creating inbound(currently this service is available on Wing). If chosen to provide sku information during item creation, all parameters under this object are required and partial information will lead to error.

 

If you decide to provide skuInfo, “additionalInformationForRocketGrowth” > “rfmInboundName” item is a required information. If skuInfo has values and no “rfmInboundName” it will lead to error.

 
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 O Parameters of this object are required if requesting creation of Marketplace items or for both Rocket Growth and Marketplace items. If the request is for creating Rocket Growth item only, these parameters should be null.
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.

 

If you decide to provide “skuInfo”, this is a required information. If skuInfo has values and no “rfmInboundName” it will lead to error.

 		 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 error. All Rocket Growth item creation requires consent information on policy. See the policy below.

 

Consent for Rocket Growth Inspection

  1. The products below cannot be handled by Rocket Growth and cannot be stored in the warehouse of Coupang Fulfillment Service (CFS).
  • Fresh/refrigerated/frozen food group, food
  • Product groups for which separate handling/storage/display standards are set by individual laws, including the cases below

a. Products containing ‘target chemical substances’ subject to the obligation to provide and post MSDS (Material Safety Data Sheet) and education under the Occupational Safety and Health Act, etc.

b. Products that fall under the Chemical Substances Control Act (toxic substances, permitted substances, restricted substances, prohibited substances, accident preparation substances, and other chemicals that are or are likely to be harmful or dangerous)

c. Products managed by the Dangerous Substances Safety Management Act include diffusers, air fresheners, hand sanitizers, deodorants, detergents, engine oil, oil-based paints, fuel additives, liquid cleaners, pesticides, liquid cigarettes, etc., which have a high content index of flammable and combustible chemical ingredients.

d. Products managed by the High Pressure Gas Safety Management Act

1.  Products of Compressed gas (e.g., CO2, N2, carbon dioxide, nitrogen, compressed gas, helium, etc.) whose pressure (referring to gauge pressure; hereinafter the same) is more than 1 megapascal at commercial temperature, and that the pressure is actually Compressed gas (excluding acetylene gas) with a pressure of 1 megapascal or more at a temperature of 35 degrees Celsius, and liquefied gas with a pressure of 0.2 megapascal or more (e.g. LPG, liquefied natural gas, DME, etc.) 

2.  Acetylene gas whose pressure exceeds 0 Pascal at a temperature of 15 degrees Celsius

3.   Liquefied gas whose pressure is 0.2 megapascal or more at commercial temperature, which actually has a pressure of 0.2 megapascal or more, or liquefied gas whose temperature when the pressure is 0.2 megapascal is 35 degrees Celsius or less.

4.  Among liquefied gases whose pressure exceeds 0 Pascal at a temperature of 35 degrees Celsius, liquefied hydrogen cyanide, liquefied brominated methane and liquefied ethylene oxide gas

e. Products corresponding to guns, swords, gunpowder, spray guns, electric shock guns, crossbows, etc. according to the Firearms and Explosives Act

f. Medical devices that need to be maintained at a certain temperature (e.g. refrigerated, frozen storage) in accordance with medical device distribution quality management standards

  • When the sum of width + length + height (including packaging materials) exceeds 250cm or the weight exceeds 30kg for one individually sold unit product
  • Installation delivery product that requires a customer visit
  • Products that do not comply with other relevant legal regulations (e.g. violation of the Act on Labeling and Advertising of Food, etc. and violation of expiration date/consumption date labeling)

2. Even if the product is eligible for Coupang Fulfillment Service (CFS), it may be returned if it does not meet the inspection standards below.

  • If the appearance of the product is different for each option due to differences in color, capacity, length, etc., the representative image of the product must be registered for each option.
  • During the inspection phase of Coupang Fulfillment Service, the actual product received is compared with the product information registered by the seller on Wing. At this time, the product name, option name, and representative product image must be visible in person.
  • The stock of products that can melt or change shape due to temperature, such as chocolate, candy, jelly, candles, etc., is limited in the summer season (July to September). When the product is in stock, the product can be returned or taken out, and if unavoidable, it can be disposed of at the Coupang Fulfillment Service warehouse. In this case, costs incurred for return, removal, and disposal may be charged to the seller.
  • Temperature-sensitive products that can melt, change shape, or deteriorate depending on temperature (nuts, tea, processed cocoa products, chocolate, jelly, pudding, some candies, candles, grains, and others) are restricted from being stocked. Sellers are responsible for checking whether the product is a temperature-sensitive product type before requesting stock, and stocking of temperature-sensitive products may be restricted. Damage due to the temperature sensitivity of the product is not separately compensated, and temperature-sensitive products may be returned or taken out if unavoidable reasons such as damage occur, and the costs incurred for this may be charged to the seller.
  • In addition, you must comply with the warehousing manual separately distributed by Coupang Fulfillment Service.

3. You must classify the product into the correct category and accurately register all information about the product.

  • Coupang's categories are provided solely for reference by sellers. Sellers must accurately classify their products in accordance with the law and make sure that they are products that can be sold on Rocket Growth before registering them.

All damages and liabilities arising from registration/storage/sale of products that do not comply with the above standards (including shipping/delivery costs, damages to Coupang Fulfillment Service and its affiliates, and all legal liabilities, including administrative measures and criminal punishment, but not limited to this) confirms that the seller holds the responsibility.

 

Request Example

Rocket Growth Only Product

{

    "vendorId": "A00012345",

    "vendorUserId": "vendor1234",

    "displayCategoryCode": 69515,

    "brand": "brandname",

    "manufacture": "sadf",

    "sellerProductName": "test openapi rg only",

    "displayProductName": "test openapi rg only",

    "generalProductName": "test openapi rg only",

    "saleStartedAt": "2024-04-24T13:15:10",

    "saleEndedAt": "2099-12-30T07:00:00",

    "items":

    [

        {

            "images":

            [

                {

                    "imageOrder": 0,

                    "imageType": "REPRESENTATION",

                    "vendorPath": "vendor_inventory/3f2d/3761ff43e340428f448570409a373b21976fe051a954b3f4bbc18ef69e96.jpeg"

                }

            ],

            "offerDescription": "",

            "contents":

            [

                {

                    "contentsType": "HTML",

                    "contentDetails":

                    [

                        {

                            "content": "<p>asdf</p>",

                            "detailType": "TEXT"

                        }

                    ]

                }

            ],

            "itemName": "s",

            "attributes":

            [

                {

                    "attributeTypeName": "패션의류/잡화 사이즈",

                    "attributeValueName": "s"

                }

            ],

            "notices":

            [

                {

                    "noticeCategoryName": "기타 재화",

                    "noticeCategoryDetailName": "품명 및 모델명",

                    "content": "first"

                },

                {

                    "noticeCategoryName": "기타 재화",

                    "noticeCategoryDetailName": "인증사항",

                    "content": "second"

                },

                {

                    "noticeCategoryName": "기타 재화",

                    "noticeCategoryDetailName": "제조국(원산지)",

                    "content": "third"

                },

                {

                    "noticeCategoryName": "기타 재화",

                    "noticeCategoryDetailName": "제조자(수입자)",

                    "content": "fourth"

                },

                {

                    "noticeCategoryName": "기타 재화",

                    "noticeCategoryDetailName": "소비자상담 관련 전화번호",

                    "content": "fifth"

                }

            ],

            "maximumBuyForPerson": 0,

            "maximumBuyForPersonPeriod": 1,

            "certifications":

            [

                {

                    "certificationType": "NOT_REQUIRED",

                    "certificationCode": ""

                }

            ],

            "taxType": "TAX",

            "adultOnly": "EVERYONE",

            "parallelImported": "NOT_PARALLEL_IMPORTED",

            "pccNeeded": false,

            "outboundShippingTimeDay": "1",

            "searchTags":

            [

                "tag1",

                "tag2"

            ],

            "overseasPurchased": "NOT_OVERSEAS_PURCHASED",

            "offerCondition": "NEW",

            "unitCount": 1,

            "rocketGrowthItemData": {

                 "barcode": "DEFG123456781",

                 "externalVendorSku": "DUMMY_EXT_SKU"

                 "modelNo": "DUMMY_MODEL_NO"

                 "skuInfo":

              {

                "fragile": false,

                "weight": 1042,

                "netWeight": 937,

                "leadTime": null,

                "width": 341,

                "length": 365,

                "height": 141,

                "quantityPerBox": 1,

                "distributionPeriod": 400,

                "expiredAtManaged": true

            },

                "priceData": {

                    "salePrice": 900000000,

                    "originalPrice": 0 

                }

            }

        },

        {

            "images":

            [

                {

                    "imageOrder": 0,

                    "imageType": "REPRESENTATION",

                    "vendorPath": "vendor_inventory/3f2d/3761ff43e340428f448570409a373b21976fe051a954b3f4bbc18ef69e96.jpeg"

                }

            ],

            "offerDescription": "",

            "contents":

            [

                {

                    "contentsType": "HTML",

                    "contentDetails":

                    [

                        {

                            "content": "<p>asdf</p>",

                            "detailType": "TEXT"

                        }

                    ]

                }

            ],

            "itemName": "m",

            "attributes":

            [

                {

                    "attributeTypeName": "패션의류/잡화 사이즈",

                    "attributeValueName": "m"

                }

            ],

            "notices":

            [

                {

                    "noticeCategoryName": "기타 재화",

                    "noticeCategoryDetailName": "품명 및 모델명",

                    "content": "first"

                },

                {

                    "noticeCategoryName": "기타 재화",

                    "noticeCategoryDetailName": "인증사항",

                    "content": "second"

                },

                {

                    "noticeCategoryName": "기타 재화",

                    "noticeCategoryDetailName": "제조국(원산지)",

                    "content": "third"

                },

                {

                    "noticeCategoryName": "기타 재화",

                    "noticeCategoryDetailName": "제조자(수입자)",

                    "content": "fourth"

                },

                {

                    "noticeCategoryName": "기타 재화",

                    "noticeCategoryDetailName": "소비자상담 관련 전화번호",

                    "content": "fifth"

                }

            ],

            "maximumBuyForPerson": 0,

            "maximumBuyForPersonPeriod": 1,

            "certifications":

            [

                {

                    "certificationType": "NOT_REQUIRED",

                    "certificationCode": ""

                }

            ],

            "taxType": "TAX",

            "adultOnly": "EVERYONE",

            "parallelImported": "NOT_PARALLEL_IMPORTED",

            "pccNeeded": false,

            "outboundShippingTimeDay": "1",

            "searchTags":

            [

                "tag1",

                "tag2"

            ],

            "overseasPurchased": "NOT_OVERSEAS_PURCHASED",

            "offerCondition": "NEW",

            "unitCount": 1,

            "rocketGrowthItemData": {

                 "barcode": "ABCD234567881",

                 "externalVendorSku": "DUMMY_EXT_SKU_1"

                 "modelNo": "DUMMY_MODEL_NO_1"

                 "skuInfo":

              {

                "fragile": false,

                "weight": 1042,

                "netWeight": 937,

                "leadTime": null,

                "width": 341,

                "length": 365,

                "height": 141,

                "quantityPerBox": 1,

                "distributionPeriod": 400,

                "expiredAtManaged": true

            },

                "priceData": {

                    "salePrice": 900000000,

                    "originalPrice": 0 

                }

            }

        }

    ],

    "requiredDocuments":

    [

        {

            "templateName": "기타인증서류",

            "documentPath": "vendor_inventory/documents/2024/04/25/5/6/8116774a-896c-4482-a6a3-6f6c4329eccb.png",

            "vendorDocumentPath": "images.png"

        }

    ],

    "rocketGrowthAdditionalInformation":

    {

        "rfmInboundName": "test product",

        "legalAgreement": "AGREE"

    },

    "requested": true

}

Rocket Growth/Marketplace Hybrid Product

{

    "vendorId": "A00012345",

    "vendorUserId": "vendor1234",

    "displayCategoryCode": 69515,

    "brand": "brandname",

    "manufacture": "sadf",

    "sellerProductName": "test openapi hybrid product",

    "displayProductName": "test  openapi hybrid product",

    "generalProductName": "test  openapi hybrid product",

    "saleStartedAt": "2024-04-24T13:15:10",

    "saleEndedAt": "2099-12-30T07:00:00",

    "items":

    [

        {

            "images":

            [

                {

                    "imageOrder": 0,

                    "imageType": "REPRESENTATION",

                    "vendorPath": "vendor_inventory/3f2d/3761ff43e340428f448570409a373b21976fe051a954b3f4bbc18ef69e96.jpeg"

                }

            ],

            "offerDescription": "",

            "contents":

            [

                {

                    "contentsType": "HTML",

                    "contentDetails":

                    [

                        {

                            "content": "<p>asdf</p>",

                            "detailType": "TEXT"

                        }

                    ]

                }

            ],

            "itemName": "s",

            "attributes":

            [

                {

                    "attributeTypeName": "패션의류/잡화 사이즈",

                    "attributeValueName": "s"

                }

            ],

            "notices":

            [

                {

                    "noticeCategoryName": "기타 재화",

                    "noticeCategoryDetailName": "품명 및 모델명",

                    "content": "first"

                },

                {

                    "noticeCategoryName": "기타 재화",

                    "noticeCategoryDetailName": "인증사항",

                    "content": "second"

                },

                {

                    "noticeCategoryName": "기타 재화",

                    "noticeCategoryDetailName": "제조국(원산지)",

                    "content": "third"

                },

                {

                    "noticeCategoryName": "기타 재화",

                    "noticeCategoryDetailName": "제조자(수입자)",

                    "content": "fourth"

                },

                {

                    "noticeCategoryName": "기타 재화",

                    "noticeCategoryDetailName": "소비자상담 관련 전화번호",

                    "content": "fifth"

                }

            ],

            "maximumBuyForPerson": 0,

            "maximumBuyForPersonPeriod": 1,

            "certifications":

            [

                {

                    "certificationType": "NOT_REQUIRED",

                    "certificationCode": ""

                }

            ],

            "taxType": "TAX",

            "adultOnly": "EVERYONE",

            "parallelImported": "NOT_PARALLEL_IMPORTED",

            "pccNeeded": false,

            "outboundShippingTimeDay": "1",

            "searchTags":

            [

                "tag1",

                "tag2"

            ],

            "overseasPurchased": "NOT_OVERSEAS_PURCHASED",

            "offerCondition": "NEW",

            "unitCount": 1,

            "rocketGrowthItemData": {

                 "barcode": "DEF012345678",

                 "externalVendorSku": "DUMMY_EXT_SKU_1"

                 "modelNo": "DUMMY_MODEL_NO_1",

                 "skuInfo":

              {

                "fragile": false,

                "weight": 1042,

                "netWeight": 937,

                "leadTime": null,

                "width": 341,

                "length": 365,

                "height": 141,

                "quantityPerBox": 1,

                "distributionPeriod": 400,

                "expiredAtManaged": true

            },

                "priceData": {

                    "salePrice": 900000000,

                    "originalPrice": 0 

                }

            },

            "marketplaceItemData": {

                 "externalVendorSku": "DUMMY_EXT_SKU_2"

                 "modelNo": "DUMMY_MODEL_NO_2",

                 "maximumBuyCount": "10,

                "priceData": {

                    "salePrice": 900000000,

                    "originalPrice": 0

                }

            }

        },

                {

            "images":

            [

                {

                    "imageOrder": 0,

                    "imageType": "REPRESENTATION",

                    "vendorPath": "vendor_inventory/3f2d/3761ff43e340428f448570409a373b21976fe051a954b3f4bbc18ef69e96.jpeg"

                }

            ],

            "offerDescription": "",

            "contents":

            [

                {

                    "contentsType": "HTML",

                    "contentDetails":

                    [

                        {

                            "content": "<p>asdf</p>",

                            "detailType": "TEXT"

                        }

                    ]

                }

            ],

            "itemName": "m",

            "attributes":

            [

                {

                    "attributeTypeName": "패션의류/잡화 사이즈",

                    "attributeValueName": "m"

                }

            ],

            "notices":

            [

                {

                    "noticeCategoryName": "기타 재화",

                    "noticeCategoryDetailName": "품명 및 모델명",

                    "content": "first"

                },

                {

                    "noticeCategoryName": "기타 재화",

                    "noticeCategoryDetailName": "인증사항",

                    "content": "second"

                },

                {

                    "noticeCategoryName": "기타 재화",

                    "noticeCategoryDetailName": "제조국(원산지)",

                    "content": "third"

                },

                {

                    "noticeCategoryName": "기타 재화",

                    "noticeCategoryDetailName": "제조자(수입자)",

                    "content": "fourth"

                },

                {

                    "noticeCategoryName": "기타 재화",

                    "noticeCategoryDetailName": "소비자상담 관련 전화번호",

                    "content": "fifth"

                }

            ],

            "maximumBuyForPerson": 0,

            "maximumBuyForPersonPeriod": 1,

            "certifications":

            [

                {

                    "certificationType": "NOT_REQUIRED",

                    "certificationCode": ""

                }

            ],

            "taxType": "TAX",

            "adultOnly": "EVERYONE",

            "parallelImported": "NOT_PARALLEL_IMPORTED",

            "pccNeeded": false,

            "outboundShippingTimeDay": "1",

            "searchTags":

            [

                "tag1",

                "tag2"

            ],

            "overseasPurchased": "NOT_OVERSEAS_PURCHASED",

            "offerCondition": "NEW",

            "unitCount": 1,

            "rocketGrowthItemData": {

                 "barcode": "ABC123456788",

                 "externalVendorSku": "DUMMY_EXT_SKU_3"

                 "modelNo": "DUMMY_MODEL_NO_3",

                 "skuInfo":

              {

                "fragile": false,

                "weight": 1042,

                "netWeight": 937,

                "leadTime": null,

                "width": 341,

                "length": 365,

                "height": 141,

                "quantityPerBox": 1,

                "distributionPeriod": 400,

                "expiredAtManaged": true

            },

                "priceData": {

                    "salePrice": 900000000,

                    "originalPrice": 0 

                }

            },

            "marketplaceItemData": {

                 "externalVendorSku": "DUMMY_EXT_SKU_4"

                 "modelNo": "DUMMY_MODEL_NO_4",

                 "maximumBuyCount": "10,

                "priceData": {

                    "salePrice": 900000000,

                    "originalPrice": 0

                }

            }

        }

    ],

    "requiredDocuments":

    [

        {

            "templateName": "기타인증서류",

            "documentPath": "vendor_inventory/documents/2024/04/25/5/6/8116774a-896c-4482-a6a3-6f6c4329eccb.png",

            "vendorDocumentPath": "images.png"

        }

    ],

    "rocketGrowthAdditionalInformation":

    {

        "rfmInboundName": "test product",

        "legalAgreement": "AGREE"

    },

    "marketplaceShippingAndReturnInfo": {

        "deliveryMethod": "SEQUENCIAL",

        "deliveryCompanyCode": "HYUNDAI",

        "deliveryChargeType": "FREE",

        "deliveryCharge": 0,

        "freeShipOverAmount": 0,

        "remoteAreaDeliverable": "Y",

        "unionDeliveryType": "UNION_DELIVERY",

        "outboundShippingPlaceCode": 63714,

        "extraInfoMessage": "",

        "returnCenterCode": "NO_RETURN_CENTERCODE",

        "returnChargeName": "지모스(쿠팡)",

        "companyContactNumber": "031-297-9758",

        "returnZipCode": "18335",

        "returnAddress": "경기도 화성시 봉담읍 복만터길72번길 48",

        "returnAddressDetail": "나동 202호",

        "returnCharge": 3000,

        "deliveryChargeOnReturn": 3000

    },

    "requested": true

}

 

Response Message

Name Type Description
code String
result code
SUCCES/ERROR
message String
message
data Long
registered product ID
=sellerProductId
 

Error Spec 

New Error Messages

Http Status Code 
(error type ) 		Error message Resolution
400

등록상품명에 허용하지 않는 특수문자가 존재합니다.

노출상품명에 허용하지 않는 특수문자가 존재합니다.

 

SellerProductName have not allowed special characters.

DisplayProductName have not allowed special charaters.

displayProductName and sellerProductName

 

only Allow English, Korean, Number, space and these few of special characters.

 

!@#$%^&*()_+=-][{}';:\"/.,<>?~㈜®|°。×
400

중복된 바코드가 존재합니다.

Duplicate barcode exist.

Can’t reuse barcode on different item.

Fill other barcode or use auto-generate Coupang barcode.
400

입고를 생성하신 이후에는 물류(SKU)정보를 변경하실 수 없습니다.

After create inbound, skuInfo can’t modify.

 After inbound, sku info can’t modify. If need, please contact support team.
400

누락된 물류정보가 있습니다. 기존 등록된 SKU정보나 변경하실 SKU정보를 입력하여 다시 수정을 요청하세요.

 

Missed skuInfo exist. Modify request  again with exist skuInfo or modify skuInfo.

Some of values missed on sku info field. Please fill this filed. And also, sku info can’t remove.

 
400

로켓그로스 입고 불가(검수) 조건을 확인하시고 동의해주세요. 동의하지 않으면 로켓그로스 상품등록을 할 수 없습니다.

 

Please check Rocket Growth inbound prohibit condition and do legal agreement. If not, can’t register rocketGrowth product.

 RocketGrowthAdditionalInformation.legalAgreement is required field.
400

판매중인 상품은 삭제할 수 없습니다.

 

Sales product can’t delete.

 Some of id( vendorItemId, sellerProductItmeId ) are missed. Please check these value.

 

Existing Error Messages

HTTP status code (error type) Error message Solution
400 (check request parameter) The value of attributeValueName is incorrect. Please enter the acceptable values as following the error spec guide

Please check if it is a diaper step that can be entered.
Only the following values can be entered, and up to one value per one inventory ID can be newly entered.

1단계, 2단계, 3단계, 4단계, 5단계, 6단계, 7단계, 신생아(NB), 소형(S), 중형(M), 대형(L), 특대형(XL), 점보형(2XL), 점보형 이상(3XL)
400 (check request parameter) Cannot find mandatory attributes for category. Error occurs when mandatory attribute value is left out. Need to input mandatory attribute by checking with Category meta data query API.
400 (check request parameter) Input value error. line: 123 Need to check if appropriate parameter, value and array format has been entered for the corresponding line in request JSON message.
400 (check request parameter) Please input correct return location center code. Check shipping location and return location query API to see if appropriate shipping and return location codes were entered.
400 (check request parameter) java.lang.NullPointerException Need to check for typos in requested JSON message.
400 (check request parameter) Mandatory display info (such as manufacturer and supplier) and info provided through category (such as cosmetics) are different. Error when there is problem with display info. Need to query Category display meta data and check if it's identical to the display info (("notices": []) you've entered.
400 (check request parameter) If delivery type is free shipping for purchases of 19800 and above, then conditional free is 19800 won with initial delivery fee of 0 won. When using freeShipOverAmount:19800  setting, need to check if initial delivery fee (deliveryChargeOnReturn) value has been set to '0'.
400 (check request parameter) check [courier code]. When using remote area shipping, can only input registered courier for (remoteAreaDeliverable : "Y") shipping location. 
400 (check request parameter) UNAUTHORIZATION Error caused by incorrect authorization info. Please check if appropriate authorization has been made. 
400 (check request parameter) Please check the delivery method. If you select overseas purchasing agency(AGENT_BUY), check if the shipping address is an overseas shipping address. It is not possible to select a domestic(Korean) delivery address.
400 (check request parameter) If the delivery method is a purchasing agent(AGENT_BUY), Coupang makes it mandatory for customers to enter PCCC for delivery. If you select overseas purchasing agency(AGENT_BUY), check that the pccNeeded parameter value is set to true.

 

 

※ Caution

 "code": "SUCCESS"

 After you received message that product has been successfully created, we advise you to use [Product list section query API] or WING to check if product status is 'approved'. 

  • If status is 'approval rejected', please check the rejection reason and resend after applying changes. 
  • You may find 'approval rejected' reasons in WING's status change history or by using [Product status change history query API]. 

※ Please limit your API calls for Product creation and modification APIs to no more than 10 per second.

 

URL API Name

CREATE_PRODUCT