상품 API – Open APIs

모드 카테고리 구매옵션 입력 변경 안내 FAQ 모음 (2024년 10월 10일)

Q. 무엇이 변경되나요? 쿠팡 카탈로그에서 정의하는 구매 옵션을 반드시 입력해야 하며, 구매 옵션 별 입력 가능한 값에 맞춰 등록 해야합니다. 또한, 자유로운 구매 옵션 구성은 할 수 없습니다. 예를 들어, 음료 카테고리 수량 그리고 개당 용량 혹은 개당 중량을 반드시 입력해야 합니다. “수량: 1개”로 입력하되, 자유로운 옵션 구성 (“옵션: 없음”... 더보기

필수 구매 옵션 혹은 입력 가능한 값 확인하는 방법은 무엇인가요?

카테고리 메타정보 조회 API 조회 시 조건 1 또는 조건 2를 만족하면, 필수 구매 옵션입니다. 조건 1. 다음 파라미터 값을 만족하는 속성 "required": "MANDATORY" "groupNumber": "NONE" "exposed": "EXPOSED" 조건 2. 다음 파라미터 값을 가진 여러 속성 중 하나를 선택해서 입력해야 하는 속... 더보기

상품생성, 수정 시 반품배송비 값 오류가 발생합니다.

입력하신 배송비 및 반품비가 기준에 부합하는지 아래 공지 링크 내용에서 확인해주시기 바랍니다.https://wing.coupang.com/tenants/wing-account/partner/notices/54932 더보기

서플라이허브 , 로켓그로스 상품은 OpenAPI로 조회할 수 있나요?

서플라이허브 , 로켓그로스 상품은 현재 OpenAPI를 지원하지 않습니다. 판매자 배송 상품만 OpenAPI 를 통해 조회하실 수 있는 점 양해부탁드립니다. 더보기

상품구성, 당일출고, 카탈로그 매칭관리, 자동가격조정 기능은 OpenAPI에서 지원되지 않나요?

문의하신 상품구성, 당일출고, 카탈로그 매칭관리, 자동가격조정 기능은 OpenAPI에서 지원하지 않습니다. WING(wing.coupang.com)에서 이용해주시기 바랍니다. 더보기

API 로 상품수정시, '필수 옵션이(개당 중량,기타) 입력되지 않았습니다" 라는 에러가 발생합니다.

API로 쿠팡에 등록된 상품수정 시에는 1. 우선 상품조회 API로 쿠팡에 등록된 상품을 조회하시고 (GET) 2. 조회해온 JSON 형태의 전체 전문에서 수정하실 부분의 값만 변경하신 후 3. 전체 JSON 전문을 수정요청 하셔야 정상적으로 반영됩니다. 상품수정 시 등록되어 있는 상품의 옵션중에 일부가 제외되었을 경우 문의하신 에러 메시지가 출력... 더보기

API로 상품수정 시 '중복된 아이템 이름이 존재합니다.' 라는 에러가 발생합니다.

API로 쿠팡에 등록된 상품수정 시에는 1. 우선 상품조회 API로 쿠팡에 등록된 상품을 조회하시고 (GET) 2. 조회해온 JSON 형태의 전체 전문에서 수정하실 부분의 값만 변경하신 후 3. 전체 JSON 전문을 수정요청 하셔야 정상적으로 반영됩니다. 최초 등록 했던 상품 정보에서 누락된 attributeTypeName, attributeValue... 더보기

API로 상품수정시, '판매중인 상품은 삭제할 수 없습니다.' 라는 에러가 발생합니다.

API로 쿠팡에 등록된 상품수정 시에는 1. 우선 상품조회 API로 쿠팡에 등록된 상품을 조회하시고 (GET) 2. 조회해온 JSON 형태의 전체 전문에서 수정하실 부분의 값만 변경하신 후 3. 전체 JSON 전문을 수정요청 하셔야 정상적으로 반영됩니다. 상품수정 시 등록되어 있는 상품의 옵션중에 일부가 누락 또는 제외되었을 경우 문의하신 에러 메... 더보기

API로 세트 상품은 어떻게 등록하나요?

세트 상품 등록을 원할 경우, 세트 상품을 구성할 수 있는 카테고리를 먼저 선정하셔야 합니다. 아래 첨부 파일을 확인하시어 등록할 상품에 적합한 세트 카테고리 선정 바랍니다. 예시) “여성용 스킨케어 5종 1세트” 상품 등록하고자 함. 카테고리ID: 56180 스킨>기초세트>4종 이상 세트 필수옵션: 수량 옵션값: 1세트 더보기

단일상품으로 등록된 상품(옵션상품 1개)에 상품수정 API를 통해 옵션을 추가할 수 있나요?

단일 상품으로 등록된 상품(옵션상품 1개)에 상품수정 등으로 옵션 추가가 불가능합니다. 옵션 추가를 원하실 경우 기존 상품은 삭제하시고 새로 상품을 생성하는 것을 추천드립니다. 더보기

API 로 상품등록, 수정 시 입력한 itemName 값이 제대로 노출되지 않습니다.

API JSON 전문상에서 itemName 은 각 item(옵션)을 구분하기 위한 내부용도의 값입니다.API 상의 itemName과 WING 에 표시되는 옵션명은 연관이 없으며 API로 itemName 수정 시 서로 다르게 표시될 수 있습니다.표시 순서 또한 보장이 되지 않으니 이점 참고하시기 바랍니다. 더보기

API로 상품등록 시 '아이템과 같은 옵션 및 옵션값을 가지고 있는 아이템이 중복으로 존재합니다" 라는 에러가 발생합니다.

1. 상품생성 JSON 전문에 있는 옵션 별 itemName 값이 중복이 없는지 체크해주십시요. 2. attribute 배열 내에 attributeTypeName 과 attributeValueName 값을 중복되지 않게 입력했는지 체크해 보시기 바랍니다. 더보기

저는 쇼핑몰 통합 관리 서비스로 상품 등록하고 있습니다. 저는 이 API 변경 사항에 어떻게 입력해야 하나요?

쇼핑몰 통합 관리 서비스를 제공하는 회사의 가이드에 맞게 입력하시면 됩니다. 더보기

대표 또는 기타 이미지 다운로드 실패 사유로 인해 상품승인이 반려되었습니다.

이미지 다운로드가 실패되는 이유는 아래와 같습니다. 1.이미지 다운로드 속도 초과로 TimeOut 2.이미지 호스트 서버에 접근 불가 3.잘못된 이미지 경로 4.이미지 URL 에 80, 443 port 이외의 번호 사용 위 4가지 경우가 아닌 정상적인 이미지에 해당 시 재수정연동을 해보시고 그래도 다운로드 실패 시 온라인 문의로 접수 바랍니다. 더보기

상품 수정 API로 수정 가능한 상태는 언제 인가요?

API로 상품수정은 WING 과 동일하게 승인완료, 승인반려 상태에서 가능합니다. 승인대기 중에는 수정이 불가합니다. 더보기

상품등록 시 고시정보 에러가 발생합니다.

입력한 카테고리 코드를 카테고리메타정보 API로 조회하여 상품등록 시 입력한 고시 정보와 일치하는지 체크해보시기 바랍니다. 더보기

상품수정(승인필요) API 를 통해 배송비종류와 무료배송조건 금액을 변경 하였는데 쿠팡 프런트 에는 언제 반영되나요?

상품수정 (승인필요) API 를 이용해 배송비를 수정 시 승인과정을 거치게 되어 있습니다. 승인 완료 후 쿠팡 프론트에 반영되기 까지 최소 4시간 이상 최대 24시간 까지 걸릴 수 있으니 배송비 수정 시에는 상품 수정 (승인불필요) API를 이용하시기 바랍니다. 더보기

고객으로 부터 개인통관번호(PCC)를 입력받으려면 어떻게 해야 하나요?

상품생성 API 에서 pccNeeded 값을 true 로 설정하면 됩니다. 더보기

병행수입상품은 어떻게 등록하나요?

병행수입 상품을 등록하기 위해서는 아래의 2가지를 확인해주셔야 합니다.1. 병행수입여부(parallelImported) 를 "PARALLEL_IMPORTED" 로 입력합니다. { "parrallelImported": "PARALLEL_IMPORTED",} 2. json 내에 필수 구비서류(requiredDocuments) 등록병행수입 상품의 ... 더보기

상품등록시 검색어의 입력 기준은 어떻게 되나요?

1개의 검색어 당 20자 이내로, 최대 20개의 검색어를 입력하실 수 있습니다. 검색어에는 !@#$%^&*-+;:'. 외의 특수문자는 입력하실 수 없습니다. 일반적으로 상품과 관련된 검색어는 모두 등록이 가능하며, 자세한 검색어에 대한 가이드라인은 링크 내의 가이드를 확인부탁드립니다. [검색어 등록 가이드] 바로가기 더보기

상품등록 API를 호출하였는데 "입력값에 오류가 있습니다." 라는 오류가 발생합니다.

해당 오류는 일반적으로 문제가 있는 Line이 함께 노출됩니다. 전송하신 JSON 전문 중, 해당하는 Line의 내용을 알맞게 수정해주시기 바랍니다. 더보기

판매자가 제공하는 Unique key(상품 관리 코드)를 쿠팡에 등록하여 상품 관리를 하는 방법은 없나요?

상품 생성 시, externalVendorSku (판매자상품 코드)를 넣어주시면, 발주서 등에서 해당 코드를 확인하여 관리할 수 있습니다. 그 외의 값은 extraProperties(옵션추가정보)필드를 이용하시면 됩니다. 실제 프런트에 노출되는 값은 아니며, 업체의 편의를 위해 만들어진 필드입니다. 자사의 별도 관리 코드 및 추가 저장이 필요한 값을 ... 더보기

아이템(벤더아이템)을 추가하고 싶습니다.

items 배열에서 해당하는 옵션의 하위 항목을 모두 추가해 주시기 바랍니다.추가한 옵션에는 sellerProductItemId를 입력하지 않습니다. 더보기

"vendorItem로 생성된 아이템은 삭제가 불가능합니다." 위와 같은 에러가 발생합니다.

승인이 완료된 상품의 옵션을 삭제 시도하여 발생한 오류입니다. 이미 승인 완료된 상품에 대해서는 옵션 삭제가 불가능하오니 해당하는 옵션을 "판매 중지" 처리하여 운영해주시기 바랍니다. 더보기

등록한 옵션 순서대로 사이트에 노출할 수 있나요?

아닙니다. 프런트(판매페이지) 노출순서는 쿠팡 내부 로직에 의해 결정됩니다. 더보기

상품 조회를 하려고 합니다. sellerProductId는 어디서 확인할 수 있을까요?

sellerProductId는 상품 생성 시 Response 값으로 받을 수 있으며, [상품 목록 페이징 조회] 와 [상품 목록 구간 조회]를 통해서도 확인할 수 있습니다. 더보기

"업체상품[********]이 없거나 삭제가 불가능한 상태입니다. 삭제는 '저장중', '임시저장' 상태에서만 가능합니다." 라는 메시지가 노출됩니다.

상품에 포함된 옵션(아이템)이 모두 "판매 중지"된 경우에만 삭제가 가능합니다. 옵션을 판매 중지한 후, 삭제 처리를 재시도 해주시기 바랍니다. 더보기

검색 허용 범위를 초과했습니다. 최대 허용 범위는 10분입니다. 라는 오류메시지가 노출됩니다.

[상품 목록 구간 조회 API]는 설정한 10분 이내의 상품만 조회 가능하니 조회 구간을 재설정하여 주시기 바랍니다. 더보기

상품 승인을 하려는데, sellerProductId는 어떻게 확인하나요?

상품 생성 시, Response 메시지로 해당 값이 출력됩니다. (또는, 판매관리시스템(WING)의 상품조회에서 "등록상품 ID"로 확인 가능합니다.) 더보기

"Object text must begin with '{' at character 0" 라는 오류가 발생합니다.

vendorItemId를 확인 바랍니다. vendorItemId는 상품 승인 완료 시 생성되는 옵션 ID입니다. 해당 값을 확인하여 입력하시기 바랍니다. 더보기

OPENAPI 관련 안내