상품 생성 (로켓그로스 및 마켓플레이스/로켓그로스 동시 운영 상품)

API 적용 가능한 구매자 사용자 지역: 한국

쿠팡에서 판매할 상품을 등록하는 API 입니다. 

로켓그로스 상품 생성의 경우 API를 성공적으로 호출하려면 먼저 WING 플랫폼 > 판매자 정보 메뉴 > 추가 정보 메뉴 > "OPEN API 키 발급" 영역 우측에 있는 "로켓그로스 상품 생성 API 이용 및 검수 기준 동의"를 클릭하여 동의 처리 후 사용 가능합니다. 

기 마켓플레이스 상품생성 API를 사용하시는 경우, 동일 Endpoint로 로켓그로스 로켓그로스 상품 또는 로켓그로스 & 마켓플레이스 동시 운영 상품 생성이 가능하지만, 본 문서에 있는 신규 schema를 활용하셔야 합니다. 기존 상품생성 API에서 추가/변경된 parameter는 초록색 텍스트를 참고하실 수 있습니다. 기존 마켓플레이스 상품에 로켓그로스 상품을 추가하시는 경우, 상품수정 API를 활용하여 추가하실 수 있습니다.

상품을 생성할 때는 상품 카테고리 별 고시정보, 옵션 정보 등이 필요합니다.  
아래 상품등록 가이드를 다운받으시면, 보다 상세하게 확인하실 수 있습니다.  
[Download] 쿠팡 OPENAPI 상품등록가이드

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

Rocket Growth 검수 기준 동의

1. 아래 상품들은 로켓그로스에서 취급이 불가능하며, 쿠팡풀필먼트서비스(CFS)의 창고에 입고할 수 없습니다.
   • 신선/냉장/냉동식품군, 식품
   • 아래의 경우를 포함하여 개별 법령에서 별도의 취급/보관/진열 기준을 정하고 있는 상품 군

a. 산업안전보건법 등의 의거 MSDS(물질안전보건자료)의 제공, 게시 의무 및 교육 의무가 적용되는 ‘대상화학물질'이 포함된 상품

b. 화학물질관리법에 따른 유해화학물질(유독물질, 허가물질, 제한물질, 금지물질, 사고대비물질, 그 밖에 유해성 또는 위해성이 있거나 그러한 우려가 있는 화학물질)에 해당하는 상품

c. 위험물 안전관리법에 의해 관리되는 상품으로 인화성 및 발화성이 있는 화학성분의 함량지수가 높은 디퓨저, 방향제, 손소독제, 탈취제, 세정제, 엔진오일, 유성페인트, 연료첨가제, 액상형 클리너, 살충제, 액상담배 등

d. 고압가스 안전관리법에 의해 관리되는 상품

1.  상용(常用)의 온도에서 압력(게이지압력을 말한다. 이하 같다)이 1메가파스칼 이상이 되는 압축가스(예, CO2, N2, 이산화탄소, 질소, 압축가스, 헬륨 등)로서 실제로 그 압력이 1메가파스칼 이상이 되는 것 또는 섭씨 35도의 온도에서 압력이 1메가파스칼 이상이 되는 압축가스(아세틸렌가스는 제외한다) 및 0.2 메가파스칼 이상이 되는 액화가스(예, LPG, 액화천연가스, DME, 등)인 상품

2.  섭씨 15도의 온도에서 압력이 0파스칼을 초과하는 아세틸렌가스

3.  상용의 온도에서 압력이 0.2메가파스칼 이상이 되는 액화가스로서 실제로 그 압력이 0.2메가파스칼 이상이 되는 것 또는 압력이 0.2메가파스칼이 되는 경우의 온도가 섭씨 35도 이하인 액화가스

4.  섭씨 35도의 온도에서 압력이 0파스칼을 초과하는 액화가스 중 액화시안화수소ㆍ액화브롬화메탄 및 액화산화에틸렌가스

e. 총포화약법에 따른 총포, 도검, 화약류, 분사기, 전기충격기, 석궁 등에 해당하는 상품

f. 의료기기 유통품질 관리기준에 따라 일정 온도(예: 냉장, 냉동 보관) 를 유지할 필요가 있는 의료기기

• 개별 판매 단위 상품 1개 기준(포장재 포함) 가로+세로+높이 합이 250cm을 초과하거나 그 무게가 30kg 초과인 경우
• 고객 방문이 필요한 설치배송 상품
• 기타 관련 법령상의 규정을 준수하지 아니한 상품(예시: 식품 등의 표시광고에 관한 법률 위반 및 유통기한/소비기한 표시 위반)

2. 쿠팡풀필먼트서비스(CFS) 입고 가능 상품이더라도 아래 검수 기준에 부합하지 않을 경우 회송될 수 있습니다.

• 색상, 용량, 길이 등의 차이로 제품의 외관이 옵션 별로 다를 경우 상품 대표 이미지는 반드시 각각 옵션별 대표 이미지를 등록해야 합니다.
• 쿠팡풀필먼트서비스의 검수 단계에서 입고한 실물과 Wing에 판매자가 등록한 상품 정보를 대조합니다. 이때 상품명, 옵션명, 상품 대표 이미지가 실물에서 확인 가능해야 합니다.
• 초콜릿, 캔디, 젤리, 캔들 등과 같이 온도에 의해 녹거나 모양의 변형이 발생할 수 있는 상품은 하절기(7월~9월) 입고가 제한되며, 해당 상품 입고 시 상품을 회송하거나 반출할 수 있고, 부득이한 경우 쿠팡풀필먼트서비스 창고에서 폐기할 수 있습니다. 이때, 회송, 반출, 폐기에 소요되는 비용은 판매자에게 청구할 수 있습니다.
• 온도에 따라 녹거나 모양이 변형 혹은 상품이 변질될 수 있는 온도에 민감한 상품(견과류, 차류, 코코아가공품류, 초콜릿류, 젤리, 푸딩 등 캔디류 일부, 캔들, 곡류 및 기타)은 입고가 제한됩니다. 판매자들은 입고 요청 전에 온도에 민감한 상품 유형인지를 확인할 책임이 있고, 온도에 민감한 상품의 입고는 제한될 수 있습니다. 상품의 온도 민감성으로 인한 훼손은 별도로 보상되지 않으며, 온도에 민감한 상품은 훼손 등 부득이한 사유 발생시 회송 또는 반출될 수 있고, 이에 소요되는 비용은 판매자에게 청구될 수 있습니다.
• 이외에도 쿠팡풀필먼트서비스가 별도로 배포하는 입고 매뉴얼을 준수하여야 합니다.

3. 상품의 정확한 카테고리를 분류하고 상품에 대한 모든 정보를 정확하게 등록하여야 합니다.

• 쿠팡의 카테고리는 판매자가 참조할 수 있는 목적으로 제공되는 것일 뿐입니다. 판매자는 법령에 따라 상품을 정확하게 분류하여 로켓그로스에서 판매가 가능한 상품인지를 반드시 확인하고 등록하여 주시기 바랍니다.

위의 기준을 준수하지 않은 상품을 등록/보관/판매함으로써 발생하는 모든 손해와 책임(회송/반출 비용, 쿠팡풀필먼트서비스 및 그 계열회사의 손해, 행정처분 및 형사처벌을 포함한 모든 법적 책임을 포함하며 이에 한정하지 아니함)이 판매자 본인에게 있음을 확인합니다.

Request Example

Rocket Growth 전용 상품

{

    "vendorId": "A00012345",

    "vendorUserId": "vendor1234",

    "displayCategoryCode": 69515,

    "brand": "brandname",
    "brandId": "KR-00005",

    "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 동시 운영 상품

{

    "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

{ 
  "code": "200", 
  "message": "", 
  "data": { 
    "code": "SUCCESS", 
    "message": "", 
    "data": 427011919 
  } 
} 

 "code": "SUCCESS"