跳到主要内容

泰国移民局报告

快速设置

大多数酒店大约 10 分钟即可完成设置。请先设置 Schedule Time、Email Recipients 和 Guest Source Mode。

本指南帮助你配置 TM30 和 RR4 报告，并处理午夜前后的入住情况。

AVA 使用酒店的 Country 设置来识别泰国报告工作流。 现有的小写国家记录仍与 TM30 计划刷新兼容。

前往： Government Compliance → Thailand

旧的 Reports → Thailand Immigration Reports 链接会重定向到此处。

套餐权限​

  • 泰国移民局报告需要付费套餐。
  • 免费套餐账号会看到升级提示，而不是报告页面。

要升级，请前往 Settings → Billing & Subscription。

快速参考​

设置控制内容推荐默认值
Enable Automatic Daily Reports每天发送每个已启用的报告开启
Schedule Time每日报告的生成时间（酒店本地时间）05:00
Use separate email recipientsTM30 和 RR4 是否发送到不同的收件箱关闭（团队不同则开启）
TM30 Guest Source ModeTM30 包含哪些客人包含未通过 AVA 入住的客人
RR4 Guest Source ModeRR4 包含哪些客人包含未通过 AVA 入住的客人
RR4 Thai Hotel NameRR4 上打印的泰文名称填写泰文文本
Include Stayover Guests (RR4)是否包含过夜客人，而不只是新入住客人关闭（仅在需要时开启）
RR4 Stayover Remark写在 RR4 过夜行中的可选备注除非申报流程需要，否则留空
Required Guest Information必填字段的 RR4 合规状态全部设置完成
Manual report actions为每个已启用的报告显示操作生成报告前先启用报告
后台处理

TM30/RR4 报告会先经过后台处理，然后由 AVA 发送邮件。 这适用于自动计划和手动报告请求。 如果手动请求无法进入队列，AVA 会显示错误。

设置自动报告​

  1. 前往 Government Compliance → Thailand。
  2. 打开 Enable Automatic Daily Reports。
  3. 设置 Schedule Time（酒店本地时间）。
  4. 添加 Email Recipients，或启用 Use separate email recipients。
  5. 点击 Save Configuration。

✓ 保存后你应该会看到成功提示。 ✓ AVA 会启用或更新每日报告计划。

泰国移民局报告配置界面，显示计划时间和收件人邮箱 TODO: 替换为显示 Automatic Daily Reports 卡片的更新版布局。

使用合并或分开的邮箱列表​

选项适用场景
Combined recipientsTM30 和 RR4 发给同一团队
Separate recipientsTM30 和 RR4 发给不同团队

若要使用分开的列表：

  1. 打开 Use separate email recipients。
  2. 添加 TM30 Email Recipients。
  3. 添加 RR4 Email Recipients。

选择客人来源模式（TM30 和 RR4）​

选择 AVA 在每个报告中如何包含客人。

TM30 客人来源模式​

选项AVA 的处理方式适合场景
Include guests who didn't check in through AVA如果存在 AVA 入住时间，AVA 会使用它。如果缺少该时间，只有当 PMS 已显示预订为已入住时，AVA 才会包含该客人。有时会在 AVA 外为客人办理入住的酒店
Don't include guests who didn't check in through AVAAVA 仅包含具有有效 AVA 入住时间的客人。希望只使用 AVA 入住证据的酒店

RR4 客人来源模式​

RR4 使用与 TM30 相同的选项。此设置是独立的，因此请确认它与 RR4 流程一致。

时间戳规则
  • 如果存在 AVA 入住时间，AVA 使用该时间戳来决定报告日期。
  • 如果缺少 AVA 入住时间，Include 模式仅在 PMS 已将预订标记为已入住时使用回退逻辑。
  • 如果 AVA 入住时间无法读取，AVA 会排除该条记录。
  • 在 Don't include 模式下，仅包含具有有效 AVA 入住时间戳的客人。

午夜示例（Include 模式）​

预订：2 月 9 日至 13 日。报告生成时间：2 月 10 日 00:10。

报告生成时的情况结果
AVA 入住时间为 2 月 10 日 00:01客人会被排除在 2 月 9 日 报告之外，并出现在 2 月 10 日 报告中
AVA 入住时间尚不可用，但 PMS 状态已经是 checked in使用 PMS 回退，将客人纳入 2 月 9 日 报告
AVA 入住时间尚不可用，且 PMS 状态为 not checked in客人暂时不会被纳入

RR4 报告设置​

RR4 客人来源模式​

在 RR4 Settings 卡片中，RR4 Guest Source Mode 显示在顶部。 请先设置它，再设置 Thai Hotel Name 和 Include Stayover Guests。

选项与 TM30 相同：

  • Include guests who didn't check in through AVA
  • Don't include guests who didn't check in through AVA

必填客人信息​

为生成准确的 RR4 报告，请将以下项目设为必填登记字段：

  • Nationality
  • Place of Departure
  • Next Destination

如果其中任何一项为可选，你会在 Required Guest Information 卡片中看到 Action required。 点击 Configure Registration Fields，或前往 Settings → Check-In。

泰文酒店名​

请输入泰文酒店名称，例如 โรงแรมว้าว รีสอร์ต。

RR4 会在报告页眉中使用此值。留空则使用你的主要酒店名称。

包含过夜客人​

打开此项可包含过夜客人，而不仅是新入住客人。

示例：

  • 关闭：客人在 10 月 20 日入住、10 月 25 日退房，只会出现在 10 月 20 日的报告中。
  • 开启：同一位客人会出现在 10 月 20、21、22、23 和 24 日的报告中。

设置 RR4 过夜备注​

使用 RR4 Stayover Remark 为过夜行添加简短备注。

示例：ไม่มีการเปลี่ยนแปลง

如果不需要过夜备注，请将该字段留空。

该字段何时可用

只有在开启 Include Stayover Guests 时，此字段才会启用。 如果关闭过夜报告，AVA 会禁用备注字段。

为什么 TM30 和 RR4 的时间可能不同

TM30 和 RR4 可能会为同一位客人显示不同的时间戳。 这是正常现象，因为每个报告使用各自的计时规则。

RR4 设置界面，显示客人来源模式、泰文酒店名和过夜客人 TODO: 替换为在 Thai Hotel Name 上方显示 Guest Source Mode 的更新版 RR4 Settings 卡片。

登记卡归档​

AVA 现在将此导出标记为 Registration Card Archive。 旧版界面在兼容区域中可能仍显示 RR3。

该归档不是定期报告。 关于完整的同步、异步和恢复流程，请参阅 下载登记卡归档。 AVA 会在临时存储中准备这些导出文件。 文件就绪后，员工会看到提示，说明文件可保留 7 天。 请在过期前下载，或稍后重新创建归档。

何时包含登记卡​

  • Self check-in: 提交自助终端签名后立即包含。
  • Assisted check-in: 员工提交客人签名时包含。

员工应确认的内容​

  • 标记为 RR3 Required 的必填字段均已完成。
  • 签名前确认客人身份和预订详情正确。

手动生成报告​

手动 TM30 和 RR4 报告使用为酒店属性保存的时区。 如果未保存酒店属性时区，AVA 可能会使用请求中的时区。 设置酒店属性时区，以避免设备或浏览器时区差异。

检查酒店属性时区

在 Hotel Basic Details 中设置正确的时区。 这样可以使报告日期与酒店属性的本地日历保持一致。

  1. 确认泰国报告配置已保存。
  2. 滚动到 Manual Report Generation。
  3. 对所需的已启用报告，点击 Generate TM30 或 Generate RR4。
  4. 等待确认。

AVA 仅在匹配的报告已启用时显示相应的手动操作。 例如，Generate RR4 可能显示，而 Generate TM30 仍处于隐藏状态。

理解成功消息​

AVA 会显示以下本地化成功消息之一：

消息含义你应采取的操作
Report queued successfullyAVA 已接受请求并进行后台处理等待报告邮件。不要立即再次生成报告。
"TM30 report could not be queued. Please try again later." 或 "RR4 report could not be queued. Please try again later."AVA 无法接受请求等待后再重试一次。如果问题重复出现，请联系支持。

手动生成报告始终使用后台处理。 队列成功消息表示请求已被接受，并不表示邮件会立即送达。 如果 AVA 无法将请求加入队列，它会停止处理并显示错误。 它不会立即生成报告。

故障排查​

客人未出现在前一天的报告中​

你会看到： 客人在午夜前后入住，但没有出现在昨天的报告中。

解决方法：

  1. 打开客人的入住记录。
  2. 检查 AVA 入住时间戳。
  3. 如果时间戳在午夜之后，请使用今天的报告查看该客人。

客人在午夜后入住，却出现在昨天的报告中​

你会看到： 客人在午夜后抵达，但仍出现在昨天的报告中。

解决方法：

  1. 检查你的 Guest Source Mode。
  2. 在 Include 模式下，缺失的 AVA 时间戳只有在 PMS 已将预订标记为已入住时才会使用回退逻辑。
  3. 如果你只想使用严格的 AVA 时间戳，请切换到 Don't include guests who didn't check in through AVA。

在 Include 模式下，AVA 外入住的客人缺失​

你会看到： 客人是手动入住的，但尚未被纳入。

解决方法：

  1. 检查 PMS 中的预订状态。
  2. 确认 PMS 已将预订标记为已入住。
  3. 状态更新后重新运行报告。

手动报告使用了错误日期​

你会看到： 手动报告覆盖的日期早于或晚于酒店属性的本地日期。

解决方法：

  1. 打开 Settings → Essentials → Hotel Basic Details。
  2. 确认 Timezone 与酒店属性的本地时区一致。
  3. 如果更改了设置，请点击 Save。
  4. 从 Government Compliance → Thailand 再次生成报告。

手动报告使用已保存的酒店属性时区，即使员工从另一个时区发起报告也是如此。

TM30 和 RR4 显示不同时间​

你会看到： 同一位客人在 TM30 和 RR4 中的时间戳不同。

解决方法：

  1. 确认这不会阻碍你的申报流程。
  2. 核对客人数据和入住完成详情。
  3. 如果不一致会影响合规申报，请联系支持。

过夜备注缺失​

你会看到： RR4 过夜行没有显示你配置的备注。

解决方法：

  1. 确认 Include Stayover Guests 已开启。
  2. 检查 RR4 Stayover Remark 不为空。
  3. 再次保存配置。
  4. 为受影响的日期重新生成 RR4。

PMS 更改后 TM30 计划缺失​

你会看到： 泰国酒店更改 PMS 后，TM30 计划缺失。

解决方法：

  1. 打开 Settings → Essentials → Hotel Basic Details。
  2. 确认 Country 设置为 Thailand。
  3. 打开 Government Compliance → Thailand。
  4. 确认 Enable Automatic Daily Reports 和 TM30 设置已启用。
  5. 如果计划仍缺失，请联系支持。

现有的小写国家记录应在 PMS 更改后正确刷新。

保存政府配置超时​

你会看到： 保存泰国设置时显示 Service timeout: TM30ProxyService - PUT exceeded 7000ms。

发生原因： AVA 可能在完成报告计划更新前就已完成保存。 超时可能会掩盖成功的保存结果。

解决方法：

  1. 不要反复点击 Save Configuration。

  2. 刷新 Government Compliance → Thailand。

  3. 确认邮箱、计划和报告设置仍然存在。

  4. 如果这些值仍在，则无需进一步操作。

  5. 如果值已缺失，再保存一次。

  6. 如果再次超时，请联系支持。

    ✓ 成功保存后应不再出现 7 秒超时。

未收到报告邮件​

你会看到： 在计划时间没有收到报告邮件。

解决方法：

  1. 确认报告已启用。
  2. 确认收件人邮箱正确。
  3. 检查垃圾邮件或垃圾箱文件夹。
  4. 如果看到 Report queued successfully，请等待后台处理完成。
  5. 在第一个请求完成前，不要提交另一个手动请求。

报告一直处于队列中​

你会看到： 报告确认显示 Report queued successfully，但没有收到邮件。

解决方法：

  1. 确认已配置的收件人地址。
  2. 检查垃圾邮件或垃圾箱文件夹。
  3. 等待队列完成后再重试。
  4. 如果报告在正常处理时间后仍缺失，请联系支持。

手动报告无法加入队列​

你会看到： "TM30 report could not be queued. Please try again later." 或 RR4 版本的消息。

解决方法：

  1. 等待几分钟后再重试。
  2. 只提交一次报告。
  3. 如果请求再次失败，请联系支持。

请提供报告类型和尝试时间。

报告服务不可用​

你会看到： "Report generation is temporarily unavailable because the report service rejected its credential. Please contact support."

解决方法：

  1. 不要退出登录或重置密码。
  2. 此错误涉及报告处理，不涉及你的 AVA 会话。
  3. 将报告类型和尝试时间发送至 success@vouch-technologies.com，联系支持。

警告称 TM30 和 RR4 设置未对齐​

你会看到： 黄色横幅警告 TM30 和 RR4 设置不同。

解决方法：

  1. 检查 Schedule Time 和收件人设置。
  2. 如果要使用分开的列表，请打开 Use separate email recipients。
  3. 点击 Save Configuration 以同步设置。

出现分开收件人提示​

你会看到： 蓝色横幅显示已启用分开收件人模式。

解决方法：

  1. 检查 TM30 Email Recipients 和 RR4 Email Recipients。
  2. 如果要使用单一列表，请关闭 Use separate email recipients。
  3. 点击 Save Configuration。

Required Guest Information 显示 "Action required"​

你会看到： Required Guest Information 卡片显示 Action required。

解决方法：

  1. 点击 Configure Registration Fields。
  2. 将 Nationality、Place of Departure 和 Next Destination 设为必填。
  3. 返回报告页面并刷新。

手动报告按钮缺失​

你会看到： 一个或两个手动报告按钮不可见。

解决方法：

  1. 检查缺少哪个报告按钮。
  2. 在泰国报告设置中启用该报告。
  3. 保存配置。
  4. 刷新页面。

当匹配的报告被禁用时，AVA 会隐藏相应按钮。

Registration Card Archive 按钮缺失​

你会看到： 看不到 Download Registration Card Archive。

解决方法：

  1. 请管理员授予 report:export 权限。
  2. 权限更新后刷新页面。

未找到登记卡​

你会看到： AVA 显示在所选日期范围内未找到登记卡。

解决方法：

  1. 扩大日期范围。
  2. 确认该时段已提交登记卡签名。
  3. 再次尝试导出。

仍然无法解决？​

如果出现以下情况，请联系 success@vouch-technologies.com：

  • ❌ 客人反复未出现在预期的报告日期中
  • ❌ 报告时间戳阻碍合规提交
  • ❌ 自动报告连续一个以上周期失败

建议提供：

  • 酒店名称
  • 客人姓名和预订编号
  • 预期报告日期和实际结果
  • 报告设置及客人入住详情的截图