AVA가 문서 이름을 읽는 방식
약 3분이면 이 안내서를 검토할 수 있습니다. AVA는 여권에서 이름을 읽을 때 두 가지 방법을 사용합니다. 아래쪽의 기계 판독 영역(MRZ)과 인쇄된 텍스트의 시각 스캔입니다. 대부분의 여권에서는 MRZ를 우선합니다. 일부 국가에서는 MRZ가 이름과 성을 안정적으로 나누지 못하므로 시각 스캔을 우선합니다.
이 안내서에서는 추출된 이름이 게스트가 예상한 것과 다르게 보이는 이유, 단일 이름 게스트를 처리하는 방식, 그리고 AVA가 이름을 가져오는 위치를 설명합니다.
빠른 참고
| 상황 | AVA의 처리 방식 | 화면에 표시되는 내용 |
|---|---|---|
| MRZ가 명확한 일반 여권 | MRZ 이름 사용 | 이름이 기계 판독 영역과 일치 |
| 말레이시아, 미얀마, 인도네시아 또는 싱가포르 여권 | 시각 스캔 이름 사용 | 이름이 MRZ 위의 인쇄 텍스트와 일치 |
| 이름이 하나뿐인 게스트(단일 이름) | 단일 이름을 저장하고 PMS용으로 복제 | 이름과 성에 같은 값이 표시 |
| 한 줄에 이름이 인쇄된 말레이시아 ID | 매칭을 위해 이름과 성의 분할을 추론 | Balanced 또는 Lenient 모드에서는 승인된 앞부분 이름 하나가 생략될 수 있음 |
| 싱가포르 IC의 혼인명 또는 별칭 이름 | 출생 이름과 별칭을 모두 예약과 대조 | 별칭이 일치해도 기본(출생) 이름 저장 |
| 프랑스 여권의 배우자 성 | 출생 성과 혼인 성을 분리 | 출생 성은 성으로 저장되고 혼인 성은 매칭에 사용 |
| MRZ가 흐리거나 잘렸거나 오류가 있음 | 시각 스캔으로 대체 | 인쇄된 텍스트에서 이름을 가져옴 |
| 올바른 대소문자 설정이 활성화됨 | 최종 매칭 후 모두 대문자인 이름을 변경 | 이름이 Joseph McNamara로 표시 |
Document Name Overwrite가 켜져 있으면 AVA는 지원되는 문서 흐름에서 일치한 문서 이름을 게스트 레코드에 복사합니다. 꺼져 있으면 AVA는 예약 또는 PMS 게스트 이름을 유지합니다.
스캔한 이름을 올바른 대소문자로 표시
약 1분이면 설정할 수 있습니다. 기본값은 꺼져 있습니다.
모두 대문자인 이름을 첫 글자만 대문자인 형식으로 저장하려면 이 설정을 사용합니다.
예를 들어 JOSEPH MCNAMARA가 Joseph McNamara로 바뀝니다.
이미 대소문자가 섞여 있는 이름은 변경되지 않습니다.
| 설정 | 기본값 | 결과 |
|---|---|---|
| Format scanned names in proper case | 끄기 | 여권 및 ID 이름을 올바른 대소문자로 저장 |
올바른 대소문자 이름 켜기
-
Settings → Check-In Settings → Check-In Policy로 이동합니다.
-
Guest document options 섹션을 찾습니다.
-
Format scanned names in proper case를 켭니다.
-
Save Check-In Policy를 클릭합니다.
✓ 여권과 ID 카드에서 새로 가져온 모두 대문자 이름이 올바른 대소문자로 저장됩니다.
대소문자만 다른 이름 변경도 PMS에 전달될 수 있습니다. 이 설정을 켜기 전에 PMS가 이러한 업데이트를 올바르게 처리하는지 확인하세요.
작동 방식
이름의 출처
AVA는 모든 문서에서 두 가지 출처로 이름을 읽은 다음 더 신뢰할 수 있는 출처를 선택합니다.
1. 기계 판독 영역(MRZ)
MRZ는 여권 아래쪽에 있는 대문자 블록입니다. << 구분자로 나뉜 구조화된 이름 데이터를 포함합니다.
AVA가 MRZ를 신뢰하는 경우:
- 여권이 표준 2줄 MRZ 형식인 경우
- AVA가 2줄 여권 MRZ에서 약간 다른 줄 길이를 정규화하는 경우
- 체크 숫자 검증을 통과하는 경우
- 이름과 성 구간이 모두 있는 경우
- 국가가 단일 필드 이름 형식을 사용하지 않는 경우
AVA가 MRZ를 신뢰하지 않는 경우:
- 체크 숫자 검증에 실패한 경우(문자를 잘못 읽은 경우)
- MRZ가 없거나 흐리거나 불완전한 경우
- 이름 구간이 하나뿐인 경우(성 및 이름 사이에
<<구분자가 없는 경우)
각 MRZ 줄에는 작은 검증 숫자가 포함됩니다. 이 숫자가 데이터와 일치하지 않으면 카메라가 문자를 잘못 읽었다는 뜻입니다. AVA는 전체 MRZ를 거부하고 게스트에게 사진을 다시 찍도록 요청합니다.
AVA는 검증 전에 2줄 여권 MRZ의 작은 줄 길이 차이도 보정합니다. 이렇게 하면 선명하게 스캔된 문서는 다시 스캔하지 않고도 처리할 수 있습니다.
2. 시각 스캔(인쇄된 텍스트)
AVA는 문서에 인쇄된 이름 필드도 읽습니다. 사진과 MRZ 위에서 볼 수 있는 텍스트입니다. MRZ를 신뢰할 수 없을 때 사용하는 대체 방식이며, ID나 운전면허증 같은 비여권 문서에서는 기본 출처입니다.
국가별 이름 처리
일부 국가는 MRZ가 이름과 성을 안정적으로 분리하지 못하는 여권을 발급합니다. AVA는 이러한 여권을 감지하고 이름을 나눌 때 시각 스캔으로 전환합니다.
시각 이름을 사용하는 국가
| 국가 | 이유 | 달라지는 점 |
|---|---|---|
| 말레이시아 | MRZ가 전체 이름을 하나의 필드에 넣을 수 있음 | MRZ 이름 대신 인쇄된 이름 필드를 읽음 |
| 미얀마 | 이름에 성이 없는 경우가 많거나 단일 필드를 사용함 | 인쇄된 이름을 읽고 단일 이름을 감지할 수 있음 |
| 인도네시아 | 많은 시민이 단일 이름을 사용함 | 인쇄된 이름을 읽으며 이름 하나만 저장할 수 있음 |
| 싱가포르 | 특정 이름 패턴에서 MRZ 형식이 모호할 수 있음 | 이름과 성을 나누기 위해 인쇄된 이름 필드를 읽음 |
한 줄로 표시되는 말레이시아 ID 이름
일부 말레이시아 ID 카드는 이름 필드를 나누지 않고 전체 이름을 한 줄에 인쇄합니다. AVA는 매칭을 위해 이름과 성의 분할을 추론합니다.
Balanced 및 Lenient 모드에서는 승인된 앞부분 이름 하나를 예약에서 생략할 수 있습니다. 나머지 문서 토큰은 정확히 일치해야 합니다.
예를 들어 MUHAMMAD HAFIZ ABDULLAH는 HAFIZ ABDULLAH와 일치할 수 있습니다.
이 예외는 여권, 알 수 없는 문서 유형, 목록에 없는 앞부분 이름 또는 두 개의 생략된 접두사에는 적용되지 않습니다.
Strict 및 Custom 모드에서는 계속 전체 이름이 일치해야 합니다.
AVA가 시각 스캔에서 이름을 읽더라도 문서 번호, 생년월일, 만료일, 국적에는 계속 MRZ를 사용합니다. 이름을 나누는 방식만 시각 스캔으로 전환됩니다.
그 밖의 모든 국가
위에 나열되지 않은 국가의 여권은 MRZ를 읽을 수 있고 체크 숫자 검증을 통과하면 AVA가 MRZ 이름을 사용합니다.
단일 이름 게스트 처리 방식
인도네시아와 미얀마 시민처럼 법적 이름이 하나뿐인 게스트도 있습니다. AVA는 이를 두 단계로 처리합니다.
1단계: 추출
AVA가 다음 조건을 충족하는 여권을 감지하면:
- MRZ 이름 구간에
<<구분자가 없고, - 시각 스캔에 단일 이름(공백 없음)이 표시되는 경우
이름을 이름만 저장하고 성은 비워 둡니다.
2단계: PMS 동기화
대부분의 숙박 시설 관리 시스템은 이름과 성을 모두 요구합니다. 게스트 데이터를 PMS로 보내기 전에 AVA는 단일 이름을 두 필드에 복제합니다.
ACI에서 직원이 해당 여권의 이름 불일치를 확인하면 AVA는 선택한 게스트를 확인된 단일 문서 이름으로 업데이트합니다. 덮어쓰기 기록과 PMS 메모에 이름 변경이 기록됩니다.
| 문서에 표시 | AVA에 저장 | PMS로 전송 |
|---|---|---|
| SUKARNO | 이름: SUKARNO, 성: (비어 있음) | 이름: SUKARNO, 성: SUKARNO |
| (비어 있음), SUHARTO | 이름: (비어 있음), 성: SUHARTO | 이름: SUHARTO, 성: SUHARTO |
이 방식은 항공사가 단일 이름 여행자에게 사용하는 IATA Passenger Name Record(PNR) 관례를 따릅니다.
이름 재정렬
문서와 예약에 같은 이름 토큰이 있지만 이름과 성으로 나뉜 방식이 다른 경우가 있습니다. 이는 말레이시아, 인도네시아, 미얀마, 싱가포르 게스트에게 흔합니다.
예시:
| 출처 | 이름 | 성 |
|---|---|---|
| 문서 | AHMAD BIN IBRAHIM | (비어 있음) |
| 예약 | AHMAD | BIN IBRAHIM |
AVA는 양쪽에 같은 이름 부분이 포함되어 있음을 감지합니다. 일치가 확인되면 저장된 이름이 PMS 레코드와 일치하도록 예약의 분할 방식을 적용합니다.
예약에 추가적이고 관련 없는 예약 라벨 이름이 포함되어 있으면 AVA는 예약의 분할 방식을 적용하지 않습니다. AVA가 분할 방식을 변경하려면 예약 이름의 모든 토큰이 추출된 문서 이름에 포함되어 있어야 합니다.
이 경우 추출된 신원이 기준으로 유지됩니다. 이렇게 하면 그룹 또는 회사 라벨이 게스트의 여권 이름을 대체하는 것을 막을 수 있습니다.
Document Name Overwrite가 활성화되어 있으면 저장된 게스트 레코드에는 안전하게 정규화된 이름이 사용됩니다. 문서 업로드 이벤트에는 직원 검토를 위해 공급자가 추출한 원시 이름이 보존됩니다.
별칭 및 혼인명 매칭
기본 문서 이름이 예약과 일치하지 않으면 AVA는 대체 이름을 확인합니다.
싱가포르 신분증
싱가포르 IC에는 두 줄의 이름이 표시될 수 있습니다.
- 출생 이름(기본 이름) — 예: DASIMA BINTE MOHAMMAD
- 혼인 이름(별칭) — 예: MRS DASIMA KAYA
AVA는 두 이름을 모두 예약과 대조합니다. 별칭이 일치하면 체크인이 진행되지만 출생 이름이 공식 게스트 이름으로 저장됩니다.
프랑스 여권
프랑스 여권에는 혼인 성이 한 줄에 표시될 수 있습니다. 예: "FREBOURG ép. GODIN". AVA는 이를 다음과 같이 나눕니다.
- 기본 성: FREBOURG
- 별칭 성: GODIN
두 이름 모두 예약 이름과 대조합니다.
재스캔 요청이 발생하는 경우
다음과 같은 경우 AVA는 게스트에게 여권 사진을 다시 찍도록 요청합니다.
- ❌ MRZ 체크 숫자 검증 실패(문자를 잘못 읽음)
- ❌ MRZ 텍스트가 너무 짧거나 불완전함
- ❌ 백엔드가 어느 출처에서도 신뢰할 수 있는 이름을 확인할 수 없음
- ❌ 여권이 단일 필드 국가에 해당하고 시각 이름을 사용할 수 없음
재스캔 요청은 AVA가 문서를 확신을 가지고 읽지 못했다는 뜻입니다. 게스트는 더 선명한 사진을 찍으면 됩니다. 보통 조명을 개선하고 MRZ 전체가 보이도록 하면 충분합니다.
문제 해결
게스트 이름이 중복되어 보임(이름과 성이 같음)
보이는 현상: PMS에서 게스트의 이름과 성에 같은 값이 표시됩니다.
이유: 게스트에게 단일 법적 이름이 있습니다. AVA는 PMS 요구사항을 충족하기 위해 이를 복제합니다.
조치: 별도 조치는 필요하지 않습니다. 단일 이름 게스트에게는 예상된 동작입니다.
게스트 이름 분할이 여권과 다르게 보임
보이는 현상: 이름과 성이 여권에 표시된 방식과 다르게 바뀌거나 묶여 있습니다.
이유: 말레이시아, 미얀마, 인도네시아 또는 싱가포르 여권에서는 AVA가 시각 스캔을 사용하므로 MRZ와 다른 방식으로 이름을 나눌 수 있습니다.
해결 방법:
- 저장된 이름을 실물 여권의 인쇄 텍스트 및 MRZ와 비교합니다.
- 전체 이름은 맞지만 이름과 성의 분할만 다르다면 이는 정상입니다.
- 이름이 명백히 잘못되었다면 전체 문서가 보이도록 게스트에게 다시 스캔하도록 요청합니다.
게스트가 여권을 계속 재스캔하라는 요청을 받음
보이는 현상: 게스트가 다시 시도해도 AVA가 계속 새 사진을 요청합니다.
해결 방법:
- 게스트에게 여권을 어두운 표면에 평평하게 놓도록 안내합니다.
- MRZ 전체(아래쪽 두 줄)가 보이고 초점이 맞는지 확인합니다.
- 반사광과 그림자를 줄이고 손가락으로 문서의 어느 부분도 가리지 않도록 합니다.
- 계속 스캔에 실패하면 프런트 데스크에서 체크인을 완료합니다.
스캔한 이름이 여전히 대문자로 표시됨
보이는 현상: 새로 스캔한 이름이 여전히 모두 대문자로 표시됩니다.
해결 방법:
- Settings → Check-In Settings → Check-In Policy를 엽니다.
- Format scanned names in proper case가 켜져 있는지 확인합니다.
- Save Check-In Policy를 클릭합니다.
- 새 체크인에서 문서를 다시 스캔합니다.
이 설정은 매칭 후 새 문서 이름에 적용됩니다. 기존 게스트 레코드는 다시 작성하지 않습니다.
혼인명은 일치하지만 저장된 이름이 다름
보이는 현상: 체크인은 통과했지만 저장된 이름이 혼인명이 아니라 출생 이름입니다.
이유: 별칭 이름이 예약과 일치하더라도 AVA는 항상 문서의 기본(출생/법적) 이름을 저장합니다.
조치: 별도 조치는 필요하지 않습니다. 법적 준수를 위해 의도된 동작입니다.
여전히 해결되지 않나요?
다음과 같은 경우 success@vouch-technologies.com으로 문의하세요.
- ❌ 특정 국적의 여권 스캔이 계속 실패함
- ❌ 여러 번 다시 시도한 후에도 이름 추출 결과가 명백히 잘못됨
- ❌ 위에 나열되지 않은 국가의 이름 처리 방식에 대한 안내가 필요함
문의할 때 포함하면 좋은 정보:
- 게스트의 국적과 문서 유형
- 추출된 이름과 실물 문서를 비교한 스크린샷
- 호텔 국가 설정