跳到主要内容

泰国移民局报告

快速设置

大多数酒店大约 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 会显示错误。

支持的 PMS 系统​

TM30 和 RR4 报告支持 AVA PMS、Cloudbeds、Opera Cloud、Mews 和 eZee。 AVA 会在启动报告前检查已连接 PMS 的功能。 Furama PMS 目前不支持这些报告。

AVA 会按照各个 PMS 自身的预订和客人数据规则读取数据。 报告使用酒店本地日期，并包含符合条件的抵达客人或过夜客人。

Opera 报告数据​

Opera 报告可以包含国籍、出生日期、性别、地址和身份证件详情。 请让 Opera 管理员授予 AVA Sensitive Data Access。

没有此权限时，Opera 会遮盖部分身份值。 AVA 会从报告中省略被遮盖的护照号码和占位出生日期。 如果有可用的 CCI 记录，则可提供回退值。

Mews 护照数据​

Mews 报告读取身份证件，而不是客户税号。 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 流程一致。

混合客人列表的合并方式​

在 Include guests who didn't check in through AVA 模式下，AVA 会合并符合条件的 CCI 和 PMS 客人。 这样可以避免在另一位客人通过 AVA 入住时，Cloudbeds 客人从列表中消失。

预订数据报告中显示的内容
CCI 和 PMS 中各有一位主要客人，另有一位 PMS 客人两行客人记录
只有一位 CCI 主要客人，另有两位不同的 PMS 客人三行客人记录
一位 CCI 客人与一位 PMS 客人匹配一行记录，使用 CCI 身份详情和实际 CCI 入住时间

当身份凭据存在歧义时，AVA 会保留分开的记录。 报告生成器不会创建或更新 CCI 或 PMS 客人记录。

Cloudbeds 多房间预订​

对于 Cloudbeds TM30 报告，AVA 会检查预订中的每个房间。 这包括已分配房间的客人，以及仍在等待分配房间的客人。

预订情况TM30 结果
一笔 Cloudbeds 预订中的客人分布在多个房间每位符合条件的客人都会以自己的身份详情显示
多位客人共用一个房间每位符合条件的客人仍单独占一行
房间的抵达日期不同每位客人使用其所在房间的抵达日期
儿童房已取消或尚未抵达其中的客人仍会被排除
客人已经退房只要存在有效的抵达凭据，客人仍符合条件

这仅适用于 TM30 报告发现。 它不会改变普通预订视图或 RR4 客人来源。

TM30 报告中的已退房客人​

重新生成报告时，TM30 可以在客人退房后仍保留符合条件的客人。 当 PMS 在退房后仍提供客人的抵达记录时，这一功能很有帮助。

情况TM30 结果
符合条件的客人在抵达后退房客人仍保留在对应的 TM30 报告中
客人没有有效抵达日期或必需的身份数据客人仍会被排除
仅有离店记录的 PMS 预订没有抵达凭据客人仍会被排除

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. 状态更新后重新运行报告。

PMS 客人显示为额外的报告行​

你会看到： 同一预订中，Cloudbeds 客人出现在 CCI 客人旁边。

解决方法：

  1. 确认 Guest Source Mode 包含未通过 AVA 入住的客人。
  2. 对比 CCI 和 Cloudbeds 中的客人姓名及身份详情。
  3. 如果额外的记录代表另一位客人，请保留该行。
  4. 在生成下一份报告前，修正 PMS 中重复或冲突的身份详情。

AVA 会在混合报告中保留未匹配但符合条件的 PMS 客人。 当身份凭据无法安全确认匹配关系时，AVA 可能会保留分开的记录。

退房后客人缺失​

你会看到： 客人在退房前出现，但重新生成 TM30 时消失了。

解决方法：

  1. 确认你生成的是 TM30，而不是 RR4。
  2. 确认客人有有效的抵达日期和必需的身份详情。
  3. 检查报告目标是否为酒店当地的前一天。
  4. PMS 记录完成更新后，重新生成 TM30。

符合条件的已完成住宿在退房后仍会保留在 TM30 中。 仅有离店记录的预订以及没有有效抵达凭据的客人仍会被排除。

Cloudbeds 多房间客人缺失​

你会看到： Cloudbeds TM30 报告中的客人数量少于预订中的客人数量。

解决方法：

  1. 确认报告使用的是包含 PMS 客人的 TM30 Guest Source Mode。
  2. 在 Cloudbeds 中检查客人的抵达日期和身份详情。
  3. 确认客人的房间属于同一笔预订或子预订。
  4. 从预期数量中排除已取消或尚未抵达的房间。
  5. Cloudbeds 完成预订更新后，再次生成 TM30。

AVA 会保留来自已分配和未分配房间的符合条件的客人。 没有有效抵达凭据或必需身份详情的客人会被排除。

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

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

解决方法：

  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. 在第一个请求完成前，不要提交另一个手动请求。

报告因缺少配置而停止​

你会看到： 计划生成的 TM30 或 RR4 报告没有到达。 支持团队或报告日志提示必须修复配置后才能继续。

原因： 对于没有配置变更就无法成功的失败，AVA 会停止重试。 常见原因包括：

原因修复方法
Cloudbeds 应用已断开连接在 Cloudbeds 中重新连接 Vouch 应用。
缺少 PMS 配置请 PMS 管理员恢复酒店配置。
缺少 PMS 凭据恢复所需凭据，然后再次运行报告。
PMS 是 Furama联系支持团队，了解其他合规报告流程。
PMS 未列在上方确认 PMS 连接，然后联系支持团队。

修复方法：

  1. 打开 Settings → Essentials → PMS Integration。
  2. 确认 PMS 连接和凭据是最新的。
  3. 对于 Cloudbeds，如果 Vouch 应用已断开连接，请重新连接。
  4. 返回 Government Compliance → Thailand。
  5. 修复配置后，手动生成报告。
  6. 如果不再需要该计划，请关闭 Enable Automatic Daily Reports。
重试行为

当 PMS 配置无法使报告成功时，AVA 不会持续重试该报告。 临时服务故障仍会按照正常重试流程处理。

报告提示 PMS 供应商不受支持​

你会看到： TM30 或 RR4 报告停止，并显示 PMS 供应商不受支持的消息。

解决方法：

  1. 打开 Settings → Essentials → PMS Integration。
  2. 确认正确的 PMS 已连接到此酒店。
  3. 如果使用 AVA PMS，确认酒店的 AVA PMS 设置已完成。
  4. 返回 Government Compliance → Thailand。
  5. PMS 连接恢复后，再次生成报告。

如果 PMS 列在支持的 PMS 系统中，请联系支持团队。 请提供报告类型、酒店名称和失败尝试的时间。

报告邮件中没有客人​

你会看到： 收到了 TM30 或 RR4 邮件，但报告中没有客人。

解决方法：

  1. 确认报告日期与酒店本地日期一致。
  2. 检查预期客人在 PMS 中是否有有效的抵达或过夜数据。
  3. 确认必需的客人身份字段已填写完整。
  4. PMS 完成更新后，再次生成报告。

如果应该包含客人，请不要提交空报告。 如果存在符合条件的客人但报告再次为空，请联系支持团队。 请提供报告类型、报告日期、PMS 和预期客人数。

Opera 报告值缺失​

你会看到： Opera 报告中缺少护照号码或出生日期。

解决方法：

  1. 请 Opera 管理员启用 Module Level Access Control。
  2. 请管理员授予 AVA OHIP 客户端 Sensitive Data Access。
  3. 确认该权限适用于正确的 Opera 酒店。
  4. Opera 权限更新后，再次生成报告。

被遮盖的护照值和 1800-01-01 出生日期会被有意排除。

报告一直处于队列中​

你会看到： 报告确认显示 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：

  • ❌ 客人反复未出现在预期的报告日期中
  • ❌ 报告时间戳阻碍合规提交
  • ❌ 自动报告连续一个以上周期失败
  • ❌ 重新连接或恢复 PMS 设置后仍存在配置错误

建议提供：

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