상품 생성

쿠팡에서 판매할 상품을 등록하는 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

Name

Required

Type

Description

displayCategoryCode

Number

노출카테고리코드

카테고리 목록 조회 API 또는 카테고리 정보 excel을 다운받아 노출카테고리코드 확인 가능

※ 미입력 시, 카테고리 자동매칭 서비스에 의해 자동으로 카테고리가 등록될 수 있습니다. 자세한 사항은 여기를 확인하세요.

sellerProductName

String

등록상품명

발주서에 사용되는 상품명

최대 길이 : 100 자

vendorId

String

판매자ID (=업체코드)

쿠팡에서 업체에게 발급한 고유 코드. Wing 로그인 후 확인 가능

saleStartedAt

String

판매시작일시

"yyyy-MM-dd'T'HH:mm:ss" 형식

saleEndedAt

String

판매종료일시

"yyyy-MM-dd'T'HH:mm:ss" 형식, *2099년 까지 길게 선택 가능

displayProductName

String

노출상품명

실제 쿠팡 판매페이지에서 노출되는 상품명.
[brand]+[generalProductName]과 동일하게 입력할 것을 권장, 미입력 상태로도 등록 가능
미입력 시 [brand]+[generalProductName]이 노출되거나, [sellerProductName]이 노출될 수 있음

최대 길이 : 100 자

brand

String

브랜드

브랜드명은 한글/영어 표준이름 입력
띄어쓰기 및 특수문자 없이 입력

generalProductName

String

제품명

구매옵션[Attribute exposed] 정보(사이즈, 색상 등)를 포함하지 않는 상품명. 모델명 추가 기입 가능

productGroup

String

상품군

상품의 종류를 나타내는 명칭으로 노출카테고리의 최하위명을 참고하여 입력 가능.
제품명[generalProductName]과 중복될 경우, 입력 불필요

deliveryMethod

String

배송방법

Parameter Name	Status
SEQUENCIAL	일반배송 (순차배송)
COLD_FRESH	신선냉동
MAKE_ORDER	주문제작
AGENT_BUY	구매대행
VENDOR_DIRECT	설치배송 또는 판매자 직접 전달

신선식품은 반드시 일반배송이 아닌 신선냉동 타입을 선택해주시기 바랍니다.

deliveryCompanyCode

String

택배사 코드

택배사 코드 바로가기

deliveryChargeType

String

배송비종류

Parameter Name	Status
FREE	무료배송
NOT_FREE	유료배송
CHARGE_RECEIVED	착불배송
CONDITIONAL_FREE	조건부 무료배송

● 무료배송 설정 시
초도반품배송비(편도)[deliveryChargeOnReturn]와, 반품배송비(편도)[returnCharge] 금액 설정
● 유료배송 설정 시
기본배송비[deliveryCharge]와 반품배송비(편도) 금액 설정
● 조건부 무료배송 설정 시
기본배송비와 반품배송비(편도) 금액 설정
● 착불배송 설정 시
착불배송 가능 카테고리는 따로 정리되어 있으며, 판매자 안내를 위해 판매자콜센터에 공유가 되었습니다.

※ [CONDITIONAL_FREE] 사용 시, 원하는 조건부 무료배송 금액을 별도로 설정할 수 있습니다.

deliveryCharge

Number

기본배송비

유료배송 또는 조건부 무료배송 시, 편도 배송비 금액 입력

freeShipOverAmount

Number

무료배송을 위한 조건 금액

● 예시 : 10,000원 이상 조건부 무료배송을 설정하기 원할 경우 [deliveryChargeType]을 'CONDITIONAL_FREE'로 설정 후, [freeShipOverAmount]에 10000을 입력

※ 100원 이상 단위로 입력 가능
※ 무료배송인 경우, 0 입력

deliveryChargeOnReturn

Number

초도반품배송비

무료배송인 경우 반품시 소비자가 지불하는 배송비

remoteAreaDeliverable

String

도서산간 배송여부

Parameter Name	Status
Y	도서산간 배송
N	도서산간 배송안함

unionDeliveryType

String

묶음 배송여부

Parameter Name	Status
UNION_DELIVERY	묶음 배송 가능
NOT_UNION_DELIVERY	묶음 배송 불가능

※ 묶음 배송 조건
출고지 정보 필수 입력 (출고지 정보가 같은 상품만 묶음 배송 가능)
착불배송 불가 설정 불가

returnCenterCode

String

반품지센터코드

반품지 생성 후, 추출 된 반품지 센터코드를 입력
● 반품지 생성은 Wing 또는 반품지 생성 API를 통해 가능
● 반품지 생성이 불가능한 경우, "NO_RETURN_CENTERCODE"를 입력하여 직접 반품지 정보 등록 가능

※ 반품자동연동 서비스(굿스플로우)는 계약한 택배사가 있어야만 이용이 가능하며, 반품지 센터코드 입력 필수

※ 해외 배송 상품은 반드시 국내 반품지 주소지와 계약된 택배사 코드를 입력하여 반품지 센터 코드를 생성해주시기바랍니다. *해외 배송 상품 반품지 가이드(Click)

returnChargeName

String

반품지명

쿠팡 Wing 또는 반품지 조회 API를 통해 반품지 등록 후 확인
'반품지 조회 시, shippingPlaceName로 노출되는 값 입력'

companyContactNumber

String

반품지연락처

쿠팡 Wing 또는 반품지 조회 API를 통해 반품지 등록 후 확인

returnZipCode

String

반품지우편번호

쿠팡 Wing 또는 반품지 생성 API를 통해 반품지 등록 후 확인

returnAddress

String

반품지주소

쿠팡 Wing 또는 반품지 생성 API를 통해 반품지 등록 후 확인

returnAddressDetail

String

반품지주소상세

쿠팡 Wing 또는 반품지 생성 API를 통해 반품지 등록 후 확인

returnCharge

Number

반품배송비

반품회수시 편도 배송비

*초도반품배송비와 비교 시, 100~150%까지만 입력 가능

outboundShippingPlaceCode

Number

출고지주소코드

묶음 배송 선택할 경우 필수, 출고지 조회 API를 통해 조회 가능

해외구매대행(AGENT_BUY) 선택시 해외주소지만 입력가능함

vendorUserId

String

실사용자아이디(쿠팡 Wing ID)

업체(Vendor)에 소속된 사용자아이디

requested

Boolean

자동승인요청여부

상품 등록 시, 자동으로 판매승인요청을 진행할지 여부 선택
● false : 작성 내용만 저장하고 판매요청 전 상태 (판매를 원할 시에는 상품 승인요청 API 또는 wing에서 판매요청을 진행 해야 함)
● true : 저장 및 자동으로 판매 승인 요청

items

List

업체상품옵션목록

최대 200개 옵션 등록 가능

itemName

String

업체상품옵션명

각각의 아이템에 중복되지 않도록 기입
사이트에 노출되는 옵션명이 아니며, 구매옵션에 따라 변경될 수 있음

최대 길이 : 150자 제한

originalPrice

Number

할인율기준가 (정가표시)

할인율(%)표시를 위한 할인전 금액으로, 판매가격과 동일하게 입력시 '쿠팡가'로 노출. 승인완료 이후 할인율기준가 수정은 [옵션별 할인율기준가 변경] API를 통해 변경가능

salePrice

Number

판매가격

판매가격을 입력.
'최초' 업체상품 등록시 판매가격은 상품 승인 요청 전에만 가능하며, 승인완료 이후 판매가격 수정은 [옵션별 가격 변경] API를 통해 변경가능

maximumBuyCount

Number

판매가능수량

판매가능한 재고수량을 입력.
'최초' 업체상품 등록시 판매수량은 상품 승인 요청 전에만 가능하며, 승인완료 이후 재고 수정은 [옵션별 수량 변경] API를 통해 변경가능

최대값 : 99999

maximumBuyForPerson

Number

인당 최대 구매 수량

1인당 최대 구매 가능한 수량.
제한이 없을 경우 ‘0’을 입력
(예: 인당 최대 구매 수량 100, 최대 구매 수량 기간 3 입력 시, 1인당 3일 동안 최대 100개까지 구매 가능함을 의미)

maximumBuyForPersonPeriod

Number

최대 구매 수량 기간

1인당 해당 상품을 구매할 수 있는 주기 설정.
제한이 없을 경우 ‘1’을 입력
(예: 인당 최대 구매 수량 100, 최대 구매 수량 기간 3 입력 시, 1인당 3일 동안 최대 100개까지 구매 가능함을 의미)

outboundShippingTimeDay

Number

기준출고일(일)

주문일(D-Day) 이후 배송을 위한 출고예정일자를 '일' 단위로 입력. (다음날(D+1) 출고일 경우 '1' 입력)

unitCount

Number

단위수량

상품에 포함된 수량을 입력하면 (판매가격 ÷ 단위수량) 로 계산하여 (1개당 가격 #,000원) 으로 노출. 개당가격이 필요하지 않은 상품은 '0'을 입력

adultOnly

String

19세이상

Parameter Name	Status
ADULT_ONLY	19세이상 구입 가능 상품
EVERYONE	전연령 구입 가능 상품 (기본값)

taxType

String

과세여부

Parameter Name	Status
TAX	과세 (기본값)
FREE	비과세

parallelImported

String

병행수입여부

Parameter Name	Status
PARALLEL_IMPORTED	병행수입
NOT_PARALLEL_IMPORTED	병행수입 아님 (기본값)

※ 병행수입의 경우, 상품 생성 시에 수입신고필증 URL을 함께 등록해야 함 - 등록방법 참고(Click)

overseasPurchased

String

해외구매대행여부

Parameter Name	Status
OVERSEAS_PURCHASED	구매대행
NOT_OVERSEAS_PURCHASED	구매대행 아님 (기본값)

※ 구매대행의 경우, 상품 생성 시에 인보이스영수증을 URL을 함께 등록해야 함 - 등록방법 참고(Click)

pccNeeded

Boolean

PCC(개인통관부호) 필수/비필수 여부

해외구매대행 상품인 경우, 상품 PCC(개인통관번호)는 반드시 true로 입력해야 함
- 기본값 : 비필수(false)

true	고객이 PCC 입력 후 구매 가능 (PCC는 발주서에 포함 됨)
false	고객이 PCC를 입력하지 않고 상품 구매 가능

externalVendorSku

String

판매자상품코드 (업체상품코드)

업체고유의 item 코드값을 임의로 세팅할 수 있으며, 입력값은 발주서 조회 API response 에 포함됨.

barcode

String

바코드

상품에 부착 된 유효한 표준상품 코드

emptyBarcode

Boolean

바코드 없음

바코드가 없으면 true

emptyBarcodeReason

String

바코드 없음에 대한 사유

최대길이 : 100 자 제한

modelNo

String

모델번호

extraProperties

업체상품옵션추가정보

Key : Value 형태로 필요한 만큼 반복입력가능

Key

String

Value

certifications

List

상품인증정보

상품 인증 정보

certificationType

String

인증정보Type

카테고리 메타정보 조회 API를 통해 등록가능한 Type을 구할 수 있다.
인증대상이 아닌 카테고리일 경우 : NOT_REQUIRED

certificationCode

String

상품인증정보코드

인증기관에서 발급받은 코드

certificationAttachments

List<Map<String,String>>

인증정보 첨부파일

이동통신사전승낙서 및 인증대리점 인증서 등록 시 사용함
1.이동통신 사전승낙서 또는 인증대리점 인증서
2.판매점 사전승낙 인증마크 또는 이동통신사 대리점 인증마크

아래 업체이미지 경로 또는 쿠팡CDN 경로 중 하나 이상 필수 입력 필요
1. vendorPath: 업체에서 사용하는 이미지 경로, http://로 시작하는 경로일 경우 자동 다운로드하여 쿠팡 CDN에 추가됨
2. cdnPath: 쿠팡 CDN 서버에 올린 경우 직접 입력

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

검색어

필요한 만큼 반복입력가능. ["검색어1","검색어2"]

1개의 검색어 당 20자 이내로, 최대 20개의 검색어를 입력가능, !@#$%^&*-+;:’. 외의 특수문자는 입력불가

images

List

이미지목록

필요한 만큼 반복 입력 가능

imageOrder

Number

이미지표시순서

0,1,2...

imageType

String

이미지타입

대표이미지 타입
3MB 이하의 정사각형 이미지를 JPG, PNG로 등록 가능 (최소 500 x 500px, 최대 5000 x 5000px)

● 필수
REPRESENTATION : 정사각형 대표이미지
● 선택
DETAIL : 기타이미지 (최대 9개까지 등록 가능)
USED_PRODUCT : 중고상태 이미지 (최대 4개까지 등록 가능)

cdnPath

String

쿠팡CDN경로

쿠팡 CDN 에 올린 경우 직접 입력, vendorPath와 cdnPath 중 하나 이상 필수
최대 길이 : 200 자

vendorPath

String

업체이미지경로

업체에서 사용하는 이미지 경로, http://로 시작하는 경로일 경우 자동 다운로드하여 쿠팡 CDN에 추가됨, vendorPath와 cdnPath 중 하나 이상 필수

80, 443 Port 이미지 경로만 사용가능
최대 길이 : 200 자

notices

List

상품고시정보 목록

카테고리 메타 정보 조회 API 또는 전체카테고리 리스트 Excel file을 통해, 필요한 고시정보 항목의 확인 및 선택 가능

noticeCategoryName

String

상품고시정보카테고리명

카테고리별 입력 가능한 상품고시정보 카테고리 중 하나를 입력
카테고리 메타 정보 조회 API 또는 전체 카테고리 정보 Excel file을 통해, 필요한 고시정보 항목의 확인 및 선택 가능

noticeCategoryDetailName

String

상품고시정보카테고리상세명

content

String

내용

attributes

List

옵션목록(속성)

카테고리 기준으로 정해진 옵션 목록을 입력하는 객체
등록하기 원하는 구매옵션 개수 만큼 반복 입력 가능

● 구매옵션(attribute exposed)의 모든 값이 중복될 경우 등록 불가
● 한개 이상 필수 등록

※ 자유로운 구매옵션 구성(open attribute) 은 아래의 가이드에서 확인할 수 있습니다.
구매옵션 자유 입력 가이드 (20201012 변경사항)

※ 음료 카테고리의 경우 카테고리 메타정보에서 정의한 필수구매옵션만 등록이 가능하며, 구매 옵션이 없거나 자유로운 구매옵션은 제한 됩니다. (카테고리 확인)

attributeTypeName

String

옵션타입명

카테고리 메타 정보 조회 API 또는 전체카테고리 리스트 다운로드 엑셀 파일을 통해, 카테고리에 맞는 옵션타입명 확인 및 선택 가능 (구매옵션은 자유롭게 입력 가능)

최대 길이 25자 제한

attributeValueName

String

옵션값

옵션타입명[attributeTypeName]에 해당하는 Value를 단위와 함께 입력 (예시 : "200ml")

최대 길이 30자 제한

exposed

String

옵션과 검색필터를 구분하는 항목

해당 항목을 제외하고 등록할 경우, 옵션으로 등록되고

해당 항목에 "NONE"이라는 값을 작성할 경우 필터로 등록 됨

검색필터는 반드시 등록하는 카테고리와 일치하는 필터명만 사용 가능

contents

List

컨텐츠목록

필요한 만큼 반복 입력 가능

contentsType

String

컨텐츠타입

Parameter Name	Status
IMAGE	이미지
IMAGE_NO_SPACE	이미지(공백없음)
TEXT	텍스트
IMAGE_TEXT	이미지-텍스트
TEXT_IMAGE	텍스트-이미지
IMAGE_IMAGE	이미지-이미지
TEXT_TEXT	텍스트-텍스트
TITLE	제목
HTML	HTML

contentDetails

List

상세컨텐츠목록

content

String

내용

detailType

String

세부타입

Parameter Name	Status
IMAGE	이미지
TEXT	텍스트

offerCondition

String

상품상태

상품 생성 후에는 offerCondition 변경 불가능
노출카테고리 코드에 따라 아래 값을 선택가능, 없을 경우 NEW로 취급함

Parameter Name	Mean
NEW	새 상품
REFURBISHED	리퍼
USED_BEST	중고(최상)
USED_GOOD	중고(상)
USED_NORMAL	중고(중)

offerDescription

String

중고상품 상세설명

중고상품 상태를 설명, 700자 제한
offerCondition을 중고로 입력한 경우에만 작성

requiredDocuments

List

구비 서류 필수인 경우 입력

구비서류는 5MB이하의 파일 입력 가능 (PDF, HWP, DOC, DOCX, TXT, PNG, JPG, JPEG)

templateName

String

구비서류템플릿명

카테고리 메타 정보 조회 API에서 확인 가능

documentPath

String

구비서류 쿠팡CDN경로

documentPath 와 vendorDocumentPath 중 하나 필수
최대 길이 : 150자

vendorDocumentPath

String

구비서류벤더경로

구비서류 경로, http://로 시작하는 경로일 경우 자동 다운로드하여 쿠팡 CDN에 추가됨. documentPath 와 vendorDocumentPath 중 하나 필수
최대 길이 : 150자

extraInfoMessage

String

주문제작 안내 메시지

배송 방법을 '주문제작'으로 선택했을 경우, 고객에게 안내할 메시지를 입력

manufacture

String

제조사

정확한 제조사를 기입할 수 없는 경우, [brand] 항목과 동일하게 입력 가능

bundleInfo

Map<String,String>

번들상품

bundleType

String

번들상품 구분

● SINGLE : 단일구성상품 (기본값)

● AB : 혼합구성상품

혼합 구성 상품 등록 시에는 옵션을 구성할 수 없으며, 번들 상품 정보를 추가한 뒤에는 번들 상품 값을 수정할 수 없습니다. 이는 새로운 상품 등록과 동일한 것으로 간주되어 적용된 사항입니다.

Request Example

{
  "displayCategoryCode": 56137,
  "sellerProductName": "test_클렌징오일_관리용_상품명",
  "vendorId": "A00012345",
  "saleStartedAt": "2017-11-30T00:00:00",
  "saleEndedAt": "2099-01-01T23:59:59",
  "displayProductName": "해피바스 솝베리 클렌징 오일",
  "brand": "해피바스",
  "generalProductName": "솝베리 클렌징 오일",
  "productGroup": "클렌징 오일",
  "deliveryMethod": "SEQUENCIAL",
  "deliveryCompanyCode": "KDEXP",
  "deliveryChargeType": "FREE",
  "deliveryCharge": 0,
  "freeShipOverAmount": 0,
  "deliveryChargeOnReturn": 2500,
  "remoteAreaDeliverable": "N",
  "unionDeliveryType": "UNION_DELIVERY",
  "returnCenterCode": "1000274592",
  "returnChargeName": "반품지_1",
  "companyContactNumber": "02-1234-678",
  "returnZipCode": "135-090",
  "returnAddress": "서울특별시 강남구 삼성동",
  "returnAddressDetail": "333",
  "returnCharge": 2500,
  "outboundShippingPlaceCode": "74010",
  "vendorUserId": "wing_loginId_123",
  "requested": true,
  "items": [
    {
      "itemName": "200ml_1개",
      "originalPrice": 13000,
      "salePrice": 10000,
      "maximumBuyCount": "100",
      "maximumBuyForPerson": "0",
      "outboundShippingTimeDay": "1",
      "maximumBuyForPersonPeriod": "1",
      "unitCount": 1,
      "adultOnly": "EVERYONE",
      "taxType": "TAX",
      "parallelImported": "NOT_PARALLEL_IMPORTED",
      "overseasPurchased": "NOT_OVERSEAS_PURCHASED",
      "pccNeeded": "false",
      "externalVendorSku": "0001",
      "barcode": "",
      "emptyBarcode": true,
      "emptyBarcodeReason": "상품확인불가_바코드없음사유",
      "modelNo": "171717",
      "extraProperties": {
        "coupangSalePrice": 5000,
        "onlineSalePriceForBooks": 10000,
        "transactionType": "manufacturer",
        "businessType": "Beauty"
      },
      "certifications": [
        {
          "certificationType": "NOT_REQUIRED",
          "certificationCode": ""
        }
      ],
      "searchTags": [
        "검색어1",
        "검색어2"
      ],
      "images": [
        {
          "imageOrder": 0,
          "imageType": "REPRESENTATION",
          "vendorPath": "http://image11.coupangcdn.com/image/product/image/vendoritem/2018/06/25/3719529368/27a6b898-ff3b-4a27-b1e4-330a90c25e9c.jpg"
        },
        {
          "imageOrder": 1,
          "imageType": "DETAIL",
          "vendorPath": "http://image11.coupangcdn.com/image/product/image/vendoritem/2017/02/21/3000169918/34b79649-d625-4f49-a260-b78bf7a573a8.jpg"
        },
        {
          "imageOrder": 2,
          "imageType": "DETAIL",
          "vendorPath": "http://image11.coupangcdn.com/image/product/image/vendoritem/2018/06/28/3000169918/5716aa61-70bd-47cd-8f3d-f3d49e7f496d.jpg"
        }
      ],
      "notices": [
        {
          "noticeCategoryName": "화장품",
          "noticeCategoryDetailName": "용량(중량)",
          "content": "상세페이지 참조"
        },
        {
          "noticeCategoryName": "화장품",
          "noticeCategoryDetailName": "제품 주요 사양",
          "content": "상세페이지 참조"
        },
        {
          "noticeCategoryName": "화장품",
          "noticeCategoryDetailName": "사용기한 또는 개봉 후 사용기간",
          "content": "상세페이지 참조"
        },
        {
          "noticeCategoryName": "화장품",
          "noticeCategoryDetailName": "사용방법",
          "content": "상세페이지 참조"
        },
        {
          "noticeCategoryName": "화장품",
          "noticeCategoryDetailName": "제조업자 및 제조판매업자",
          "content": "상세페이지 참조"
        },
        {
          "noticeCategoryName": "화장품",
          "noticeCategoryDetailName": "제조국",
          "content": "상세페이지 참조"
        },
        {
          "noticeCategoryName": "화장품",
          "noticeCategoryDetailName": "화장품법에 따라 기재, 표시하여야 하는 모든 성분",
          "content": "상세페이지 참조"
        },
        {
          "noticeCategoryName": "화장품",
          "noticeCategoryDetailName": "식품의약품안전처 심사 필 유무",
          "content": "상세페이지 참조"
        },
        {
          "noticeCategoryName": "화장품",
          "noticeCategoryDetailName": "사용할 때 주의사항",
          "content": "상세페이지 참조"
        },
        {
          "noticeCategoryName": "화장품",
          "noticeCategoryDetailName": "품질보증기준",
          "content": "제품 이상 시 공정거래위원회 고시 소비자분쟁해결기준에 의거 보상합니다."
        },
        {
          "noticeCategoryName": "화장품",
          "noticeCategoryDetailName": "소비자상담관련 전화번호",
          "content": "상세페이지 참조"
        }
      ],
      "attributes": [
        {
          "attributeTypeName": "수량",
          "attributeValueName": "1개"
        },
        {
          "attributeTypeName": "개당 용량",
          "attributeValueName": "200ml"
        },
        {
          "attributeTypeName": "피부타입",
          "attributeValueName": "모든피부",
          "exposed": "NONE"
        },
        {
          "attributeTypeName": "피부고민",
          "attributeValueName": "모공",
          "exposed": "NONE"
        },
        {
          "attributeTypeName": "사용부위",
          "attributeValueName": "얼굴",
          "exposed": "NONE"
        }
      ],
      "contents": [
        {
          "contentsType": "TEXT",
          "contentDetails": [
            {
              "content": "<html><div></div><div><img src='http://image11.coupangcdn.com/image/product/content/vendorItem/2018/06/26/196713/738d905f-ed80-4fd8-ad21-ed87b195a19e.jpg' /><div></html>",
              "detailType": "TEXT"
            }
          ]
        }
      ],
      "offerCondition": "NEW",
      "offerDescription": ""
    },
    {
      "itemName": "200ml_2개",
      "originalPrice": 26000,
      "salePrice": 20000,
      "maximumBuyCount": 100,
      "maximumBuyForPerson": 0,
      "outboundShippingTimeDay": 2,
      "maximumBuyForPersonPeriod": 1,
      "unitCount": 1,
      "adultOnly": "EVERYONE",
      "taxType": "TAX",
      "parallelImported": "NOT_PARALLEL_IMPORTED",
      "overseasPurchased": "NOT_OVERSEAS_PURCHASED",
      "pccNeeded": "false",
      "externalVendorSku": "0001",
      "barcode": "",
      "emptyBarcode": true,
      "emptyBarcodeReason": "상품확인불가_바코드없음사유",
      "modelNo": "171717",
      "extraProperties": {
        "coupangSalePrice": 5000,
        "onlineSalePriceForBooks": 10000,
        "transactionType": "manufacturer",
        "businessType": "Beauty"
      },
      "certifications": [
        {
          "certificationType": "NOT_REQUIRED",
          "certificationCode": ""
        }
      ],
      "searchTags": [
        "검색어1",
        "검색어2"
      ],
      "images": [
        {
          "imageOrder": 0,
          "imageType": "REPRESENTATION",
          "vendorPath": "http://image11.coupangcdn.com/image/product/image/vendoritem/2018/06/26/3001519145/74100e2a-d1ad-4b50-9c78-840c12a3e10d.jpg"
        },
        {
          "imageOrder": 1,
          "imageType": "DETAIL",
          "vendorPath": "http://image11.coupangcdn.com/image/product/image/vendoritem/2017/02/21/3000169918/34b79649-d625-4f49-a260-b78bf7a573a8.jpg"
        },
        {
          "imageOrder": 2,
          "imageType": "DETAIL",
          "vendorPath": "http://image11.coupangcdn.com/image/product/image/vendoritem/2018/06/28/3000169918/5716aa61-70bd-47cd-8f3d-f3d49e7f496d.jpg"
        }
      ],
      "notices": [
        {
          "noticeCategoryName": "화장품",
          "noticeCategoryDetailName": "용량(중량)",
          "content": "상세페이지 참조"
        },
        {
          "noticeCategoryName": "화장품",
          "noticeCategoryDetailName": "제품 주요 사양",
          "content": "상세페이지 참조"
        },
        {
          "noticeCategoryName": "화장품",
          "noticeCategoryDetailName": "사용기한 또는 개봉 후 사용기간",
          "content": "상세페이지 참조"
        },
        {
          "noticeCategoryName": "화장품",
          "noticeCategoryDetailName": "사용방법",
          "content": "상세페이지 참조"
        },
        {
          "noticeCategoryName": "화장품",
          "noticeCategoryDetailName": "제조업자 및 제조판매업자",
          "content": "상세페이지 참조"
        },
        {
          "noticeCategoryName": "화장품",
          "noticeCategoryDetailName": "제조국",
          "content": "상세페이지 참조"
        },
        {
          "noticeCategoryName": "화장품",
          "noticeCategoryDetailName": "화장품법에 따라 기재, 표시하여야 하는 모든 성분",
          "content": "상세페이지 참조"
        },
        {
          "noticeCategoryName": "화장품",
          "noticeCategoryDetailName": "식품의약품안전처 심사 필 유무",
          "content": "상세페이지 참조"
        },
        {
          "noticeCategoryName": "화장품",
          "noticeCategoryDetailName": "사용할 때 주의사항",
          "content": "상세페이지 참조"
        },
        {
          "noticeCategoryName": "화장품",
          "noticeCategoryDetailName": "품질보증기준",
          "content": "상세페이지 참조"
        },
        {
          "noticeCategoryName": "화장품",
          "noticeCategoryDetailName": "소비자상담관련 전화번호",
          "content": "상세페이지 참조"
        }
      ],
      "attributes": [
        {
          "attributeTypeName": "수량",
          "attributeValueName": "2개"
        },
        {
          "attributeTypeName": "개당 용량",
          "attributeValueName": "200ml"
        },
        {
          "attributeTypeName": "피부타입",
          "attributeValueName": "모든피부",
          "exposed": "NONE"
        },
        {
          "attributeTypeName": "피부고민",
          "attributeValueName": "모공",
          "exposed": "NONE"
        },
        {
          "attributeTypeName": "사용부위",
          "attributeValueName": "얼굴",
          "exposed": "NONE"
        }
      ],
      "contents": [
        {
          "contentsType": "TEXT",
          "contentDetails": [
            {
              "content": "<html><div></div><div><img src='http://image11.coupangcdn.com/image/product/content/vendorItem/2018/06/26/196713/738d905f-ed80-4fd8-ad21-ed87b195a19e.jpg' /><div></html>",
              "detailType": "TEXT"
            }
          ]
        }
      ],
      "offerCondition": "NEW",
      "offerDescription": ""
    }
  ],
  "requiredDocuments": [
    {
      "templateName": "기타인증서류",
      "vendorDocumentPath": "http://image11.coupangcdn.com/image/product/content/vendorItem/2018/07/02/41579010/eebc0c30-8f35-4a51-8ffd-808953414dc1.jpg"
    }
  ],
  "extraInfoMessage": "",
  "manufacture": "아모레퍼시픽",
  "bundleInfo": {
    "bundleType": "SINGLE"
  }
}

Response Message

Name

Type

Description

code

String

결과코드

SUCCES/ERROR

message

String

메세지

경고 및 에러 메세지가 포함되어 있으며, 여러 개 포함되어 있을 수 있습니다.

data

Long

등록상품ID

=sellerProductId

details

String

에러 및 경고 상황에 대해 상세 설명되어 있습니다.

ettorItems

List

상품등록 실패가 될 수 있는 상품이 나열되어져 있습니다.

Item

Type

Description

itemIndex

Integer

ItemIndex = 0 as element index position of items List

itemName

String

등록상품명

attributes

List <Attribute>

Attribute	Type	Description
attributeTypename	String
attributeValuename	String
message	String	유효하지 않은 데이터 타입, 단위

Response Example

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

{
  "code": "SUCCESS",
  "message": "유효하지 않은 구매 옵션 값 혹은 단위가 존재합니다.",
  "details": "100ml 의 단위값이 유효하지 않습니다. 자세한 사항은 
  아래 errorItems 에서 확인할 수 있습니다. 
  또한, 카테고리 메타 정보 조회 API 혹은 공지사항에서 
  업데이트된 내용을 확인할 수 있습니다",
  "errorItems": [
    {
      "itemIndex": 0,
      "itemName": "coke500ml10ea",
      "attributes": [
        {
          "attributeTypeName": "수량",
          "attributeValueName": "100ml",
          "message": "유효하지않은단위값입니다."
        }
      ]
    }
  ],
  "data": null
}

Error Spec

HTTP 상태 코드 (오류 유형)	오류 메시지	해결 방법
400 (요청변수확인)	필수 구매 옵션이 존재하지 않습니다. Missing Attribute(s)	카테고리 메타정보 조회 API를 통해 필수 구매 옵션이 무엇인지 확인 후 상품 등록 진행 바랍니다.
400 (요청변수확인)	유효하지 않은 구매 옵션이 존재합니다. Attribute(s) Not Allowed	자유로운 구매 옵션 구성이 제한된 카테고리입니다. 필수 구매 옵션만 입력 바랍니다.
400 (요청변수확인)	유효하지 않은 구매 옵션 값 혹은 단위가 존재합니다. Invalid Attribute Value(s)	데이터 형식 혹은 단위가 유효하지 않은 값입니다. 카테고리 메타 정보 조회 API를 통해 유효한 값 유형 확인 바랍니다.
400 (요청변수확인)	The value of attributeValueName is incorrect. Please enter the acceptable values as following the error spec guide.	입력 가능한 기저귀 단계인지 확인해 주세요. 아래 값들만 입력 가능하며, 이 외 시장에 존재하는 단계는 등록 상품 당 1개까지 입력할 수 있습니다. 1단계, 2단계, 3단계, 4단계, 5단계, 6단계, 7단계, 신생아(NB), 소형(S), 중형(M), 대형(L), 특대형(XL), 점보형(2XL), 점보형 이상(3XL)
400 (요청변수확인)	카테고리의 필수 속성이 존재하지 않습니다.	속성(attributes) 값 중에서 필수(MANDATORY)로 입력해야할 항목을 누락했을 경우 발생하는 에러, 카테고리메타정보 조회 API를 통해 확인 및 필수 속성 값 입력 필요합니다.
400 (요청변수확인)	입력값에 오류가 있습니다. line: 123	요청한 JSON 전문의 해당 line 상에 올바른 파라메터, 값, 배열형식을 입력했는지 확인합니다.
400 (요청변수확인)	올바른 반품지 센터코드를 입력 하세요.	출고지, 반품지 조회 API를 이용하여 올바른 출고지, 반품지 코드를 입력했는지 확인합니다.
400 (요청변수확인)	java.lang.NullPointerException	요청한 JSON 전문에 오탈자가 있는지 확인이 필요합니다.
400 (요청변수확인)	입력된 상품필수 고지정보[예) 제조자 및 제조판매업자]가 카테고리[예)화장품]에서 제공하는 것과 다릅니다.	입력한 고시정보에 문제가 있을 경우 발생하는 에러로 카테고리메타정보를 조회하여 입력한 고시정보("notices": [])와 정확히 일치하는지 확인이 필요합니다.
400 (요청변수확인)	배송비 종류가 19800이상 무료배송이면 조건부무료가 19800원, 초도배송비가 0원 입니다.	freeShipOverAmount:19800 로 설정했을 경우 초도배송비(deliveryChargeOnReturn)값을 '0'으로 입력했는지 확인이 필요합니다.
400 (요청변수확인)	[택배사 코드]를 확인해 주세요.	도서산간 배송을 설정했을 경우(remoteAreaDeliverable : "Y") 출고지에 등록한 택배사만 입력이 가능합니다.
400 (요청변수확인)	UNAUTHORIZATION	잘못된 인증 정보로 발생한 에러입니다. 올바른 인증이 이루어 졌는지 확인합니다.
400 (요청변수확인)	배송방법을 확인해 주시기 바랍니다.	구매대행을 선택한 경우 출고지주소가 해외배송지인지 확인합니다. 국내배송지는 선택할 수 없습니다.
400 (요청변수확인)	배송방법이 구매대행인 경우에는 쿠팡에서 배송을 위해 고객에게 PCCC를 의무적으로 입력하도록 합니다.	구매대행을 선택한 경우 pccNeeded 파라메터 값을 true로 설정했는지 확인합니다.
400 (요청변수확인)	혼합 구성 상품 등록할 때, 여러 개 옵션 구성은 불가능 합니다.	혼합 구성 상품 등록할 때, 노출 옵션을 제거해주세요
400 (요청변수확인)	혼합 구성 상품 등록할 때, 속성(attributeTypeName) 입력할 수 없습니다.	혼합 구성 상품 등록할 때, 속성(attributeTypeName)을 제거해주세요.
400 (요청변수확인)	bundleInfo에서 허용하지 않는 값입니다.	bundleInfo에 SINGLE, AB 값만 가능합니다.

※ 주의사항

 "code": "SUCCESS"

상품 생성에 성공하였다는 메시지를 확인 하신 후, [상품 목록 구간 조회 API] 또는 WING을 통해서 상품의 상태가 '승인완료' 상태인지 확인하실 것을 권장드립니다.

'승인반려' 상태일 경우, 반려 사유를 확인하시고 수정하여 재전송해주시기 바랍니다.
'승인반려' 사유는 'WING'에서 상태변경이력을 확인하시거나 [상품 상태 변경 이력 조회 API]를 통해서 확인하실 수 있습니다.

※ 상품 생성 및 수정 API는 초당 10건 이하로 호출해 주시기 바랍니다.

URL API Name

CREATE_PRODUCT

New 상품등록 API 가이드(20201012 변경).docx
30 킬로바이트 다운로드
음료카테고리확인_공유.xlsx
10 킬로바이트 다운로드

OPENAPI 관련 안내

이 섹션의 문서

Path

Example Endpoint

Request Parameters

Body Parameter

Request Example

Response Message

Response Example

Error Spec

URL API Name

OPENAPI 관련 안내

이 섹션의 문서

Path

Example Endpoint

Request Parameters

Body Parameter

Request Example

Response Message

Response Example

Error Spec

URL API Name

관련 문서