Using 'product query API', edit only the value you wish to modify from the JSON message queried and then send the entire JSON message to make for quick modification.
- update/modify option : Insert [sellerProductItemId] and [vendorItemId] at the top of the option item you want to update and modify it to [attributeValueName] and then send
- delete option : Delete value of item you wish to remove (i.e., from an array of items/options) and insert [sellerProductItemId] at the top of the item you wish to keep and then send. (an option that had a record of having been 'approved' cannot be deleted)
- add option : Don't enter [sellerProductItemId] and send by adding items array
※ [sellerProductItemId] can by checked by using Product Query API
※ When it comes to selling price, inventory qty, sale status, and base price for discount rate of item that has been approved, modification can be done not through Product Modification API but via [Change qty/price/on sale or not/base price for discount rate by item] API
Path
PUT
/v2/providers/seller_api/apis/api/v1/marketplace/seller-products
Example Endpoint
PUT https://api-gateway.coupang.com/v2/providers/seller_api/apis/api/v1/marketplace/seller-products
Request Parameters
Body Parameter
Name |
Required |
Type |
Description |
|||||||||||||||||||||||
sellerProductId |
O |
Number |
Registered product ID |
|||||||||||||||||||||||
displayCategoryCode |
O |
Number |
Display category code After product is registered, sellers cannot modify it themselves |
|||||||||||||||||||||||
sellerProductName |
O |
String |
Product name for registration |
|||||||||||||||||||||||
vendorId |
O |
String |
VendorID |
|||||||||||||||||||||||
saleStartedAt |
O |
String |
Starting date of sales |
|||||||||||||||||||||||
saleEndedAt |
O |
String |
Ending date of sales |
|||||||||||||||||||||||
displayProductName |
|
String |
Product name for display |
|||||||||||||||||||||||
brand |
|
String |
Brand |
|||||||||||||||||||||||
generalProductName |
|
String |
Product name |
|||||||||||||||||||||||
productGroup |
|
String |
Product category |
|||||||||||||||||||||||
marketplaceShippingAndReturnInfo |
|
|
Delivery and return information are modifiable for Marketplace items only. |
|||||||||||||||||||||||
|
deliveryMethod |
O |
String |
Delivery method
|
||||||||||||||||||||||
|
deliveryCompanyCode |
O |
String |
Courier code |
||||||||||||||||||||||
|
deliveryChargeType |
O |
String |
Delivery fee type
|
||||||||||||||||||||||
|
deliveryCharge |
O |
Number |
Standard delivery fee |
||||||||||||||||||||||
|
freeShipOverAmount |
O |
Number |
Conditional amount for free delivery |
||||||||||||||||||||||
|
deliveryChargeOnReturn |
O |
Number |
Initial shipping fee on return |
||||||||||||||||||||||
|
remoteAreaDeliverable |
O |
String |
Remote area delivery possible or not
|
||||||||||||||||||||||
|
unionDeliveryType |
O |
String |
Bundled delivery possible or not
|
||||||||||||||||||||||
|
returnCenterCode |
O |
String |
Return location center code |
||||||||||||||||||||||
|
returnChargeName |
O |
String |
Return location name |
||||||||||||||||||||||
|
companyContactNumber |
O |
String |
Return location contact number |
||||||||||||||||||||||
|
returnZipCode |
O |
String |
Return location postal code |
||||||||||||||||||||||
|
returnAddress |
O |
String |
Return location address |
||||||||||||||||||||||
|
returnAddressDetail |
O |
String |
Return location detail address |
||||||||||||||||||||||
|
returnCharge |
O |
Number |
Return shipping fee |
||||||||||||||||||||||
|
outboundShippingPlaceCode |
O |
Number |
Shipping location address code |
||||||||||||||||||||||
vendorUserId |
O |
String |
Actual user ID (Coupang Wing ID) |
|||||||||||||||||||||||
requested |
O |
Boolean |
Request for automatic approval or not |
|||||||||||||||||||||||
items |
O |
List |
Vendor item option list |
|||||||||||||||||||||||
|
itemName |
O |
String |
Vendor item option name |
||||||||||||||||||||||
|
maximumBuyForPerson |
O |
Number |
Max order quantity per person |
||||||||||||||||||||||
|
maximumBuyForPersonPeriod |
O |
Number |
Max order quantity period |
||||||||||||||||||||||
|
outboundShippingTimeDay |
O |
Number |
Outbound shipping days (day) |
||||||||||||||||||||||
|
unitCount |
O |
Number |
Unit count |
||||||||||||||||||||||
|
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
|
||||||||||||||||||||||
|
extraProperties |
|
|
Vendor product option additional info. |
||||||||||||||||||||||
|
|
Key |
|
String |
Value |
|||||||||||||||||||||
|
certifications |
|
List |
Product certification info |
||||||||||||||||||||||
|
|
certificationType |
|
String |
Certification info type |
|||||||||||||||||||||
|
|
certificationCode |
|
String |
Certification info code |
|||||||||||||||||||||
|
|
certificationAttachments |
|
List<Map<String,String>> |
Certification info attachments Example: |
|||||||||||||||||||||
|
searchTags |
|
List |
Keywords |
||||||||||||||||||||||
|
images |
O |
List |
Image list |
||||||||||||||||||||||
|
|
imageOrder |
O |
Number |
Image display order |
|||||||||||||||||||||
|
|
imageType |
O |
String |
Image type |
|||||||||||||||||||||
|
|
cdnPath |
O |
String |
Coupang CDN path |
|||||||||||||||||||||
|
|
vendorPath |
O |
String |
Vendor image path |
|||||||||||||||||||||
|
notices |
|
List |
Display info list |
||||||||||||||||||||||
|
|
noticeCategoryName |
|
String |
Display info category name |
|||||||||||||||||||||
|
|
noticeCategoryDetailName |
|
String |
Display info category detail name |
|||||||||||||||||||||
|
|
content |
|
String |
Content |
|||||||||||||||||||||
|
attributes |
O |
List |
Option list (attributes) |
||||||||||||||||||||||
|
|
attributeTypeName |
O |
String |
Option type name |
|||||||||||||||||||||
|
|
attributeValueName |
O |
String |
Option value |
|||||||||||||||||||||
|
contents |
O |
List |
Contents list |
||||||||||||||||||||||
|
|
contentsType |
O |
String |
Contents type
|
|||||||||||||||||||||
|
|
contentDetails |
O |
List |
Detail content list |
|||||||||||||||||||||
|
|
|
content |
O |
String |
Content |
||||||||||||||||||||
|
|
|
detailType |
O |
String |
Detailed type
|
||||||||||||||||||||
|
offerCondition |
|
String |
Product condition
|
||||||||||||||||||||||
|
offerDescription |
|
String |
Used item detailed description |
||||||||||||||||||||||
|
rocketGrowthItemData |
|
|
|
||||||||||||||||||||||
|
|
sellerProductItemId |
O |
Number |
Vendor item option ID |
|||||||||||||||||||||
|
|
vendorItemId |
O |
Number |
Option ID |
|||||||||||||||||||||
|
|
barcode |
|
String |
Barcode 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
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) 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) |
||||||||||||||||||||
|
|
|
salePrice |
O |
Number |
Sale price |
||||||||||||||||||||
|
|
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 |
|
|
In case you are adding Rocket Growth Item to existing product already registered in marketplace, all information - including product, vendor item IDs - must be provided in below fields | ||||||||||||||||||||||
|
|
sellerProductItemId |
O |
Number |
Vendor item option ID |
|||||||||||||||||||||
|
|
vendorItemId |
O |
Number |
Option ID |
|||||||||||||||||||||
|
|
externalVendorSku |
|
String |
Vendor product code (vendor SKU code) |
|||||||||||||||||||||
|
|
maximumBuyCount |
|
Number |
Quantity available for sale |
|||||||||||||||||||||
|
|
modelNo |
|
String |
Model Number |
|||||||||||||||||||||
|
|
emptyBarcode |
|
Boolean |
No barcode |
|||||||||||||||||||||
|
|
barcode |
|
String |
Barcode |
|||||||||||||||||||||
|
|
emptyBarcodeReason |
|
String |