coupang
API 문서
상품 API카테고리 API브랜드 API배송 / 주문 API반품 API교환 API프로모션 / 쿠폰물류 정보고객 문의정산Rocket Growth
PUT/v2/providers/seller_api/apis/api/v1/marketplace/seller-productsv1

상품 수정 (승인필요)

# 01

요약

API 적용 가능한 구매자 사용자 지역: 한국,대만 업체상품 정보를 수정한다. '상품 조회 API'를 이용하여 조회된 JSON 전문에서 원하는 값 만 수정 후, 전체 JSON 전문을 전송 하여 수정이 가능합니다. 이 API를 사용하면 승인 후에 반영됩니다.

# 02

상세

API 적용 가능한 구매자 사용자 지역: 한국,대만
업체상품 정보를 수정한다.
'상품 조회 API'를 이용하여 조회된 JSON 전문에서 원하는 값 만 수정 후, 전체 JSON 전문을 전송하여 수정이 가능합니다.

이 API를 사용하면 승인 후에 반영됩니다.


상품 생성 시 사용한 request body에, [sellerProductId]와 [sellerProductItemId]를 삽입하여 수정 가능
- 옵션 수정 : 수정하고 싶은 옵션의 아이템 상단에 [sellerProductItemId]와 [vendorItemId] 삽입 후, 원하는 [attributeValueName]으로 수정하여 전송
- 옵션 삭제 : 삭제하고 싶은 옵션의 'items 배열 하위 값'을 제거하고, 남기고 싶은 아이템 상단에 [sellerProductItemId] 삽입 후 전송 (이미 승인완료된 이력이 있는 옵션은 삭제 불가)
- 옵션 추가 : [sellerProductItemId]를 입력하지 않고 items 배열을 추가하여 전송

※ [sellerProductItemId]는 상품 조회 API를 이용해 확인가능합니다.
※ 승인 완료된 상품의 판매가격, 자동 가격 정보, 재고수량, 판매상태, 할인율 기준가는 상품수정API가 아닌, [상품 아이템별 수량/가격/판매여부/할인율기준가 변경] API를 통해 가능합니다.

Path

PUT

/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
sellerProductId O Number
등록상품ID
상품 생성 완료 시, 출력 된 등록상품 아이디 (data)
displayCategoryCode O Number
노출카테고리코드
상품 등록 후, 셀러의 직접 변경 불가
sellerProductName O String
등록상품명
발주서에 사용되는 상품명
최대 길이 : 100 자
vendorId O String
판매자ID
쿠팡에서 업체에게 발급한 고유 코드
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]이 노출될 수 있음
최대 길이 : 100 자
brand   String
브랜드
브랜드명은 한글/영어 표준이름 입력
띄어쓰기 및 특수문자 없이 입력
generalProductName   String
제품명
구매옵션[Attribute exposed] 정보(사이즈, 색상 등)를 포함하지 않는 상품명. 모델명 추가 기입 가능
productGroup   String
상품군
상품의 종류를 나타내는 명칭으로 노출카테고리의 최하위명을 참고하여 입력 가능.
제품명[generalProductName]과 중복될 경우, 입력 불필요
deliveryMethod O String
배송방법
Parameter Name Status
SEQUENCIAL 일반배송
(순차배송)
COLD_FRESH 신선냉동
MAKE_ORDER 주문제작
AGENT_BUY 구매대행
VENDOR_DIRECT 설치배송 또는 판매자 직접 전달
deliveryCompanyCode O String
택배사 코드
택배사 코드 바로가기
deliveryChargeType O String
배송비종류
Parameter Name Status
FREE 무료배송
NOT_FREE 유료배송
CHARGE_RECEIVED 착불배송
CONDITIONAL_FREE 조건부 무료배송


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

※ [CONDITIONAL_FREE] 사용 시, 원하는 조건부 무료배송 금액을 별도로 설정할 수 있습니다.
deliveryCharge O Number
기본배송비
유료배송 또는 조건부 무료배송 시, 편도 배송비 금액 입력
freeShipOverAmount O Number
무료배송을 위한 조건 금액
● 예시 : 10,000원 이상 조건부 무료배송을 설정하기 원할 경우 [deliveryChargeType]을 'CONDITIONAL_FREE'로 설정 후, [freeShipOverAmount]에 10000을 입력
※ 100원 이상 단위로 입력 가능
※ 무료배송인 경우, 0 입력
deliveryChargeOnReturn O Number
초도반품배송비
무료배송인 경우 반품시 소비자가 지불하는 배송비
remoteAreaDeliverable O String
도서산간 배송여부
Parameter Name Status
Y 도서산간 배송
N 도서산간 배송안함
unionDeliveryType O String
묶음 배송여부
Parameter Name Status
UNION_DELIVERY 묶음 배송 가능
NOT_UNION_DELIVERY 묶음 배송 불가능


※ 묶음 배송 조건
출고지 정보 필수 입력 (출고지 정보가 같은 상품만 묶음 배송 가능)
착불배송 불가 설정 불가
returnCenterCode O String
반품지센터코드
반품지 생성 후, 추출 된 반품지 센터코드를 입력
● 반품지 생성은 Wing 또는 반품지 생성 API를 통해 가능
● 반품지 생성이 불가능한 경우, "NO_RETURN_CENTERCODE"를 입력하여 직접 반품지 정보 등록 가능
※ 반품자동연동 서비스(굿스플로우)는 계약한 택배사가 있어야만 이용이 가능하며, 반품지 센터코드 입력 필수
returnChargeName O String
반품지담당자명
쿠팡 Wing 또는 반품지 생성 API를 통해 반품지 등록 후 확인
companyContactNumber O String
반품지연락처
쿠팡 Wing 또는 반품지 생성 API를 통해 반품지 등록 후 확인
returnZipCode O String
반품지우편번호
쿠팡 Wing 또는 반품지 생성 API를 통해 반품지 등록 후 확인
returnAddress O String
반품지주소
쿠팡 Wing 또는 반품지 생성 API를 통해 반품지 등록 후 확인
returnAddressDetail O String
반품지주소상세
쿠팡 Wing 또는 반품지 생성 API를 통해 반품지 등록 후 확인
returnCharge O Number
반품배송비
반품회수시 편도 배송비
outboundShippingPlaceCode O Number
출고지주소코드
묶음 배송 선택할 경우 필수, 출고지 조회 API를 통해 조회 가능
해외구매대행(AGENT_BUY) 선택시 해외주소지만 입력가능함
vendorUserId O String
실사용자아이디(쿠팡 WING 아이디)
업체(Vendor)에 소속된 사용자아이디
requested O Boolean
자동승인요청여부
상품 등록 시, 자동으로 판매승인요청을 진행할지 여부 선택
● false : 작성 내용만 저장. (판매를 원할 시에는 상품 승인요청 API 또는 wing에서 판매요청을 진행 해야 함)
● true : 저장 및 자동으로 판매 승인 요청
items O List
업체상품옵션목록
  sellerProductItemId  O Number
업체상품옵션아이디
상품 등록 후, 각 옵션에 따라 부여 된 아이디. 상품 조회 API를 통해 확인 가능
기존 옵션 수정시 필수이며, 새로운 옵션 추가 시에는 null로 입력
  vendorItemId  O Number
옵션아이디
임시저장 상태일 경우 값이 null 입니다. 상품 승인완료 시에 값이 표시됩니다.
  itemName  O String
업체상품옵션명
각각의 아이템에 중복되지 않도록 기입
사이트에 노출되는 옵션명이 아니며, 구매옵션에 따라 변경될 수 있음
최대 길이 : 150 자
  originalPrice  O Number
할인율기준가
할인율(%)표시를 위한 할인전 금액, 판매가격과 동일하게 입력시 '쿠팡가'(saleprice)로 노출.
승인완료 이후 할인율기준가 수정은 [상품 아이템별 할인율 기준가격 변경] API를 통해 변경 가능
  salePrice  O  Number
판매가격
상품 수정 API를 통한 판매가격 수정은 상품 승인 요청 전에만 가능
승인완료 이후 판매가격 수정은 [상품 아이템별 가격 변경] API를 통해 변경 가능
  autoPricingInfo   Object 자동 가격 조정 설정. 승인 요청 전에만 본 API로 변경 가능; 승인 후에는 [옵션 단위 가격 변경] API 사용. 내부 OSellerProduct.autoPricingInfo로 매핑
    minSalePrice   Number 자동 가격 조정 최저 판매가. 기존 salePrice보다 작아야 함
    active   Boolean 자동 가격 조정 활성화 여부 (true/false)
  maximumBuyCount  O Number
판매가능수량
판매가능한 재고수량.
상품 수정 API를 통한 판매수량 수정은 상품 승인 요청 전에만 가능
승인완료 이후 재고 수정은 [상품 아이템별 수량 변경] 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
단위수량

unitCount 필드는 하나의 상품 리스팅에 포함된 개별 구성품의 수량을 정의합니다.
이 값은 시스템이 최종 사용자에게 단위 가격(예: 그램당 가격, 개당 가격, ml당 가격)을 계산 및 표시하는 데 사용되어, 대용량 또는 번들 상품의 가격 투명성을 보장합니다.

단일 구성품으로 이루어진 상품의 경우, 이 값을 1로 설정하십시오.

중요:
이 값은 오직 가격 계산 목적으로만 사용되며, 상품의 재고 수량을 정의하거나 설정하는 용도로 사용해서는 안 됩니다.
  adultOnly O  String
19세이상
Parameter Name Status
ADULT_ONLY 19세이상 구입 가능 상품
EVERYONE 전연령 구입 가능 상품
  taxType O String
과세여부
Parameter Name Status
TAX 과세
FREE 비과세
  parallelImported O String
병행수입여부
Parameter Name Status
PARALLEL_IMPORTED 병행수입
NOT_PARALLEL_IMPORTED 병행수입 아님
  overseasPurchased O  String
해외구매대행여부
Parameter Name Status
OVERSEAS_PURCHASED 구매대행
NOT_OVERSEAS_PURCHASED 구매대행 아님
  pccNeeded O 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 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 중 하나 이상 필수
최대길이 : 200 자
    vendorPath O String
업체이미지경로
업체에서 사용하는 이미지 경로, http://로 시작하는 경로일 경우 자동 다운로드하여 쿠팡 CDN에 추가됨, vendorPath와 cdnPath 중 하나 이상 필수
80, 443 Port 이미지 경로만 사용가능
최대길이 : 200 자
  notices O List
상품고시정보 목록
카테고리 메타 정보 조회 API 또는 전체카테고리 리스트 Excel file을 통해, 필요한 고시정보 항목의 확인 및 선택 가능
    noticeCategoryName O  String
상품고시정보카테고리명
카테고리별 입력 가능한 상품고시정보 카테고리 중 하나를 입력
카테고리 메타 정보 조회 API 또는 전체 카테고리 정보 Excel file을 통해, 필요한 고시정보 항목의 확인 및 선택 가능
    noticeCategoryDetailName O  String
상품고시정보카테고리상세명
    content O  String
내용
  attributes O  List

오픈 속성 관리 (Managing Open Attributes)

1. 오픈 속성 삭제 이제 상품 옵션에서 오픈 속성을 삭제할 수 있습니다. 오픈 속성을 삭제하려면 페이로드(Payload)의 attributes 배열에서 해당 속성의 전체 요소를 제외(생략)하면 됩니다.

2. 오픈 속성 확인 (식별) 오픈 속성인지 식별하려면 카테고리 메타 데이터를 통해 확인해야 합니다. 카테고리 메타 데이터 대조: '카테고리 메타 정보 조회 API'를 호출하십시오. 응답(Response) 내에 해당 attributeTypeName이 존재하지 않는 경우, 이는 오픈 속성입니다.
    attributeTypeName O  String
옵션타입명
카테고리 메타 정보 조회 API 또는 전체카테고리 리스트 다운로드 엑셀 파일을 통해, 카테고리에 맞는 옵션타입명 확인 및 선택 가능
최대 길이 25자 제한
    attributeValueName O  String
옵션값
옵션타입명[attributeTypeName]에 해당하는 Value를 단위와 함께 입력 (예시 : "200ml")
최대 길이 30자 제한
  contents O   List
컨텐츠목록
필요한 만큼 반복 입력 가능
    contentsType O   String
컨텐츠타입
Parameter Name Status
IMAGE 이미지
IMAGE_NO_SPACE 이미지(공백없음)
TEXT 텍스트
IMAGE_TEXT 이미지-텍스트
TEXT_IMAGE 텍스트-이미지
IMAGE_IMAGE 이미지-이미지
TEXT_TEXT 텍스트-텍스트
TITLE 제목
HTML HTML
    contentDetails O   List
상세컨텐츠목록
      content O   String
내용
      detailType O   String
세부타입
Parameter Name Status
IMAGE 이미지
TEXT 텍스트
  offerCondition   String
상품상태
상품 생성 후에는 offerCondition 변경 불가능
  offerDescription   String
중고상품 상세설명
중고상품 상태를 설명, 700자 제한
offerCondition을 중고로 입력한 경우에만 작성
requiredDocuments   List
구비 서류 필수인 경우 입력
  templateName   String
구비서류템플릿명
  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

{
  "sellerProductId": 309323422,
  "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": "KGB",
  "deliveryChargeType": "FREE",
  "deliveryCharge": 0,
  "freeShipOverAmount": 0,
  "deliveryChargeOnReturn": 5000,
  "remoteAreaDeliverable": "N",
  "unionDeliveryType": "UNION_DELIVERY",
  "returnCenterCode": "1000274592",
  "returnChargeName": "반품지_1",
  "companyContactNumber": "02-1234-678",
  "returnZipCode": "135-090",
  "returnAddress": "서울특별시 강남구 삼성동",
  "returnAddressDetail": "333",
  "returnCharge": 5000,
  "outboundShippingPlaceCode": "74010",
  "vendorUserId": "et5",
  "requested": true,
  "items": [
    {
      "sellerProductItemId": 769536471,
      "itemName": "200ml_1개",
      "originalPrice": 13000,
      "salePrice": 10000,
      "autoPricingInfo": {
        "minSalePrice": 15000,
        "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": "수량",
          "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": ""
    },
    {
      "sellerProductItemId": 769536472,
      "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": "아모레퍼시픽",
  "bundleInfo": {     
    "bundleType": "SINGLE"  
  }
  
}

Response Message

Name Type Description
code String
결과코드
SUCCES/ERROR
message String
메세지
data Long
업체상품아이디
생성된 업체상품아이디

Response Example

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

Error Spec

HTTP 상태 코드 (오류 유형) 오류 메시지 해결 방법
400 (요청변수확인) 카테고리의 필수 속성이 존재하지 않습니다. 속성(attributes) 값 중에서 필수(MANDATORY)로 입력해야할 항목을 누락했을 경우 발생하는 에러, 카테고리메타정보 조회 API를 통해 확인 및 필수 속성 값 입력 필요g합니다.
400 (요청변수확인) 입력값에 오류가 있습니다. line: 123 요청한 JSON 전문의 해당 line 상에 올바른 파라메터, 값, 배열형식을 입력했는지 확인합니다.
400 (요청변수확인) 올바른 반품지 센터코드를 입력 하세요. 출고지, 반품지 조회 API를 이용하여 올바른 출고지, 반품지 코드를 입력했는지 확인합니다.
400 (요청변수확인) java.lang.NullPointerException 요청한 JSON 전문에 오탈자가 있는지 확인이 필요합니다.
400 (요청변수확인) 유효하지 않은 구매 옵션 값 혹은 단위가 존재합니다. Invalid Attribute Value(s) 데이터 형식 혹은 단위가 유효하지 않은 값입니다. 카테고리 메타 정보 조회 API를 통해 유효한 값 유형 확인 바랍니다.
400 (요청변수확인） attributeValueName 값이 올바르지 않습니다. 에러 스펙 가이드를 참고하여 입력 가능한 값을 입력해 주세요.

입력 가능한 기저귀 단계인지 확인해 주세요.
아래 값들만 입력 가능하며, 이 외 시장에 존재하는 단계는 등록 상품 당 1개까지 입력할 수 있습니다.

1단계, 2단계, 3단계, 4단계, 5단계, 6단계, 7단계, 신생아(NB), 소형(S), 중형(M), 대형(L), 특대형(XL), 점보형(2XL), 점보형 이상(3XL)
400 (요청변수확인) 입력된 상품필수 고지정보[예) 제조자 및 제조판매업자]가 카테고리[예)화장품]에서 제공하는 것과 다릅니다. 입력한 고시정보에 문제가 있을 경우 발생하는 에러로 카테고리메타정보를 조회하여 입력한 고시정보("notices": [])와 정확히 일치하는지 확인이 필요합니다.
400 (요청변수확인) 배송비 종류가 19800이상 무료배송이면 조건부무료가 19800원, 초도배송비가 0원 입니다. freeShipOverAmount:19800 로 설정했을 경우 초도배송비(deliveryChargeOnReturn)값을 '0'으로 입력했는지 확인이 필요합니다.
400 (요청변수확인) [택배사 코드]를 확인해 주세요. 도서산간 배송을 설정했을 경우(remoteAreaDeliverable : "Y") 출고지에 등록한 택배사만 입력이 가능합니다. 
400 (요청변수확인) UNAUTHORIZATION 잘못된 인증 정보로 발생한 에러입니다. 올바른 인증이 이루어 졌는지 확인합니다. 
400 (요청변수확인)

배송방법을 확인해 주시기 바랍니다.

 구매대행을 선택한 경우 출고지주소가 해외배송지인지 확인합니다. 국내배송지는 선택할 수 없습니다.
400 (요청변수확인)

배송방법이 구매대행인 경우에는 쿠팡에서 배송을 위해 고객에게 PCCC를 의무적으로 입력하도록 합니다.

 구매대행을 선택한 경우 pccNeeded 파라메터 값을 true로 설정했는지 확인합니다.
400 (요청변수확인)

bundleInfo 는 변경 불가 합니다.

 bundleInfo 는 최초 등록 후 변경 불가 합니다. 수정을 원하시면 새로운 상품으로 간주되어 상품 등록이 필요합니다.
400 (요청변수확인) autoPricingInfo.minSalePrice must be less than salePrice minSalePrice를 salePrice보다 작게 설정하세요
400 (요청변수확인) autoPricingInfo cannot be modified after product approval 승인 이후에는 [옵션 단위 가격 변경] API를 사용하세요

URL API Name

UPDATE_PRODUCT