쿠팡 윙이나 API로 상품을 올리다 보면 “등록 실패”가 떠요. 메시지만 봐서는 뭐가 문제인지 알기 어려운 경우가 많고요. 우리 가게가 위탁판매 상품을 올리면서 실제로 받은 등록 실패 메시지랑 고친 방법을 모아 봤어요. 같은 메시지를 보고 검색해서 들어오셨다면 아래에서 찾아보세요.
1. “중복된 옵션값이 있습니다”
상황: 핸드크림 + 립밤 세트를 향 조합 6가지 옵션으로 올리려고 했어요.
원인: 핸드크림 카테고리는 구매 옵션을 수량이랑 개당 용량으로만 나눌 수 있대요. “동백 + 민트”, “체리 + 딸기” 같은 향 이름은 옵션으로 인정이 안 돼서, 쿠팡 입장에선 6개 옵션이 전부 “1개, 60ml”로 똑같아 보인 거예요.
해결: 옵션이 하나뿐인 상품(5종 세트)으로 바꿔 올렸어요. 꼭 향별로 팔고 싶다면 향마다 상품을 따로 등록해야 해요.
2. “허용되지 않는 구매옵션 값”
상황: 양말을 공급사 옵션 그대로(“남녀공용 차콜 1켤레”) 올렸어요.
원인: 색상·사이즈 같은 구매 옵션은 쿠팡이 정한 값만 받는 카테고리가 있어요.
해결: 색상은 “차콜”, 사이즈는 “FREE”처럼 쿠팡이 받는 값으로 바꿨어요. 공급사 옵션 이름은 쿠팡 화면에 보이는 이름만 정리하고, 발주할 때는 원래 이름으로 주문해요.
신발도 비슷해요. 털슬리퍼처럼 “235~250” 범위로 나오는 상품은 쿠팡 신발사이즈 칸에 범위를 못 넣어서, 정해진 목록(250, 270 같은 값)에서 골라야 하더라고요.
3. 필수 속성 값이 틀림 (용량·중량 단위)
상황: 음료를 올렸는데 개당 용량이 이상하게 들어가서 실패했어요.
원인: 식품·생활용품은 “개당 용량”, “개당 중량”, “총 수량” 중 하나를 꼭 넣어야 하는데, 자동으로 채운 기본값이 실제 상품이랑 안 맞았어요.
해결: 상세페이지를 보고 “200ml”, “48개”처럼 실제 값을 직접 넣었어요. 용량과 중량은 둘 중 하나만 넣으면 되는 묶음이라, 둘 다 넣으려다 꼬이는 경우도 있어요.
4. 카테고리가 엉뚱하게 잡힘
상황: 등록은 됐는데 음료가 “농수축산물” 상품정보제공고시로 들어갔어요.
원인: 상품명으로 카테고리를 자동 추천받으면 가끔 이렇게 빗나가요. 고시 항목이 틀리면 나중에 정보 수정 요청을 받을 수 있어요.
해결: 고시 종류를 직접 지정해서 다시 등록했어요. 자동 추천은 편하지만, 처음 올리는 종류의 상품은 카테고리를 한 번 눈으로 확인해요.
5. 옵션 이름에 이상한 코드가 붙음
상황: “그레이L[NW467]”처럼 공급사 관리 코드가 옵션 이름에 그대로 붙어 나왔어요.
해결: 실패는 아니지만 손님이 보기엔 이상하잖아요. 화면에는 “그레이 L”로 보이게 정리했어요. 사이즈가 앞에 붙은 “M 경량패딩 브라운”, “4XL/블랙” 같은 옵션도 색상이랑 사이즈로 나눠 줬고요.
6. 등록은 됐는데 계속 “승인 대기”
상황: 윙에서는 판매 중으로 보이는데 우리 관리 화면에는 몇 시간째 승인 대기로 남아 있었어요.
원인: 등록 직후엔 상품 상태 조회가 잠깐 오류를 내기도 하고, 승인 결과가 늦게 반영되기도 해요.
해결: 실패로 단정하지 말고 일정 간격으로 다시 확인하게 했어요. 지금은 10분마다 승인 여부를 다시 가져와요.
실패를 줄이는 습관
- 올리기 전에 최소구매수량부터 봐요 (최소구매수량 함정)
- 옵션이 여러 개면 그 카테고리가 어떤 옵션을 받는지 먼저 확인해요
- 용량·중량·수량은 상세페이지 숫자를 직접 넣어요
- 처음 다루는 종류는 카테고리랑 고시 항목을 눈으로 확인해요
등록 실패 메시지를 받으셨다면 문장 그대로 위에서 찾아보시고, 없으면 실패한 상품의 카테고리가 어떤 옵션을 받는지부터 확인해 보세요. 대부분 거기서 풀리더라고요.