쿠팡에서 판매할 상품을 등록하는 API 입니다.
상품을 생성할 때는 쿠팡 규격에 맞는 출고지/반품지, 카테고리, 고시정보, 옵션 정보 등이 필요합니다.
아래 상품등록 가이드를 다운받으시면, 보다 상세하게 확인하실 수 있습니다.
[Download] 쿠팡 OPENAPI 상품등록가이드
아래 상품등록 가이드를 다운받으시면, 보다 상세하게 확인하실 수 있습니다.
[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 | O | Number |
노출카테고리코드
카테고리 목록 조회 API 또는 카테고리 정보 excel을 다운받아 노출카테고리코드 확인 가능
|
||||||||||||||||||||||||
sellerProductName | O | String |
등록상품명
발주서에 사용되는 상품명
|
||||||||||||||||||||||||
vendorId | O | String |
업체코드
쿠팡에서 업체에게 발급한 고유 코드. Wing 로그인 후 확인 가능
|
||||||||||||||||||||||||
saleStartedAt | O | String |
판매시작일시
"yyyy-MM-dd'T'HH:mm:ss" 형식
|
||||||||||||||||||||||||
saleEndedAt | O | String |
판매종료일시
"yyyy-MM-dd'T'HH:mm:ss" 형식, *2099년 까지 길게 선택 가능
|
||||||||||||||||||||||||
displayProductName | String |
노출상품명
실제 쿠팡 판매페이지에서 노출되는 상품명.
[brand]+[generalProductName]과 동일하게 입력할 것을 권장, 미입력 상태로도 등록 가능 미입력 시 [brand]+[generalProductName]이 노출되거나, [sellerProductName]이 노출될 수 있음 |
|||||||||||||||||||||||||
brand | O | String |
브랜드
브랜드명은 한글/영어 표준이름 입력
띄어쓰기 및 특수문자 없이 입력 |
||||||||||||||||||||||||
generalProductName | String |
제품명
구매옵션[Attribute exposed] 정보(사이즈, 색상 등)를 포함하지 않는 상품명. 모델명 추가 기입 가능
|
|||||||||||||||||||||||||
productGroup | String |
상품군
상품의 종류를 나타내는 명칭으로 노출카테고리의 최하위명을 참고하여 입력 가능.
제품명[generalProductName]과 중복될 경우, 입력 불필요 |
|||||||||||||||||||||||||
deliveryMethod | O | String |
배송방법
“INSTRUCTURE”와 “MAKE_ORDER_DIRECT”는 “VENDOR_DIRECT”로 통합되었습니다.
신선식품은 반드시 일반배송이 아닌 신선냉동 타입을 선택해주시기 바랍니다.
|
||||||||||||||||||||||||
deliveryCompanyCode | O | String |
택배사 코드
|
||||||||||||||||||||||||
deliveryChargeType | O | String |
배송비종류
● 무료배송 설정 시 초도반품배송비(편도)[deliveryChargeOnReturn]와, 반품배송비(편도)[returnCharge] 금액 설정 ● 유료배송 설정 시 기본배송비[deliveryCharge]와 반품배송비(편도) 금액 설정 ● 조건부 무료배송 설정 시 기본배송비와 반품배송비(편도) 금액 설정 ● 착불배송 설정 시 착불배송 가능 카테고리는 따로 정리되어 있으며, 판매자 안내를 위해 판매자콜센터에 공유가 되었습니다. ※ [CONDITIONAL_FREE] 사용 시, 원하는 조건부 무료배송 금액을 별도로 설정할 수 있습니다.
※ 쿠런티 상품은 '무료배송'과 'FREE_DELIVERY_OVER_9800'만 적용 가능합니다. |
||||||||||||||||||||||||
deliveryCharge | O | Number |
기본배송비
유료배송 또는 조건부 무료배송 시, 편도 배송비 금액 입력
|
||||||||||||||||||||||||
freeShipOverAmount | O | Number |
무료배송을 위한 조건 금액
● 예시 : 10,000원 이상 조건부 무료배송을 설정하기 원할 경우 [deliveryChargeType]을 'CONDITIONAL_FREE'로 설정 후, [freeShipOverAmount]에 10000을 입력
※ 100원 이상 단위로 입력 가능
※ 무료배송인 경우, 0 입력 |
||||||||||||||||||||||||
deliveryChargeOnReturn | O | Number |
초도반품배송비
무료배송인 경우 반품시 소비자가 지불하는 배송비
|
||||||||||||||||||||||||
remoteAreaDeliverable | O | String |
도서산간 배송여부
|
||||||||||||||||||||||||
unionDeliveryType | O | String |
묶음 배송여부
※ 묶음 배송 조건 출고지 정보 필수 입력 (출고지 정보가 같은 상품만 묶음 배송 가능) 착불배송 불가 설정 불가 |
||||||||||||||||||||||||
returnCenterCode | O | String |
반품지센터코드
반품지 생성 후, 추출 된 반품지 센터코드를 입력
● 반품지 생성은 Wing 또는 반품지 생성 API를 통해 가능 ● 반품지 생성이 불가능한 경우, "NO_RETURN_CENTERCODE"를 입력하여 직접 반품지 정보 등록 가능 ※ 반품자동연동 서비스(굿스플로우)는 계약한 택배사가 있어야만 이용이 가능하며, 반품지 센터코드 입력 필수
|
||||||||||||||||||||||||
returnChargeName | O | String |
반품지명
쿠팡 Wing 또는 반품지 조회 API를 통해 반품지 등록 후 확인
'반품지 조회 시, shippingPlaceName로 노출되는 값 입력' |
||||||||||||||||||||||||
companyContactNumber | O | String |
반품지연락처
쿠팡 Wing 또는 반품지 조회 API를 통해 반품지 등록 후 확인
|
||||||||||||||||||||||||
returnZipCode | O | String |
반품지우편번호
쿠팡 Wing 또는 반품지 생성 API를 통해 반품지 등록 후 확인
|
||||||||||||||||||||||||
returnAddress | O | String |
반품지주소
쿠팡 Wing 또는 반품지 생성 API를 통해 반품지 등록 후 확인
|
||||||||||||||||||||||||
returnAddressDetail | O | String |
반품지주소상세
쿠팡 Wing 또는 반품지 생성 API를 통해 반품지 등록 후 확인
|
||||||||||||||||||||||||
returnCharge | O | Number |
반품배송비
반품회수시 편도 배송비
|
||||||||||||||||||||||||
returnChargeVendor | O | String |
착불여부
더 이상 동작하지 않음
착불배송은 deliveryChargeType 파라메터에서 설정 가능합니다.
|
||||||||||||||||||||||||
afterServiceInformation | O | String |
A/S안내
|
||||||||||||||||||||||||
afterServiceContactNumber | O | String |
A/S전화번호
|
||||||||||||||||||||||||
outboundShippingPlaceCode | O | Number |
출고지주소코드
묶음 배송 선택할 경우 필수, 출고지 조회 API를 통해 조회 가능
|
||||||||||||||||||||||||
vendorUserId | O | String |
실사용자아이디(쿠팡 Wing ID)
업체(Vendor)에 소속된 사용자아이디
|
||||||||||||||||||||||||
requested | O | Boolean |
자동승인요청여부
상품 등록 시, 자동으로 판매승인요청을 진행할지 여부 선택
● false : 작성 내용만 저장하고 판매요청 전 상태 (판매를 원할 시에는 상품 승인요청 API 또는 wing에서 판매요청을 진행 해야 함) ● true : 저장 및 자동으로 판매 승인 요청 |
||||||||||||||||||||||||
items | O | List |
업체상품옵션목록
최대 200개 옵션 등록 가능
|
||||||||||||||||||||||||
itemName | O | String |
업체상품옵션명
각각의 아이템에 중복되지 않도록 기입
사이트에 노출되는 옵션명이 아니며, 구매옵션에 따라 변경될 수 있음 |
||||||||||||||||||||||||
originalPrice | O | Number |
할인율기준가 (정가표시)
할인율(%)표시를 위한 할인전 금액으로, 판매가격과 동일하게 입력시 '쿠팡가'로 노출. 승인완료 이후 할인율기준가 수정은 [옵션별 할인율기준가 변경] API를 통해 변경가능
|
||||||||||||||||||||||||
salePrice | O | Number |
판매가격
판매가격을 입력.
'최초' 업체상품 등록시 판매가격은 상품 승인 요청 전에만 가능하며, 승인완료 이후 판매가격 수정은 [옵션별 가격 변경] API를 통해 변경가능 |
||||||||||||||||||||||||
maximumBuyCount | O | Number |
판매가능수량
판매가능한 재고수량을 입력.
'최초' 업체상품 등록시 판매수량은 상품 승인 요청 전에만 가능하며, 승인완료 이후 재고 수정은 [옵션별 수량 변경] API를 통해 변경가능 |
||||||||||||||||||||||||
maximumBuyForPerson | O | Number |
인당 최대 구매 수량
1인당 최대 구매 가능한 수량.
제한이 없을 경우 ‘0’을 입력 (예: 인당 최대 구매 수량 100, 최대 구매 수량 기간 3 입력 시, 1인당 3일 동안 최대 100개까지 구매 가능함을 의미) |
||||||||||||||||||||||||
maximumBuyForPersonPeriod | O | Number |
최대 구매 수량 기간
1인당 해당 상품을 구매할 수 있는 주기 설정.
제한이 없을 경우 ‘1’을 입력 (예: 인당 최대 구매 수량 100, 최대 구매 수량 기간 3 입력 시, 1인당 3일 동안 최대 100개까지 구매 가능함을 의미) |
||||||||||||||||||||||||
outboundShippingTimeDay | O | Number |
기준출고일(일)
주문일(D-Day) 이후 배송을 위한 출고예정일자를 '일' 단위로 입력. (다음날(D+1) 출고일 경우 '1' 입력)
|
||||||||||||||||||||||||
unitCount | O | Number |
단위수량
상품에 포함된 수량을 입력하면 (판매가격 ÷ 단위수량) 로 계산하여 (1개당 가격 #,000원) 으로 노출. 개당가격이 필요하지 않은 상품은 '0'을 입력
|
||||||||||||||||||||||||
adultOnly | O | String |
19세이상
|
||||||||||||||||||||||||
taxType | O | String |
과세여부
|
||||||||||||||||||||||||
parallelImported | O | String |
병행수입여부
|
||||||||||||||||||||||||
overseasPurchased | O | String |
해외구매대행여부
|
||||||||||||||||||||||||
pccNeeded | O | Boolean |
PCC(개인통관부호) 필수/비필수 여부
해외구매대행 상품의 경우 상품 PCC(개인통관번호)
필수/비필수 여부 기본값 : 비필수(false) true를 입력할 경우 구매시 고객이 개인통관부호를 반드시 입력해야하나, false일 경우 입력하지 않고 상품구매가 가능. |
||||||||||||||||||||||||
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 |
상품인증정보코드
인증기관에서 발급받은 코드
|
|||||||||||||||||||||||||
searchTags | List |
검색어
검색어는 최대 40개까지 입력 가능. 한 단어는 20자 이내로 입력 가능
|
|||||||||||||||||||||||||
images | O | List |
이미지목록
필요한 만큼 반복 입력 가능
|
||||||||||||||||||||||||
imageOrder | O | Number |
이미지표시순서
0,1,2...
|
||||||||||||||||||||||||
imageType | O | String |
이미지타입
대표이미지 타입
3MB 이하의 정사각형 이미지를 JPG, PNG로 등록 가능 (최소 500 x 500px, 최대 5000 x 5000px) ● 필수 REPRESENTATION : 정사각형 대표이미지 ● 선택 DETAIL : 기타이미지 (최대 9개까지 등록 가능) USED_PRODUCT : 중고상태 이미지 (최대 4개까지 등록 가능) |
||||||||||||||||||||||||
cdnPath | O | String |
쿠팡CDN경로
쿠팡 CDN 에 올린 경우 직접 입력, vendorPath와 cdnPath 중 하나 이상 필수
최대 길이 : 150 |
||||||||||||||||||||||||
vendorPath | O | String |
업체이미지경로
업체에서 사용하는 이미지 경로, http://로 시작하는 경로일 경우 자동 다운로드하여 쿠팡 CDN에 추가됨, vendorPath와 cdnPath 중 하나 이상 필수
최대 길이 : 150 |
||||||||||||||||||||||||
notices | O | List |
상품고시정보 목록
카테고리 메타 정보 조회 API 또는 전체카테고리 리스트 Excel file을 통해, 필요한 고시정보 항목의 확인 및 선택 가능
|
||||||||||||||||||||||||
noticeCategoryName | O | String |
상품고시정보카테고리명
카테고리별 입력 가능한 상품고시정보 카테고리 중 하나를 입력
카테고리 메타 정보 조회 API 또는 전체 카테고리 정보 Excel file을 통해, 필요한 고시정보 항목의 확인 및 선택 가능 |
||||||||||||||||||||||||
noticeCategoryDetailName | O | String |
상품고시정보카테고리상세명
|
||||||||||||||||||||||||
content | O | String |
내용
|
||||||||||||||||||||||||
attributes | O | List |
옵션목록(속성)
카테고리 기준으로 정해진 옵션 목록을 입력하는 객체
등록하기 원하는 구매옵션 개수 만큼 반복 입력 가능 구매옵션(attribute exposed)의 모든 값이 중복될 경우 등록 불가
한개 이상 필수 등록이며, 입력을 원하지 않는 속성은 attributes 목록에서 제거 또는 attributeValueName을 ""로 입력하여 전송 |
||||||||||||||||||||||||
attributeTypeName | O | String |
옵션타입명
카테고리 메타 정보 조회 API 또는 전체카테고리 리스트 다운로드 엑셀 파일을 통해, 카테고리에 맞는 옵션타입명 확인 및 선택 가능
|
||||||||||||||||||||||||
attributeValueName | O | String |
옵션값
옵션타입명[attributeTypeName]에 해당하는 Value를 단위와 함께 입력 (예시 : "200ml")
|
||||||||||||||||||||||||
contents | O | List |
컨텐츠목록
필요한 만큼 반복 입력 가능
|
||||||||||||||||||||||||
contentsType | O | String |
컨텐츠타입
|
||||||||||||||||||||||||
contentDetails | O | List |
상세컨텐츠목록
|
||||||||||||||||||||||||
content | O | String |
내용
|
||||||||||||||||||||||||
detailType | O | String |
세부타입
|
||||||||||||||||||||||||
offerCondition | String |
상품상태
상품 생성 후에는 offerCondition 변경 불가능
노출카테고리 코드에 따라 아래 값을 선택가능, 없을 경우 NEW로 취급함
|
|||||||||||||||||||||||||
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 | O | String |
제조사
정확한 제조사를 기입할 수 없는 경우, [brand] 항목과 동일하게 입력 가능
|
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,
"returnChargeVendor": "N",
"afterServiceInformation": "A/S안내 1544-1255",
"afterServiceContactNumber": "1544-1255",
"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"
}
],
"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"
}
],
"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": "아모레퍼시픽"
}
Response Message
Name | Type | Description | ||||
---|---|---|---|---|---|---|
code | String |
결과코드
SUCCES/ERROR
|
||||
message | String |
메세지
|
||||
data | Long |
업체상품아이디
생성된 업체상품아이디
|
Response Example
{
"code": "200",
"message": "",
"data": {
"code": "SUCCESS",
"message": "",
"data": 427011919
}
}
Error Spec
Status | Message |
---|---|
400 | 카테고리의 필수 속성이 존재하지 않습니다. : 속성(attributes) 값 중에서 필수(MANDATORY)로 입력해야할 항목을 누락했을 경우 발생하는 에러, 카테고리메타정보 조회 API를 통해 확인 및 필수 속성 값 입력 필요함. |
400 | 입력값에 오류가 있습니다. line: *** (예:123) : 해당 line 상에 오류 수정 필요. |
400 | 올바른 반품지 센터코드를 입력 하세요. : 출고지, 반품지 조회 API를 이용하여 올바른 출고지, 반품지 코드를 입력필요. |
400 | java.lang.NullPointerException : 요청한 JSON 전문에 오탈자가 있는지 확인 필요. |
400 | 입력된 상품필수 고지정보[예) 제조자 및 제조판매업자]가 카테고리[예)화장품]에서 제공하는 것과 다릅니다. : 입력한 고시정보에 문제가 있을 경우 발생하는 에러로 카테고리메타정보를 조회하여 입력한 고시정보와 정확히 일치하는지 확인 필요. |
400 | 배송비 종류가 19800이상 무료배송이면 조건부무료가 19800원, 초도배송비가 0원 입니다. : freeShipOverAmount:19800 로 설정했을 경우 초도배송비(deliveryChargeOnReturn)값이 0인지 확인 필요. |
400 | [택배사 코드]를 확인해 주세요. : 도서산간 배송을 설정했을 경우(remoteAreaDeliverable : "Y") 출고지에 등록한 택배사만 입력이 가능함. |
401 | UNAUTHORIZATION : 잘못된 인증 정보. |
※ 주의사항
"code": "SUCCESS"
상품 생성에 성공하였다는 메시지를 확인 하신 후, [상품 목록 구간 조회 API] 또는 WING을 통해서 상품의 상태가 '승인완료' 상태인지 확인하실 것을 권장드립니다.
- '승인반려' 상태일 경우, 반려 사유를 확인하시고 수정하여 재전송해주시기 바랍니다.
- '승인반려' 사유는 'WING'에서 상태변경이력을 확인하시거나 [상품 상태 변경 이력 조회 API]를 통해서 확인하실 수 있습니다.