# 마켓 등록 실패 메시지

> 💡 이 문서를 마치면 마켓에 상품을 보냈다가 실패했을 때 그 문구가 무슨 뜻인지 알고, 무엇을 고쳐 다시 보낼지 찾을 수 있습니다. (⏱️ 문구 하나 찾는 데 약 1분)
>
> 📍 실패 사유 보는 곳: **상품 관리 > 상품 작업 현황** → **마켓 작업 로그** 탭\
> ✅ 미리 준비: 실패한 작업의 실패 문구(빨간 **i** 아이콘에서 복사)

## 이게 뭔가요?

마켓에 등록·수정·품절·삭제를 보냈다가 실패하면 그 이유가 이 문구로 남습니다. 실패 사유는 **상품 관리 > 상품 작업 현황**에서 봅니다. **마켓 작업 로그** 탭에서 실패한 줄의 빨간 **i** 아이콘을 누르면 나옵니다([상품 작업 현황](item-work.md)).

실패는 대부분 마켓의 등록 기준과 상품 정보가 맞지 않아서 생깁니다. 아래 표에서 고칠 곳을 찾아 고친 뒤 [일괄처리](product-batch.md)의 **[등록/수정]**으로 다시 보냅니다.

- 문구에서 ○○는 상품번호·상품명·개수처럼 상황마다 바뀌는 값입니다.
- 마켓이 돌려준 문구는 Spresso가 바꾸지 않고 그대로 보여 줍니다. 그래서 같은 이유라도 마켓이 문구를 바꾸면 조금 다르게 보일 수 있습니다. 문구 앞에 `[coupang:registerProduct]`·`[naver:updateProduct]`처럼 마켓과 동작 이름이 붙기도 합니다. 
- G마켓·옥션 문구는 앞에 마켓 이름이 영어 소문자(`gmarket`·`auction`)로 붙습니다.
- 같은 이유로 실패한 상품을 모으려면 검색 기준을 **에러 메시지**로 바꾸고 문구 일부를 넣어 검색합니다.
- 작업 로그(실패 사유 포함)는 한 달이 지나면 지워집니다. 고칠 상품은 그 안에 확인합니다. 

> 💡 **문의할 때 보낼 것**: 작업 이름(예: "마켓 등록-20261023-020120-G마켓"), 실행 날짜·시각, Spresso 상품 번호, 실패 문구 전체. 실패 문구는 **i** 아이콘에서 그대로 복사해 보냅니다. [고객센터](support.md)

## 쿠팡

| 화면 문구 | 뜻과 해결 |
| --- | --- |
| 해당 상품은 검수중 상태입니다. 1분 뒤 상품조회 해보시고, 조회가 안되면 쿠팡 홈페이지에서 확인해주세요. | 쿠팡에 등록은 되었고 쿠팡이 상품을 검수하고 있습니다. Spresso가 1분 뒤 한 번 더 확인해서 승인됐으면 이 줄을 **성공**으로 바꿉니다. 1분이 지나도 실패로 남아 있으면 쿠팡 윙에서 승인 상태를 보고, 승인된 뒤 **[등록/수정]**을 다시 보내면 Spresso 상품과 연결됩니다. |
| 해당 상품은 검수중 상태입니다. 검수 완료 후 재등록 시 연결됩니다. | 쿠팡이 아직 검수 중이라 Spresso 상품과 연결하지 못했습니다. 쿠팡 윙에서 승인됐는지 확인한 뒤 **[등록/수정]**을 다시 보냅니다. |
| 해당 상품은 반려처리 되었습니다. 재등록 해주세요. | 쿠팡이 상품을 승인하지 않았습니다(승인반려). 쿠팡 윙에서 반려 사유를 보고 Spresso에서 상품을 고친 뒤 **[등록/수정]**으로 다시 보냅니다.  |
| 해당 상품이 존재하지 않습니다. 재등록해주세요 | 연결하려던 상품이 쿠팡에 없습니다. Spresso가 연결을 지웠으니 **[등록/수정]**으로 다시 보내면 새로 등록합니다. |
| 해당 상품이 존재하지 않습니다. | (수정·품절) Spresso에 연결된 쿠팡 상품을 쿠팡에서 찾지 못했습니다. 쿠팡 윙에서 상품이 남아 있는지 확인합니다. 원인 확인 중입니다.  |
| 상품 판매가 승인되지 않았습니다. 쿠팡 WING 에서 확인해주세요 | 쿠팡이 옵션의 판매를 아직 승인하지 않았습니다. 쿠팡 윙에서 상품 상태를 확인하고, 승인된 뒤 **[등록/수정]**을 다시 보냅니다. |
| 등록 가능한 옵션이 없습니다. | 보낼 옵션이 없습니다. 상품 카드의 **가격/재고 탭**에서 "등록 여부"가 켜진 옵션이 하나 이상 있는지 봅니다([상품 하나 수정하기](product-edit.md)). |
| 현재 IP 주소(○○)가 쿠팡 API에서 허용되지 않았습니다. 쿠팡 WING에서 허용 IP를 확인해주세요. | 쿠팡 윙 OPEN API 키의 허용 IP에 문구 속 IP 주소가 없습니다. 그 IP를 넣습니다([쿠팡 마켓 계정 연동](connect-coupang.md)). |
| 쿠팡 상품 삭제 실패 — 옵션 판매정지가 거부되었습니다: ○○ | (삭제) 쿠팡이 판매정지를 거절해 지우지 않았습니다. 뒤의 ○○가 쿠팡이 준 이유입니다. "검수가 끝난 뒤 다시 시도해주세요."가 붙어 있으면 쿠팡 검수가 끝난 뒤 다시 삭제합니다. |
| 쿠팡 상품 삭제 실패 — 삭제 후에도 상품이 쿠팡에 남아 있습니다(상태: ○○). 원인: ○○ | (삭제) 삭제를 보냈지만 쿠팡에 상품이 남아 있습니다. 쿠팡 윙에서 그 상품의 상태를 보고 직접 지우거나, 잠시 뒤 다시 삭제합니다.  |
| 그 밖의 문구 | 쿠팡이 돌려준 거절 사유가 그대로 나옵니다. 문구에 나온 칸(카테고리·고시정보·옵션·이미지 등)을 고친 뒤 다시 보냅니다. 문구만으로 알 수 없으면 맨 위 "문의할 때 보낼 것"을 담아 문의합니다. |

## 스마트스토어

| 화면 문구 | 뜻과 해결 |
| --- | --- |
| "○○"는 유효하지 않은 이미지 URL입니다. 정상적으로 업로드한 이미지만 등록 가능합니다. | 상세페이지에 스마트스토어가 받지 않는 이미지 주소가 들어 있습니다. 상품 카드의 **[상세페이지 수정]**에서 그 이미지를 지우고 저장한 뒤 다시 보냅니다([상품 하나 수정하기](product-edit.md)).  |
| (여러 문구가 `;`로 이어진 것) | 스마트스토어가 칸마다 거절 사유를 줬습니다. `;`로 나뉜 문구를 하나씩 보고 그 칸을 고칩니다. |
| 상품 대표 이미지가 없습니다. | 상품 썸네일에 이미지가 없습니다(스마트스토어는 대표 이미지가 꼭 있어야 합니다). 상품 썸네일을 넣은 뒤 다시 보냅니다. |
| 이미지 업로드에 실패했습니다. | 스마트스토어에 이미지를 올리지 못했습니다. 원인 확인 중입니다. 잠시 뒤 다시 보냅니다.  |
| 카테고리 고시정보가 존재하지 않습니다. | 상품에 연결된 상품고시정보 템플릿의 고시 종류를 찾지 못했습니다. [상품고시정보 템플릿 관리](notice-template.md)에서 템플릿을 확인하고 다시 고릅니다.  |
| 판매상품 옵션 정보가 올바르지 않아 등록된 상품 정보를 가져오는데 실패했습니다. 네이버 스마트스토어센터에서 등록된 상품을 확인해주세요. 상품번호: ○○ | 스마트스토어에 등록은 되었지만 Spresso가 등록된 옵션을 읽어 오지 못했습니다. 스마트스토어센터에서 상품번호 ○○를 확인합니다. 다시 보내기 전에 문의합니다.  |
| 상품 등록에 실패했습니다. | 스마트스토어가 상품번호를 돌려주지 않았습니다. 원인 확인 중입니다.  |
| 그 밖의 문구 | 스마트스토어가 돌려준 거절 사유가 그대로 나옵니다. 문구에 나온 칸을 고친 뒤 다시 보냅니다. 연결·IP·권한 문구는 [자주 보는 오류 메시지](trouble-errors.md)의 "마켓 관리 — 마켓 계정 관리"를 봅니다. |

## G마켓·옥션

| 화면 문구 | 뜻과 해결 |
| --- | --- |
| gmarket 상품 업데이트에 실패했습니다, 주문옵션 추가금을 사용할 수 없는 카테고리입니다. | 이 카테고리는 옵션마다 값을 다르게(추가금) 받을 수 없습니다. Spresso는 옵션 가격과 대표 가격의 차이를 추가금으로 보냅니다. 상품 카드의 **가격/재고 탭**에서 옵션 가격을 대표 가격과 같게 맞추거나, 값이 다른 옵션의 "등록 여부"를 끕니다. 아직 등록하지 않은 상품이면 추가금을 받는 카테고리로 바꿔도 됩니다(이미 등록된 마켓은 카테고리를 바꿀 수 없습니다). |
| gmarket 상품 등록에 실패했습니다, 파일 용량이 2MB 초과하였습니다. | 상품 이미지 중 2MB가 넘는 파일이 있습니다. 고칠 곳 확인 중입니다.  |
| gmarket 상품 상태 변경에 실패했습니다, 동일한 상태로의 변경입니다. | (품절) 그 상품은 G마켓·옥션에서 이미 판매중지 상태입니다. 따로 할 일은 없습니다. |
| 등록할 상품 옵션이 없습니다. | 보낼 옵션이 없습니다. **가격/재고 탭**에서 "등록 여부"가 켜진 옵션이 있는지 봅니다. G마켓·옥션은 대표 가격의 50%~150% 밖에 있는 옵션은 보내지 않습니다. |
| 상품 이미지가 없습니다. | 상품 썸네일에 이미지가 없습니다. 썸네일을 넣은 뒤 다시 보냅니다. |
| 상품을 삭제할 수 없는 상태입니다. ESM에서 직접 삭제해주세요. | (삭제) 지금 상태에서는 Spresso가 지울 수 없습니다. ESM Plus에서 직접 지웁니다. |
| 상품이 판매중지 상태가 아닙니다. | (삭제) 판매중지를 보낸 뒤 지우려 했지만 G마켓·옥션에 판매중지가 늦게 반영됐습니다. 잠시 뒤 다시 삭제합니다. |
| gmarket(auction) 상품 등록에 실패했습니다, ○○ · gmarket(auction) 상품 업데이트에 실패했습니다, ○○ | 쉼표 뒤 ○○가 ESM이 돌려준 거절 사유입니다. 그 칸을 고친 뒤 다시 보냅니다. |

## 11번가

| 화면 문구 | 뜻과 해결 |
| --- | --- |
| 해당 카테고리는 도서 정가제로 인해 상품 등록이 불가한 카테고리 입니다 | 도서 정가제 카테고리라 Spresso로는 등록할 수 없습니다. 다른 카테고리를 고르거나 11번가에서 직접 등록합니다. |
| 상품 이미지가 300 * 300 이상이어야 합니다. | 11번가에 보낼 상품 썸네일 이미지가 없습니다. 문구와 달리 작은 이미지는 Spresso가 300×300으로 늘려 보내므로, 썸네일에 이미지가 하나라도 있는지 봅니다.  |
| 11번가 재고 응답에 ProductStock 노드가 없음 (prdNo=○○). 응답: … | 11번가에서 그 상품의 옵션 재고를 읽어 오지 못했습니다. 원인 확인 중입니다. 맨 위 "문의할 때 보낼 것"을 담아 문의합니다.  |

## eBay

| 화면 문구 | 뜻과 해결 |
| --- | --- |
| ○○번 상품 eBay 등록 실패: eBay 셀러 월 등록한도 초과(25002). 이번 달 ○○개($○○) 더 등록 가능합니다. | eBay 계정의 이번 달 등록 한도(개수·금액)를 넘었습니다. 남은 개수·금액 안으로 줄여 보내거나 다음 달에 보냅니다. 남은 한도를 읽지 못하면 뒤에 "이번 달 등록 한도에 걸렸습니다. eBay 셀러 허브에서 남은 한도를 확인해 주세요."가 붙습니다.  |
| ○○번 상품 eBay 등록 실패: eBay 배송정책 제한 — 이 카테고리(Cell Phones 등)는 판매이력 있는 계정만 economy 배송 가능. eBay 마켓정책에서 다른 배송방법 선택 필요 (25019) | 판매 이력이 없는 계정은 이 카테고리에 economy 배송을 쓸 수 없습니다. [마켓 정책](policy-market.md)의 eBay 배송 방법을 다른 것으로 바꿉니다. |
| ○○번 상품 eBay 등록 실패: 숫자:문구 · ○○번 상품 eBay 수정 실패: 숫자:문구 | 숫자는 eBay 오류 번호, 뒤는 eBay가 돌려준 사유입니다(사유가 여러 개면 세로 막대로 나뉩니다). 그 칸을 고친 뒤 다시 보냅니다. |

## 모든 마켓 — 보내기 전에 멈춘 경우

마켓에 보내기 전에 Spresso가 멈춘 경우도 마켓 작업 로그에 실패로 남습니다.

| 화면 문구 | 뜻과 해결 |
| --- | --- |
| Jimp로 이미지 읽기 실패: Error: Unsupported MIME type: image/webp | (G마켓·옥션·11번가·롯데온) 상품 이미지 중 WebP 형식 이미지를 Spresso가 마켓 크기에 맞추지 못했습니다. 고칠 곳 확인 중입니다.  |
| AI 자동입력 실패로 등록 중단 (상품 ○○, ○○): ○○ | (등록) 등록할 때 체크한 번역·AI 자동 완성이 실패해 그 상품 등록을 멈췄습니다. 끝의 ○○가 이유입니다. "잔여 토큰이 부족합니다."면 [결제 관리](payment.md)에서 AI 토큰을 충전한 뒤 다시 보냅니다. 괄호 안은 상품 번호와 마켓 이름(영어)입니다. |
| 마켓 계정을 찾을 수 없습니다. | (재수집 뒤 등록) 등록할 마켓 계정을 찾지 못했습니다. 이미 등록된 상품이면 등록했던 계정이 지워졌고, 아직 등록 전이면 상품에 적용한 [마켓 정책](policy-market.md)에 그 마켓 계정이 없습니다. [마켓 계정 관리](market-account.md)에서 계정을 확인합니다. |
| 재수집 실패: 옵션은 최대 100개까지 가능합니다. | (재수집 뒤 등록) 원본 상품의 옵션이 100개를 넘어 다시 수집하지 못해 등록도 하지 않았습니다. Spresso는 옵션 100개까지만 수집합니다. |
| 재수집 실패: 쿠팡 상세 페이지를 읽지 못했습니다(차단·로그인 확인) — 잠시 뒤 다시 시도하세요 | (재수집 뒤 등록) 쿠팡 상품 페이지를 읽지 못해 등록하지 않았습니다. 잠시 뒤 다시 합니다.  |
| 재수집 실패: 수집할 옵션이 없습니다. | (재수집 뒤 등록) 원본 상품에서 옵션을 읽지 못해 등록하지 않았습니다. 원인 확인 중입니다.  |

## 그래도 안 되면

문구로 고칠 곳을 찾지 못했거나, 고쳐서 다시 보내도 같은 문구가 나오면 맨 위 "문의할 때 보낼 것"을 담아 [고객센터](support.md)에 1:1 문의를 남깁니다. Spresso 화면 자체에 나온 오류(저장·연결·수집 등)는 [자주 보는 오류 메시지](trouble-errors.md)에서 찾습니다.

## 관련 문서

- [상품 작업 현황](item-work.md) — 마켓 작업 로그와 실패 사유 보기
- [일괄처리](product-batch.md) — 고친 상품을 **[등록/수정]**으로 다시 보내기
- [자주 보는 오류 메시지](trouble-errors.md) — Spresso 화면 오류 사전
- [마켓 계정 관리](market-account.md) — 연결·IP 문제