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

PRODUCT321: 바코드 중복 일치

이것이 의미하는 바

이 바코드와 일치하는 상품이 두 개 이상입니다.

WCPOS가 그중 하나를 안전하게 고를 수 없으므로 아무것도 추가되지 않았습니다. 상품을 이름으로 검색하고, 충돌을 해결하려면 스토어에서 각 상품에 고유한 바코드를 지정하세요.

조치 방법

다시 시도하기 전에 아래 세부 정보를 확인하세요. 위의 변경을 적용한 후에 재시도하세요. 변경하지 않고 재시도하면 같은 방식으로 실패합니다.

내 데이터

주문이나 상품 데이터에는 영향이 없습니다. 이 문제가 계속되면 스토어 관리자에게 문의하세요.

문제 해결

  1. 이번 판매를 완료하려면 상품을 이름으로 검색하세요. 바코드가 두 개 이상의 상품과 일치하기 때문에 스캔으로는 아무것도 추가되지 않았습니다.
  2. 로그 항목에는 스캔한 코드와 일치한 상품 수가 기록됩니다. POS에서 해당 바코드 값을 검색하면 어떤 상품들인지 확인할 수 있습니다.
  3. WP Admin에서 해당 상품들에 각각 고유한 바코드를 지정한 다음, 다시 스캔해 일치하는 상품이 하나만 남았는지 확인하세요.

확인할 위치

WCPOS가 이 오류를 저장할 수 있는 경우, 오류는 이를 발생시킨 기기에 기록됩니다. 스토어 상태 → 로그(내비게이션 서랍 하단의 심박 아이콘)를 열고 이 코드가 표시된 항목을 찾아 펼치세요. 펼쳐진 행에는 알기 쉽게 설명된 원인과 오류가 발생한 시점에 수집된 컨텍스트가 표시됩니다. 스토어 요청의 경우 이 컨텍스트에 서버 자체의 오류 코드(serverCode), HTTP status 또는 endpoint가 포함될 수 있으며, 표시되는 필드는 오류가 발생한 위치에 따라 다릅니다. 문제를 신고할 때는 스크린샷 대신 로그 화면 상단의 디버그 정보 복사(휴대폰과 태블릿에서는 디버그 정보 공유)를 사용하세요. 여기에는 앱 버전, 연결 상태, 가장 최근의 오류가 함께 담깁니다. 로그는 최대 30일간만 보관되므로 문제가 발생한 직후에 수집하세요. 또한 POS가 자체 로그 항목을 기록하기 전에 나타난 브라우저 콘솔 오류가 있다면 함께 복사하세요.

세부 정보

  • 코드: PRODUCT321 (BARCODE_AMBIGUOUS)
  • 심각도: warn
  • 도입 버전: WCPOS 1.10.0