查看预订详情
在任意预订上选择 View Details,即可查看完整摘要、住客文件和事件时间线。大多数查看只需 2-3 分钟。
本指南帮助你在住客卡住或缺少文件时,了解入住或退房情况。
前往: Main Menu → Command Center
快速参考
| 区域 | 显示内容 | 用途 |
|---|---|---|
| Reservation Summary | 住客姓名、确认号、房间、入住日期、最近事件 | 快速了解背景 |
| Payment Summary | 已支付、预授权、直接销售、状态标签、交易 ID、货币 | 查看整个住宿期间的付款凭证 |
| Guest Information | 住客列表、联系信息、国籍、文件类型 | 确认谁已入住 |
| Document thumbnails | 身份证/护照、登记卡、自拍照、失败上传预览 | 查看或下载文件 |
| Unassigned Documents | 未分配给住客的失败批量上传 | 查看保留的图片和错误 |
| Registration card action | 对未来抵达的住客隐藏,在 AVA 完成入住前禁用 | 确认是否可以生成登记卡 |
| PMS attachment status | 每份旅行文件、照片或登记卡的传送状态 | 确认 PMS 是否收到文件 |
| Retry action | 对符合条件的失败附件进行受控重试 | 恢复临时的 PMS 传送失败 |
| Detailed Event Log | 带状态徽标和时间戳的逐步事件 | 找出流程卡住的位置 |
| Override audit events | 支持覆盖操作的管理员姓名和原因 | 确认某一步为何解除阻塞 |
| Show Details | 输入/输出载荷 | 向支持团队分享精确错误 |
在手机上,Reservation Summary 会切换为单列堆叠布局。 较长的值会在每个字段内换行,因此标签仍然清晰可读。
计划权限与限制
- 免费套餐仅能查看最近 20 条日志中的 View Details。
- 更早的历史记录和文件访问需要付费套餐。
请在 Settings → Billing & Subscription 中升级。
打开预订详情面板
-
打开 Command Center,并停留在 Status 或 Live。
-
在要查看的预订上选择 View Details。
-
如果该预订有多个房间,请选择相应的房间标签页。
✓ 该房间的 Reservation Details 面板会打开。
分组预订可以在各房间标签页中显示一份付款摘要。
AVA 会加入独立的房间级付款凭证,并保持总额可累加。
如果没有已持久化的 AVA 付款活动,摘要会留空。
如果货币不一致,AVA 会隐藏金额,而不是进行猜测。
摘要可以同时显示 Pre-auth、Captured 和 Direct sale 标签。
如果后端省略 paymentSummary,AVA 会显示不可用标记。
如果 AVA 只有明确的无付款凭证,则会显示该状态。
在 Stripe 中打开付款
连接 Stripe 后,选择 View payment in Stripe 外部链接图标。 该图标会显示在付款金额或 Transaction ID 旁边。 它会在新的 Stripe 标签页中打开匹配的已连接账户付款记录。
链接遵循已连接 Stripe 账户的 Live 或 Test 环境。 对于非 Stripe、不完整或有歧义的付款摘要,AVA 会隐藏该链接。
如果有确认号,title 会显示确认号徽标。 滚动时 Reset Check-in Flow 和 X 按钮会保持可见。 在窄屏上,重置按钮会缩短为 Reset。
某些预订会在摘要标题栏显示 Reset Check-in Flow。 有关警告和重置步骤,请参见 Reset a Check-In Flow。
阅读预订摘要
查看面板顶部的这些字段:
- Guest
- Confirmation #
- Room Number 和 Room Type
- Overall Status
- Stay Dates
- Last Event
用此摘要确认你查看的是正确的房间和入住日期。 在小屏幕上,每个字段会扩展到全宽。 这样较长的确认号和房型便有足够空间自然换行。
查看住客信息和文件
-
在 Guest Information 中找到你要帮助的住客。
-
检查 Email、Phone、Nationality 和 Document Type。
-
选择文件缩略图将其打开。
✓ 查看器会提供 Download 和 Open in new tab。 ✓ 如果 AVA 保留了查找记录,失败上传的缩略图仍可能显示。
在 Guest Information 中,Email、Phone 和 date of birth 使用堆叠标签。 这样长的联系信息在窄模态列中也能保持可读。
你可能会看到 "Passport/ID upload failed" 或 "Passport/ID extraction failed"。这些提示表示采集或 OCR 问题。
如果提取、暂存或批量提交失败,AVA 可能会在此显示保留的失败缩略图。 即使清理流程已经运行,护照图片仍可用于复核。 在要求住客重新扫描之前,可以先用它检查上传内容。 如果之后需要帮助查找,支持团队可以按失败文件名或上传 ID 搜索。
对于批量提交失败,保留的图片会显示在上传所针对的住客行中。 某些验证提示会让上传保持待处理状态,而不是保留失败图片。
如果你的物业使用本地存储,上传后 AVA 仍可在此打开住客文件、自拍照和登记卡。 对于失败的护照或身份证上传,当旧版标记缺失时,AVA 会使用保留的失败上传记录。
查看未分配的失败文件
批量上传可能在 AVA 将文件分配给住客之前失败。 使用 Unassigned Documents 查看这些上传。
-
在 Reservation Details 中向下滚动到 Guest Information 下方。
-
找到 Unassigned Documents 和失败上传数量。
-
查看每个 Upload #、错误消息和时间戳。
-
选择缩略图打开保留的图片。
✓ 查看器包含 Download 和 Open in new tab。
重试将文件分配给住客后,该文件会离开 Unassigned Documents。 缩略图随后会显示在该住客的行中。
查看保留的批量提交失败
批量提交在暂存后失败时,AVA 会将图片保留在上传所针对的住客行中。
-
在 Guest Information 中打开目标住客行。
-
查看失败上传缩略图和警告消息。
-
选择缩略图检查或下载图片。
-
打开 Detailed Event Log,查看失败的 Document Uploaded 事件。
✓ 在调查提交失败期间,图片仍会保持可用。
生成登记卡(如可用)
如果你看到 Generate Registration Card Disclaimer 或 Regenerate Registration Card Disclaimer:
- 如果卡片已经存在,请从按钮旁的选择器中选择一种 Disclaimer language。
- 选择按钮。
- 等待文件生成完成。
- 从缩略图打开新的登记卡。
✓ AVA 会优先使用所选语言。 ✓ 如果你没有选择,AVA 会使用住客已保存的签名语言。 ✓ 如果没有已保存的语言,则回退到英语。
抵达前该按钮会保持隐藏。
抵达后,在 AVA 获得住客的 checkinTime 之前,该按钮会保持禁用。
仅在 PMS 中入住不会解锁登记卡。
仅当 AVA 尚未保存住客的 checkinTime 时使用此方法。
如果住客是在 AVA 外完成入住,请先输入实际入住时间。
AVA 会保存该时间,然后生成 PDF。
这不会改变入住状态或预订状态。
AVA 只显示已保存登记卡免责声明翻译的语言。 如果卡片没有已保存的签名语言,请先选择一种再重新生成。 English (fallback) 始终可用。 如果住客已经使用其他语言签名,AVA 会优先使用该已保存语言。
按钮禁用时,将鼠标悬停在按钮上。 你应该会看到:"Complete check-in on AVA first. PMS check-in alone does not give AVA the actual check-in time needed for the registration card."
查看 PMS 附件传送
AVA 会先在本地保存文件,然后再将其传送到 PMS。 登记卡生成和存储完成后,才会开始 PMS 传送。 文件可能已经出现在 AVA 中,而 PMS 传送仍处于待处理状态。
-
打开 Command Center → Status。
-
选择预订并选择 View Details。
-
找到 Travel Document、Guest Photo 或 Registration Card 的附件状态。
-
采取行动前先阅读状态和消息。
-
如果显示 Retry,请确认 PMS 连接正常,然后选择 Retry。
✓ AVA 只会重试该操作所显示的附件类型。 ✓ 重试成功后,该附件会变为已完成状态。
| 状态含义 | 你应采取的操作 |
|---|---|
| Waiting 或 processing | 等待 PMS 传送,然后刷新 View Details。 |
| Completed | 如有需要,在 PMS 预订中确认附件。 |
| Failed 或 needs review | 阅读消息,修复 PMS 问题,然后在可用时使用 Retry。 |
登记卡重试使用相同的传送标识。 在支持幂等传送的 PMS 中,重试不会创建第二张登记卡。
使用详细事件日志
-
滚动到 Detailed Event Log。
-
查看每个事件的状态徽标和时间戳。
-
选择 Show Details 查看 Input 和 Output。
✓ 向支持团队报告问题时,请使用这些载荷。
常见事件提示
- Queue Reason / Queued 表示该步骤正在等待;详情会说明原因。
- Room Access Error 会显示代码、消息和回退说明。
- 房间访问失败还可能在 Show Details 中显示
errorCode、retriable、vendor和upstream详情。 - Check-in v3 现在会保留嵌套的
message和error.message详情,然后再回退。 - 客人尝试过早入住时,会出现 Early Check-in。
- AVA 在入住完成前分配房间时,会出现 Room Assignment。
- PMS 返回不同房间时,会出现 PMS changed room assignment during this step。
- Facial Verification Results 会显示相似度分数、阈值、提供商和活体检测结果。
- 房间访问编码器失败后,清理消息仍可能保留
faultcode:<value>。 比较供应商事件时请使用它。 - 结构化载荷还可能包含
errorCode、retriable、vendor,以及upstream超时或供应商代码详情。 - HTTP 504 房间访问超时会作为结构化门卡错误保留,而不是变成通用外部服务错误。
- PII 脱敏仍会隐藏电子邮件、电话号码、卡号和令牌。
- 文件上传失败现在会在 Message 中显示面向住客的文案。 如需原始后端字符串,请打开 Show Details。
- 批量上传暂存和提交事件会在时间线中显示为 Document Uploaded。
- 文件上传成功或失败后,事件可能会显示 Name extracted from document。 在比较预订姓名前,用它确认 AVA 读取到的姓名。
- 失败的身份证验证条目现在会在 Message 中显示易懂的原因。 原始后端错误会保持隐藏,因此面板更易阅读。
- 姓名不匹配条目现在会显示简洁的 Message 和 Name check 比较结果。 打开 Show Details,比较 On document 与 On reservation。 较早的日志即使仍存储旧版扁平消息,也能正常显示。
- 验证失败时,请使用 Facial Verification Results 查看分数和阈值详情。
查看退房付款凭证
- 在退房事件上打开 Show Details。
- 查找 View Bill 和 Checkout Payment 条目。
- 如果住客重试了流程,请比较时间戳。
- 状态不一致时,以最新凭证为准。
查看姓名不匹配详情
如果文件姓名不匹配阻止入住,事件日志会以易读方式保留比较结果。
你会看到: 事件消息会解释不匹配,而不会显示 JSON 块。 Name check 面板会显示比较的两个姓名。
解决方法:
- 在失败的验证事件上打开 Show Details。
- 阅读 Message 中的易懂原因。
- 在 Name check 中比较 On document 与 On reservation。
- 向住客或支持团队解释阻塞原因时,使用这两个姓名。
查看从文件提取的姓名
需要确认 AVA 从旅行文件中读取了什么时,可以使用此部分。
-
打开 Detailed Event Log。
-
找到文件上传事件。
-
选择 Show Details。
-
查找 Name extracted from document。
-
将其与 Reservation Summary 中的住客姓名比较。
✓ 成功上传文件时,即使没有不匹配错误,也可能显示提取的姓名。
查看房间分配与入住的区别
如果事件日志中出现 ROOM_ASSIGNMENT,说明 AVA 已经分配了房间。 该徽标并不表示住客已经完成入住。
请查看后续事件,确认住客是否仍需要 CHECKIN 或 Room Access。
某些预订只有在该阶段存在凭证时,才会在入住前显示房间分配。 如果没有凭证,AVA 会跳过该徽标,并保持剩余流程不变。
查看 PMS 房间不匹配警告
如果 PMS 中的房间分配发生变化,你会在 Detailed Event Log 中看到琥珀色警告。
警告会显示:
- Requested room
- PMS returned room
- Auto-assign enabled
- PMS vendor(如可用)
- Reservation type: Sub-reservation(如适用)
使用此警告解释最终房间为何与请求的房间不同。
查看覆盖审计事件
-
滚动到 Detailed Event Log。
-
找到标记为 Override audit event 的事件。
-
如果有 Show Details,请打开它。
✓ 事件摘要可以显示 Admin 和 Reason。 ✓ 覆盖条目会确认谁解除了该步骤的阻塞。
对于 ACI 面部覆盖事件,事件会标识预订、住客、员工设备和流程会话。 使用 Reason 和住客详情确认批准的是正确住客。
故障排查
Reservation Details 无法加载
你会看到: "Error Loading Details" 或空白面板。
解决方法:
- 如果你使用免费套餐,请打开最近 20 条日志中的预订。更早的历史记录需要升级。
- 刷新页面并重新打开 View Details。
- 尝试另一条预订,确认日志是否正在加载。
- 检查你的互联网连接。
找不到登记卡按钮
你会看到: 没有 Generate Registration Card Disclaimer 按钮。
解决方法:
- 确认到店日期是今天或更早。
- 如果住客已经抵达,检查 AVA 入住是否完成。
- 刷新页面并重新打开 View Details。
- 如果按钮仍不显示,请联系支持团队。
登记卡按钮被禁用
你会看到: 按钮可见,但无法使用。
解决方法:
- 将鼠标悬停在按钮上查看提示。
- 先在 AVA 上完成入住,或使用手动入住时间流程。
- 入住完成后刷新页面。
- 再次尝试生成登记卡。
登记卡无法生成
你会看到: 选择 Generate Registration Card Disclaimer 后出现错误。
解决方法:
- 确认到店日期是今天或更早。
- 如果住客缺少签名,请让其完成签名。
- 如果住客是在 AVA 外完成入住,请先输入实际入住时间。
- 再次选择 Generate Registration Card Disclaimer。
登记卡已出现在 AVA 中,但未出现在 PMS
你会看到: 登记卡可以在 AVA 中打开,但 PMS 中还没有附件。
解决方法:
-
在预订的 Command Center → Status → View Details 中打开详情。
-
找到 Registration Card 附件状态。
-
如果状态为 waiting 或 processing,请在传送完成后刷新。
-
如果显示 Retry,请修复 PMS 连接错误并选择 Retry。
-
如果卡片在本地服务器上被替换,请在重试前重新生成卡片。
✓ 最新保存的卡片在状态符合条件后会被发送。
PMS 附件重试不可用
你会看到: 附件失败,但 Retry 不可用。
解决方法:
- 在 View Details 中阅读附件消息。
- 在 Settings → Essentials → PMS Integration 中确认 PMS 连接处于活动状态。
- 刷新 View Details,再次检查附件状态。
- 如果来源发生变化,请保存当前文件或重新生成登记卡。
- 如果状态仍需要审核,请联系支持团队。
上传失败后护照图片仍然出现
你会看到: 住客显示 "Passport/ID upload failed",但缩略图仍可打开。
解决方法:
- 打开缩略图,确认图片清晰可读。
- 检查 Detailed Event Log 中的提取或暂存错误。
- 如果使用本地存储,请在要求重新扫描前刷新并重新打开 View Details。
- 如果图片看起来正确,请保留它以便调查。
- 只有在图片无法读取或内容错误时才要求重新扫描。
- 如果缩略图之后消失,请让支持团队按失败文件名或上传 ID 搜索。
失败的批量上传不在预期住客下
你会看到: 批量上传失败,但预期的住客行中没有缩略图。
解决方法:
- 刷新 Command Center,然后重新打开 View Details。
- 对于多房间预订,确认打开的是正确的房间标签页。
- 检查上传所针对的住客行。
- 如果没有分配住客,请向下滚动到 Guest Information 下方,检查 Unassigned Documents。
- 打开缩略图,并记录 Upload #、消息和时间戳。
- 如果缺少该区域或预期上传,请联系支持团队。
面部验证消息看起来太技术化
你会看到: Message 字段提到验证失败,但你想了解适合住客的原因。
解决方法:
- 先阅读易懂的 Message。
- 打开 Facial Verification Results,查看相似度、阈值、提供商和活体检测结果。
- 向住客或支持团队解释失败时,同时使用这两个字段。
- 如果消息仍难以阅读,请刷新面板并打开 Show Details。
事件列表为空
你会看到: "No detailed events recorded."
解决方法:
- 确认住客已经开始入住或退房。
- 等待 1-2 分钟并刷新页面。
- 检查 Status 标签页中的最近活动。
房间已分配,但入住尚未完成
你会看到: 事件日志显示 ROOM_ASSIGNMENT,但预订仍然像是未完成。
解决方法:
- 检查事件日志中是否也存在 CHECKIN。
- 如果住客仍在流程中,请完成剩余的必要步骤。
- 刷新 Status,确认下一个待处理徽标。
- 如果日志看起来仍然过时,请重新打开 View Details。
房号意外变化
你会看到: 最终房间与请求的房间不同。
解决方法:
- 打开 Detailed Event Log,找到分配房间的步骤。
- 检查琥珀色的 PMS changed room assignment during this step 警告。
- 比较 Requested room 与 PMS returned room。
- 记录 Auto-assign enabled、PMS vendor 和 Reservation type。
- 在交接钥匙前更新住客和前台备注。
覆盖摘要缺失
你会看到: 步骤已变更,但没有出现覆盖事件。
解决方法:
- 刷新面板。
- 重新打开正确的房间标签页。
- 确认该操作已从 Status 保存。
仍然卡住?
如果出现以下情况,请联系 success@vouch-technologies.com:
- ❌ 多次刷新后,Reservation Details 仍无法加载
- ❌ 登记卡生成反复失败
- ❌ 事件错误阻止住客完成入住/退房
建议附上:
- 确认号和房号
- 问题发生时间
- Reservation Details 面板截图