Spresso🧯마켓 등록 실패 메시지
이 문서를 마치면 마켓에 상품을 보냈다가 실패했을 때 그 문구가 무슨 뜻인지 알고, 무엇을 고쳐 다시 보낼지 찾을 수 있습니다. (⏱️ 문구 하나 찾는 데 약 1분)
📍 실패 사유 보는 곳: 상품 관리 > 상품 작업 현황 → 마켓 작업 로그 탭
✅ 미리 준비: 실패한 작업의 실패 문구(빨간 i 아이콘에서 복사)
이게 뭔가요?
마켓에 등록·수정·품절·삭제를 보냈다가 실패하면 그 이유가 이 문구로 남습니다. 실패 사유는 상품 관리 > 상품 작업 현황에서 봅니다. 마켓 작업 로그 탭에서 실패한 줄의 빨간 i 아이콘을 누르면 나옵니다(상품 작업 현황).
실패는 대부분 마켓의 등록 기준과 상품 정보가 맞지 않아서 생깁니다. 아래 표에서 고칠 곳을 찾아 고친 뒤 일괄처리의 [등록/수정]으로 다시 보냅니다.
문구에서 ○○는 상품번호·상품명·개수처럼 상황마다 바뀌는 값입니다.
마켓이 돌려준 문구는 Spresso가 바꾸지 않고 그대로 보여 줍니다. 그래서 같은 이유라도 마켓이 문구를 바꾸면 조금 다르게 보일 수 있습니다. 문구 앞에
[coupang:registerProduct]·[naver:updateProduct]처럼 마켓과 동작 이름이 붙기도 합니다. <!-- 확인: 접두어가 붙는 경우(HTTP 오류 응답)와 안 붙는 경우가 섞임 — 실제 쿠팡·스마트스토어 실패 로그로 모양 확인 -->G마켓·옥션 문구는 앞에 마켓 이름이 영어 소문자(
gmarket·auction)로 붙습니다.같은 이유로 실패한 상품을 모으려면 검색 기준을 에러 메시지로 바꾸고 문구 일부를 넣어 검색합니다.
작업 로그(실패 사유 포함)는 한 달이 지나면 지워집니다. 고칠 상품은 그 안에 확인합니다. <!-- 근거: worker/services/schedule.ts deleteOldWorkProcesses — 1개월 전 작업·로그 삭제(main·develop 같음) -->
문의할 때 보낼 것: 작업 이름(예: "마켓 등록-20261023-020120-G마켓"), 실행 날짜·시각, Spresso 상품 번호, 실패 문구 전체. 실패 문구는 i 아이콘에서 그대로 복사해 보냅니다. 고객센터
쿠팡
| 화면 문구 | 뜻과 해결 |
|---|---|
| 해당 상품은 검수중 상태입니다. 1분 뒤 상품조회 해보시고, 조회가 안되면 쿠팡 홈페이지에서 확인해주세요. | 쿠팡에 등록은 되었고 쿠팡이 상품을 검수하고 있습니다. Spresso가 1분 뒤 한 번 더 확인해서 승인됐으면 이 줄을 성공으로 바꿉니다. 1분이 지나도 실패로 남아 있으면 쿠팡 윙에서 승인 상태를 보고, 승인된 뒤 [등록/수정]을 다시 보내면 Spresso 상품과 연결됩니다. |
| 해당 상품은 검수중 상태입니다. 검수 완료 후 재등록 시 연결됩니다. | 쿠팡이 아직 검수 중이라 Spresso 상품과 연결하지 못했습니다. 쿠팡 윙에서 승인됐는지 확인한 뒤 [등록/수정]을 다시 보냅니다. |
| 해당 상품은 반려처리 되었습니다. 재등록 해주세요. | 쿠팡이 상품을 승인하지 않았습니다(승인반려). 쿠팡 윙에서 반려 사유를 보고 Spresso에서 상품을 고친 뒤 [등록/수정]으로 다시 보냅니다. <!-- 확인: 처음 연결할 때 반려면 Spresso가 연결을 지워 다시 보내면 새로 등록됨(LinkSellingItem). 이미 연결된 상품이 나중에 반려되면 연결을 지우지 않아 다시 보내도 같은 문구가 반복될 수 있음(CreateMarketProduct) — dev에 확인 --> |
| 해당 상품이 존재하지 않습니다. 재등록해주세요 | 연결하려던 상품이 쿠팡에 없습니다. Spresso가 연결을 지웠으니 [등록/수정]으로 다시 보내면 새로 등록합니다. |
| 해당 상품이 존재하지 않습니다. | (수정·품절) Spresso에 연결된 쿠팡 상품을 쿠팡에서 찾지 못했습니다. 쿠팡 윙에서 상품이 남아 있는지 확인합니다. 원인 확인 중입니다. <!-- 확인: GetProduct는 조회 실패도 '없음'으로 돌려줌 — 쿠팡에서 지운 경우와 조회 실패를 구분 못 함. 쿠팡에서 지운 상품을 Spresso에서 다시 등록하는 방법 — dev --> |
| 상품 판매가 승인되지 않았습니다. 쿠팡 WING 에서 확인해주세요 | 쿠팡이 옵션의 판매를 아직 승인하지 않았습니다. 쿠팡 윙에서 상품 상태를 확인하고, 승인된 뒤 [등록/수정]을 다시 보냅니다. |
| 등록 가능한 옵션이 없습니다. | 보낼 옵션이 없습니다. 상품 카드의 가격/재고 탭에서 "등록 여부"가 켜진 옵션이 하나 이상 있는지 봅니다(상품 하나 수정하기). |
| 현재 IP 주소(○○)가 쿠팡 API에서 허용되지 않았습니다. 쿠팡 WING에서 허용 IP를 확인해주세요. | 쿠팡 윙 OPEN API 키의 허용 IP에 문구 속 IP 주소가 없습니다. 그 IP를 넣습니다(쿠팡 마켓 계정 연동). |
| 쿠팡 상품 삭제 실패 — 옵션 판매정지가 거부되었습니다: ○○ | (삭제) 쿠팡이 판매정지를 거절해 지우지 않았습니다. 뒤의 ○○가 쿠팡이 준 이유입니다. "검수가 끝난 뒤 다시 시도해주세요."가 붙어 있으면 쿠팡 검수가 끝난 뒤 다시 삭제합니다. |
| 쿠팡 상품 삭제 실패 — 삭제 후에도 상품이 쿠팡에 남아 있습니다(상태: ○○). 원인: ○○ | (삭제) 삭제를 보냈지만 쿠팡에 상품이 남아 있습니다. 쿠팡 윙에서 그 상품의 상태를 보고 직접 지우거나, 잠시 뒤 다시 삭제합니다. <!-- 확인: 권장 해결(직접 삭제 vs 재시도) — dev --> |
| 그 밖의 문구 | 쿠팡이 돌려준 거절 사유가 그대로 나옵니다. 문구에 나온 칸(카테고리·고시정보·옵션·이미지 등)을 고친 뒤 다시 보냅니다. 문구만으로 알 수 없으면 맨 위 "문의할 때 보낼 것"을 담아 문의합니다. |
스마트스토어
| 화면 문구 | 뜻과 해결 |
|---|---|
| "○○"는 유효하지 않은 이미지 URL입니다. 정상적으로 업로드한 이미지만 등록 가능합니다. | 상세페이지에 스마트스토어가 받지 않는 이미지 주소가 들어 있습니다. 상품 카드의 [상세페이지 수정]에서 그 이미지를 지우고 저장한 뒤 다시 보냅니다(상품 하나 수정하기). <!-- 근거: naver/api.ts RegisterItem 주석의 실제 응답(2026-01-13, 아마존 A+ 이미지 상대 경로). 해결 경로는 화면에서 확인 필요 --> |
(여러 문구가 ;로 이어진 것) | 스마트스토어가 칸마다 거절 사유를 줬습니다. ;로 나뉜 문구를 하나씩 보고 그 칸을 고칩니다. |
| 상품 대표 이미지가 없습니다. | 상품 썸네일에 이미지가 없습니다(스마트스토어는 대표 이미지가 꼭 있어야 합니다). 상품 썸네일을 넣은 뒤 다시 보냅니다. |
| 이미지 업로드에 실패했습니다. | 스마트스토어에 이미지를 올리지 못했습니다. 원인 확인 중입니다. 잠시 뒤 다시 보냅니다. <!-- 확인: 원인(이미지 형식·크기·한도) — dev --> |
| 카테고리 고시정보가 존재하지 않습니다. | 상품에 연결된 상품고시정보 템플릿의 고시 종류를 찾지 못했습니다. 상품고시정보 템플릿 관리에서 템플릿을 확인하고 다시 고릅니다. <!-- 확인: 해결 경로 — dev --> |
| 판매상품 옵션 정보가 올바르지 않아 등록된 상품 정보를 가져오는데 실패했습니다. 네이버 스마트스토어센터에서 등록된 상품을 확인해주세요. 상품번호: ○○ | 스마트스토어에 등록은 되었지만 Spresso가 등록된 옵션을 읽어 오지 못했습니다. 스마트스토어센터에서 상품번호 ○○를 확인합니다. 다시 보내기 전에 문의합니다. <!-- 확인: 이 경우 Spresso에 연결이 저장되지 않아 다시 보내면 같은 상품이 하나 더 등록될 수 있음 — dev --> |
| 상품 등록에 실패했습니다. | 스마트스토어가 상품번호를 돌려주지 않았습니다. 원인 확인 중입니다. <!-- 확인: 원인 — dev --> |
| 그 밖의 문구 | 스마트스토어가 돌려준 거절 사유가 그대로 나옵니다. 문구에 나온 칸을 고친 뒤 다시 보냅니다. 연결·IP·권한 문구는 자주 보는 오류 메시지의 "마켓 관리 — 마켓 계정 관리"를 봅니다. |
G마켓·옥션
| 화면 문구 | 뜻과 해결 |
|---|---|
| gmarket 상품 업데이트에 실패했습니다, 주문옵션 추가금을 사용할 수 없는 카테고리입니다. | 이 카테고리는 옵션마다 값을 다르게(추가금) 받을 수 없습니다. Spresso는 옵션 가격과 대표 가격의 차이를 추가금으로 보냅니다. 상품 카드의 가격/재고 탭에서 옵션 가격을 대표 가격과 같게 맞추거나, 값이 다른 옵션의 "등록 여부"를 끕니다. 아직 등록하지 않은 상품이면 추가금을 받는 카테고리로 바꿔도 됩니다(이미 등록된 마켓은 카테고리를 바꿀 수 없습니다). |
| gmarket 상품 등록에 실패했습니다, 파일 용량이 2MB 초과하였습니다. | 상품 이미지 중 2MB가 넘는 파일이 있습니다. 고칠 곳 확인 중입니다. <!-- 확인: 어느 이미지(대표·추가 썸네일)인지, 이미지 편집기로 다시 저장(JPEG)하면 줄어드는지 — Spresso는 가로·세로 600px 이상 이미지는 원본 그대로 보냄(s3-image-handler fillImageWithWhite) --> |
| gmarket 상품 상태 변경에 실패했습니다, 동일한 상태로의 변경입니다. | (품절) 그 상품은 G마켓·옥션에서 이미 판매중지 상태입니다. 따로 할 일은 없습니다. |
| 등록할 상품 옵션이 없습니다. | 보낼 옵션이 없습니다. 가격/재고 탭에서 "등록 여부"가 켜진 옵션이 있는지 봅니다. G마켓·옥션은 대표 가격의 50%~150% 밖에 있는 옵션은 보내지 않습니다. |
| 상품 이미지가 없습니다. | 상품 썸네일에 이미지가 없습니다. 썸네일을 넣은 뒤 다시 보냅니다. |
| 상품을 삭제할 수 없는 상태입니다. ESM에서 직접 삭제해주세요. | (삭제) 지금 상태에서는 Spresso가 지울 수 없습니다. ESM Plus에서 직접 지웁니다. |
| 상품이 판매중지 상태가 아닙니다. | (삭제) 판매중지를 보낸 뒤 지우려 했지만 G마켓·옥션에 판매중지가 늦게 반영됐습니다. 잠시 뒤 다시 삭제합니다. |
| gmarket(auction) 상품 등록에 실패했습니다, ○○ · gmarket(auction) 상품 업데이트에 실패했습니다, ○○ | 쉼표 뒤 ○○가 ESM이 돌려준 거절 사유입니다. 그 칸을 고친 뒤 다시 보냅니다. |
11번가
| 화면 문구 | 뜻과 해결 |
|---|---|
| 해당 카테고리는 도서 정가제로 인해 상품 등록이 불가한 카테고리 입니다 | 도서 정가제 카테고리라 Spresso로는 등록할 수 없습니다. 다른 카테고리를 고르거나 11번가에서 직접 등록합니다. |
| 상품 이미지가 300 * 300 이상이어야 합니다. | 11번가에 보낼 상품 썸네일 이미지가 없습니다. 문구와 달리 작은 이미지는 Spresso가 300×300으로 늘려 보내므로, 썸네일에 이미지가 하나라도 있는지 봅니다. <!-- 근거: eleven/api.ts — 썸네일을 300×300 이상으로 맞춰 올리고, 올린 이미지가 0장일 때만 이 문구. 동영상만 있는 경우 등 --> |
| 11번가 재고 응답에 ProductStock 노드가 없음 (prdNo=○○). 응답: … | 11번가에서 그 상품의 옵션 재고를 읽어 오지 못했습니다. 원인 확인 중입니다. 맨 위 "문의할 때 보낼 것"을 담아 문의합니다. <!-- 확인: 원인 — dev --> |
eBay
| 화면 문구 | 뜻과 해결 |
|---|---|
| ○○번 상품 eBay 등록 실패: eBay 셀러 월 등록한도 초과(25002). 이번 달 ○○개($○○) 더 등록 가능합니다. | eBay 계정의 이번 달 등록 한도(개수·금액)를 넘었습니다. 남은 개수·금액 안으로 줄여 보내거나 다음 달에 보냅니다. 남은 한도를 읽지 못하면 뒤에 "이번 달 등록 한도에 걸렸습니다. eBay 셀러 허브에서 남은 한도를 확인해 주세요."가 붙습니다. <!-- 확인: eBay에서 한도를 늘리는 메뉴(Seller Hub) — eBay 도움말 직접 확인 못 함 --> |
| ○○번 상품 eBay 등록 실패: eBay 배송정책 제한 — 이 카테고리(Cell Phones 등)는 판매이력 있는 계정만 economy 배송 가능. eBay 마켓정책에서 다른 배송방법 선택 필요 (25019) | 판매 이력이 없는 계정은 이 카테고리에 economy 배송을 쓸 수 없습니다. 마켓 정책의 eBay 배송 방법을 다른 것으로 바꿉니다. |
| ○○번 상품 eBay 등록 실패: 숫자:문구 · ○○번 상품 eBay 수정 실패: 숫자:문구 | 숫자는 eBay 오류 번호, 뒤는 eBay가 돌려준 사유입니다(사유가 여러 개면 세로 막대로 나뉩니다). 그 칸을 고친 뒤 다시 보냅니다. |
모든 마켓 — 보내기 전에 멈춘 경우
마켓에 보내기 전에 Spresso가 멈춘 경우도 마켓 작업 로그에 실패로 남습니다.
| 화면 문구 | 뜻과 해결 |
|---|---|
| Jimp로 이미지 읽기 실패: Error: Unsupported MIME type: image/webp | (G마켓·옥션·11번가·롯데온) 상품 이미지 중 WebP 형식 이미지를 Spresso가 마켓 크기에 맞추지 못했습니다. 고칠 곳 확인 중입니다. <!-- 확인: 이미지 편집기에서 그 이미지를 저장하면 JPEG·PNG로 바뀌어 해결되는지(편집기 저장 형식은 png/jpeg — compose.ts) — dev 화면 --> |
| AI 자동입력 실패로 등록 중단 (상품 ○○, ○○): ○○ | (등록) 등록할 때 체크한 번역·AI 자동 완성이 실패해 그 상품 등록을 멈췄습니다. 끝의 ○○가 이유입니다. "잔여 토큰이 부족합니다."면 결제 관리에서 AI 토큰을 충전한 뒤 다시 보냅니다. 괄호 안은 상품 번호와 마켓 이름(영어)입니다. |
| 마켓 계정을 찾을 수 없습니다. | (재수집 뒤 등록) 등록할 마켓 계정을 찾지 못했습니다. 이미 등록된 상품이면 등록했던 계정이 지워졌고, 아직 등록 전이면 상품에 적용한 마켓 정책에 그 마켓 계정이 없습니다. 마켓 계정 관리에서 계정을 확인합니다. |
| 재수집 실패: 옵션은 최대 100개까지 가능합니다. | (재수집 뒤 등록) 원본 상품의 옵션이 100개를 넘어 다시 수집하지 못해 등록도 하지 않았습니다. Spresso는 옵션 100개까지만 수집합니다. |
| 재수집 실패: 쿠팡 상세 페이지를 읽지 못했습니다(차단·로그인 확인) — 잠시 뒤 다시 시도하세요 | (재수집 뒤 등록) 쿠팡 상품 페이지를 읽지 못해 등록하지 않았습니다. 잠시 뒤 다시 합니다. <!-- 확인: '로그인 확인'이 가리키는 것(확장 프로그램 브라우저의 쿠팡 로그인?) — dev --> |
| 재수집 실패: 수집할 옵션이 없습니다. | (재수집 뒤 등록) 원본 상품에서 옵션을 읽지 못해 등록하지 않았습니다. 원인 확인 중입니다. <!-- 확인: 수집처별로 뜻이 다름(옥션: 옵션 100개 초과, 쿠팡: 옵션 못 읽음) --> |
그래도 안 되면
문구로 고칠 곳을 찾지 못했거나, 고쳐서 다시 보내도 같은 문구가 나오면 맨 위 "문의할 때 보낼 것"을 담아 고객센터에 1:1 문의를 남깁니다. Spresso 화면 자체에 나온 오류(저장·연결·수집 등)는 자주 보는 오류 메시지에서 찾습니다.
관련 문서
상품 작업 현황 — 마켓 작업 로그와 실패 사유 보기
일괄처리 — 고친 상품을 [등록/수정]으로 다시 보내기
자주 보는 오류 메시지 — Spresso 화면 오류 사전
마켓 계정 관리 — 연결·IP 문제 <!-- 확인: 쿠팡·스마트스토어 문구는 dev 로그가 없어 코드에서 가져옴 — 운영 작업 로그나 QA 실측으로 실제 거절 원문을 더 모으기(대표 결정 대기) -->
이 문서로 해결되지 않으면 화면에 나온 문구로 자주 보는 오류 메시지를 찾거나 고객센터에서 1:1 문의를 남깁니다. 모르는 낱말은 용어집에 있습니다.