AVA 如何读取证件姓名
AVA 用两种方式从护照中读取姓名：底部的机器可读区（MRZ）和对印刷文字的视觉扫描。对大多数护照而言，AVA 优先使用 MRZ。对于某些国家，由于其 MRZ 不能可靠地区分名和姓，因此会优先使用视觉扫描。
本指南帮助你理解为什么提取出的姓名有时会和客人的预期不同、如何处理单名客人，以及 AVA 从哪里获取姓名。
快速参考
| 情况 | AVA 的处理方式 | 你看到的结果 |
|---|---|---|
| 标准护照且 MRZ 清晰 | 使用 MRZ 中的姓名 | 姓名与机器可读区一致 |
| 来自马来西亚、缅甸、印度尼西亚或新加坡的护照 | 使用视觉（印刷）姓名 | 姓名与 MRZ 上方的印刷文字一致 |
| 只有一个名字的客人（单名） | 保存这个名字，并复制给 PMS | 名和姓显示为同一个值 |
| 新加坡 IC 上的已婚名或别名 | 同时检查出生名和别名是否与预订匹配 | 即使别名匹配，也会保存主名（出生名） |
| 带配偶姓氏的法国护照 | 将出生姓与婚后姓拆分 | 出生姓保存为 last name；婚后姓可用于匹配 |
| MRZ 模糊、被裁切或有错误 | 回退到视觉扫描 | 姓名改为来自印刷文字 |
当 Document Name Overwrite 开启时，AVA 会在支持的证件流程中把匹配到的证件姓名写入客人记录。 关闭时，AVA 会保留预订或 PMS 的客人姓名。
工作原理
姓名来源
AVA 会从每份证件上的两个来源读取姓名，然后选择更可靠的那个。
1. 机器可读区（MRZ）
MRZ 是护照底部那一块大写字母区域。它包含用 << 标记分隔的结构化姓名数据。
AVA 在以下情况下信任 MRZ：
- 护照是标准的两行 MRZ 格式
- AVA 会对两行护照 MRZ 的轻微行长差异进行规范化
- 校验位验证通过
- 同时存在名和姓两个部分
- 该国家不使用单字段姓名格式
AVA 在以下情况下不信任 MRZ：
- 校验位失败（字符被误读）
- MRZ 缺失、模糊或不完整
- 只有一个姓名部分（姓和名之间没有
<<分隔符）
每一行 MRZ 都包含小型校验数字。如果这些数字与数据不匹配，说明摄像头误读了字符。AVA 会拒绝整段 MRZ，并要求客人重新拍照。
AVA 还会在验证前对两行护照 MRZ 的细微行长差异进行平滑处理。 这有助于减少本可清晰识别的扫描被迫重拍。
2. 视觉扫描（印刷文字）
AVA 也会读取证件上的印刷姓名字段，也就是你在照片和 MRZ 上方看到的文字。当 MRZ 不可靠时，这是回退来源；对于身份证和驾照等非护照证件，它是主要来源。
按国家处理姓名
有些国家签发的护照，其 MRZ 无法可靠地区分名和姓。AVA 会识别这些证件并切换到视觉扫描来拆分姓名。
使用视觉姓名的国家
| 国家 | 原因 | 变化 |
|---|---|---|
| Malaysia | MRZ 可能把全名放进单个字段 | AVA 读取印刷姓名字段，而不是 MRZ 姓名 |
| Myanmar | 姓名通常没有家族姓，或只使用单个字段 | AVA 读取印刷姓名，并可能识别出单名 |
| Indonesia | 很多公民只有一个名字（单名） | AVA 读取印刷姓名；可能只保存一个名字 |
| Singapore | 某些姓名模式下 MRZ 格式可能有歧义 | AVA 读取印刷姓名字段来拆分名和姓 |
即使 AVA 从视觉扫描中读取姓名，它仍会使用 MRZ 里的证件号码、出生日期、到期日期和国籍。只有姓名拆分会切换到视觉方式。
其他所有国家
对于上面未列出的国家签发的护照，只要 MRZ 可读且校验位验证通过，AVA 就会使用 MRZ 中的姓名。
如何处理单名（mononym）客人
有些客人只有一个法定姓名，这在印尼和缅甸公民中很常见。AVA 分两步处理这种情况。
第 1 步：提取
当 AVA 检测到以下情况时：
- MRZ 姓名部分没有
<<分隔符，并且 - 视觉扫描显示的是单个名字（没有空格）
它会把该姓名保存为仅名，并将姓留空。
第 2 步：PMS 同步
大多数物业管理系统都要求同时有名和姓。在把客人数据发送到 PMS 之前，AVA 会把这个单名复制到两个字段中。
| 证件显示 | AVA 保存 | 发送到 PMS |
|---|---|---|
| SUKARNO | 名：SUKARNO，姓：(空) | 名：SUKARNO，姓：SUKARNO |
| (空)，SUHARTO | 名：(空)，姓：SUHARTO | 名：SUHARTO，姓：SUHARTO |
这遵循航空公司在单名旅客中使用的 IATA Passenger Name Record (PNR) 约定。
姓名重整
有时证件和预订使用的是相同的姓名词元，但名和姓的拆分方式不同。这在马来西亚、印尼、缅甸和新加坡客人中很常见。
示例：
| 来源 | 名 | 姓 |
|---|---|---|
| 证件 | AHMAD BIN IBRAHIM | (空) |
| 预订 | AHMAD | BIN IBRAHIM |
AVA 会识别出双方包含相同的姓名部分。在确认匹配后，它会采用预订中的拆分方式，让保存的姓名与 PMS 记录一致。
别名和已婚姓匹配
当主证件姓名与预订不匹配时，AVA 会检查其他姓名。
新加坡身份证
新加坡 IC 可能显示两行姓名：
- Birth name（主名） - 例如
DASIMA BINTE MOHAMMAD - Married name（别名） - 例如
MRS DASIMA KAYA
AVA 会用这两个姓名分别与预订比对。如果别名匹配，入住仍会继续 - 但birth name 会被保存为正式客人姓名。
法国护照
法国护照可能会在姓名中直接显示婚后姓，例如 “FREBOURG ép. GODIN”。AVA 会将其拆分为：
- Primary last name: FREBOURG
- Alias last name: GODIN
这两个姓名都会与预订姓名进行比对。
什么情况会触发重新扫描
在以下情况，AVA 会要求客人重新拍摄护照照片：
- ❌ MRZ 校验位失败（字符误读）
- ❌ MRZ 文本过短或不完整
- ❌ 后端无法从任一来源确定可靠姓名
- ❌ 护照来自单字段国家，而且没有可用的视觉姓名
要求重新扫描并不代表 AVA 拒绝了证件。它只是无法自信地读取该证件。客人只需要拍一张更清晰的照片，通常要有更好的光线并让完整 MRZ 可见。
故障排查
客人姓名重复显示为相同的名和姓
你会看到： 在 PMS 中，客人的名和姓显示为相同的值。
原因： 客人只有一个法定姓名（单名）。AVA 会复制该姓名以满足 PMS 要求。
处理方式： 无需操作。这是单名客人的预期行为。
客人姓名拆分与护照看起来不同
你会看到： 名和姓与护照上的显示方式不同，或者被重新分组。
原因： 对于来自马来西亚、缅甸、印度尼西亚或新加坡的护照，AVA 使用视觉扫描，拆分方式可能与 MRZ 不同。
修复：
- 将保存的姓名与实体护照上的印刷文字和 MRZ 同时对照。
- 如果全名正确，但名/姓拆分不同，这属于预期行为。
- 如果姓名明显错误，请让客人重新扫描，并确保整份证件都在画面中。
客人总是被要求重新扫描护照
你会看到： 客人反复重试，但 AVA 仍要求新的照片。
修复：
- 让客人把护照平放在深色表面上。
- 确保完整 MRZ（底部两行）清晰可见并对焦。
- 避免反光、阴影和手指遮挡证件任何部分。
- 如果扫描仍然失败，请到前台完成入住。
已婚名匹配，但保存的姓名不同
你会看到： 入住通过了，但保存的是出生名，而不是已婚名。
原因： 即使是别名与预订匹配，AVA 也始终保存证件上的主名（出生名/法定名）。
处理方式： 无需操作。这是为了满足法律合规要求。
仍然卡住？
如果出现以下情况，请联系 success@vouch-technologies.com：
- ❌ 某个特定国籍的护照扫描持续失败
- ❌ 多次重试后，姓名提取结果明显错误
- ❌ 你需要了解上面未列出的国家的姓名处理方式
建议附上：
- 客人国籍和证件类型
- 提取出的姓名与实体证件的截图
- 你的酒店国家设置