결론부터 정리
vendorItemId는 쿠팡에서 실제로 판매되는 옵션 한 개를 구분하는 ID입니다. 쿠팡 공식 문서에서는 이를 옵션ID라고 부릅니다.
확인하는 방법은 세 가지입니다.
- WING의 상품 조회·수정 화면에서 옵션별 ID 확인
- 쿠팡에서 내려받은 상품·주문 관련 엑셀의 옵션ID 열 확인
- Open API 상품 조회 응답의
items[].vendorItemId확인
화면 메뉴와 보고서 열 이름은 개편이나 계정 설정에 따라 조금 달라질 수 있습니다. 따라서 숫자만 복사하기보다 상품명, 옵션명, 자체 SKU와 함께 저장해야 합니다.
vendorItemId가 왜 필요한가요?
상품명은 사람이 읽기 쉽지만 정확한 데이터 연결에는 약합니다. 같은 상품명이 반복될 수 있고, 옵션명이 수정되거나 줄여서 표시될 수 있기 때문입니다.
vendorItemId는 다음 작업에서 옵션을 정확히 찾는 기준이 됩니다.
- 옵션별 가격과 재고 확인
- 판매 상태와 수량 관리
- 어떤 옵션이 주문됐는지 구분
- 반품 대상을 확인
- 광고보고서와 판매 데이터를 연결
- 옵션별 원가와 실제 이익을 계산
방법 1. WING 상품 화면에서 확인
API를 사용하지 않는 판매자는 WING 상품관리 영역에서 확인하는 방법이 가장 익숙합니다.
- WING에 로그인합니다.
- 상품관리의 상품 조회 또는 상품 수정 화면으로 이동합니다.
- 상품명이나 판매자상품코드로 상품을 찾습니다.
- 상품 상세 또는 옵션 목록을 엽니다.
- 옵션별로 표시된 옵션ID를 확인합니다.
- 상품명과 옵션명, 판매자상품코드와 함께 기록합니다.
WING은 수시로 화면이 개편될 수 있습니다. 메뉴 이름이 정확히 같지 않다면 “상품 조회”, “상품 수정”, “옵션ID”를 기준으로 찾으세요.
방법 2. 엑셀 보고서에서 확인
상품이나 주문 관련 보고서를 내려받았다면 옵션ID, Vendor Item ID, vendorItemId처럼 표시된 열을 찾습니다.
엑셀에서 확인할 때는 다음 세 가지를 주의하세요.
긴 ID는 텍스트로 보관합니다
셀 서식을 숫자로 두면 긴 번호가 지수 표기로 보이거나 일부 자릿수가 손상될 수 있습니다. 처음부터 열 서식을 텍스트로 바꾸고 값을 붙여 넣는 것이 안전합니다.
상품명만 보고 행을 합치지 않습니다
상품명은 같아도 색상, 크기, 수량 구성이 다를 수 있습니다. 옵션ID가 다르면 서로 다른 판매 단위입니다.
파일마다 열 이름이 다를 수 있습니다
쿠팡 보고서의 종류에 따라 옵션ID가 없거나 다른 이름으로 표시될 수 있습니다. 숫자의 위치만 보고 추정하지 말고 보고서 헤더를 확인하세요.
방법 3. Open API에서 확인
개발자나 연동 솔루션을 사용하는 경우 가장 명확한 방법입니다. 등록상품ID인 sellerProductId로 상품 조회 API를 호출합니다.
GET /v2/providers/seller_api/apis/api/v1/marketplace/seller-products/{sellerProductId}응답의 items 배열 안에서 옵션별 값을 확인합니다.
{
"sellerProductId": 123456789,
"items": [
{
"itemName": "그레이 / 대형 / 1개",
"externalVendorSku": "CS-DM-GY-L-01",
"vendorItemId": 9876543210
}
]
}위 숫자는 구조를 설명하기 위한 예시입니다. 실제 값은 본인 상품 조회 응답을 사용해야 합니다.
쿠팡 공식 문서에 따르면 임시저장 상태에서는 vendorItemId가 null일 수 있고 승인 완료 후 표시됩니다. 값이 없다면 코드 오류로 단정하기 전에 상품 상태를 확인하세요.
확인한 값을 어떻게 저장하나요?
상품 마스터를 옵션 한 줄당 한 행으로 만들면 관리가 쉽습니다.
| 자체 SKU | 상품명 | 옵션명 | sellerProductId | vendorItemId |
|---|---|---|---|---|
CS-DM-GY-L-01 |
실리콘 식기건조매트 | 그레이 / 대형 / 1개 | 등록 묶음 ID | 옵션 ID |
CS-DM-GY-L-02 |
실리콘 식기건조매트 | 그레이 / 대형 / 2개 | 같은 등록 묶음 ID | 다른 옵션 ID |
이 표를 원가표, 재고표, 광고 분석 파일의 기준표로 사용하면 상품명이 조금 달라도 같은 옵션을 안정적으로 찾을 수 있습니다.
잘못 찾았는지 확인하는 방법
다음 질문에 모두 “예”라면 올바른 옵션ID일 가능성이 높습니다.
옵션ID 검증 체크리스트
- 내 판매자 계정에서 조회한 상품인가요?
- 상품명뿐 아니라 색상·사이즈·구성이 일치하나요?
- 자체 SKU가 같은 옵션 행에 표시되나요?
- 등록상품ID가 예상한 상품 묶음과 일치하나요?
- 임시저장이 아니라 승인 완료된 상품인가요?
다음 단계
옵션ID를 찾았다면 옵션ID는 어디에 쓰는지에서 활용 범위를 확인하고, 자체 SKU가 없다면 SKU 코드 규칙 만드는 법으로 옵션별 관리 코드를 정하세요.