결론부터 정리
쿠팡에서 SKU는 판매자가 정하는 관리 코드이고, sellerProductId, productId, vendorItemId는 쿠팡이 상품 구조를 구분하기 위해 사용하는 ID입니다. 비슷해 보여도 서로 바꿔 쓸 수 없습니다.
초보 셀러가 가장 먼저 기억할 기준은 다음 두 줄입니다.
- 내 엑셀과 재고표에서 상품을 찾는 코드:
SKU(externalVendorSku) - 쿠팡 주문·가격·재고·광고 데이터를 옵션 단위로 잇는 값:
vendorItemId
SKU는 무엇인가요?
SKU는 Stock Keeping Unit의 약자입니다. 한국어로는 재고 관리 단위 정도로 이해하면 됩니다. 판매자가 상품과 옵션을 빠르게 구분하기 위해 직접 만드는 코드입니다.
예를 들어 실리콘 식기건조매트를 색상과 크기별로 판다면 다음처럼 정할 수 있습니다.
| 상품 옵션 | 판매자 SKU 예시 |
|---|---|
| 그레이 / 소형 / 1개 | CS-DM-GY-S-01 |
| 그레이 / 대형 / 1개 | CS-DM-GY-L-01 |
| 그레이 / 대형 / 2개 | CS-DM-GY-L-02 |
쿠팡 OPEN API에서 이 판매자 관리 코드는 externalVendorSku라는 필드로 표현됩니다. 상품 생성 시 판매자가 임의로 입력할 수 있고, 옵션 단위로 관리할 수 있습니다.
중요한 점은 SKU가 쿠팡이 자동으로 만들어주는 번호가 아니라는 것입니다. 판매자가 규칙을 정하지 않으면 상품명이나 임의 번호만으로 재고를 관리하게 되고, 상품이 늘수록 주문·광고·정산 파일을 합치기 어려워집니다.
쿠팡 상품 ID 4가지를 구분하세요
| 구분 | 시스템 필드 | 누가 정하나 | 무엇을 가리키나 | 바뀔 수 있나 |
|---|---|---|---|---|
| 판매자 SKU | externalVendorSku |
판매자 | 내가 관리하는 옵션 코드 | 판매자가 변경 가능 |
| 등록상품ID | sellerProductId |
쿠팡 | 판매자가 등록한 상품 묶음 | 공식 문서상 변경되지 않음 |
| 노출상품ID | productId |
쿠팡 | 고객에게 노출되는 상품 단위 | 결합·분리로 바뀔 수 있음 |
| 옵션ID | vendorItemId |
쿠팡 | 실제 판매되는 가장 작은 옵션 단위 | 승인 후 부여되며 변경되지 않음 |
여기에 sellerProductItemId라는 값도 있습니다. 상품 생성 후 상품 조회 API에서 확인할 수 있고, 등록한 옵션 값을 수정할 때 사용합니다. 이름이 비슷하지만 vendorItemId와 같은 값이라고 가정하면 안 됩니다.
상품 하나에 ID가 여러 개인 이유
쿠팡은 “판매자가 등록한 구조”와 “고객에게 보여주는 구조”를 따로 관리합니다.
판매자는 한 번의 등록에서 그레이와 블랙 옵션을 함께 올릴 수 있습니다. 이 등록 묶음에는 하나의 sellerProductId가 생깁니다. 그 아래 각 옵션에는 서로 다른 vendorItemId가 생깁니다.
반면 쿠팡은 여러 판매자가 올린 같은 상품을 하나의 고객 노출 페이지로 결합할 수 있습니다. 이 노출 단위가 productId입니다. 결합이나 분리 상태에 따라 달라질 수 있으므로 내부 장부의 영구 식별값으로 단독 사용하기에는 불안정합니다.
실무에서는 어떤 값을 저장해야 하나요?
상품 마스터를 만든다면 옵션 한 줄마다 다음 값을 함께 저장하는 방식이 좋습니다.
| 필드 | 예시 | 저장 이유 |
|---|---|---|
| 자체 SKU | CS-DM-GY-L-01 |
사람이 알아보고 재고·발주에 사용 |
| 상품명 | 실리콘 식기건조매트 | 검색과 확인 |
| 옵션명 | 그레이 / 대형 / 1개 | 실제 옵션 구분 |
| sellerProductId | 숫자 ID | 등록 묶음 조회 |
| productId | 숫자 ID | 현재 노출 상품 확인 |
| vendorItemId | 숫자 ID | 주문·가격·재고·보고서 연결 |
| sellerProductItemId | 숫자 ID | 등록 옵션 수정 시 사용 |
긴 숫자 ID는 엑셀에서 숫자가 아니라 텍스트 형식으로 저장하는 편이 안전합니다. 지수 표기로 바뀌거나 뒤 자릿수가 손상되면 다른 상품과 연결될 수 있습니다.
상황별로 어떤 ID를 쓰나요?
재고와 발주를 관리할 때
자체 SKU를 사용합니다. 사람이 읽을 수 있고 창고 라벨, 발주서, 원가표에서 같은 규칙으로 사용할 수 있기 때문입니다.
쿠팡에 등록한 상품 묶음을 찾을 때
sellerProductId를 사용합니다. 상품 조회 API도 이 값을 기준으로 등록 상품과 하위 옵션을 불러옵니다.
옵션별 가격과 재고를 확인할 때
vendorItemId를 사용합니다. 쿠팡 공식 문서에서도 가격, 재고, 판매 상태를 다루는 옵션 단위로 설명합니다.
고객에게 보이는 상품 페이지를 확인할 때
productId를 참고합니다. 다만 결합·분리로 달라질 수 있으므로 자체 SKU나 vendorItemId를 대신하는 값으로 사용하지 않습니다.
자주 생기는 관리 실수
- 상품명만으로 광고보고서와 주문 파일을 연결합니다.
- 모든 옵션에 같은 SKU를 넣습니다.
- productId 하나만 저장하고 영구히 같을 것이라고 생각합니다.
- vendorItemId와 sellerProductItemId를 같은 값으로 취급합니다.
- 긴 ID를 엑셀 숫자 형식으로 저장해 뒷자리가 바뀝니다.
- 상품을 재등록한 뒤 예전 ID와 새 ID의 관계를 기록하지 않습니다.
이 문제는 상품이 적을 때는 잘 드러나지 않습니다. 하지만 옵션이 늘고 광고·정산 파일을 합칠 때 갑자기 큰 오류가 됩니다.
지금 바로 할 일
상품 ID 관리 체크리스트
- 판매 중인 옵션마다 중복되지 않는 SKU가 있는지 확인합니다.
- SKU와 vendorItemId를 같은 행에 저장합니다.
- sellerProductId는 등록 묶음 기준으로 함께 기록합니다.
- productId는 노출 확인용으로 기록하되 영구 키로 단독 사용하지 않습니다.
- 모든 ID 열을 엑셀에서 텍스트 형식으로 관리합니다.
SKU 규칙이 아직 없다면 SKU 자동 생성기로 상품명과 옵션을 넣어 후보 코드를 먼저 만들어보세요.