쿠팡 옵션ID는 어디서 확인하고 어디에 쓰나?

결론부터 정리

쿠팡에서 흔히 말하는 옵션ID는 Open API 필드명으로 vendorItemId입니다. 실제로 판매되는 색상·사이즈·구성 한 개를 가리키는 가장 작은 단위입니다.

예를 들어 같은 식기건조매트라도 아래 옵션은 서로 다른 옵션ID를 가집니다.

• 그레이 / 대형 / 1개
• 그레이 / 대형 / 2개
• 블랙 / 대형 / 1개

옵션ID는 단순 조회용 번호가 아닙니다. 가격과 재고, 주문과 반품, 광고와 정산 자료를 같은 옵션 기준으로 연결할 때 핵심이 됩니다.

옵션ID는 어디서 확인하나요?

WING에서 확인

상품관리의 상품 조회·수정 화면에서 상품을 찾고 옵션 목록을 확인합니다. WING 개편에 따라 메뉴명이나 열 이름은 달라질 수 있으므로 상품명과 자체 SKU를 함께 대조하세요.

엑셀 보고서에서 확인

상품·주문·판매 관련 보고서에 옵션ID, Vendor Item ID, vendorItemId 열이 있다면 해당 값을 사용할 수 있습니다. 긴 숫자는 텍스트 형식으로 저장해야 자릿수 손상을 막을 수 있습니다.

Open API에서 확인

sellerProductId로 상품 조회 API를 호출한 뒤 items[].vendorItemId를 확인합니다. 임시저장 상태에서는 값이 없을 수 있고 승인 후 생성됩니다.

확인 절차가 필요하다면 vendorItemId 확인하는 방법에 화면·파일·API 경로를 더 자세히 정리했습니다.

옵션ID는 어디에 쓰나요?

옵션별 가격과 재고

같은 등록상품 아래에서도 옵션마다 판매가와 재고가 다를 수 있습니다. vendorItemId를 기준으로 해야 정확한 옵션의 가격과 수량을 다룰 수 있습니다.

주문과 반품

상품명만으로는 어떤 옵션이 팔렸는지 확실하지 않을 수 있습니다. 주문 데이터의 vendorItemId를 상품 마스터와 연결하면 실제 판매 옵션을 정확히 찾을 수 있습니다.

광고와 판매 데이터 연결

광고를 집행한 상품과 실제 전환된 상품이 다를 수 있습니다. 광고보고서와 판매 데이터를 합칠 때 옵션ID가 있으면 이름이 조금 달라도 같은 옵션을 찾을 수 있습니다.

정산과 원가 분석

옵션별 원가와 구성수량이 다르면 이익도 달라집니다. vendorItemId를 원가 프로필과 연결하면 상품명 평균이 아니라 실제 판매 옵션 기준으로 이익을 계산할 수 있습니다.

vendorItemId와 sellerProductItemId 차이

두 값은 모두 옵션 아래에 보이지만 목적이 다릅니다.

쿠팡의 상품 수정 공식 문서는 기존 옵션을 수정할 때 sellerProductItemId와 vendorItemId를 함께 넣도록 안내합니다. 따라서 둘 중 하나를 다른 하나로 복사해 사용하면 안 됩니다.

옵션ID를 관리하는 표

옵션별 한 행 구조를 사용하세요.

이 표에는 원가, 판매가, 공급업체 코드, 바코드 등을 추가할 수 있습니다. 다만 쿠팡 ID 열은 이름이 비슷하므로 열 제목을 줄이지 말고 원래 필드명까지 함께 적는 편이 좋습니다.

옵션ID를 사용할 때 주의할 점

1. 임시저장 상품에는 vendorItemId가 아직 없을 수 있습니다.
2. 상품을 새로 등록하면 기존과 다른 ID가 생길 수 있습니다.
3. 옵션명만 같다고 같은 vendorItemId라고 판단하면 안 됩니다.
4. productId는 노출 구조 변경으로 바뀔 수 있으므로 대신 사용하지 않습니다.
5. 엑셀에서 긴 숫자를 텍스트 형식으로 저장합니다.
6. 타 판매자의 ID와 내 상품 ID를 섞지 않습니다.

바로 적용할 체크리스트

전체 상품 ID의 관계는 쿠팡 SKU와 상품 ID 차이에서 한 번에 확인할 수 있습니다.