주 콘텐츠로 건너뛰기
버전: 2.x

오류 코드

WCPOS는 문제가 발생하면 원인을 파악하는 데 도움이 되는 오류 코드를 표시합니다. v1.10.0부터 코드는 영역 + 세 자리 숫자 형식을 따릅니다. 예를 들면 SYNC131 또는 AUTH311입니다. 영역은 POS의 어느 부분에서 문제가 발생했는지 나타내고, 숫자는 구체적인 상황을 식별합니다. 각 코드에는 의미, 해결 방법, 데이터에 미치는 영향을 설명하는 개별 페이지가 있습니다.

POS에서 오류 코드는 매장 상태 → 로그에 표시됩니다. 행을 펼친 다음 도움말 링크를 사용하면 여기 있는 해당 코드의 페이지로 바로 이동할 수 있습니다.

오류 영역 (v1.10.0+)​

영역분야
AUTH로그인, 세션 및 토큰
CHECKOUT계산대에서 주문 완료
CLIENTPOS 앱 자체 및 로컬 저장소
DISPLAY고객용 디스플레이
HOSTPOS를 차단하는 호스팅 및 방화벽 규칙
LICENSEPro 라이선스 활성화 및 유효성 검사
PAYMENT결제 게이트웨이 및 단말기
PRINT영수증 인쇄
PRODUCT상품 데이터 및 카탈로그 작업
REGISTER현금 서랍, 계산대 세션 및 시재 확인
SYNCPOS와 매장 간 동기화

아래에서 해당 코드를 찾거나 검색하세요.

999로 끝나는 코드는 아직 전용 코드가 없는 상황에 사용하는 해당 영역의 공통 코드입니다.

전체 코드​

AUTH: 로그인, 세션 및 토큰​

코드의미
AUTH101세션이 종료되어 다시 로그인해야 합니다.
AUTH111매장에서 로그인 인증 정보를 받아들이지 않았습니다.
AUTH121로그인한 매장 계정이 이 계산대의 캐셔와 일치하지 않습니다.
AUTH131저장된 매장 세션이 불완전하여 WCPOS가 매장 목록으로 돌아갔습니다.
AUTH201계정에 이 작업을 수행할 권한이 없습니다.
AUTH301다른 인증 플러그인이 WCPOS의 연결을 막고 있습니다.
AUTH311WCPOS가 매장의 연결 지점에 접근할 수 없습니다.
AUTH321이 사이트에서 WooCommerce가 활성화되어 있지 않아 WCPOS가 연결할 수 없습니다.
AUTH331이 매장의 WCPOS 플러그인이 너무 오래되어 현재 앱 버전에서 사용할 수 없습니다.
AUTH341이 매장이 이 기기에 이미 저장된 매장과 동일한 식별 정보를 반환합니다.
AUTH401이 매장과의 보안 연결을 신뢰할 수 없습니다.
AUTH411매장 주소가 없거나 유효한 URL이 아닙니다.
AUTH421매장 서버가 이 앱에서 사용할 수 있는 모든 경로에서 로그인 토큰을 차단하고 있습니다.
AUTH431매장의 REST API가 이 앱에서 사용할 수 있는 어떤 주소 형식에도 응답하지 않았습니다.
AUTH441로그인 토큰이 이 서버에서 허용하는 크기보다 큽니다.
AUTH999로그인하거나 로그인 상태를 유지하는 중에 예기치 않은 문제가 발생했습니다.

CHECKOUT: 계산대에서 주문 완료​

코드의미
CHECKOUT101결제가 완료되지 않았으며, 장바구니는 안전하게 보존되어 다시 시도할 수 있습니다.
CHECKOUT111이 변경 사항을 장바구니에 적용하지 못했으며, 장바구니는 변경되지 않았습니다.
CHECKOUT201WCPOS가 결제 완료 여부를 확인하지 못했습니다.
CHECKOUT211매장에서 결제 결과를 반환하지 않아 주문 상태를 알 수 없습니다.
CHECKOUT301상품 SKU가 중복되거나 유효하지 않아 결제를 계속할 수 없습니다.
CHECKOUT401매장에서 계산한 이 주문의 합계가 계산대에 표시된 금액과 다릅니다. 주문은 매장에서 계산한 합계로 저장됩니다.
CHECKOUT411이 주문의 한 항목에 POS가 읽을 수 없는 가격 정보가 있어 저장된 합계에서 해당 금액을 가져왔습니다.
CHECKOUT421이 주문은 현재 매장에 없는 세율을 참조하므로 세금이 올바르지 않을 수 있습니다.
CHECKOUT999결제 중에 예기치 않은 문제가 발생했습니다.

CLIENT: POS 앱 자체 및 로컬 저장소​

코드의미
CLIENT101WCPOS가 시작을 완료하지 못했습니다.
CLIENT111동기화가 시작되는 데 예상보다 오래 걸리고 있습니다.
CLIENT121이 브라우저에서는 한 번에 하나의 탭만 변경 사항을 전송할 수 있습니다.
CLIENT131WCPOS가 한꺼번에 너무 많은 요청을 대기열에 추가하여 일부를 삭제했습니다.
CLIENT141상품과 일치하지 않는 검색 결과가 있어 WCPOS가 해당 결과를 숨겼습니다.
CLIENT142검색 인덱스가 제시간에 응답하지 않아 WCPOS가 카탈로그를 직접 검색했습니다.
CLIENT143검색 결과에 표시되어야 할 상품이 누락되었습니다.
CLIENT144검색 인덱스 재구성에 실패하여 앱이 초기화를 다시 시도하는 동안 결과가 불완전할 수 있습니다.
CLIENT151화면 일부를 불러오지 못해 오류 메시지로 대체되었습니다.
CLIENT161이 브라우저 탭은 현재 계산대를 실행하는 탭이 아니므로 새 결제 요청을 보내지 않았습니다.
CLIENT171이 기기의 시계와 매장의 시계가 일 분 넘게 차이 납니다.
CLIENT181WCPOS가 해당 매장으로 전환하지 못했습니다.
CLIENT201이 기기의 메모리가 부족하여 마지막 작업이 완료되지 않았을 수 있습니다.
CLIENT211기기 수준의 충돌로 WCPOS가 중지되었습니다.
CLIENT999WCPOS에서 예기치 않은 오류가 발생했습니다.

DISPLAY: 고객용 디스플레이​

코드의미
DISPLAY101고객용 디스플레이에서 장바구니 스냅샷을 만들지 못해 다음 변경이 있을 때까지 대기 화면을 표시합니다.

HOST: POS를 차단하는 호스팅 및 방화벽 규칙​

코드의미
HOST101서버가 브라우저의 권한 확인(CORS 사전 요청)을 차단하여 웹 앱이 서버에 접근할 수 없습니다.
HOST111서버의 교차 출처(CORS) 설정이 잘못되어 브라우저가 응답을 거부합니다.
HOST121매장의 API 대신 봇 방지 페이지가 응답하고 있습니다.
HOST131매장 앞단의 프록시가 헤더가 너무 많다는 이유로 서버 응답을 거부합니다.
HOST141호스팅 서비스의 보안 필터가 상품 검색을 차단하고 있습니다.
HOST151호스팅 서비스의 캐시가 한 사람의 매장 데이터를 다른 사람에게 반환할 수 있습니다.
HOST161호스팅 서비스가 이 매장 계산대의 요청 빈도를 제한하고 있습니다.

LICENSE: Pro 라이선스 활성화 및 유효성 검사​

코드의미
LICENSE101이 매장 또는 기기에 WCPOS Pro 라이선스가 활성화되어 있지 않습니다.
LICENSE201WCPOS Pro의 버전이 WCPOS와 일치하지 않아 비활성화되었습니다.
LICENSE301업데이트 도구에 WCPOS Pro 업데이트를 다운로드할 권한이 없습니다.
LICENSE999라이선스 확인 중에 예기치 않은 문제가 발생했습니다.

PAYMENT: 결제 게이트웨이 및 단말기​

코드의미
PAYMENT101결제는 성공했지만 WCPOS가 이후 결제 상태를 새로고침하지 못했습니다.
PAYMENT111매장에 결제가 기록되었지만 계산대에는 사본을 저장하지 못했습니다.
PAYMENT113매장에서 청구서를 전송하거나 취소했지만 이 계산대에는 주문 사본을 저장하지 못했습니다.
PAYMENT121카드에 금액이 청구되었지만 주문이 완료되지 않았습니다.
PAYMENT201WCPOS가 단말기에서 결제 금액이 청구되었는지 확인하지 못했습니다.
PAYMENT211단말기에서 이 결제 금액을 받지 않았습니다.
PAYMENT212결제 게이트웨이에서 이 결제를 받아들이지 않았습니다.
PAYMENT213매장에서 이 결제의 기록을 거부했습니다. 받은 금액은 없습니다.
PAYMENT221결제 승인을 취소하지 못하여 해당 금액이 아직 보류되어 있습니다.
PAYMENT301이 매장에서 선택한 결제 게이트웨이를 사용할 수 없습니다.
PAYMENT311WCPOS가 이 환불의 처리 여부를 확인하지 못했습니다.
PAYMENT401결제 단말기와 WCPOS의 페어링이 완료되지 않았습니다.
PAYMENT501이미 온라인으로 결제된 주문이므로 계산대에서 받은 결제 금액은 추가 결제입니다.
PAYMENT511계산대에서 주문의 남은 미결제 금액보다 많은 금액을 받았습니다.
PAYMENT999결제 처리 중에 예기치 않은 문제가 발생했습니다.

PRINT: 영수증 인쇄​

코드의미
PRINT101이 영수증의 자동 인쇄가 시작되지 않았습니다.
PRINT201WCPOS가 인쇄 작업의 완료 여부를 확인하지 못했습니다.
PRINT301선택한 프린터에 연결할 수 없습니다.
PRINT311이 영수증을 이메일로 보내거나 다운로드하지 못했습니다.
PRINT999인쇄 중에 예기치 않은 문제가 발생했습니다. 판매에는 영향이 없습니다.

PRODUCT: 상품 데이터 및 카탈로그 작업​

코드의미
PRODUCT101이 상품 변경 사항은 아직 매장에 전달되지 않았습니다.
PRODUCT111상품에 이 옵션을 추가하지 못했습니다.
PRODUCT201이 상품 이미지를 사용할 수 없지만 상품은 계속 판매할 수 있습니다.
PRODUCT301현재 검색 및 필터 조건에 맞는 상품이 없습니다.
PRODUCT321이 바코드와 일치하는 상품이 두 개 이상입니다.
PRODUCT401표시된 재고가 매장의 재고보다 오래된 정보일 수 있습니다.
PRODUCT411바코드 스캔 설정을 불러오지 못해 스캔 결과가 상품과 일치하지 않을 수 있습니다.
PRODUCT421이 상품의 옵션 가격 데이터를 읽지 못해 표시 가격이 잘못되거나 누락될 수 있습니다.
PRODUCT999상품을 불러오거나 업데이트하는 중에 예기치 않은 문제가 발생했습니다.

REGISTER: 현금 서랍, 계산대 세션 및 시재 확인​

코드의미
REGISTER101매장에서 계산대에 이미 기록된 입금, 출금 또는 판매 없는 서랍 열기를 거부했습니다.
REGISTER111매장에서 현금 이동 취소를 거부하여 원래 내역이 계속 집계됩니다.
REGISTER201매장에서 이 계산대 세션의 시작을 거부하여 해당 세션에 아무 내역도 집계되지 않습니다.
REGISTER211매장에서 이 계산대의 시재 확인 결과를 거부하여 매장에는 세션이 계속 열려 있습니다.
REGISTER212이 기기에서 현금 서랍 이월이 완료되지 않았습니다. 매장은 전환되지 않았습니다.
REGISTER221다른 기기에서 이미 이 계산대를 열어 두었으므로 이 계산대는 새 세션을 시작하지 않고 기존 세션에 참여했습니다.
REGISTER231이 계정은 계산대를 열거나 시재를 확인하거나 계산대를 닫을 수 없습니다.
REGISTER301매장에서 이 시재 확인에 대한 매니저 승인을 받아들이지 않아 계산대가 계속 열려 있습니다.

SYNC: POS와 매장 간 동기화​

코드의미
SYNC101WCPOS가 이 기기의 저장소에 변경 사항을 기록하지 못했습니다.
SYNC111이 기기에 저장된 일부 데이터가 손상되어 동기화할 수 없습니다.
SYNC121현재 매장에 연결할 수 없습니다.
SYNC131매장에서 오류가 발생하여 이 요청을 완료하지 못했습니다.
SYNC141매장에서 WCPOS에 잠시 요청 속도를 줄이도록 요청했습니다.
SYNC151매장 응답에 불필요한 텍스트가 포함되어 WCPOS가 이를 정리하려고 했습니다.
SYNC161이 기기의 저장소가 응답하지 않아 저장이 일시 중지되었습니다.
SYNC171WCPOS가 이 기기의 저장소를 설정하거나 제거하지 못했습니다.
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로 전환하세요.

추가 도움이 필요하신가요?​

문제 해결 단계를 따른 후에도 문제가 계속되면 다음을 확인하세요:

  1. 더 자세한 안내는 문제 해결 섹션을 확인하세요
  2. Discord 커뮤니티에 참여하여 지원을 받으세요
  3. GitHub에 문제를 보고하세요