오류 코드
WCPOS는 문제가 발생하면 원인을 파악하는 데 도움이 되는 오류 코드를 표시합니다. v1.10.0부터 코드는 영역 + 세 자리 숫자 형식을 따릅니다. 예를 들면 SYNC131 또는 AUTH311입니다. 영역은 POS의 어느 부분에서 문제가 발생했는지 나타내고, 숫자는 구체적인 상황을 식별합니다. 각 코드에는 의미, 해결 방법, 데이터에 미치는 영향을 설명하는 개별 페이지가 있습니다.
POS에서 오류 코드는 매장 상태 → 로그에 표시됩니다. 행을 펼친 다음 도움말 링크를 사용하면 여기 있는 해당 코드의 페이지로 바로 이동할 수 있습니다.
오류 영역 (v1.10.0+)
| 영역 | 분야 |
|---|---|
AUTH | 로그인, 세션 및 토큰 |
CHECKOUT | 계산대에서 주문 완료 |
CLIENT | POS 앱 자체 및 로컬 저장소 |
DISPLAY | 고객용 디스플레이 |
HOST | POS를 차단하는 호스팅 및 방화벽 규칙 |
LICENSE | Pro 라이선스 활성화 및 유효성 검사 |
PAYMENT | 결제 게이트웨이 및 단말기 |
PRINT | 영수증 인쇄 |
PRODUCT | 상품 데이터 및 카탈로그 작업 |
REGISTER | 현금 서랍, 계산대 세션 및 시재 확인 |
SYNC | POS와 매장 간 동기화 |
아래에서 해당 코드를 찾거나 검색하세요.
999로 끝나는 코드는 아직 전용 코드가 없는 상황에 사용하는 해당 영역의 공통 코드입니다.
전체 코드
AUTH: 로그인, 세션 및 토큰
| 코드 | 의미 |
|---|---|
| AUTH101 | 세션이 종료되어 다시 로그인해야 합니다. |
| AUTH111 | 매장에서 로그인 인증 정보를 받아들이지 않았습니다. |
| AUTH121 | 로그인한 매장 계정이 이 계산대의 캐셔와 일치하지 않습니다. |
| AUTH131 | 저장된 매장 세션이 불완전하여 WCPOS가 매장 목록으로 돌아갔습니다. |
| AUTH201 | 계정에 이 작업을 수행할 권한이 없습니다. |
| AUTH301 | 다른 인증 플러그인이 WCPOS의 연결을 막고 있습니다. |
| AUTH311 | WCPOS가 매장의 연결 지점에 접근할 수 없습니다. |
| AUTH321 | 이 사이트에서 WooCommerce가 활성화되어 있지 않아 WCPOS가 연결할 수 없습니다. |
| AUTH331 | 이 매장의 WCPOS 플러그인이 너무 오래되어 현재 앱 버전에서 사용할 수 없습니다. |
| AUTH341 | 이 매장이 이 기기에 이미 저장된 매장과 동일한 식별 정보를 반환합니다. |
| AUTH401 | 이 매장과의 보안 연결을 신뢰할 수 없습니다. |
| AUTH411 | 매장 주소가 없거나 유효한 URL이 아닙니다. |
| AUTH421 | 매장 서버가 이 앱에서 사용할 수 있는 모든 경로에서 로그인 토큰을 차단하고 있습니다. |
| AUTH431 | 매장의 REST API가 이 앱에서 사용할 수 있는 어떤 주소 형식에도 응답하지 않았습니다. |
| AUTH441 | 로그인 토큰이 이 서버에서 허용하는 크기보다 큽니다. |
| AUTH999 | 로그인하거나 로그인 상태를 유지하는 중에 예기치 않은 문제가 발생했습니다. |
CHECKOUT: 계산대에서 주문 완료
| 코드 | 의미 |
|---|---|
| CHECKOUT101 | 결제가 완료되지 않았으며, 장바구니는 안전하게 보존되어 다시 시도할 수 있습니다. |
| CHECKOUT111 | 이 변경 사항을 장바구니에 적용하지 못했으며, 장바구니는 변경되지 않았습니다. |
| CHECKOUT201 | WCPOS가 결제 완료 여부를 확인하지 못했습니다. |
| CHECKOUT211 | 매장에서 결제 결과를 반환하지 않아 주문 상태를 알 수 없습니다. |
| CHECKOUT301 | 상품 SKU가 중복되거나 유효하지 않아 결제를 계속할 수 없습니다. |
| CHECKOUT401 | 매장에서 계산한 이 주문의 합계가 계산대에 표시된 금액과 다릅니다. 주문은 매장에서 계산한 합계로 저장됩니다. |
| CHECKOUT411 | 이 주문의 한 항목에 POS가 읽을 수 없는 가격 정보가 있어 저장된 합계에서 해당 금액을 가져왔습니다. |
| CHECKOUT421 | 이 주문은 현재 매장에 없는 세율을 참조하므로 세금이 올바르지 않을 수 있습니다. |
| CHECKOUT999 | 결제 중에 예기치 않은 문제가 발생했습니다. |
CLIENT: POS 앱 자체 및 로컬 저장소
| 코드 | 의미 |
|---|---|
| CLIENT101 | WCPOS가 시작을 완료하지 못했습니다. |
| CLIENT111 | 동기화가 시작되는 데 예상보다 오래 걸리고 있습니다. |
| CLIENT121 | 이 브라우저에서는 한 번에 하나의 탭만 변경 사항을 전송할 수 있습니다. |
| CLIENT131 | WCPOS가 한꺼번에 너무 많은 요청을 대기열에 추가하여 일부를 삭제했습니다. |
| CLIENT141 | 상품과 일치하지 않는 검색 결과가 있어 WCPOS가 해당 결과를 숨겼습니다. |
| CLIENT142 | 검색 인덱스가 제시간에 응답하지 않아 WCPOS가 카탈로그를 직접 검색했습니다. |
| CLIENT143 | 검색 결과에 표시되어야 할 상품이 누락되었습니다. |
| CLIENT144 | 검색 인덱스 재구성에 실패하여 앱이 초기화를 다시 시도하는 동안 결과가 불완전할 수 있습니다. |
| CLIENT151 | 화면 일부를 불러오지 못해 오류 메시지로 대체되었습니다. |
| CLIENT161 | 이 브라우저 탭은 현재 계산대를 실행하는 탭이 아니므로 새 결제 요청을 보내지 않았습니다. |
| CLIENT171 | 이 기기의 시계와 매장의 시계가 일 분 넘게 차이 납니다. |
| CLIENT181 | WCPOS가 해당 매장으로 전환하지 못했습니다. |
| CLIENT201 | 이 기기의 메모리가 부족하여 마지막 작업이 완료되지 않았을 수 있습니다. |
| CLIENT211 | 기기 수준의 충돌로 WCPOS가 중지되었습니다. |
| CLIENT999 | WCPOS에서 예기치 않은 오류가 발생했습니다. |
DISPLAY: 고객용 디스플레이
| 코드 | 의미 |
|---|---|
| DISPLAY101 | 고객용 디스플레이에서 장바구니 스냅샷을 만들지 못해 다음 변경이 있을 때까지 대기 화면을 표시합니다. |
HOST: POS를 차단하는 호스팅 및 방화벽 규칙
| 코드 | 의미 |
|---|---|
| HOST101 | 서버가 브라우저의 권한 확인(CORS 사전 요청)을 차단하여 웹 앱이 서버에 접근할 수 없습니다. |
| HOST111 | 서버의 교차 출처(CORS) 설정이 잘못되어 브라우저가 응답을 거부합니다. |
| HOST121 | 매장의 API 대신 봇 방지 페이지가 응답하고 있습니다. |
| HOST131 | 매장 앞단의 프록시가 헤더가 너무 많다는 이유로 서버 응답을 거부합니다. |
| HOST141 | 호스팅 서비스의 보안 필터가 상품 검색을 차단하고 있습니다. |
| HOST151 | 호스팅 서비스의 캐시가 한 사람의 매장 데이터를 다른 사람에게 반환할 수 있습니다. |
| HOST161 | 호스팅 서비스가 이 매장 계산대의 요청 빈도를 제한하고 있습니다. |
LICENSE: Pro 라이선스 활성화 및 유효성 검사
| 코드 | 의미 |
|---|---|
| LICENSE101 | 이 매장 또는 기기에 WCPOS Pro 라이선스가 활성화되어 있지 않습니다. |
| LICENSE201 | WCPOS Pro의 버전이 WCPOS와 일치하지 않아 비활성화되었습니다. |
| LICENSE301 | 업데이트 도구에 WCPOS Pro 업데이트를 다운로드할 권한이 없습니다. |
| LICENSE999 | 라이선스 확인 중에 예기치 않은 문제가 발생했습니다. |
PAYMENT: 결제 게이트웨이 및 단말기
| 코드 | 의미 |
|---|---|
| PAYMENT101 | 결제는 성공했지만 WCPOS가 이후 결제 상태를 새로고침하지 못했습니다. |
| PAYMENT111 | 매장에 결제가 기록되었지만 계산대에는 사본을 저장하지 못했습니다. |
| PAYMENT113 | 매장에서 청구서를 전송하거나 취소했지만 이 계산대에는 주문 사본을 저장하지 못했습니다. |
| PAYMENT121 | 카드에 금액이 청구되었지만 주문이 완료되지 않았습니다. |
| PAYMENT201 | WCPOS가 단말기에서 결제 금액이 청구되었는지 확인하지 못했습니다. |
| PAYMENT211 | 단말기에서 이 결제 금액을 받지 않았습니다. |
| PAYMENT212 | 결제 게이트웨이에서 이 결제를 받아들이지 않았습니다. |
| PAYMENT213 | 매장에서 이 결제의 기록을 거부했습니다. 받은 금액은 없습니다. |
| PAYMENT221 | 결제 승인을 취소하지 못하여 해당 금액이 아직 보류되어 있습니다. |
| PAYMENT301 | 이 매장에서 선택한 결제 게이트웨이를 사용할 수 없습니다. |
| PAYMENT311 | WCPOS가 이 환불의 처리 여부를 확인하지 못했습니다. |
| PAYMENT401 | 결제 단말기와 WCPOS의 페어링이 완료되지 않았습니다. |
| PAYMENT501 | 이미 온라인으로 결제된 주문이므로 계산대에서 받은 결제 금액은 추가 결제입니다. |
| PAYMENT511 | 계산대에서 주문의 남은 미결제 금액보다 많은 금액을 받았습니다. |
| PAYMENT999 | 결제 처리 중에 예기치 않은 문제가 발생했습니다. |
PRINT: 영수증 인쇄
| 코드 | 의미 |
|---|---|
| PRINT101 | 이 영수증의 자동 인쇄가 시작되지 않았습니다. |
| PRINT201 | WCPOS가 인쇄 작업의 완료 여부를 확인하지 못했습니다. |
| PRINT301 | 선택한 프린터에 연결할 수 없습니다. |
| PRINT311 | 이 영수증을 이메일로 보내거나 다운로드하지 못했습니다. |
| PRINT999 | 인쇄 중에 예기치 않은 문제가 발생했습니다. 판매에는 영향이 없습니다. |
PRODUCT: 상품 데이터 및 카탈로그 작업
| 코드 | 의미 |
|---|---|
| PRODUCT101 | 이 상품 변경 사항은 아직 매장에 전달되지 않았습니다. |
| PRODUCT111 | 상품에 이 옵션을 추가하지 못했습니다. |
| PRODUCT201 | 이 상품 이미지를 사용할 수 없지만 상품은 계속 판매할 수 있습니다. |
| PRODUCT301 | 현재 검색 및 필터 조건에 맞는 상품이 없습니다. |
| PRODUCT321 | 이 바코드와 일치하는 상품이 두 개 이상입니다. |
| PRODUCT401 | 표시된 재고가 매장의 재고보다 오래된 정보일 수 있습니다. |
| PRODUCT411 | 바코드 스캔 설정을 불러오지 못해 스캔 결과가 상품과 일치하지 않을 수 있습니다. |
| PRODUCT421 | 이 상품의 옵션 가격 데이터를 읽지 못해 표시 가격이 잘못되거나 누락될 수 있습니다. |
| PRODUCT999 | 상품을 불러오거나 업데이트하는 중에 예기치 않은 문제가 발생했습니다. |
REGISTER: 현금 서랍, 계산대 세션 및 시재 확인
| 코드 | 의미 |
|---|---|
| REGISTER101 | 매장에서 계산대에 이미 기록된 입금, 출금 또는 판매 없는 서랍 열기를 거부했습니다. |
| REGISTER111 | 매장에서 현금 이동 취소를 거부하여 원래 내역이 계속 집계됩니다. |
| REGISTER201 | 매장에서 이 계산대 세션의 시작을 거부하여 해당 세션에 아무 내역도 집계되지 않습니다. |
| REGISTER211 | 매장에서 이 계산대의 시재 확인 결과를 거부하여 매장에는 세션이 계속 열려 있습니다. |
| REGISTER212 | 이 기기에서 현금 서랍 이월이 완료되지 않았습니다. 매장은 전환되지 않았습니다. |
| REGISTER221 | 다른 기기에서 이미 이 계산대를 열어 두었으므로 이 계산대는 새 세션을 시작하지 않고 기존 세션에 참여했습니다. |
| REGISTER231 | 이 계정은 계산대를 열거나 시재를 확인하거나 계산대를 닫을 수 없습니다. |
| REGISTER301 | 매장에서 이 시재 확인에 대한 매니저 승인을 받아들이지 않아 계산대가 계속 열려 있습니다. |
SYNC: POS와 매장 간 동기화
| 코드 | 의미 |
|---|---|
| SYNC101 | WCPOS가 이 기기의 저장소에 변경 사항을 기록하지 못했습니다. |
| SYNC111 | 이 기기에 저장된 일부 데이터가 손상되어 동기화할 수 없습니다. |
| SYNC121 | 현재 매장에 연결할 수 없습니다. |
| SYNC131 | 매장에서 오류가 발생하여 이 요청을 완료하지 못했습니다. |
| SYNC141 | 매장에서 WCPOS에 잠시 요청 속도를 줄이도록 요청했습니다. |
| SYNC151 | 매장 응답에 불필요한 텍스트가 포함되어 WCPOS가 이를 정리하려고 했습니다. |
| SYNC161 | 이 기기의 저장소가 응답하지 않아 저장이 일시 중지되었습니다. |
| SYNC171 | WCPOS가 이 기기의 저장소를 설정하거나 제거하지 못했습니다. |
| SYNC181 | 이 기기에서 저장 또는 불러오기가 매우 느리며 아직 결과를 알 수 없습니다. |
| SYNC191 | 이 변경 사항은 아직 매장으로 전송 중입니다. |
| SYNC201 | 매장에서 이 변경 사항을 거부하여 매장에 반영되지 않았습니다. |
| SYNC202 | 매장에서 이 변경 사항을 거부하여 이 기기가 매장의 버전으로 되돌아갔습니다. |
| SYNC203 | 매장에 이 주문이 더 이상 없어 이 기기가 자체 사본을 정리했습니다. |
| SYNC211 | 매장에서 전송된 값을 거부했습니다. |
| SYNC221 | 이 기기의 변경 사항이 매장의 더 최근 수정 사항과 충돌했습니다. 데이터는 손실되지 않았습니다. |
| SYNC222 | 이 기기가 매장의 더 최근 수정 사항을 자체 버전으로 덮어썼습니다. |
| SYNC231 | 매장에서 이 변경 사항을 수신했지만 이 기기는 전송 완료 사실을 기록하지 못했습니다. |
| SYNC301 | 매장의 변경 사항 목록이 예기치 않게 이동하여 WCPOS가 자동으로 다시 확인하고 있습니다. 데이터는 손실되지 않았습니다. |
| SYNC311 | 이 기기의 데이터가 다른 WCPOS 버전에서 저장되어 아직 열 수 없습니다. |
| SYNC321 | 이번에 일부 데이터가 동기화되지 않았습니다. |
| SYNC331 | 이 기기의 레코드 사본이 매장의 레코드와 일치하지 않습니다. 입력한 내용에는 영향이 없습니다. |
| SYNC341 | 이제 이 매장에는 더 최신 버전의 POS 앱이 필요합니다. |
| SYNC401 | 백그라운드 동기화 작업이 완료되기 전에 예기치 않게 중지되었습니다. |
| SYNC411 | 이 기기가 평소보다 훨씬 자주 매장에 데이터를 요청했습니다. |
| SYNC999 | 동기화 중에 예기치 않은 문제가 발생했습니다. |
v1.10.0 이전의 코드
API04001 같은 코드는 v1.10.0 이전 버전에서 사용하던 코드이며, 이 버전에서는 발생하지 않습니다. 업그레이드 전에 저장된 로그 항목이나 이전 지원 게시글에서 이러한 코드를 볼 수 있습니다. 확인하려면 버전 메뉴를 1.x로 전환하세요.
추가 도움이 필요하신가요?
문제 해결 단계를 따른 후에도 문제가 계속되면 다음을 확인하세요:
- 더 자세한 안내는 문제 해결 섹션을 확인하세요
- Discord 커뮤니티에 참여하여 지원을 받으세요
- GitHub에 문제를 보고하세요