Cara AVA Membaca Nama Dokumen
AVA memakai dua metode untuk membaca nama dari paspor: machine-readable zone (MRZ) di bagian bawah dan visual scan pada teks tercetak. Untuk sebagian besar paspor, MRZ lebih diutamakan. Untuk negara tertentu, visual scan mendapat prioritas karena MRZ mereka tidak memisahkan nama depan dan nama belakang dengan andal.
Panduan ini membantu Anda memahami mengapa nama yang diekstrak kadang terlihat berbeda dari ekspektasi tamu, bagaimana tamu dengan satu nama ditangani, dan apa yang menentukan dari mana AVA mengambil nama.
Referensi Cepat
| Situasi | Yang dilakukan AVA | Yang Anda lihat |
|---|---|---|
| Paspor standar dengan MRZ yang jelas | Menggunakan nama MRZ | Nama cocok dengan machine-readable zone |
| Paspor dari Malaysia, Myanmar, Indonesia, atau Singapore | Menggunakan nama visual (tercetak) | Nama cocok dengan teks tercetak di atas MRZ |
| Tamu dengan satu nama saja (mononym) | Menyimpan nama tunggal dan menggandakannya untuk PMS | First name dan last name menampilkan nilai yang sama |
| Nama menikah atau alias di Singapore IC | Memeriksa nama lahir dan alias terhadap reservasi | Nama utama (lahir) disimpan meski alias yang cocok |
| Paspor Prancis dengan surname pasangan | Memisahkan surname lahir dari surname menikah | Surname lahir disimpan sebagai last name; surname menikah tersedia untuk pencocokan |
| MRZ buram, terpotong, atau punya error | Beralih ke visual scan | Nama diambil dari teks tercetak |
Saat Document Name Overwrite aktif, AVA menyalin nama dokumen yang cocok ke record tamu selama alur dokumen yang didukung. Saat mati, AVA mempertahankan nama reservasi atau nama tamu dari PMS.
Cara Kerjanya
Dari Mana Nama Berasal
AVA membaca nama dari dua sumber pada setiap dokumen, lalu memilih yang paling andal.
1. Machine-Readable Zone (MRZ)
MRZ adalah blok huruf kapital di bagian bawah paspor. Bagian ini berisi data nama terstruktur yang dipisahkan dengan penanda <<.
Saat AVA mempercayai MRZ:
- Paspor memakai format MRZ dua baris standar
- AVA menormalkan perbedaan panjang baris kecil pada MRZ paspor dua baris
- Check digit lolos validasi
- Ada bagian nama depan dan nama belakang
- Negara tidak memakai format nama satu field
Saat AVA tidak mempercayai MRZ:
- Check digit gagal (karakter terbaca salah)
- MRZ hilang, buram, atau tidak lengkap
- Hanya ada satu bagian nama (tidak ada pemisah
<<antara surname dan given names)
Setiap baris MRZ menyertakan angka verifikasi kecil. Jika angka ini tidak cocok dengan data, artinya kamera salah membaca karakter. AVA menolak seluruh MRZ dan meminta tamu memotret ulang.
AVA juga merapikan perbedaan panjang baris kecil pada MRZ paspor dua baris sebelum validasi. Ini membantu scan yang jelas lolos tanpa perlu scan ulang.
2. Visual Scan (Teks Tercetak)
AVA juga membaca field nama tercetak pada dokumen, yaitu teks yang terlihat di atas foto dan MRZ. Ini adalah fallback saat MRZ tidak andal, dan sumber utama untuk dokumen non-paspor seperti ID dan SIM.
Penanganan Nama Berdasarkan Negara
Beberapa negara menerbitkan paspor yang MRZ-nya tidak secara andal memisahkan nama depan dari nama belakang. AVA mendeteksi ini dan beralih ke visual scan untuk pemisahan nama.
Negara yang Memakai Nama Visual
| Negara | Alasannya | Yang berubah |
|---|---|---|
| Malaysia | MRZ dapat menempatkan nama lengkap dalam satu field | AVA membaca field nama tercetak, bukan nama MRZ |
| Myanmar | Nama sering tidak punya nama keluarga, atau memakai satu field | AVA membaca nama tercetak dan dapat mendeteksi mononym |
| Indonesia | Banyak warga memiliki satu nama (mononym) | AVA membaca nama tercetak; bisa menyimpan satu nama saja |
| Singapore | Format MRZ bisa ambigu untuk pola nama tertentu | AVA membaca field nama tercetak untuk split nama depan/belakang |
Walaupun AVA membaca nama dari visual scan, AVA tetap memakai MRZ untuk document number, date of birth, expiry date, dan nationality. Hanya pemisahan nama yang beralih ke visual.
Semua Negara Lain
Untuk paspor dari negara yang tidak tercantum di atas, AVA memakai nama MRZ selama MRZ terbaca dan lolos validasi check digit.
Cara AVA Menangani Tamu Satu Nama (Mononym)
Beberapa tamu hanya punya satu nama legal, umum pada warga Indonesia dan Myanmar. AVA menanganinya dalam dua langkah.
Langkah 1: Ekstraksi
Saat AVA mendeteksi paspor dengan:
- Tidak ada pemisah
<<di bagian nama MRZ, dan - Visual scan menunjukkan satu nama (tanpa spasi)
AVA menyimpan nama sebagai first name saja, dengan last name kosong.
Langkah 2: Sinkron ke PMS
Sebagian besar property management system memerlukan first name dan last name. Sebelum mengirim data tamu ke PMS, AVA menggandakan nama tunggal ke kedua field.
| Yang Tertulis di Dokumen | Yang Disimpan AVA | Dikirim ke PMS |
|---|---|---|
| SUKARNO | First name: SUKARNO, Last name: (kosong) | First name: SUKARNO, Last name: SUKARNO |
| (kosong), SUHARTO | First name: (kosong), Last name: SUHARTO | First name: SUHARTO, Last name: SUHARTO |
Ini mengikuti konvensi IATA Passenger Name Record (PNR) yang digunakan maskapai untuk pelancong dengan satu nama.
Penyelarasan Nama
Kadang dokumen dan reservasi memiliki token nama yang sama tetapi membaginya berbeda antara first name dan last name. Ini umum untuk tamu dari Malaysia, Indonesia, Myanmar, dan Singapore.
Contoh:
| Sumber | First Name | Last Name |
|---|---|---|
| Dokumen | AHMAD BIN IBRAHIM | (kosong) |
| Reservasi | AHMAD | BIN IBRAHIM |
AVA mendeteksi bahwa kedua sisi berisi bagian nama yang sama. Setelah mengonfirmasi kecocokan, AVA mengadopsi split milik reservasi agar nama yang tersimpan selaras dengan record PMS Anda.
Pencocokan Alias dan Nama Menikah
AVA memeriksa nama alternatif ketika nama utama pada dokumen tidak cocok dengan reservasi.
Kartu Identitas Singapore
Singapore IC bisa menampilkan dua baris nama:
- Nama lahir (utama) - misalnya, DASIMA BINTE MOHAMMAD
- Nama menikah (alias) - misalnya, MRS DASIMA KAYA
AVA mencoba kedua nama terhadap reservasi. Jika alias cocok, check-in tetap lanjut, tetapi nama lahir disimpan sebagai nama tamu resmi.
Paspor Prancis
Paspor Prancis dapat menampilkan surname menikah secara inline, misalnya "FREBOURG ép. GODIN". AVA memisahkan ini menjadi:
- Primary last name: FREBOURG
- Alias last name: GODIN
Keduanya dicek terhadap nama reservasi.
Apa yang Memicu Permintaan Scan Ulang
AVA meminta tamu memotret ulang paspor mereka ketika:
- ❌ Check digit MRZ gagal (karakter terbaca salah)
- ❌ Teks MRZ terlalu pendek atau tidak lengkap
- ❌ Backend tidak bisa menentukan nama yang andal dari salah satu sumber
- ❌ Paspor berasal dari negara satu field dan tidak ada nama visual yang tersedia
Permintaan scan ulang berarti AVA tidak bisa membaca dokumen dengan yakin. Tamu hanya perlu mengambil foto yang lebih jelas, biasanya dengan pencahayaan lebih baik dan MRZ terlihat penuh.
Pemecahan Masalah
Nama tamu terlihat duplikat (first dan last name sama)
Yang Anda lihat: First name dan last name tamu menampilkan nilai yang sama di PMS Anda.
Mengapa: Tamu memiliki satu nama legal (mononym). AVA menggandakannya untuk memenuhi kebutuhan PMS.
Yang perlu dilakukan: Tidak perlu tindakan. Ini perilaku yang diharapkan untuk tamu satu nama.
Split nama tamu berbeda dari paspornya
Yang Anda lihat: First dan last name tertukar atau dikelompokkan berbeda dari yang terlihat di paspor.
Mengapa: Untuk paspor dari Malaysia, Myanmar, Indonesia, atau Singapore, AVA memakai visual scan yang bisa membagi nama berbeda dari MRZ.
Perbaikan:
- Bandingkan nama yang tersimpan dengan teks tercetak dan MRZ pada paspor fisik.
- Jika nama lengkap benar tetapi split first/last berbeda, itu memang diharapkan.
- Jika nama jelas salah, minta tamu memindai ulang dengan seluruh dokumen terlihat.
Tamu terus diminta scan ulang paspor
Yang Anda lihat: Tamu mencoba lagi tetapi AVA terus meminta foto baru.
Perbaikan:
- Minta tamu meletakkan paspor rata di permukaan gelap.
- Pastikan seluruh MRZ (dua baris bawah) terlihat dan fokus.
- Hindari glare, bayangan, dan jari yang menutupi bagian dokumen.
- Jika scan terus gagal, selesaikan check-in di front desk.
Nama menikah cocok tetapi nama yang tersimpan berbeda
Yang Anda lihat: Check-in lolos, tetapi nama yang tersimpan adalah nama lahir, bukan nama menikah.
Mengapa: AVA selalu menyimpan nama utama (lahir/legal) dari dokumen, meskipun nama alias yang cocok dengan reservasi.
Yang perlu dilakukan: Tidak perlu tindakan. Ini memang desainnya untuk kepatuhan hukum.
Masih Terkendala?
Hubungi success@vouch-technologies.com jika:
- ❌ Scan paspor terus gagal untuk kewarganegaraan tertentu
- ❌ Ekstraksi nama menghasilkan hasil yang jelas salah setelah beberapa kali percobaan
- ❌ Anda butuh panduan cara kerja penanganan nama untuk negara yang tidak tercantum di atas
Detail yang membantu untuk disertakan:
- Kewarganegaraan dan jenis dokumen tamu
- Screenshot nama yang diekstrak vs dokumen fisik
- Setting negara hotel Anda