跳到主要内容

配置客人登记字段

快速设置

选择每个字段的查看者和填写者。整个过程大约需要 5 分钟。 First Name、Last Name 和 Travel Document Number 始终为必填项。

使用登记字段控制客人在到店前和入住期间提供的信息。 如果页面提供模式选择器，请为每个流程分别选择字段设置。

独立设置

Mandatory Guest Registration 与这些字段开关相互独立。 使用入住政策要求每位 PMS 客人完成登记。

查找位置​

Settings → Check-In → Registration Form

快速参考​

设置选项对客人的影响
Show toAll guests、Main guest only 或 Hidden控制哪些客人可以看到该字段
Require fromOptional、Main guest only 或 All guests控制哪些客人必须填写该字段
Required fields已锁定确保客人身份信息和 PMS 要求得到保护
PMS Required由服务商决定的锁定字段防止预订与客人同步失败
TM30/RR3 badges泰国专用指示标记突出显示合规字段
Travel document datesTravel Document Issue Date 和 Travel Document Expiry Date在需要时收集证件日期
EVA declaration仅限启用 EVA 的酒店在入住期间收集永久居民或工作准证持有者状态
Mode-specific fieldsPre-arrival 或 Check-in允许为每个客人流程使用不同规则
Default Value支持的来源或自定义值为为空的字段提供建议值
CompanyAll guests、Main guest only 或 Hidden收集客人的公司名称

在模式之间切换​

  1. 使用页面顶部的模式选择器。

  2. 选择 Pre-arrival 或 Check-in。

  3. 更新该流程的字段。

  4. 选择 Save Registration Fields。

    ✓ AVA 会分别保留每种模式的设置。

字段开关的工作方式​

在每个字段行中使用两个选择器：

  • Show to → All guests 会向每位客人显示该字段。
  • Show to → Main guest only 只会向预订的主客人显示该字段。
  • Show to → Hidden 会从客人表单中移除该字段。
  • Require from → Optional 允许所选客人跳过该字段。
  • Require from → Main guest only 仅要求主客人填写该字段。
  • Require from → All guests 要求每位客人填写该字段。

字段必须先显示，AVA 才能将其设为必填。 隐藏字段会自动变为可选字段。 要求填写的客人不能多于可以看到该字段的客人。 没有客人范围的现有设置会继续保持以前的所有客人行为。

主客人示例

如果只想向主客人收集地址，请在两个选择器中都选择 Main guest only。 额外客人不会看到或填写该地址字段。

必填字段​

以下字段在入住期间始终可见：

  • First Name
  • Last Name
  • Travel Document Number

PMS 要求的字段也可能处于锁定状态。 当当前 PMS 要求这些字段时，AVA 会用 PMS Required 标记显示它们。

在两种模式下，PMS 要求的字段对所有客人可见且为必填项。 这些字段不能隐藏，也不能限制为仅主客人填写。

Travel Document Issue Date 和 Travel Document Expiry Date 是可选字段。 在 Check-in 模式下，这两个字段默认隐藏。 当你的酒店需要客人查看或提供这些日期时，请显示它们。

入住期间的 EVA 声明​

Permanent resident or work permit holder 声明支持 EVA 提交。 只有当前酒店启用了 EVA 时，该声明才会出现在 CCI 和 ACI 中。

当 EVA 被禁用、缺失或不可用时，AVA 会隐藏此声明。 当前酒店配置正在加载时，AVA 也会继续隐藏此声明。

当声明出现时，客人必须先完成声明，才能保存其信息。 此行为可防止因居留声明不完整而导致 EVA 提交失败。

证件日期规则​

AVA 可以从扫描或手动输入中保存证件签发日期和到期日期。 未来的到期日期有效，因此客人可以输入仍在有效期内的证件。 签发日期不能晚于到期日期。

日期验证

如果输入了两个日期，AVA 会在保存客人信息前检查它们的先后顺序。 如果证件未提供某个日期，请将该日期留空。

扫描日期会保留

当证件扫描发现签发日期或到期日期时，AVA 会在重新打开客人信息时再次显示该日期。 将该输入留空会保留已保存的日期，即使你保存了其他客人更改。 如需更正日期，请输入替换日期并再次保存。

当前 PMSPMS 要求的字段
CloudbedsNationality
eZeeEmail Address
Mews、Opera 和 AVA PMS没有其他 PMS 要求的字段

AVA 会从当前 PMS 的能力信息中读取这些要求。 它不会根据服务商名称推断要求。 更换 PMS 服务商时，AVA 会在保存前重新检查这些要求。

能力信息不可用

如果 AVA 无法验证 PMS 能力，它会禁用登记字段编辑。 请等待要求加载完成后，再重试更改。

锁定的 PMS 姓名

如果你的 PMS 锁定了 First Name 或 Last Name，AVA 会保留空白字段不变。 你仍然可以保存客人信息，包括只有一个已保存姓名的 Opera 预订。

可启用的常用字段​

类别示例使用时机
ContactEmail Address、Phone Number用于确认和后续联系
IdentityNationality、Date of Birth、Gender、Travel Document Issue Date、Travel Document Expiry Date用于合规和证件检查
AddressAddress、City、State/Province、Postal Code、Country of Residence用于监管或账单需求
Travel DetailsPlace of Departure、Next Destination、Departure Time、Pre Check-In Time用于移民申报
Guest ProfileCompany、Occupation、Purpose of Stay用于报表和个性化

收集客人的公司信息​

Company 字段默认隐藏。 当酒店需要客人的雇主或公司名称时，请启用此字段。

Company 值遵循所选的 Show to 和 Require from 规则。 客人和员工最多可以输入 80 个字符。 AVA 会在保存值之前去除多余的空格。

入住后，该值可能会出现在客人资料和登记卡中。 为空、未提供或隐藏的 Company 字段不会清除现有的已保存值。 这样可以在 PMS 刷新预订数据时保留该值。

如果 Company 同步失败，AVA 会继续显示本地值，并允许你重试。

配置 Company​

  1. 前往 Settings → Check-In → Registration Form。

  2. 选择 Pre-arrival 或 Check-in。

  3. 在字段列表中找到 Company。

  4. 在 Show to 下选择 All guests、Main guest only 或 Hidden。

  5. 在 Require from 下选择匹配的要求。

  6. 点击 Save Registration Fields。

    ✓ CCI 和 ACI 使用 Check-in 的 Company 规则。 ✓ Pre-arrival 使用自己的 Company 规则。

Opera 预计时间同步

当客人在 CCI 或 ACI 期间输入 Estimated Arrival Time 或 Departure Time 时，AVA 会将其发送到 Opera Cloud。 Opera 会将每个值保存为客人预订的预计时间。 对于主预订，AVA 会使用主客人的有效值。 对于 Opera 共享客人，AVA 会更新共享客人自己的预订。 如果字段仅对主客人可见，共享客人会继承主客人的有效值。 如果共享客人有自己的有效值，则以该值为准。 AVA 不会将共享客人的时间复制到主预订。 缺失或无效的值不会更改现有的 Opera 时间。 如果你的酒店使用此同步功能，请保持相关时间字段可见。

Opera 停留目的同步

当客人在 CCI 或 ACI 期间选择 Purpose of Stay 时，AVA 会将所选代码发送到 Opera Cloud。 AVA 会在发送前，根据 Opera 当前的停留目的列表检查该代码。 如果列表中包含该代码，AVA 会将 Opera 使用的拼写写入预订。 对于 Opera 共享客人，AVA 会在共享验证后更新共享客人的预订。 当 Purpose of Stay 仅对主客人显示时，每位共享客人都会接收主客人的有效代码。 同一预订中的同行客人不能覆盖该预订的值。 如果代码不在列表中，或列表不可用，AVA 会跳过此次更新，但不会导致客人同步失败。 其他 PMS 服务商会跳过此预订更新。

模式专属规则的工作方式​

AVA 可以为每个客人流程显示不同的字段规则。

模式使用的规则典型流程
Pre-arrival独立的到店前规则客人在到店前登记
Check-in独立的入住规则客人在 CCI 和 ACI 中登记

如果旧数据没有模式专属规则，AVA 会使用旧的共享配置。 保存时，AVA 会将该设置复制到两种模式中。

流程映射

CCI 和 ACI 都使用 Check-in 模式规则。 仅在到店前登记客人时使用 Pre-arrival 规则。

到店前规则

Pre-arrival 可以包含比 Check-in 更多的字段或更严格的规则。 它不能隐藏 Check-in 显示的字段，也不能缩小所有客人的范围。

泰国合规（TM30 和 RR3）​

如果你的 Country of Hotel 设置为泰国，某些字段旁边会显示 TM30 Required 和 RR3 Required 徽标。

  • TM30 fields 通常包括 First Name、Gender、Travel Document Number、Nationality 和 Date of Birth。
  • RR3 fields 通常包括 Address、Occupation、Place of Departure、Next Destination、Departure Time 和 Pre Check-In Time。

如果必须提交这些报告，请让带徽标的字段对所需客人保持可见且必填。

配置登记字段​

  1. 前往 Settings → Check-In → Registration Form。

  2. 当出现模式选择器时，选择 Pre-arrival 或 Check-in。

  3. 在 Show to 下选择 All guests、Main guest only 或 Hidden。

  4. 在 Require from 下选择 Optional、Main guest only 或 All guests。

  5. 点击 Save Registration Fields。

    ✓ 在查看未保存的更改时，所选值仍会显示。

值的填充方式​

客人详细信息可以从 PMS 或证件扫描中预填。除非字段被策略锁定（例如禁用编辑时的 Date of Birth），否则客人可以编辑这些字段。

证件扫描可以预填 Travel Document Issue Date 和 Travel Document Expiry Date。 AVA 会在客人信息表单中显示这些值，并在后续提交没有填写其中任一日期时保留这些值。

确认到店和离店时间​

使用时间选择器输入 Estimated Arrival Time 或 Departure Time。

  1. 在客人信息表单中选择时间字段。

  2. 在弹出层中选择小时和分钟。

  3. 选择 OK 应用新的时间。

    ✓ 确认后，新时间会显示在表单中。

在选择 OK 之前，选择器会将你的选择保留为草稿。 选择 Cancel、点按选择器外部，或按下 Escape，即可保留之前的值。 弹出层会保持在可见屏幕范围内，包括固定的 Save 页脚附近。 手动输入和已配置的时间窗口限制仍然适用。

证件国籍的填充方式​

当证件提供可靠的公民身份信息时，AVA 会填写 Nationality。

对于可识别的新加坡 NRIC，S 或 T 前缀可能表示 SG。 这是基于证件的推断，并不构成公民身份的证明。 明确的外国公民身份或永久居民身份优先。

对于可识别的马来西亚 MyKad，AVA 会为马来西亚公民填写 MY。 马来西亚 MyPR 和 MyKAS 卡不会自动表示持有人拥有马来西亚公民身份。 如果公民身份未知或无法读取，Nationality 会保持为空。

如果 Nationality 为必填项，请让客人在保存前填写或确认该信息。

如果客人没有电话号码，AVA 会使用扫描证件中的国籍作为默认国家代码。 已有电话号码会保留其已保存的国家代码。 AVA 会在预填前清除明显的占位号码，例如 +1 0000000000。

移动端国家选择器

在手机和平板上，Phone Number、Nationality、Country of Residence、Place of Departure 和 Next Destination 会打开可搜索的底部抽屉。 桌面端继续使用内联自动补全。

预填联系信息检查

如果 AVA 打开无效的已保存邮箱或电话号码，会立即显示错误。 只有无效的非空值才会被标记。

地址自动补全

当客人输入地址、邮政编码、出发地址或下一个目的地时，AVA 会根据其国籍调整 Google Places 的结果优先级。 如果缺少国籍，AVA 会改用酒店所在国家。

为为空的字段建议默认值​

使用 Default Value，在支持的登记字段为空时建议一个值。 默认值适用于所选的 Pre-arrival 或 Check-in 模式。 CCI 和 ACI 使用 Check-in 默认值。

字段可用默认值结果
Departure TimeUse configured Checkout Time 或 Custom value建议酒店的退房时间或固定时间
Country of ResidenceBased on identification document nationality、Hotel's Country 或 Custom value建议一个国家，但不会更改客人的地址
Place of DepartureSame as Country of Residence 或 Custom value根据客人的居住国建议一个国家
Next DestinationSame as Country of Residence 或 Custom value根据客人的居住国建议一个国家
Purpose of StayCustom value建议一个已配置的目的

配置字段默认值​

  1. 前往 Settings → Check-In → Registration Form。

  2. 选择 Pre-arrival 或 Check-in。

  3. 找到支持的字段并打开 Default Value。

  4. 选择一个来源，或选择 Custom value。

  5. 根据提示选择国家、目的或时间。

  6. 点击 Save Registration Fields。

    ✓ AVA 仅在该字段为空时建议此值。

客人信息始终优先

现有客人数据、已保存的草稿和客人编辑内容优先于默认值。 默认值不会覆盖客人明确保存的空值。

可见性和客人范围

默认值仅在该字段对相应客人可见时生效。 它们遵循字段的 Show to 和 Require from 设置。 国家默认值不会复制地址，也不会启用相同地址复选框。

选择 No default 可停止今后的建议。 这不会清除已经为客人保存的信息。

限制可选时间​

对于 Estimated Arrival Time 和 Departure Time，设置 Earliest 和 Latest 值。 客人只能选择包含边界时间在内的范围中的时间。 请将自定义时间默认值保持在该范围内。

将任一边界留空即可移除该限制。 两个边界都留空则允许所有时间。 两个边界都包括你输入的确切时间。 例如，Earliest 14:00 允许客人选择 14:00。 时间范围不能跨午夜，例如 22:00–02:00。

时间选择器会隐藏范围之外的小时。 跨过生效边界的分钟会显示为灰色。 输入范围外的时间会被移除，并显示允许范围消息。 已有的范围外时间必须更正后，客人才能继续。 员工工具和 PMS 更新仍可写入范围外的时间。

如果 Earliest 晚于 Latest，AVA 会清除另一个边界。 这样可以防止编辑值时形成无效范围。

配置的退房默认值若在范围外，不会向客人建议。

时间窗口分别应用于 Pre-arrival 和 Check-in。 例如，可以允许到店前规划使用比客人自助入住更早的时间。

入住流程时间选择器行为已保存的范围外值
Pre-arrival 或客人自助服务仅显示窗口内的时间更正前会阻止提交
双设备 ACI 员工界面员工可以输入任意时间允许员工审批
配对的客人平板客人只能选择允许的时间接受表单中已由员工批准的时间
双设备 ACI 审批

审批提前到店或延迟离店时，请使用员工界面。 员工设备保存后，配对的平板会接受该批准值。 客人输入的窗口外值会被拒绝。

客人平板会接受表单中已经存在的、由员工批准的范围外值。 如果客人更改该值，新的时间必须符合配置的范围。

默认建议未显示​

你看到的是： 配置的默认值没有出现在客人表单中。

解决方法：

  1. 确认该字段对客人的范围可见。
  2. 检查所选模式是否与客人流程匹配。
  3. 确认客人没有已保存的值或草稿。
  4. 检查是否已选择自定义国家、目的或时间。
  5. 对于时间字段，将默认值保持在配置的 Earliest 和 Latest 范围内。
  6. 再次保存登记字段。

停留目的的可见性​

Purpose of Stay 字段必须对客人可见，才会在入住期间出现。

  • 在此处启用它，或
  • 在 Purpose of Stay 中使用 Make Visible 按钮

故障排查​

模式专属设置没有变化​

你看到的是： 到店前和入住显示相同的字段。

解决方法：

  1. 确认预订使用的是正确流程。
  2. 选择 Pre-arrival 并查看这些字段。
  3. 选择 Check-in 并查看 CCI 和 ACI 的字段。
  4. 为每种模式各保存一次，以升级旧的共享设置。

无法选择 Require from​

你看到的是： 在 Require from 下无法选择 Main guest only 或 All guests。

解决方法：

  1. 确认 Show to 不是 Hidden。
  2. 如果只应由主客人填写，请在 Show to 下选择 Main guest only。
  3. 检查该字段是否因客人身份识别要求或 PMS 要求而被锁定。

无法设置到店前范围​

你看到的是： 到店前不允许设置比入住更窄的范围。

解决方法：

  1. 选择 Check-in，查看该字段的 Show to 和 Require from 值。
  2. 让 Pre-arrival 的范围至少与 Check-in 一样宽。
  3. 如果需要扩大共享要求，请先保存 Check-in。

时间超出允许范围​

你看到的是： 时间字段显示允许范围，或提交被阻止。

解决方法：

  1. 检查所选的 Pre-arrival 或 Check-in 模式。
  2. 查看受影响时间字段的 Earliest 和 Latest。
  3. 输入包含边界在内的范围中的时间。
  4. 再次保存登记表单。
员工批准的 ACI 时间

在双设备 ACI 中，配对的平板可以保留由员工输入的范围外时间。 客人无法在平板上创建范围外值。

TM30/RR3 字段未显示​

你看到的是： 没有显示合规徽标或必填字段。

检查：

  • Hotel Basic Details 中的 Country of Hotel 是否设置为泰国。
  • 保存国家更改后刷新页面。

EVA 声明缺失​

你看到的是： 入住期间没有显示永久居民声明。

解决方法：

  1. 打开 Government Compliance → Singapore → STB EVA。
  2. 确认当前酒店已启用 EVA。
  3. 酒店配置加载完成后，刷新入住流程。
  4. 如果 EVA 已启用但声明仍然隐藏，请联系支持团队。

更改没有保存​

你看到的是： 点击 Save Registration Fields 后，字段选择恢复原状。

解决方法：

  1. 确保必填字段仍保持启用。
  2. 检查是否出现验证错误或 PMS registration requirements are unavailable 警告。
  3. 警告消失后再次保存。
  4. 刷新页面并确认已保存的范围。

证件日期被拒绝​

你看到的是： 输入证件日期后无法保存客人信息。

解决方法：

  1. 检查 Travel Document Issue Date 是否早于或等于 Travel Document Expiry Date。
  2. 如果证件仍然有效，请保留未来的到期日期。
  3. 如果证件未显示某个日期，请将该日期留空。
  4. 再次保存客人信息。

PMS 要求的字段被锁定​

你看到的是： 某个字段显示 PMS Required，且其控件已禁用。

解决方法：

  1. 让该字段对 All guests 可见。
  2. 保持选中 Require from → All guests。
  3. PMS 能力信息加载完成后保存。

这会保护当前 PMS 的预订与客人同步。

PMS 登记要求不可用​

你看到的是： 警告显示“PMS registration requirements are unavailable.”

解决方法：

  1. 在 Settings → Essentials → PMS Integration 中确认已选择正确的 PMS。
  2. 刷新页面并等待能力信息加载。
  3. 重试 Save Registration Fields。
  4. 如果警告持续出现，请联系 PMS 管理员。

在能够验证 PMS 要求之前，AVA 不会保存登记更改。

Company 同步失败​

你看到的是： 客人的 Company 值仍然显示，但同步出现错误。

解决方法：

  1. 如果显示的 Company 值正确，请保留该值。

  2. 选择可用的 Retry 操作。

  3. 同步完成后刷新预订。

  4. 如果重试再次失败，请联系支持团队。

    ✓ 同步失败期间，AVA 不会丢弃本地提交的 Company 值。

Opera 预计离店时间未更改​

你看到的是： Opera 仍显示之前的预计离店时间。

解决方法：

  1. 确认当前 Check-in 登记规则中 Departure Time 可见。
  2. 请客人再次提交出发时间。
  3. 如果客人是 Opera 共享客人，请在 Opera 中检查共享客人自己的预订。
  4. 如果 Departure Time 仅对主客人可见，请检查主客人的规范值。
  5. 等 Opera 完成同步后刷新预订。
  6. 如果时间仍未更改，请联系支持团队。

仍然无法解决？​

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

  • ❌ 未显示模式专属规则
  • ❌ 缺少必填字段。
  • ❌ 字段范围无法正确保存。

建议附上：

  • 登记字段列表的截图。
  • 酒店国家设置。
  • 看起来不正确的流程和字段范围。