# 자주 보는 오류 메시지

> 💡 이 문서를 마치면 Spresso 화면에 나온 오류 문구가 무슨 뜻인지 알고, 어디서 고치면 되는지 찾아갈 수 있습니다. (⏱️ 문구 하나 찾는 데 약 1분)
>
> 📍 찾는 법: 위 **화면 문구로 찾기** 칸에 화면에 나온 문구 일부를 넣습니다(브라우저 **Ctrl+F**도 됩니다).
>
> 🧯 마켓에 보냈다가 실패한 문구(상품 작업 현황의 실패 사유)는 [마켓 등록 실패 메시지](trouble-market.md)에 따로 모았습니다.

## 이게 뭔가요?

화면에 나온 오류·안내 문구를 메뉴별로 모은 사전입니다. 항목 제목과 표 첫 칸이 화면 문구 그대로라서 문구로 찾으면 됩니다. 문구 안의 ○○는 상황마다 바뀌는 값입니다.

- 오류는 대부분 화면 오른쪽 위에 잠깐 나왔다 사라지는 **알림 메시지**로 나옵니다. 마우스를 올리면 사라지지 않고 멈춥니다([화면 둘러보기](app-basics.md)).
- Spresso 서버가 돌려준 오류는 그 문구가 그대로 알림으로 나옵니다. 여기 없는 문구는 [고객센터](support.md)로 문의합니다.
- 마켓에 등록·수정을 보낸 결과는 **상품 관리 > 상품 작업 현황**의 **마켓 작업 로그** 탭에 있는 빨간 **i** 아이콘에 실패 이유가 있습니다. 검색 유형 **에러 메시지**로 같은 문구를 검색하면 같은 이유로 실패한 상품을 모아 볼 수 있습니다([상품 작업 현황](item-work.md)). 성공한 행에도 알려 줄 것이 있으면 노란 **i** 아이콘이 붙습니다(예: eBay에 등록은 됐지만 자동 완성이 채우지 못한 칸).
- 문구가 나온 메뉴를 알면 오른쪽 목차에서 그 메뉴로 바로 갑니다. 메뉴는 왼쪽 사이드바 순서대로 놓았습니다.

![마켓 작업 로그: 실패 줄의 빨간 i와 사유](../img/item-work-03.png)

## 공통 (모든 화면)

### "세션이 만료되었습니다. 다시 로그인 해주세요."

- **언제**: 쓰던 중 갑자기 이 알림이 나오고 로그인 화면으로 이동합니다.
- **왜**: 로그인 상태를 더 이어 갈 수 없게 되었습니다. 미리 알려 주는 창은 없습니다.
- **해결**: 다시 로그인합니다. 저장하지 않은 입력은 사라졌을 수 있습니다.

### "불러오던 중 오류가 발생했습니다."

- **언제**: 탭 하나가 열리지 않고 "새로고침 하여 재시도하시길 바랍니다."와 **[새로고침]** 버튼이 보입니다. 앱 전체가 오류일 때도 같은 화면입니다.
- **해결**: **[새로고침]**을 선택합니다. 그래도 같으면 브라우저를 새로고침(F5)하고, 계속되면 [고객센터](support.md)로 화면 캡처와 함께 문의합니다.

### "1개의 .xlsx 또는 .xls 파일만 업로드 가능합니다."

- **언제**: 엑셀 업로드 창에서 엑셀이 아닌 파일이나 파일 여러 개를 골랐을 때.
- **해결**: .xlsx 또는 .xls 파일 하나만 고릅니다.

### "파일을 선택해주세요."

- 업로드 창에서 파일을 고르지 않고 버튼을 눌렀습니다. 파일을 고른 뒤 다시 선택합니다.

### "파일 업로드 중 오류가 발생했습니다. 다시 시도해주세요."

- **해결**: 파일을 다시 골라 업로드합니다. 뒤에 붙은 오류 내용이 계속 같으면 고객센터로 문의합니다.

## 로그인·가입

자세한 내용은 [로그인·아이디/비밀번호 찾기](login-help.md), [Spresso 가입하기](start-signup.md)를 봅니다.

### "아이디나 비밀번호를 입력하세요"

- 로그인 화면에서 아이디나 비밀번호 칸이 비어 있습니다. 두 칸을 모두 입력합니다.

### "유저 정보를 찾을 수 없습니다."

- **왜**: 아이디·비밀번호 찾기에서 넣은 정보로 가입한 계정을 찾지 못했습니다. 화면에 알림 없이 버튼만 반응하지 않을 수도 있습니다.
- **해결**: 가입할 때 쓴 휴대폰 번호인지 확인합니다. 그래도 안 되면 [로그인·아이디/비밀번호 찾기](login-help.md)의 "그래도 안 되면"을 봅니다. 

### "아이디 또는 비밀번호가 올바르지 않습니다."

- **왜**: 아이디가 없거나 비밀번호가 틀렸습니다. 둘 중 무엇이 틀렸는지는 알려 주지 않습니다.
- **해결**: [아이디 찾기](login-help.md)로 아이디부터 확인하고, 그래도 안 되면 비밀번호를 다시 설정합니다.

### "관리자가 이용을 멈춘 계정입니다. 관리자에게 문의해주세요."

- 관리자가 이 계정의 이용을 멈췄습니다. 로그인할 수 없으니 Spresso 운영팀에 문의합니다.

### "영문/숫자의 조합(6~12자리)를 입력해주세요."

- 가입할 때 아이디 규칙이 맞지 않습니다. 영문과 숫자를 모두 넣어 6~12자리로 만듭니다.

### "중복된 아이디입니다."

- 이미 쓰는 아이디입니다. 다른 아이디로 다시 중복 확인을 합니다.

### "사업자등록증은 4.5MB 이하만 업로드할 수 있습니다. 파일을 줄여서 다시 시도해주세요."

- 가입할 때 올린 사업자등록증 파일이 4.5MB보다 큽니다. 사진 해상도를 낮춰 크기를 줄인 뒤 다시 올립니다.

### "이미 가입된 전화번호입니다."

- **언제**: 가입할 때, 또는 [계정 관리](account.md)에서 휴대폰 번호를 바꿀 때.
- **왜**: 휴대폰 번호 하나에는 계정 하나만 만들 수 있습니다. 그 번호로 가입한 계정이 이미 있습니다.
- **해결**: 가입 중이라면 [로그인·아이디/비밀번호 찾기](login-help.md)로 기존 아이디를 찾습니다.

### "가입되지 않은 전화번호입니다."

- 아이디·비밀번호 찾기에서 넣은 번호로 가입한 계정이 없습니다. 가입할 때 쓴 번호를 넣습니다.

### "인증시간이 초과되었습니다. 인증번호를 재요청해주세요"

- 인증번호를 받은 지 5분이 지났습니다. **[재요청]**으로 새 번호를 받습니다.

### "인증시간이 초과되었습니다."

- **언제**: 휴대폰 인증을 마친 뒤 가입·비밀번호 재설정을 끝내기 전에.
- **왜**: 인증한 뒤 5분 안에 마쳐야 합니다.
- **해결**: 본인 인증부터 다시 합니다.

### "인증번호가 일치하지 않습니다."

- 문자로 받은 6자리를 다시 확인해 넣습니다.

### "인증번호를 보내지 못했습니다. 잠시 후 다시 시도해주세요."

- 문자 발송이 실패했습니다. 잠시 뒤 다시 요청합니다.

### "인증 횟수를 초과했습니다. 관리자에게 문의하세요."

- **왜**: 같은 곳(IP)에서 하루에 요청할 수 있는 인증 횟수를 넘었습니다.
- **해결**: 다음 날 다시 합니다. [계정 관리](account.md)에서 번호를 바꾸다 나왔다면 [고객센터](support.md)로 문의할 수도 있습니다(고객센터는 로그인해야 열립니다).

## 확장 프로그램·수집

### "확장 프로그램 설정이 필요합니다."

- Spresso가 확장 프로그램과 연결하지 못했습니다. [확장 프로그램·브라우저 문제](trouble-extension.md)를 봅니다.

### "네트워크 에러"

- 수집 실패 이유로 나옵니다. 확장 프로그램이 상품 하나에 60초 동안 답하지 않았습니다. [확장 프로그램·브라우저 문제](trouble-extension.md)의 "수집이 멈추거나" 항목을 봅니다.

## 상품 수집 — 수집기 생성

자세한 내용은 [수집기 생성](collector-create.md)을 봅니다.

| 화면 문구 | 뜻과 해결 |
| --- | --- |
| 이미 검색 중인 요청이 있습니다. | 같은 수집처에서 같은 검색어(주소)로 검색 중이거나 이미 검색한 기록이 있습니다. 검색 기록에서 그 결과를 보거나, 그 항목을 지운 뒤 다시 검색합니다. |
| 검색이 완료되지 않았습니다. | 검색이 끝나기 전에 **[모든 상품 수집]**을 눌렀습니다. 검색 기록이 "검색 완료"가 된 뒤 누릅니다. |
| 검색 기록이 없습니다 · 검색된 상품이 없습니다. | 아직 검색하지 않았거나, 검색 결과가 없습니다. |
| 선택된 상품이 없습니다. | 상품을 체크하지 않고 **[선택 상품 수집]**을 눌렀습니다. |
| 수집기명을 입력해주세요. | 수집기 설정 창에서 수집기명이 비어 있습니다. |
| 해당 마켓에 동일한 수집기 이름이 존재합니다. | 같은 수집처에 같은 이름의 수집기가 있습니다. 다른 이름을 넣습니다. |
| 모든 대상 상품이 이미 수집되어 수집기 생성에 실패하였습니다. | 고른 상품이 모두 이미 수집했거나 다른 수집기에서 기다리는 상품입니다. **상품 조회**나 **수집기 조회**에서 확인합니다. |
| 생성할 상품 그룹 이름을 입력해주세요. | **[그룹 생성]**을 누르고 새 그룹 이름을 넣지 않았습니다. 이름을 넣거나 **[생성 취소]**를 누릅니다. |
| 대표 이미지 번호를 입력해주세요. | 사이트 설정의 대표이미지 번호가 비었거나 0입니다. 1 이상을 넣습니다. |
| 재고 설정 값을 정확히 입력해주세요. | 사이트 설정의 재고 설정 두 칸 중 하나만 넣었습니다. 둘 다 넣거나 둘 다 비웁니다. |
| 사이트 설정 저장에 실패했습니다. | 사이트 설정을 저장하지 못했습니다. 다시 저장합니다. |

## 상품 수집 — 수집기 조회

자세한 내용은 [수집기 조회](collector-list.md)를 봅니다.

| 화면 문구 | 뜻과 해결 |
| --- | --- |
| 선택된 수집기가 없습니다. | 수집기를 체크하지 않고 버튼을 눌렀습니다. |
| 재수집 가능한 상품이 없습니다. | 고른 수집기에 수집 실패 상태의 상품이 없습니다. 금지어·수집 제외 상품은 다시 수집하지 않습니다. |
| 요청 상품 중 수집제외된 상품이 존재합니다. | 재수집할 상품에 수집 제외 상품이 섞여 있습니다. 빼고 다시 고릅니다. |
| 수집완료/미완료인 수집기가 없습니다. | 끝났거나 멈춘 수집기가 없습니다. |
| 미완료 상품 목록이 없습니다. | 다시 수집할 상품이 없습니다. |

## 카테고리 관리 — 카테고리·상품고시정보

자세한 내용은 [카테고리 조회/수정](category-edit.md), [상품고시정보 템플릿 관리](notice-template.md)를 봅니다.

| 화면 문구 | 뜻과 해결 |
| --- | --- |
| 카테고리가 설정돼 있으면 고시정보도 설정해야 합니다. | 국내 마켓에 카테고리만 고르고 상품고시 템플릿을 고르지 않았습니다. **[상품고시 선택]**에서 템플릿을 고릅니다. 맞는 템플릿이 없으면 [상품고시정보 템플릿 관리](notice-template.md)에서 먼저 만듭니다. |
| 검색어를 2글자 이상 입력해주세요. | 마켓 카테고리 검색어가 너무 짧습니다. 2글자 이상 넣습니다. |
| 재매핑 중 오류가 발생했습니다. | 카테고리 재매핑이 실패했습니다. **[다시 시도]**를 선택합니다. |
| 카테고리가 없습니다. | 이 수집처에서 수집한 카테고리가 없습니다. |
| 필수값을 입력해주세요. | (상품고시정보 템플릿) 필수 항목이 빈 템플릿을 복사했습니다. 복사본은 그대로 만들어지니, 목록에서 복사본을 열어 표시가 있는 항목을 채우고 저장합니다. |
| 템플릿이 없습니다. | 이 마켓 탭에 만든 상품고시 템플릿이 없습니다. **[새 템플릿 생성]**으로 만듭니다. |

## 정책 관리 — 통합 정책

자세한 내용은 [통합 정책 관리](policy-group.md), [기본 정책 만들기](start-policy.md)를 봅니다.

| 화면 문구 | 뜻과 해결 |
| --- | --- |
| 정책 그룹 이름을 설정해주세요 | 정책명이 비어 있습니다. 정책명을 입력합니다. |
| 마진 정책을 선택해주세요 | 통합 정책에 마진 정책을 고르지 않았습니다. 마진 정책 표에서 하나를 선택합니다. |
| 적어도 한개의 마켓정책을 선택해야합니다 | 통합 정책에 마켓 정책이 하나도 없습니다. 마켓 탭에서 마켓 정책을 하나 이상 선택합니다. |
| 해당 정책그룹을 찾을 수 없습니다. | 이미 지워진 통합 정책을 고치거나 지우려 했습니다. 화면을 새로고침해 목록을 다시 봅니다. |

## 정책 관리 — 마진 정책

자세한 내용은 [마진 정책](policy-margin.md)을 봅니다.

| 화면 문구 | 뜻과 해결 |
| --- | --- |
| 정책명을 입력해 주세요 | 정책명을 입력합니다. |
| 기본 마진율/마진 금액은 필수 입니다. | 기본 마진 금액(%)이 0입니다. 0보다 큰 값을 입력합니다. |
| 원가별 마진 설정값을 모두 채워야 합니다 | 원가별 마진 구간에 빈 칸이 있습니다. 칸을 채우거나 줄을 지웁니다. 시작 금액 0원도 빈 칸으로 보니 첫 구간은 1원부터 시작합니다. |
| 금액 범위가 중복돼있습니다 | 원가별 마진 구간이 겹칩니다. 앞 줄의 끝 금액보다 다음 줄의 시작 금액이 작지 않게 고칩니다. |
| 해당 마진정책을 찾을 수 없습니다. | 이미 지워진 정책입니다. 목록을 다시 봅니다. |
| ○○번 상품의 연결된 마진정책이 없습니다. | 마켓 등록 때 나옵니다. 상품에 걸린 마진 정책이 지워졌거나 없습니다. 상품의 **적용 정책** 탭에서 마진 정책을 다시 고릅니다. |

## 정책 관리 — 마켓 정책

마켓 정책을 저장할 때 빠진 값이 있으면 나옵니다. 문구에 나온 칸을 채우고 다시 저장합니다. 자세한 내용은 [마켓 정책](policy-market.md)을 봅니다.

| 화면 문구 | 마켓 | 고칠 곳 |
| --- | --- | --- |
| 마켓 아이디를 선택해주세요 | 공통 | 이 정책을 쓸 마켓 계정을 고릅니다. |
| 수수료는 0초과 100미만으로 입력해주세요 | 공통 | 수수료(%) 칸 |
| 택배사를 선택해야 합니다 | 택배사 칸이 있는 마켓 | 택배사 |
| 출고지와 반품지를 선택해야 합니다 | 쿠팡·11번가·스마트스토어·G마켓·옥션 | 출고지·반품지(마켓 판매자센터에 먼저 등록해 둔 주소) |
| 출고지와 회수지를 선택해야 합니다 | 롯데온 | 출고지·회수지(롯데ON 스토어센터에 먼저 등록해 둔 주소) |
| 배송비 정책을 선택해야 합니다 | 롯데온 | 배송비 정책 |
| 발송예정일은 0~○○일로 입력해주세요 | 롯데온 | 발송예정일. 국내 판매자는 "발송예정일은 0~3일로 입력해주세요"(0~3일), 해외 판매자는 0~30일입니다. |
| 기준 출고일은 최소 1입니다 | 쿠팡 | 기준 출고일 |
| A/S 안내 메세지를 입력하세요 | 11번가·롯데온 | A/S 안내 |
| 반품 안내 메세지를 입력하세요 | 11번가 | 반품 안내 |
| A/S 전화번호를 입력해주세요 | 스마트스토어 | A/S 전화번호 |
| 제주도 배송비는 10원 이상 20만원 이하로 입력해주세요 · 도서산간 배송비는 10원 이상 20만원 이하로 입력해주세요 | 스마트스토어 | 제주·도서산간 배송비 |
| 묶음배송인 경우 묶음배송번호를 선택해주세요 | G마켓·옥션 | 묶음배송 정책 |
| 배송 정책을 선택해주세요 · 반품 정책을 선택해주세요 · 결제 정책을 선택해주세요 | eBay | 비즈니스 정책 3개([이베이 시작하기](ebay-start.md)) |
| 무게별 배송비 표의 무게는 0보다 크고 배송비는 0 이상이어야 합니다 · 무게별 배송비 표에 같은 무게 구간이 두 번 있습니다 | eBay | 배송비 (구매자 부담)의 무게별 배송비 표 |
| ○○원 이상 ○○원 이하로 입력해주세요 · ○○원 이상 ○○원 미만으로 입력해주세요 | 쿠팡·11번가·스마트스토어·G마켓·옥션 | 배송비, 조건부 무료배송 기준 금액. 마켓마다 넣을 수 있는 범위가 다릅니다(예: "100원 이상 100만원 이하로 입력해주세요"). |
| 100원 단위로 입력해주세요 · 10원 단위로 입력해주세요 | 쿠팡(100원)·스마트스토어·G마켓·옥션(10원) | 배송비, 조건부 무료배송 기준 금액 |

불러오기·저장이 실패할 때 나오는 문구입니다.

| 화면 문구 | 뜻과 해결 |
| --- | --- |
| 호출 중 문제가 발생했습니다 | 출고지·반품지 목록을 마켓에서 못 불러왔습니다. 새로고침 아이콘으로 다시 불러옵니다. |
| 이베이 정책 목록을 불러오지 못했습니다. | **[다시 불러오기]**를 선택합니다. 계속되면 [eBay 마켓 계정 연동](connect-ebay.md)에서 연결 상태를 확인합니다. |
| 정책 수정을 실패했습니다. · 정책 삭제를 실패했습니다. | 서버가 저장·삭제를 거절했습니다. 잠시 뒤 다시 합니다. |

## 정책 관리 — 상품/옵션명 정책

자세한 내용은 [상품/옵션명 정책](policy-name.md)을 봅니다.

| 화면 문구 | 뜻과 해결 |
| --- | --- |
| 잘못된 엑셀 파일 포맷입니다. 헤더가 "변경 전 문자"와 "변경 후 문자"인지 확인해주세요. | 첫 줄 머리글을 "변경 전 문자" · "변경 후 문자"로 맞춥니다. **[엑셀 다운로드]**로 받은 파일을 고쳐 쓰면 편합니다. |
| 중복된 단어 n 건 | 같은 **변경 전**이 두 줄 이상입니다. **[삭제]**를 누르면 맨 위 줄만 남습니다. |

## 정책 관리 — 상세페이지 정책

자세한 내용은 [상세페이지 정책](policy-detail.md)을 봅니다.

| 화면 문구 | 뜻과 해결 |
| --- | --- |
| 상품 번호를 입력해주세요 | 미리보기 전에 Spresso 상품번호를 넣습니다. |
| 존재하지 않는 상품입니다. | 미리보기에 넣은 상품번호가 내 수집 상품에 없습니다. **상품 조회**에서 번호를 다시 확인합니다. |
| 상세페이지 정책 id가 필요합니다. | 저장하지 않은 새 정책으로 미리보기를 눌렀습니다. 먼저 **[변경사항 저장]**을 선택합니다. |
| 기본 정책은 삭제할 수 없습니다. | 기본 상세페이지 정책은 지울 수 없습니다. |
| 존재하지 않는 정책입니다. | 이미 지워진 정책입니다. 목록을 다시 봅니다. |

## 상품 관리 — 상품 조회·수정

자세한 내용은 [상품 조회 — 찾기·목록](product-search.md), [상품 하나 수정하기](product-edit.md)를 봅니다.

| 화면 문구 | 뜻과 해결 |
| --- | --- |
| 선택된 상품이 없습니다 | 상품을 고르지 않고 버튼이나 일괄처리 메뉴를 눌렀습니다. 먼저 상품을 고릅니다. |
| 저장하지 않은 변경사항이 있습니다. 계속 진행하시겠습니까? | 상품 카드에서 고친 내용이 아직 저장되지 않았습니다. 취소하고 카드의 **[변경사항 저장]**을 먼저 선택합니다. |
| 전체 상품 목록을 불러오지 못했습니다. 다시 시도해 주세요. | **[전체 선택]**에 실패했습니다. 다시 선택합니다. |
| 수집 상품 등록 갯수를 초과했습니다. 서비스를 업그레이드해주세요. | 수집 상품 수가 한도에 이르러 새 상품이 수집되지 않았습니다. [결제 관리](payment.md)에서 **수집 상품 개수**를 늘립니다. |
| 잔여 토큰이 부족합니다. | AI 토큰이 모자라 AI 상품명·검색 태그를 만들지 못했습니다. [결제 관리](payment.md)에서 AI 토큰을 충전합니다. |
| 변경사항이 저장되었습니다. | 오류가 아닙니다. 상품 카드의 고친 내용이 저장되었습니다. |
| 작성 중인 내용이 있습니다. 저장 후 다시 시도해주세요. | 고친 내용을 저장하지 않고 AI 생성을 눌렀습니다. **[변경사항 저장]** 뒤 다시 누릅니다. |
| 상세페이지 정책을 설정해야합니다. | **적용 정책** 탭에서 상세페이지 정책을 고르고 저장합니다. |
| 마켓 정책이 적용되지 않았습니다. | **적용 정책** 탭에서 마켓 정책을 고릅니다. |
| 옵션을 모두 삭제할 수 없습니다. | 옵션은 하나 이상 남겨야 합니다. 판매하지 않을 옵션은 가격/재고 탭의 "등록 여부"를 끕니다. |

### 마켓 필수 정보 (옵션 관리 탭)

상품을 펼친 뒤 **옵션 관리** 탭의 마켓 하위 탭에 나오는 안내입니다.

| 화면 문구 | 뜻과 해결 |
| --- | --- |
| 쿠팡 카테고리가 매칭되지 않았습니다. 카테고리를 지정하면 필수속성이 표시됩니다. | 이 상품의 쿠팡 카테고리가 정해지지 않았습니다. [카테고리 조회/수정](category-edit.md)에서 이 상품 수집 카테고리의 쿠팡 카테고리를 정합니다. |
| 이 마켓의 정책이 설정되지 않았습니다. 정책을 설정하면 필수값을 입력할 수 있습니다. | 상품의 **적용 정책**에서 이 마켓의 마켓 정책(또는 통합 정책)을 고릅니다. |
| 마켓 계정이 연결되지 않았습니다. 마켓 계정을 먼저 연결해 주세요. | [마켓 계정 관리](market-account.md)에서 이 마켓 계정을 연결합니다. |
| 마켓 요청 한도를 초과했습니다. 잠시 후 다시 시도해 주세요. | 마켓에 너무 자주 물었습니다. 잠시 뒤 **[새로고침]**을 선택합니다. |
| 이 카테고리는 쿠팡 필수속성이 없습니다. | 오류가 아닙니다. 넣을 필수속성이 없습니다. |
| 필수속성 정의를 불러오는 중입니다... | 마켓에서 항목을 받아 오는 중입니다. 기다립니다. |

## 상품 관리 — 일괄처리

자세한 내용은 [상품 조회 — 일괄처리](product-batch.md)를 봅니다.

| 화면 문구 | 뜻과 해결 |
| --- | --- |
| 작업이 등록되었습니다. | 오류가 아닙니다. 작업이 시작되었습니다. 결과는 [상품 작업 현황](item-work.md)에서 봅니다. |
| 필수정책 설정필요 | 마진·마켓 정책이 없는 상품이 있습니다. 링크를 눌러 정책을 적용합니다. |
| 카테고리 설정필요 | 고른 마켓의 카테고리가 없는 상품이 있습니다. 링크를 눌러 카테고리를 정합니다. |
| 1000개 이상의 상품을 처리할 수 없습니다. | 한 번에 보내는 상품이 1,000개를 넘었습니다. 나눠서 보냅니다. |
| 수집할 상품이 모두 수집기에 있습니다. | 고른 상품이 이미 다른 수집기에 들어 있습니다. |
| 잔여 토큰 부족 — 번역 작업은 생성되지만 실패로 기록됩니다. | AI 토큰이 0입니다. [결제 관리](payment.md)에서 AI 토큰을 충전한 뒤 번역합니다. |
| 토큰이 모자랍니다. 충전하거나 범위를 줄여 주세요. | 이미지 토큰이 모자랍니다. 고른 이미지를 줄이거나 토큰을 채웁니다. |

## 상품 관리 — 상품 그룹·금지어·작업 현황

자세한 내용은 [상품 그룹 관리](item-group.md), [금지어 설정](forbidden-words.md), [상품 작업 현황](item-work.md)을 봅니다.

| 화면 문구 | 뜻과 해결 |
| --- | --- |
| 그룹명을 입력해주세요. | (상품 그룹) 그룹명 칸이 비어 있습니다. |
| 그룹 이름에 '그룹 없음'은 사용할 수 없습니다. | (상품 그룹) "그룹 없음"은 쓸 수 없는 이름입니다. 다른 이름을 넣습니다. |
| 이미 존재하는 그룹 이름입니다. | (상품 그룹) 같은 이름의 그룹이 이미 있습니다. 다른 이름을 넣습니다. |
| 그룹은 최대 300개까지 생성 가능합니다. | (상품 그룹) 그룹이 300개입니다. 쓰지 않는 그룹을 지운 뒤 만듭니다. |
| 금지어가 포함된 상품입니다. | (마켓 작업 로그) 마켓 등록 때 상품명에 금지어가 있어 등록하지 않았습니다. 상품명을 고치거나 예외 금지어를 등록한 뒤 다시 등록합니다. |
| 잘못된 엑셀 파일 포맷입니다. 제공된 포맷으로 업로드해주세요. | (금지어) 파일 모양이 다릅니다. **[엑셀 다운로드]**로 받은 파일에 단어를 넣어 올립니다. |
| 엑셀 업로드에 실패하였습니다. | (금지어) 업로드하지 못했습니다. 파일 모양을 확인하고 다시 올립니다. |
| 삭제할 항목을 선택해주세요. | (상품 작업 현황) 지울 작업을 체크하지 않았습니다. |

## 상품 관리 — 이미지 편집기

자세한 내용은 [이미지 편집기](image-editor.md)를 봅니다.

### "이미지가 너무 큽니다."

- 에디터로 연 원본 이미지나 저장할 이미지가 4MB를 넘었습니다. 더 작은 이미지를 씁니다.

### "이미지 토큰이 모자랍니다. 이번 번역에 ○○개가 필요합니다."

- 이미지 번역에 쓸 [이미지 토큰](glossary.md)이 모자랍니다. 번역은 하나도 시작되지 않습니다. 이미지 토큰은 AI 토큰과 따로 세므로 결제 관리에서 AI 토큰을 충전해도 늘지 않습니다. 번역할 이미지를 줄여 다시 번역합니다.

### "번역이 30분 넘게 끝나지 않았습니다. 다시 번역해 주세요."

- 번역을 건 뒤 30분이 지나도 끝나지 않았습니다. 그 언어로 **다시 번역**을 선택합니다.

### 그 밖의 문구

| 화면 문구 | 뜻과 해결 |
| --- | --- |
| 이미지를 열지 못했습니다. | 이미지를 불러오지 못했습니다. 편집기를 닫고 다시 엽니다. |
| 윤곽 계산을 준비하지 못했습니다(…). 자동 누끼나 지우개로 다듬을 수 있습니다. | 클릭 누끼를 준비하지 못했습니다. **[자동 누끼]**나 지우개를 씁니다. |
| 자동 누끼를 따지 못했습니다. | 자동 누끼가 실패했습니다. **[클릭 누끼]**나 지우개로 다듬을 수 있습니다. |
| 번역할 언어가 없습니다(원본과 같은 언어뿐). | 원본이 이미 마켓 언어입니다. 번역할 필요가 없습니다. |
| 이미지가 너무 커서 나눌 수 없습니다 | 상세페이지 이미지가 나눌 수 있는 크기(최대 4,000만 화소)를 넘었습니다. |

## 상품 관리 — AI 작업 설정

자세한 내용은 [AI 작업 설정](ai-settings.md)을 봅니다.

| 화면 문구 | 뜻과 해결 |
| --- | --- |
| 설정을 불러오지 못했습니다. | 저장된 설정을 읽지 못했습니다. 화면을 다시 엽니다. |
| 저장에 실패했습니다. | 설정을 저장하지 못했습니다. 다시 **[변경사항 저장]**을 선택합니다. |

## 마켓 입점 — 이베이 시작하기

자세한 내용은 [이베이 시작하기](ebay-start.md)의 "자주 보는 메시지"를 봅니다.

| 화면 문구 | 뜻과 해결 |
| --- | --- |
| 저장했습니다. 확장 프로그램에도 넣었습니다. | 오류가 아닙니다. eBay·Payoneer 가입 화면에서 "에스프레소로 채우기"를 누르면 됩니다. |
| 저장했습니다. 확장 프로그램을 새 버전으로 바꿔 주세요. | 설치된 확장 프로그램이 옛 버전입니다. 새 버전을 설치한 뒤 **[다시 저장]**을 선택합니다. |
| 저장했습니다. 확장 프로그램이 설치돼 있지 않습니다. | [확장 프로그램을 설치](start-extension.md)한 뒤 **[다시 저장]**을 선택합니다. 설치하지 않아도 칸을 직접 채워 가입할 수 있습니다. |
| 진행 상황을 저장하지 못했습니다. 잠시 뒤 다시 눌러 주세요. | 단계 버튼을 누를 때 저장이 실패했습니다. 잠시 뒤 같은 버튼을 다시 선택합니다. |
| 영문으로 변환하지 못했습니다. 잠시 뒤 다시 눌러 주세요. | 영문 변환이 실패했습니다. 잠시 뒤 **[영문으로 변환]**을 다시 선택하거나 영문 칸을 직접 채웁니다. |
| 저장하지 못했습니다. 잠시 뒤 다시 눌러 주세요. | 1단계 저장이 실패했습니다. 잠시 뒤 다시 저장합니다. |
| 판매 설정은 이베이 계정을 에스프레소에 연결한 뒤에 할 수 있습니다. | [eBay 마켓 계정 연동](connect-ebay.md)을 먼저 합니다. |
| 마진 정책이 없습니다. 마진 정책을 먼저 만드세요. | [마진 정책](policy-margin.md)을 만든 뒤 7단계로 돌아옵니다. |
| 0 초과 100 미만으로 넣으세요 | eBay 수수료 칸 값을 고칩니다. |

## 마켓 관리 — 마켓 계정 관리

자세한 내용은 [마켓 계정 관리](market-account.md)를 봅니다.

### "테스트 실패"

- **언제**: **[API Key 테스트]**(G마켓·옥션은 **[로그인 테스트]**) 뒤. 성공하면 "테스트 성공"이 나오고 저장 버튼이 켜집니다.
- **왜**: 마켓이 연결을 거절했습니다. 옆에 마켓이 알려 준 이유가 나오고 이유가 없으면 "계정 확인에 실패했습니다."가 나옵니다(아래).
- **해결**: 마켓 판매자센터에서 받은 연결 정보를 다시 복사해 넣고 테스트합니다. 테스트한 뒤 칸을 고치면 다시 테스트해야 저장할 수 있습니다. 마켓별 방법은 [마켓 계정 연동하기](start-market.md)에서 찾습니다.

### "API 연결 상태를 확인해주세요"

- 연결 테스트에 성공하지 않은 채 저장하려 했거나, 마켓이 이유 없이 거절했습니다. 테스트에 성공한 뒤 저장합니다.

### "계정 확인에 실패했습니다."

- 마켓이 사유를 알려 주지 않고 연결을 거절했습니다. 연결 정보를 빠짐없이 복사했는지, 판매자센터에 **내 IP**를 등록했는지 확인하고 다시 테스트합니다.

### "아이디를 입력해주세요"

- 아이디 칸이 비어 있습니다. 마켓 판매자 아이디를 넣습니다.

### 마켓별 연결 오류

연결 테스트나 연결한 뒤 마켓에서 정보를 불러올 때 마켓이 알려 주는 문구입니다. 자세한 내용은 마켓별 연동 문서의 "자주 보는 메시지"를 봅니다.

| 화면 문구 | 마켓 | 뜻과 해결 |
| --- | --- | --- |
| Specified key is not registered. (이 말이 들어간 문구) | 쿠팡 | 쿠팡이 이 Access Key를 모릅니다. 쿠팡 API Key 칸에 Access Key를 넣었는지 확인합니다([쿠팡 마켓 계정 연동](connect-coupang.md)). |
| 현재 IP 주소(…)가 쿠팡 API에서 허용되지 않았습니다. 쿠팡 WING에서 허용 IP를 확인해주세요. | 쿠팡 | 쿠팡 윙 OPEN API 키의 IP 주소에 **내 IP**가 없습니다. IP를 넣습니다([쿠팡 마켓 계정 연동](connect-coupang.md)). |
| 쿠팡 API 인증이 만료되었습니다. 쿠팡 WING에서 API 키를 재발급한 뒤 다시 연동해주세요. | 쿠팡 | 쿠팡 키가 만료되었습니다. 쿠팡 윙에서 키를 다시 발급받고 [마켓 계정 관리](market-account.md)에서 넣은 뒤 다시 테스트합니다. |
| 쿠팡에 등록되지 않은 API 키입니다. 쿠팡 WING에서 API 키를 확인한 뒤 다시 연동해주세요. | 쿠팡 | 쿠팡이 넣은 키를 모릅니다. 쿠팡 윙에서 발급한 키를 빠짐없이 다시 복사해 넣고 테스트합니다([쿠팡 마켓 계정 연동](connect-coupang.md)). |
| 현재 서버 IP가 스마트스토어에서 허용되지 않았습니다. 스마트스토어 판매자센터 > API 관리에서 IP를 허용해주세요. | 스마트스토어 | 애플리케이션의 API 호출 IP에 **내 IP**가 없습니다. 네이버 커머스 API 센터에서 IP를 넣습니다([스마트스토어 마켓 계정 연동](connect-smartstore.md)). |
| 스마트스토어 API 권한이 없습니다. 네이버 커머스 API 센터 > 애플리케이션에서 "판매자정보" API 그룹이 추가되어 있는지 확인해주세요. | 스마트스토어 | **판매자정보** API 그룹이 빠졌습니다. 애플리케이션에 추가합니다. |
| 스마트스토어 애플리케이션이 휴면 상태입니다. 네이버 커머스 API 센터에서 휴면을 해제해주세요. | 스마트스토어 | 네이버 커머스 API 센터에서 애플리케이션 휴면을 풉니다. |
| 스마트스토어 API 요청 한도에 걸렸습니다. 잠시 후(1~2분) 다시 시도해주세요. | 스마트스토어 | 짧은 시간에 요청이 많았습니다. 1~2분 뒤 다시 합니다. |
| 스마트스토어 API 인증이 유효하지 않습니다. 마켓 계정 관리에서 계정을 다시 연동해주세요. | 스마트스토어 | 애플리케이션 시크릿이 바뀌었거나 애플리케이션이 지워졌습니다. 새 시크릿을 [마켓 계정 관리](market-account.md)에서 넣고 다시 테스트합니다. |
| 2차 인증이 필요합니다. | G마켓·옥션 | ESM이 2차 인증을 요구합니다. [ESM (G마켓/옥션) 마켓 계정 연동](connect-esm.md)의 2차 인증 안내대로 합니다. |
| 로그인 실패: …로 시작하는 문구 | G마켓·옥션 | ESM이 로그인을 거절했습니다. ESM Plus에 마스터 아이디로 직접 로그인되는지 확인하고, 같은 아이디·비밀번호로 다시 테스트합니다. |
| ESM 사이트에서 비밀번호 변경이 필요합니다. | G마켓·옥션 | ESM Plus에서 비밀번호를 바꾼 뒤 새 비밀번호로 다시 테스트합니다. |
| G마켓 판매자 정보를 찾을 수 없습니다. 마켓 계정을 확인해주세요. (옥션도 같은 꼴) | G마켓·옥션 | ESM에서 고른 판매자 아이디를 찾지 못했습니다. ESM Plus에 그 판매자 아이디가 있는지 보고, 없으면 [마켓 계정 관리](market-account.md)에서 계정을 지우고 맞는 판매자 아이디로 다시 추가합니다. |
| 옥션/G마켓 로그인이 만료되었습니다. 마켓 계정을 다시 연결해주세요. | G마켓·옥션 | ESM 로그인이 풀렸습니다. [마켓 계정 관리](market-account.md)에서 그 계정의 **[로그인 테스트]**를 다시 하고 저장합니다. |
| 인증 URL이 만료되었거나 이미 사용되었습니다. [인증 URL 생성]부터 다시 진행해주세요. | eBay | eBay 로그인 뒤 받은 주소를 늦게 넣었거나 한 번 쓴 주소입니다. **[인증 URL 생성]**부터 다시 합니다([eBay 마켓 계정 연동](connect-ebay.md)). |
| App ID 또는 Cert ID가 맞지 않습니다. | eBay | eBay Developers Application Keys의 Production 키 세트 값을 다시 복사해 넣습니다([eBay API 키 발급](ebay-key.md)). |
| 이베이 연결에 실패했습니다. 입력한 App ID·Cert ID·Redirect URI를 확인해주세요. | eBay | 세 값 중 하나가 맞지 않거나 키 세트가 꺼져 있습니다. Redirect URI에 RuName 이름을 넣었는지, 키 세트가 켜졌는지 확인합니다([eBay API 키 발급](ebay-key.md)). |
| API Key를 입력해주세요 | 롯데온 | 롯데온 API Key 칸이 비어 있습니다. 키를 넣고 테스트합니다. |

### "계정 등록 갯수를 초과했습니다. 서비스를 업그레이드해주세요."

- **왜**: [부가서비스](glossary.md)의 마켓 계정 한도(모든 마켓을 합친 수)를 넘었습니다.
- **해결**: 쓰지 않는 계정을 지우거나 [결제 관리](payment.md) > **부가서비스 구매**에서 **마켓 계정** 한도를 늘립니다.

### "중복된 계정이 존재합니다."

- 같은 마켓에 같은 계정이 이미 연결되어 있습니다. 같은 계정인지 보는 기준(아이디·API Key 등)은 마켓마다 다릅니다. 이미 있는 계정을 고쳐 씁니다.

### "연결된 마켓 정책이 있습니다."

- 지우려는 계정을 쓰는 마켓 정책이 있습니다. [마켓 정책](policy-market.md)에서 그 정책을 지우거나 다른 계정으로 바꾼 뒤 다시 지웁니다.

### "연결된 상품이 있어 삭제할 수 없습니다."

- 이 계정으로 마켓에 등록한 상품이 있습니다. 등록 상품을 먼저 삭제한 뒤 계정을 지웁니다.

### "인증 URL에서 authorization code를 찾을 수 없습니다."

- **인증 URL** 칸에 eBay 로그인을 마친 뒤의 주소가 아닌 다른 주소(로그인 화면 주소 등)를 넣었습니다. **[인증 URL 생성]**으로 열린 탭에서 로그인을 마치고 "Authorization successfully completed." 화면의 주소창 주소 전체를 붙여 넣습니다([eBay 마켓 계정 연동](connect-ebay.md)).

### "인증 URL 생성에 실패했습니다." · "토큰 교환에 실패했습니다."

- eBay 연결 중에 문제가 생겼습니다. App ID·Cert ID·Redirect URI를 확인하고 잠시 뒤 **[인증 URL 생성]**부터 다시 합니다([eBay 마켓 계정 연동](connect-ebay.md)).

### "상품이 등록된 계정은 다른 이베이 계정으로 바꿀 수 없습니다. 같은 이베이 계정으로 다시 연결해 주세요."

- 상품을 등록한 eBay 계정을 다시 연결할 때 다른 eBay 판매자 계정으로 로그인했습니다. **[인증 URL 생성]**부터 원래 eBay 계정으로 다시 로그인합니다.

### "이베이 연결을 완료해주세요"

- eBay 계정을 저장하기 전에 **[API Key 테스트]**를 성공하지 않았습니다. eBay 로그인 뒤 주소를 **인증 URL**에 넣고 테스트에 성공한 뒤 저장합니다([eBay 마켓 계정 연동](connect-ebay.md)).

### "롯데ON 이 접근을 거부했습니다. 스토어센터 [판매자정보 > OpenAPI관리]의 허용 IP 에 에스프레소 서버 IP 가 등록돼 있는지 확인해주세요."

- **언제**: 롯데온 계정의 **[API Key 테스트]** 뒤, 또는 롯데온 마켓 정책에서 배송비 정책·출고지 목록을 불러올 때.
- **해결**: 롯데ON 스토어센터의 허용 IP에 계정 팝업의 **내 IP**를 공백 없이 넣었는지 확인하고 다시 시도합니다([롯데온 마켓 계정 연동](connect-lotteon.md)).

### "등록되지 않은 롯데ON OpenAPI Key 입니다. 키를 확인해주세요."

- 넣은 키가 롯데ON에 없습니다. 키를 빠짐없이 복사했는지 확인하고 필요하면 스토어센터에서 새로 발급받습니다([롯데온 마켓 계정 연동](connect-lotteon.md)).

## 주문 관리 — 주문 조회

자세한 내용은 [주문 조회](order-search.md)를 봅니다.

| 화면 문구·표시 | 뜻과 해결 |
| --- | --- |
| 조회 완료! 새로 고침을 해주세요. | 오류가 아닙니다. 주문을 다 가져왔습니다. 목록 위 **[새로고침]**을 선택합니다. |
| 송장 전송 실패 | 마켓에 송장을 보내지 못했습니다. 표시를 누르면 주문 로그가 열려 이유를 볼 수 있습니다. 이유대로 고친 뒤 주문을 체크하고 **[송장 전송]**을 다시 선택합니다. 옆 X를 누르면 표시가 지워집니다. |
| 중복된 해외 송장번호 (노랑) | 같은 해외 송장번호를 쓴 다른 주문이 있습니다. 번호를 확인합니다. |
| 중복된 국내 송장번호 (회색) | 같은 국내 송장번호를 쓴 다른 주문이 있습니다. 번호를 확인합니다. |
| 마켓 계정이 존재하지 않습니다. | 고른 마켓에 연동한 계정이 없습니다. [마켓 계정 연동하기](start-market.md)를 봅니다. |
| 작업 등록에 실패했습니다. | 내역 조회·발주 처리·송장 전송 작업을 만들지 못했습니다. 다시 시도합니다. |
| 선택한 주문을 찾을 수 없습니다. 새로고침 후 다시 선택해주세요. | 체크한 주문이 바뀌었습니다. **[새로고침]** 뒤 다시 체크합니다. |

발주 처리·송장 전송이 마켓에서 실패한 이유는 [주문 작업 현황](order-work.md)의 **주문 작업 로그**에서 봅니다.

## 주문 관리 — 문의 조회

자세한 내용은 [문의 조회](cs.md)의 "자주 보는 메시지"를 봅니다.

| 화면 문구 | 뜻과 해결 |
| --- | --- |
| 보낼 답변이 없습니다 | 고른 문의가 모두 빈 답변·빈칸 `{…}`·500자 초과·이미 처리됨이라 뺐습니다. 알림 끝의 이유를 보고 고칩니다. |
| 답변 전송에 실패하였습니다. | 답변 작업을 등록하지 못했습니다. 다시 보냅니다. |
| AI 답변을 만들지 못했습니다. 잠시 뒤 다시 만들어 주세요. · AI 답변 요청이 실패했습니다. 잠시 뒤 다시 만들어 주세요. | 잠시 뒤 **[다시 만들기]**(답변이 없으면 **[AI 답변 만들기]**)를 선택하거나 **직접 작성** 탭에서 씁니다. |
| 답변 내용이 너무 짧습니다. 5자 이상 입력해주세요. | (G마켓·옥션, 주문 작업 로그) 5자 이상 써서 다시 보냅니다. |
| 이미 답변이 등록된 CS입니다. | (주문 작업 로그) 이미 처리한 문의입니다. **[새로고침]**으로 처리 여부를 확인합니다. |
| 삭제에 실패하였습니다. | 문의를 지우지 못했습니다. 다시 시도합니다. |

## 계정 관리

### "잘못된 비밀번호입니다."

- 비밀번호 변경 창의 **현재 비밀번호**가 틀렸습니다. 다시 입력합니다. 잊었다면 로그아웃 후 [비밀번호 찾기](login-help.md)로 다시 설정합니다.

### "비밀번호가 일치하지 않습니다."

- **새 비밀번호**와 **새 비밀번호 확인**이 다릅니다. 같게 입력합니다.

휴대폰 번호를 바꿀 때 나오는 문구는 위 "로그인·가입"의 인증 문구와 같습니다. [계정 관리](account.md)도 봅니다.

## 결제 관리

자세한 내용은 [결제 관리](payment.md)의 "결제가 안 될 때"를 봅니다.

### "카드 결제에 실패했습니다."

- 창 제목은 "카드 결제 실패"입니다. 등록한 카드의 유효기간과 쓸 수 있는 카드인지 확인합니다. 유효한 카드로 바꾸면 다음 날 자동 결제됩니다.

### "결제 실패" (결제 수단 옆 빨간 글씨)

- 등록한 카드를 쓸 수 없습니다("카드 정보가 올바르지 않습니다."). **[결제 수단 변경]**으로 다른 카드를 등록합니다.

### "*해지 예약 중에는 플랜 구매가 불가합니다."

- 구독 해지를 예약한 동안에는 플랜을 살 수 없습니다. **현재 구독중인 플랜**에서 **해지 취소**를 먼저 합니다.

### "*무료플랜인 경우에는 부가서비스 구매가 불가합니다."

- 무료 플랜에서는 부가서비스를 살 수 없습니다. 먼저 플랜을 삽니다.

### "이미 다음 결제로 예약된 플랜입니다."

- 고른 플랜·범위가 이미 다음 결제로 예약되어 있습니다. 따로 할 일은 없습니다.

### 그 밖의 결제 문구

| 화면 문구 | 뜻과 해결 |
| --- | --- |
| 결제 예약 실패 · 결제 예약에 실패했습니다. | 다음 결제 플랜 변경 예약이 실패했습니다. 잠시 뒤 다시 합니다. |
| 환불 신청 실패 · 환불 신청을 실패했습니다. | 잠시 뒤 다시 하거나 [고객센터](support.md)로 문의합니다. |
| 결제 모듈을 불러오는데 실패했습니다 | 결제창을 열지 못했습니다. 화면을 새로고침한 뒤 다시 합니다. |
| 플랜 해지에 실패했습니다. (사유) | 사유를 확인하고 다시 하거나 고객센터로 문의합니다. |

## 고객센터

| 화면 문구 | 해결 |
| --- | --- |
| 문의 유형을 선택해주세요. · 제목을 입력해주세요. · 내용을 입력해주세요. | 빠진 칸을 채우고 **[문의하기]**를 다시 선택합니다. |
| 파일 크기는 10MB를 초과할 수 없습니다. | 첨부 파일을 10MB 미만으로 줄입니다. |
| 1개의 .png, .jpg 또는 .pdf 파일만 업로드 가능합니다. | jpg·png·pdf 파일 하나만 고릅니다. |

## 그래도 안 되면

여기서 문구를 찾지 못했거나 해결대로 해도 같으면 [고객센터](support.md) > **1:1 문의**로 남깁니다. 화면에 나온 문구 그대로와 화면 캡처, 어느 메뉴에서 무엇을 눌렀는지를 같이 적습니다.

## 관련 문서

- [확장 프로그램·브라우저 문제](trouble-extension.md)
- [화면 둘러보기 (사이드바·상단 탭·계정 팝업·이용 제한)](app-basics.md)
- [고객센터](support.md) — 여기 없는 문구 문의하기
- [용어집](glossary.md)