POST
/v2/providers/seller_api/apis/api/v1/marketplace/seller-products2609170000상품 생성
KRTW
# 01
요약
상품 생성
# 02
상세
API 적용 가능한 구매자 사용자 지역: 한국，대만
쿠팡에서 판매할 상품을 등록하는 API 입니다.
상품을 생성할 때는 쿠팡 규격에 맞는 출고지/반품지, 카테고리, 고시정보, 옵션 정보 등이 필요합니다.
아래 상품등록 가이드를 다운받으시면, 보다 상세하게 확인하실 수 있습니다.
Download 쿠팡 OPENAPI 상품등록가이드
경로
POST/v2/providers/seller_api/apis/api/v1/marketplace/seller-products
예시 엔드포인트
https://api-gateway.coupang.com/v2/providers/seller_api/apis/api/v1/marketplace/seller-productsURL API Name
CREATE_PRODUCT
# 03
요청 본문
요청 파라미터
본문 파라미터
| Name | Type | Description | ||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| displayCategoryCode | integer | 노출카테고리코드 카테고리 목록 조회 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 | 브랜드 브랜드명은 한글/영어 표준이름 입력 띄어쓰기 및 특수문자 없이 입력 브랜드가 없는 상품은 GENERIC을 입력 | ||||||||||||||||||||||||
| brandId | string | 고유 브랜드 식별자 (예: KR-5)
| ||||||||||||||||||||||||
| generalProductName | string | 제품명 구매옵션[Attribute exposed] 정보(사이즈, 색상 등)를 포함하지 않는 상품명. 모델명 추가 기입 가능 | ||||||||||||||||||||||||
| productGroup | string | 상품군 상품의 종류를 나타내는 명칭으로 노출카테고리의 최하위명을 참고하여 입력 가능. 제품명[generalProductName]과 중복될 경우, 입력 불필요 | ||||||||||||||||||||||||
| deliveryMethod* | string | 배송방법
| ||||||||||||||||||||||||
| deliveryCompanyCode* | string | 택배사 코드 택배사 코드 바로가기 | ||||||||||||||||||||||||
| deliveryChargeType* | string | 배송비종류
초도반품배송비(편도)[deliveryChargeOnReturn]와, 반품배송비(편도)[returnCharge] 금액 설정 ● 유료배송 설정 시 기본배송비[deliveryCharge]와 반품배송비(편도) 금액 설정 ● 조건부 무료배송 설정 시 기본배송비와 반품배송비(편도) 금액 설정 ● 착불배송 설정 시 착불배송 가능 카테고리는 따로 정리되어 있으며, 판매자 안내를 위해 판매자콜센터에 공유가 되었습니다. ※ [CONDITIONAL_FREE] 사용 시, 원하는 조건부 무료배송 금액을 별도로 설정할 수 있습니다.
| ||||||||||||||||||||||||
| deliveryCharge* | integer | 기본배송비 유료배송 또는 조건부 무료배송 시, 편도 배송비 금액 입력 | ||||||||||||||||||||||||
| freeShipOverAmount* | integer | 무료배송을 위한 조건 금액 ● 예시 : 10,000원 이상 조건부 무료배송을 설정하기 원할 경우 [deliveryChargeType]을 'CONDITIONAL_FREE'로 설정 후, [freeShipOverAmount]에 10000을 입력 ※ 100원 이상 단위로 입력 가능 ※ 무료배송인 경우, 0 입력 | ||||||||||||||||||||||||
| deliveryChargeOnReturn* | integer | 초도반품배송비 무료배송인 경우 반품시 소비자가 지불하는 배송비 | ||||||||||||||||||||||||
| remoteAreaDeliverable* | string | 도서산간 배송여부
| ||||||||||||||||||||||||
| unionDeliveryType* | string | 묶음 배송여부
출고지 정보 필수 입력 (출고지 정보가 같은 상품만 묶음 배송 가능) 착불배송 불가 설정 불가
| ||||||||||||||||||||||||
| 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* | integer | 반품배송비 반품회수시 편도 배송비 *초도반품배송비와 비교 시, 100~150%까지만 입력 가능 | ||||||||||||||||||||||||
| outboundShippingPlaceCode* | string | 출고지주소코드 묶음 배송 선택할 경우 필수, 출고지 조회 API를 통해 조회 가능 해외구매대행(AGENT_BUY) 선택시 해외주소지만 입력가능함 | ||||||||||||||||||||||||
| vendorUserId* | string | 실사용자아이디(쿠팡 Wing ID) 업체(Vendor)에 소속된 사용자아이디 | ||||||||||||||||||||||||
| requested* | boolean | 자동승인요청여부 상품 등록 시, 자동으로 판매승인요청을 진행할지 여부 선택 ● false : 작성 내용만 저장하고 판매요청 전 상태 (판매를 원할 시에는 상품 승인요청 API 또는 wing에서 판매요청을 진행 해야 함) ● true : 저장 및 자동으로 판매 승인 요청 | ||||||||||||||||||||||||
| items* | object[] | 업체상품옵션목록 최대 200개 옵션 등록 가능 | ||||||||||||||||||||||||
| itemName* items[].itemName | string | 업체상품옵션명 각각의 아이템에 중복되지 않도록 기입 사이트에 노출되는 옵션명이 아니며, 구매옵션에 따라 변경될 수 있음 최대 길이 : 150자 제한 | ||||||||||||||||||||||||
| originalPrice* items[].originalPrice | integer | 할인율기준가 (정가표시) 할인율(%)표시를 위한 할인전 금액으로, 판매가격과 동일하게 입력시 '쿠팡가'로 노출. 승인완료 이후 할인율기준가 수정은 [옵션별 할인율기준가 변경] API를 통해 변경가능 | ||||||||||||||||||||||||
| salePrice* items[].salePrice | integer | 판매가격 판매가격을 입력. '최초' 업체상품 등록시 판매가격은 상품 승인 요청 전에만 가능하며, 승인완료 이후 판매가격 수정은 [옵션별 가격 변경] API를 통해 변경가능 | ||||||||||||||||||||||||
| autoPricingInfo items[].autoPricingInfo | object | 자동 가격 조정 설정. 최초 상품 등록 시 승인 요청 전에만 입력 가능. 승인 후 변경은 [옵션 단위 가격 변경] API 사용. 내부 OSellerProduct.autoPricingInfo로 매핑
| ||||||||||||||||||||||||
| minSalePrice items[].autoPricingInfo.minSalePrice | integer | 자동 가격 조정 최저 판매가. 기존 salePrice보다 작아야 함
| ||||||||||||||||||||||||
| active items[].autoPricingInfo.active | boolean | 자동 가격 조정 활성화 여부 (true/false)
| ||||||||||||||||||||||||
| maximumBuyCount* items[].maximumBuyCount | integer | 판매가능수량 판매가능한 재고수량을 입력. '최초' 업체상품 등록시 판매수량은 상품 승인 요청 전에만 가능하며, 승인완료 이후 재고 수정은 [옵션별 수량 변경] API를 통해 변경가능 최대값 : 99999 | ||||||||||||||||||||||||
| maximumBuyForPerson* items[].maximumBuyForPerson | integer | 인당 최대 구매 수량 1인당 최대 구매 가능한 수량. 제한이 없을 경우 ‘0’을 입력 (예: 인당 최대 구매 수량 100, 최대 구매 수량 기간 3 입력 시, 1인당 3일 동안 최대 100개까지 구매 가능함을 의미) | ||||||||||||||||||||||||
| maximumBuyForPersonPeriod* items[].maximumBuyForPersonPeriod | integer | 최대 구매 수량 기간 1인당 해당 상품을 구매할 수 있는 주기 설정. 제한이 없을 경우 ‘1’을 입력 (예: 인당 최대 구매 수량 100, 최대 구매 수량 기간 3 입력 시, 1인당 3일 동안 최대 100개까지 구매 가능함을 의미) | ||||||||||||||||||||||||
| outboundShippingTimeDay* items[].outboundShippingTimeDay | integer | 기준출고일(일) 주문일(D-Day) 이후 배송을 위한 출고예정일자를 '일' 단위로 입력. (당일출고를 하는 경우 '1'을 입력하세요.다음날(D+1) 출고일 경우 '1' 입력하시기 바랍니다.) | ||||||||||||||||||||||||
| unitCount* items[].unitCount | integer | 단위수량 unitCount 필드는 단일 상품 구성 내에 포함된 개별 단위의 수량을 정의합니다. 시스템은 이 값을 사용하여 최종 사용자에게 '단위당 가격'(예: g당 가격, 개당 가격, ml당 가격 등)을 계산하여 표시함으로써, 대량 상품이나 번들 상품의 가격 투명성을 보장합니다. 단일 단위로 구성된 상품의 경우 이 값을 1로 설정하십시오.
| ||||||||||||||||||||||||
| adultOnly* items[].adultOnly | string | 19세이상
| ||||||||||||||||||||||||
| taxType* items[].taxType | string | 과세여부
| ||||||||||||||||||||||||
| parallelImported* items[].parallelImported | string | 병행수입여부
| ||||||||||||||||||||||||
| overseasPurchased* items[].overseasPurchased | string | 해외구매대행여부
| ||||||||||||||||||||||||
| pccNeeded* items[].pccNeeded | string | PCC(개인통관부호) 필수/비필수 여부 해외구매대행 상품인 경우, 상품 PCC(개인통관번호)는 반드시 true로 입력해야 함
| ||||||||||||||||||||||||
| externalVendorSku items[].externalVendorSku | string | 판매자상품코드 (업체상품코드) 업체고유의 item 코드값을 임의로 세팅할 수 있으며, 입력값은 발주서 조회 API response 에 포함됨. | ||||||||||||||||||||||||
| barcode items[].barcode | string | 바코드 상품에 부착 된 유효한 표준상품 코드 | ||||||||||||||||||||||||
| emptyBarcode items[].emptyBarcode | boolean | 바코드 없음 바코드가 없으면 true | ||||||||||||||||||||||||
| emptyBarcodeReason items[].emptyBarcodeReason | string | 바코드 없음에 대한 사유 최대길이 : 100 자 제한 | ||||||||||||||||||||||||
| modelNo items[].modelNo | string | 모델번호
| ||||||||||||||||||||||||
| extraProperties items[].extraProperties | object | 업체상품옵션추가정보 Key : Value 형태로 필요한 만큼 반복입력가능 | ||||||||||||||||||||||||
| Key items[].extraProperties.Key | string | Value
| ||||||||||||||||||||||||
| certifications items[].certifications | object[] | 상품인증정보 상품 인증 정보 | ||||||||||||||||||||||||
| certificationType items[].certifications[].certificationType | string | 인증정보Type 카테고리 메타정보 조회 API를 통해 등록가능한 Type을 구할 수 있다. 인증대상이 아닌 카테고리일 경우 : NOT_REQUIRED | ||||||||||||||||||||||||
| certificationCode items[].certifications[].certificationCode | string | 상품인증정보코드 인증기관에서 발급받은 코드 | ||||||||||||||||||||||||
| certificationAttachments items[].certifications[].certificationAttachments | object[] | 인증정보 첨부파일 이동통신사전승낙서 및 인증대리점 인증서 등록 시 사용함 1.이동통신 사전승낙서 또는 인증대리점 인증서 2.판매점 사전승낙 인증마크 또는 이동통신사 대리점 인증마크 아래 업체이미지 경로 또는 쿠팡CDN 경로 중 하나 이상 필수 입력 필요
| ||||||||||||||||||||||||
| searchTags items[].searchTags | object[] | 검색어 필요한 만큼 반복입력가능. ["검색어1","검색어2"] 1개의 검색어 당 20자 이내로, 최대 20개의 검색어를 입력가능, !@#$%^&*-+;:’. 외의 특수문자는 입력불가 | ||||||||||||||||||||||||
| images* items[].images | object[] | 이미지목록 필요한 만큼 반복 입력 가능 | ||||||||||||||||||||||||
| imageOrder* items[].images[].imageOrder | integer | 이미지표시순서 0,1,2... | ||||||||||||||||||||||||
| imageType* items[].images[].imageType | string | 이미지타입 대표이미지 타입 3MB 이하의 정사각형 이미지를 JPG, PNG로 등록 가능 (최소 500 x 500px, 최대 5000 x 5000px) ● 필수 REPRESENTATION : 정사각형 대표이미지 ● 선택 DETAIL : 기타이미지 (최대 9개까지 등록 가능) USED_PRODUCT : 중고상태 이미지 (최대 4개까지 등록 가능) | ||||||||||||||||||||||||
| cdnPath* items[].images[].cdnPath | string | 쿠팡CDN경로 쿠팡 CDN 에 올린 경우 직접 입력, vendorPath와 cdnPath 중 하나 이상 필수 최대 길이 : 200 자 | ||||||||||||||||||||||||
| vendorPath* items[].images[].vendorPath | string | 업체이미지경로 업체에서 사용하는 이미지 경로, http://로 시작하는 경로일 경우 자동 다운로드하여 쿠팡 CDN에 추가됨, vendorPath와 cdnPath 중 하나 이상 필수 80, 443 Port 이미지 경로만 사용가능 최대 길이 : 200 자 | ||||||||||||||||||||||||
| notices items[].notices | object[] | 상품고시정보 목록 카테고리 메타 정보 조회 API 또는 전체카테고리 리스트 Excel file을 통해, 필요한 고시정보 항목의 확인 및 선택 가능 | ||||||||||||||||||||||||
| noticeCategoryName items[].notices[].noticeCategoryName | string | 상품고시정보카테고리명 카테고리별 입력 가능한 상품고시정보 카테고리 중 하나를 입력 카테고리 메타 정보 조회 API 또는 전체 카테고리 정보 Excel file을 통해, 필요한 고시정보 항목의 확인 및 선택 가능 | ||||||||||||||||||||||||
| noticeCategoryDetailName items[].notices[].noticeCategoryDetailName | string | 상품고시정보카테고리상세명
| ||||||||||||||||||||||||
| content items[].notices[].content | string | 내용
| ||||||||||||||||||||||||
| attributes* items[].attributes | object[] | 옵션목록(속성) 카테고리 기준으로 정해진 옵션 목록을 입력하는 객체 등록하기 원하는 구매옵션 개수 만큼 반복 입력 가능 ● 구매옵션(attribute exposed)의 모든 값이 중복될 경우 등록 불가 ● 한개 이상 필수 등록 ※ 자유로운 구매옵션 구성(open attribute) 은 아래의 가이드에서 확인할 수 있습니다. 구매옵션 자유 입력 가이드 (20201012 변경사항) | ||||||||||||||||||||||||
| attributeTypeName* items[].attributes[].attributeTypeName | string | 옵션타입명 카테고리 메타 정보 조회 API 또는 전체카테고리 리스트 다운로드 엑셀 파일을 통해, 카테고리에 맞는 옵션타입명 확인 및 선택 가능 (구매옵션은 자유롭게 입력 가능) 최대 길이 25자 제한 | ||||||||||||||||||||||||
| attributeValueName* items[].attributes[].attributeValueName | string | 옵션값 옵션타입명[attributeTypeName]에 해당하는 Value를 단위와 함께 입력 (예시 : "200ml") 최대 길이 30자 제한 | ||||||||||||||||||||||||
| exposed items[].attributes[].exposed | string | 옵션과 검색필터를 구분하는 항목 해당 항목을 제외하고 등록할 경우, 옵션으로 등록되고 해당 항목에 "NONE"이라는 값을 작성할 경우 필터로 등록 됨 검색필터는 반드시 등록하는 카테고리와 일치하는 필터명만 사용 가능 | ||||||||||||||||||||||||
| contents* items[].contents | object[] | 컨텐츠목록 필요한 만큼 반복 입력 가능 | ||||||||||||||||||||||||
| contentsType* items[].contents[].contentsType | string | 컨텐츠타입
| ||||||||||||||||||||||||
| contentDetails* items[].contents[].contentDetails | object[] | 상세컨텐츠목록
| ||||||||||||||||||||||||
| content* items[].contents[].contentDetails[].content | string | 내용
| ||||||||||||||||||||||||
| detailType* items[].contents[].contentDetails[].detailType | string | 세부타입
| ||||||||||||||||||||||||
| offerCondition items[].offerCondition | string | 상품상태 상품 생성 후에는 offerCondition 변경 불가능 노출카테고리 코드에 따라 아래 값을 선택가능, 없을 경우 NEW로 취급함
| ||||||||||||||||||||||||
| offerDescription items[].offerDescription | string | 중고상품 상세설명 중고상품 상태를 설명, 700자 제한 offerCondition을 중고로 입력한 경우에만 작성 | ||||||||||||||||||||||||
| requiredDocuments | object[] | 구비 서류 필수인 경우 입력 구비서류는 5MB이하의 파일 입력 가능 (PDF, HWP, DOC, DOCX, TXT, PNG, JPG, JPEG) | ||||||||||||||||||||||||
| templateName requiredDocuments[].templateName | string | 구비서류템플릿명 카테고리 메타 정보 조회 API에서 확인 가능 | ||||||||||||||||||||||||
| documentPath requiredDocuments[].documentPath | string | 구비서류 쿠팡CDN경로 documentPath 와 vendorDocumentPath 중 하나 필수 최대 길이 : 150자 | ||||||||||||||||||||||||
| vendorDocumentPath requiredDocuments[].vendorDocumentPath | string | 구비서류벤더경로 구비서류 경로, http://로 시작하는 경로일 경우 자동 다운로드하여 쿠팡 CDN에 추가됨. documentPath 와 vendorDocumentPath 중 하나 필수 최대 길이 : 150자 | ||||||||||||||||||||||||
| extraInfoMessage | string | 주문제작 안내 메시지 배송 방법을 '주문제작'으로 선택했을 경우, 고객에게 안내할 메시지를 입력 | ||||||||||||||||||||||||
| manufacture | string | 제조사 정확한 제조사를 기입할 수 없는 경우, [brand] 항목과 동일하게 입력 가능 | ||||||||||||||||||||||||
| bundleInfo | object | 번들상품
| ||||||||||||||||||||||||
| bundleType bundleInfo.bundleType | string | 번들상품 구분 ● SINGLE : 단일구성상품 (기본값) ● AB : 혼합구성상품 혼합 구성 상품 등록 시에는 옵션을 구성할 수 없으며, 번들 상품 정보를 추가한 뒤에는 번들 상품 값을 수정할 수 없습니다. 이는 새로운 상품 등록과 동일한 것으로 간주되어 적용된 사항입니다. 유의사항: AB 번들 상품의 경우 UID(MPN 또는 GTIN)는 필수가 아닙니다. |
요청 예시application/json
{
"displayCategoryCode": 56137,
"sellerProductName": "노트북 파우치 13인치",
"vendorId": "A00012345",
"saleStartedAt": "2017-11-30T00:00:00",
"saleEndedAt": "2099-01-01T23:59:59",
"displayProductName": "노트북 파우치 13인치",
"brand": "삼성전자",
"brandId": "100",
"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": "노트북 파우치 13인치",
"originalPrice": 4980000,
"salePrice": 4960000,
"autoPricingInfo": {
"minSalePrice": 40000000,
"active": true
},
"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": "Global Trade Item Number",
"attributeValueName": "8801234567890",
"exposed": "NONE"
},
{
"attributeTypeName": "Manufacturer Part Number",
"attributeValueName": "T0123456",
"exposed": "NONE"
},
{
"attributeTypeName": "수량",
"attributeValueName": "1개"
}
],
"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": "노트북 파우치 15인치",
"originalPrice": 5000000,
"salePrice": 5000000,
"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": "Global Trade Item Number",
"attributeValueName": "8801234567890",
"exposed": "NONE"
},
{
"attributeTypeName": "Manufacturer Part Number",
"attributeValueName": "T0123456",
"exposed": "NONE"
},
{
"attributeTypeName": "수량",
"attributeValueName": "1개"
}
],
"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"
}
}# 04
응답 본문
응답 메시지
| Name | Type | Description |
|---|---|---|
| code | string | 결과코드 SUCCES/ERROR |
| message | string | 메세지 경고 및 에러 메세지가 포함되어 있으며, 여러 개 포함되어 있을 수 있습니다. |
| data | integer | 등록상품ID =sellerProductId |
| details | string | 에러 및 경고 상황에 대해 상세 설명되어 있습니다.
|
| errorItems | object[] | Product registration error items.
|
| itemIndex errorItems[].itemIndex | integer | |
| itemName errorItems[].itemName | string | |
| itemAttributes errorItems[].itemAttributes | object[] | |
| attributeTypeName errorItems[].itemAttributes[].attributeTypeName | string | |
| attributeValueName errorItems[].itemAttributes[].attributeValueName | string | |
| message errorItems[].itemAttributes[].message | string |
Response Example
Success Response Example
{
"code": "200",
"message": "",
"data": {
"code": "SUCCESS",
"message": "",
"data": 427011919
}
}Response Example
Notable Response Example
1) 'ERROR' 응답 예시 이 경우 상품 등록에 실패했습니다. 필수 구매 옵션 속성을 추가해야 합니다.
{
"code": "ERROR",
"message": "[]. 유효하지 않은 구매 옵션 값 혹은 단위가 존재합니다.",
"data": null,
"details": "'30 개입'의 단위값이 유효하지 않습니다. '40 개입'의 단위값이 유효하지 않습니다. 다음과 같이 필수 구매 옵션 (미입력시 등록/노출 제한)을 입력해주세요. : '총 수량'. 자세한 사항은 아래 errorItems 에서 확인할 수 있습니다. 또한, 카테고리 메타 정보 조회 API(https://developers.coupangcorp.com/hc/en-us/articles/360034035713-Category-Metadata-Query) 혹은 공지사항에서 업데이트된 내용 확인할 수 있으며, 상품 생성 API (https://developers.coupangcorp.com/hc/en-us/articles/360033877853-Product-Creation)에서 업데이트된 에러 스펙 확인할 수 있습니다.",
"errorItems": [
{
"itemIndex": 0,
"itemName": "190ml 30개",
"itemAttributes": [
{
"attributeTypeName": "총 수량",
"attributeValueName": null,
"message": "필수 구매 옵션 (미입력시 등록/노출 제한) 존재하지 않습니다."
}
]
},
{
"itemIndex": 1,
"itemName": "190ml 40개",
"itemAttributes": [
{
"attributeTypeName": "총 수량",
"attributeValueName": "40 개입",
"message": "유효하지 않은 단위값입니다."
}
]
}
]
}Response Example
2) 'Success' 응답 예시
이 경우 MOTA 에러가 발생했으며, 속성 값을 업데이트해야 합니다.
{
"code": "SUCCESS",
"message": "[]",
"data": 16009258995,
"details": "다음과 같이 필수 구매 옵션을 입력해주세요. : '개당 용량' or '개당 중량'. 다음과 같이 필수 구매 옵션 (미입력시 등록/노출 제한)을 입력해주세요. : '개당 용량' and '개당 중량'. 자세한 사항은 아래 errorItems 에서 확인할 수 있습니다. 또한, 카테고리 메타 정보 조회 API(https://developers.coupangcorp.com/hc/en-us/articles/360034035713-Category-Metadata-Query) 혹은 공지사항에서 업데이트된 내용 확인할 수 있으며, 상품 생성 API (https://developers.coupangcorp.com/hc/en-us/articles/360033877853-Product-Creation)에서 업데이트된 에러 스펙 확인할 수 있습니다.",
"errorItems": [
{
"itemIndex": 0,
"itemName": "350ml 1개",
"itemAttributes": [
{
"attributeTypeName": "개당 용량",
"attributeValueName": null,
"message": "번들 속성 그룹(groupNumber=1)의 '개당 용량', '개당 중량'에서 필수 속성을 하나만 선택합니다"
},
{
"attributeTypeName": "개당 중량",
"attributeValueName": null,
"message": "번들 속성 그룹(groupNumber=1)의 '개당 용량', '개당 중량'에서 필수 속성을 하나만 선택합니다"
},
{
"attributeTypeName": "개당 용량",
"attributeValueName": null,
"message": "필수 구매 옵션 (미입력시 등록/노출 제한) 존재하지 않습니다."
},
{
"attributeTypeName": "개당 중량",
"attributeValueName": null,
"message": "필수 구매 옵션 (미입력시 등록/노출 제한) 존재하지 않습니다."
}
]
}
]
}# 05
에러 코드
| HTTP | 코드 | 메시지 |
|---|---|---|
| 400 | HTTP_400 | Bad Request |
오류 사양
| HTTP | 유형 | 오류 메시지 | 해결 방법 |
|---|---|---|---|
| 400 | 400 (요청변수확인) | 필수 구매 옵션이 존재하지 않습니다. Missing Attribute(s) | 카테고리 메타정보 조회 API를 통해 필수 구매 옵션이 무엇인지 확인 후 상품 등록 진행 바랍니다. |
| 400 | 400 (요청변수확인) | 유효하지 않은 구매 옵션이 존재합니다. Attribute(s) Not Allowed | 자유로운 구매 옵션 구성이 제한된 카테고리입니다. 필수 구매 옵션만 입력 바랍니다. |
| 400 | 400 (요청변수확인) | 유효하지 않은 구매 옵션 값 혹은 단위가 존재합니다. Invalid Attribute Value(s) | 데이터 형식 혹은 단위가 유효하지 않은 값입니다. 카테고리 메타 정보 조회 API를 통해 유효한 값 유형 확인 바랍니다. |
| 400 | 400 (요청변수확인) | 필수 구매 옵션(미입력 시 등록/노출 제한)이 존재하지 않습니다. | 필수 구매 옵션을 입력해 주세요. 상품 상세 정보를 확인하여 필수 옵션 값이 올바르게 입력되었는지 확인하시기 바랍니다. |
| 400 | 400 (요청변수확인) | The value of attributeValueName is incorrect. Please enter the acceptable values as following the error spec guide. | 입력 가능한 기저귀 단계인지 확인해 주세요. 1단계, 2단계, 3단계, 4단계, 5단계, 6단계, 7단계, 신생아(NB), 소형(S), 중형(M), 대형(L), 특대형(XL), 점보형(2XL), 점보형 이상(3XL) |
| 400 | 400 (요청변수확인) | 카테고리의 필수 속성이 존재하지 않습니다. | 속성(attributes) 값 중에서 필수(MANDATORY)로 입력해야할 항목을 누락했을 경우 발생하는 에러, 카테고리메타정보 조회 API를 통해 확인 및 필수 속성 값 입력 필요합니다. |
| 400 | 400 (요청변수확인) | 입력값에 오류가 있습니다. line: 123 | 요청한 JSON 전문의 해당 line 상에 올바른 파라메터, 값, 배열형식을 입력했는지 확인합니다. |
| 400 | 400 (요청변수확인) | 올바른 반품지 센터코드를 입력 하세요. | 출고지, 반품지 조회 API를 이용하여 올바른 출고지, 반품지 코드를 입력했는지 확인합니다. |
| 400 | 400 (요청변수확인) | java.lang.NullPointerException | 요청한 JSON 전문에 오탈자가 있는지 확인이 필요합니다. |
| 400 | 400 (요청변수확인) | 입력된 상품필수 고지정보[예) 제조자 및 제조판매업자]가 카테고리[예)화장품]에서 제공하는 것과 다릅니다. | 입력한 고시정보에 문제가 있을 경우 발생하는 에러로 카테고리메타정보를 조회하여 입력한 고시정보("notices": [])와 정확히 일치하는지 확인이 필요합니다. |
| 400 | 400 (요청변수확인) | 배송비 종류가 19800이상 무료배송이면 조건부무료가 19800원, 초도배송비가 0원 입니다. | freeShipOverAmount:19800 로 설정했을 경우 초도배송비(deliveryChargeOnReturn)값을 '0'으로 입력했는지 확인이 필요합니다. |
| 400 | 400 (요청변수확인) | [택배사 코드]를 확인해 주세요. | 도서산간 배송을 설정했을 경우(remoteAreaDeliverable : "Y") 출고지에 등록한 택배사만 입력이 가능합니다. |
| 400 | 400 (요청변수확인) | UNAUTHORIZATION | 잘못된 인증 정보로 발생한 에러입니다. 올바른 인증이 이루어 졌는지 확인합니다. |
| 400 | 400 (요청변수확인) | 배송방법을 확인해 주시기 바랍니다. | 구매대행을 선택한 경우 출고지주소가 해외배송지인지 확인합니다. 국내배송지는 선택할 수 없습니다. |
| 400 | 400 (요청변수확인) | 배송방법이 구매대행인 경우에는 쿠팡에서 배송을 위해 고객에게 PCCC를 의무적으로 입력하도록 합니다. | 구매대행을 선택한 경우 pccNeeded 파라메터 값을 true로 설정했는지 확인합니다. |
| 400 | 400 (요청변수확인) | 혼합 구성 상품 등록할 때, 여러 개 옵션 구성은 불가능 합니다. | 혼합 구성 상품 등록할 때, 노출 옵션을 제거해주세요 |
| 400 | 400 (요청변수확인) | 혼합 구성 상품 등록할 때, 속성(attributeTypeName) 입력할 수 없습니다. | 혼합 구성 상품 등록할 때, 속성(attributeTypeName)을 제거해주세요. |
| 400 | 400 (요청변수확인) | bundleInfo에서 허용하지 않는 값입니다. | bundleInfo에 SINGLE, AB 값만 가능합니다. |
| 400 | 400 (요청변수확인) | autoPricingInfo.minSalePrice must be less than salePrice | minSalePrice를 salePrice보다 작게 설정하세요 |
| 400 | 400 (요청변수확인) | autoPricingInfo cannot be modified after product approval | 승인 이후에는 [옵션 단위 가격 변경] API를 사용하세요 |