跳到主要内容

从文件导入预订

快速设置

文件准备好后，大多数导入都能在 3-5 分钟内完成。

使用此流程可通过 .xlsx、.csv 或 .json 文件一次创建多条预订。

批量导入时，客人邮箱是可选项，因此缺少邮箱不会阻断流程。 AVA 还会把像 ="2/0/0" 这样的 Excel 强制文本包装器当作普通文本读取。 当工作表使用 Contact Name 之类的标签时，单列全名会自动映射。

前往： Operations View

开始前​

要求重要原因需要检查
PMS 是 Cloudbeds 或 AVA只有受支持的 PMS 才会显示批量导入按钮确认 Settings → Essentials → PMS Integration
文件是 .xlsx、.csv 或 .json其他格式会被拦截将文件另存或导出为这些格式之一
文件大小不超过 10 MB更大的文件会被拒绝上传前检查文件属性
有客人数据信息AVA 可导入成人、儿童和婴儿包含独立人数列，或一个 HGuru Persons 列
AVA 中已存在房型没有房型时无法匹配确认房型已可用
部分值使用了 Excel 强制文本PMS 导出可能会包裹字面文本值AVA 会自动去掉像 ="2/0/0" 这样的包装
全名使用单列AVA 可以把一个客人姓名拆成姓和名使用清晰标签，例如 Contact Name、Guest Name 或 Primary Guest

JSON 导入的处理方式​

JSON 结构示例AVA 的处理
嵌套对象guest.email将其扁平化为带点号的源路径
简单数组roomNumbers: [101, 102]用竖线分隔符合并这些值
对象数组guests: [{...}]跳过它并显示提取说明

如果 JSON 包含多个预订集合，AVA 会选择最匹配的一组。 它在这样做时也会显示警告。

导入预订​

  1. 前往 Operations View。
  2. 点击右上角操作区的 Bulk Import。
  3. 在 Upload 中拖放文件，或点击选择文件。
  4. 设置 Date format：
    • 大多数文件保留 Auto-detect 即可。
    • 如果日和月可能互换，请选择固定格式。
  5. 点击 Analyze file。
  6. 在 Review Mapping 中确认每个必填字段都映射到正确的源字段：
    • First Name 和 Last Name，或一个 Guest Name 列
    • Check-in Date
    • Check-out Date
    • Room Type
    • Nationality
    • 可选客人数：Adults、Children、Infants，或一个 HGuru Persons 列（ADT、CHD、INF）
    • 如果仍有必填字段缺失，映射清单会在继续前显示阻塞项。
    • 未映射的字段也会很容易被发现，因此先修正这些字段。
    • JSON 源字段可能会显示为类似 guest.email 的带点号路径。
  7. 点击 Generate preview。
  8. 在 Preview 中查看每一行的状态：
    • Ready：可以创建
    • Invalid：存在阻止导入的错误
    • Duplicate：在文件中或 PMS 中已存在
  9. 使用筛选器（All、Ready、Invalid、Duplicate）快速查看问题行。
  10. 如有需要，先修正文件并重新上传。
  11. 只剩有效行时，点击 Create reservations。

✓ AVA 会显示结果汇总，包括已创建、重复跳过和失败的行。

映射客人人数​

AVA 在导入时支持两种客人数格式。

文件格式示例在 AVA 中的结果
独立列Adults=2, Children=1, Infants=1创建包含成人 2、儿童 1、婴儿 1 的预订
HGuru Persons 列ADT:2,CHD:1,INF:1解析这些值并映射到成人、儿童和婴儿

如果两种格式都存在，预览中会优先使用已映射的人数列。 AVA 扁平化字段后，JSON 文件也遵循相同规则。 CSV 行中像 ="2/0/0" 这样的强制文本值也能正确解析。

理解结果行为​

结果含义操作
Created预订已成功添加无需操作
Skipped duplicate该行与现有 PMS 数据或另一行重复查看重复来源详情
Failed导入在该行停止修复问题并重新导入剩余行
部分成功

导入会按顺序逐行执行。如果某一行失败，AVA 会停在该行。 它之前的行仍然可以成功创建。

故障排查​

缺少 Bulk Import 按钮​

你看到的情况： 在 Operations View 中找不到 Bulk Import。

解决方法：

  1. 确认你的 PMS 是 Cloudbeds 或 AVA。
  2. 确认你的账号具有预订写入权限。
  3. 请管理员确认你的酒店拥有有效的商户配置。

“Only XLSX, CSV, and JSON files are supported”​

你看到的情况： 文件上传会立即被拒绝。

解决方法：

  1. 将文件重新导出为 .xlsx、.csv 或 .json。
  2. 删除不受支持的格式，例如 .xls、.numbers 或 .ods。
  3. 上传新文件。

JSON 提取说明出现​

你看到的情况： 映射步骤会针对你的 JSON 文件显示提取警告。

解决方法：

  1. 查看 JSON extraction notes 中带点号的源路径。
  2. 检查 JSON 是否使用了多个集合。
  3. 如果可能，移除不受支持的嵌套对象数组。
  4. 再次生成预览。

JSON 字段未按预期映射​

你看到的情况： 文件中明明有值，但 AVA 没有正确映射。

解决方法：

  1. 确认源字段是否以带点号的路径显示。
  2. 将该带点号路径映射到正确的预订字段。
  3. 如果你修改了源结构，请重新运行 Analyze file。

“Spreadsheet files must be 10 MB or smaller”​

你看到的情况： 出现文件大小错误。

解决方法：

  1. 删除无用的工作表和列。
  2. 将文件拆分为更小的批次。
  3. 重新上传每个批次。

“Date format is auto-detected or low confidence”​

你看到的情况： 映射或预览中出现警告。

解决方法：

  1. 手动设置 Date format。
  2. 重新生成预览。
  3. 在提交前确认解析后的日期正确。

预览中出现房型错误​

你看到的情况： 某些行显示房型无效。

解决方法：

  1. 让电子表格中的房型与现有房型名称或 ID 对齐。
  2. 如有需要，先创建缺失的房型。
  3. 重新上传并再次生成预览。

映射仍显示阻塞项​

你看到的情况： 映射步骤无法继续，清单仍显示缺失字段。

解决方法：

  1. 映射清单中显示的每个必填字段。
  2. 检查是否还有高亮的未映射字段。
  3. 每修正一项后都重新生成预览。

HGuru Persons 值未解析​

你看到的情况： 预览后客人数仍保持默认值。

解决方法：

  1. 检查 Persons 是否使用有效标记：ADT、CHD、INF。
  2. 只使用数字值，例如：ADT:2,CHD:1,INF:1。
  3. 生成预览前确认 Persons 列已经映射。

“Bulk import stopped at row X”​

你看到的情况： 提交结果显示停止的行和失败信息。

解决方法：

  1. 打开结果中的失败行详情。
  2. 在文件中修正该行。
  3. 只重新导入尚未创建的剩余行。

仍有问题？​

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

  • ❌ 重新映射字段和日期后仍持续失败
  • ❌ 所有行意外变成无效
  • ❌ 对有效的新预订误判为重复

建议附上：

  • 错误或结果页面截图
  • 受影响的文件行样本
  • 你的 PMS 类型和酒店名称