# 如何连接 Beds24 渠道管理器以同步房源日历和预订

> 分步指南：连接 Beds24 渠道管理器，一次性让您的空房情况、日历和预订信息在 Airbnb、Booking.com 等所有预订平台上自动保持同步。

对于在多个预订平台上发布同一房源的房东来说，渠道管理器是最实用的工具之一。没有渠道管理器时，每个平台都维护各自的日历，手动保持所有平台一致正是重复预订问题的根源。连接渠道管理器后，日历可自动保持同步：任一平台上的预订都会自动在其他平台封锁对应日期。

本指南介绍如何连接 [Beds24](https://beds24.com)——一款广泛使用的渠道管理器——以便将空房情况、日历和预订汇聚到同一处管理。本指南假设您已拥有 Beds24 账户并已在其中完成房产配置。

## 同步为您带来什么

连接 Beds24 可使以下三项内容保持同步，支持单向或双向：

- **空房情况** — 房源可预订的日期从 Beds24 同步导入，日历不会显示已在其他平台被占用的空余日期，包括同日交接的情况（即同一天一位客人退房、另一位客人入住）。
- **预订信息** — 已确认的预订会以只读方式同步显示，无需逐一登录各平台即可统一查看。
- **直接预订** — 当客人直接向您预订时，该预订可被推送回 Beds24，由渠道管理器在所有已连接平台上封锁相应日期。

**不**在同步范围内的是房源内容——照片、描述、设施和定价。这些内容仍保留在您当前管理它们的地方。渠道管理器负责日历管理，不会接管您的房源信息。

## 开始之前

您需要准备好两样东西：

1. 一个已配置好房产和房型的 **Beds24 账户**。
2. 在该账户中**生成邀请码**的权限（位于 Beds24 控制面板的 API 部分）。

关于术语说明：在 Beds24 中，一个*房产*可以包含多个*房型*，每个房型对应您这边的一个房源。拥有两个房型的房产，在您这边就是两个房源。

## 第一步 — 在 Beds24 中生成邀请码

登录您的 Beds24 控制面板，进入 **API v2** 部分（有时标注为"API access"）。生成一个邀请码，并确保已启用**预订、库存和房产**权限范围——这些权限允许集成读取您的日历和预订信息，并将已确认的直接预订写回。

邀请码是一个**一次性令牌**。您只需粘贴一次，系统会在后台将其兑换为有效期更长的凭证，因此无需保存或重复使用邀请码本身。

如果您通过 Beds24 管理他人的房产，请在生成邀请码时勾选允许**关联房产**的选项，否则这些房产将被跳过。

## 第二步 — 粘贴邀请码完成连接

在 Beds24 集成页面，将邀请码粘贴到连接字段并提交。集成系统会将邀请码兑换为凭证并安全存储。成功后，页面会切换至**已连接**状态，显示凭证最近一次刷新的时间。

如果邀请码有误或已过期，页面会显示明确的错误提示，您只需重新生成一个新邀请码再试即可——失败的尝试不会留下任何存储记录。

## 第三步 — 将房间映射到房源

连接成功后，您需要将每个 Beds24 **房间**映射到对应的房源。这一步告知集成系统哪个日历属于您这边的哪个房产。映射关系为**一对一**——一个房间最多对应一个房源——且映射会被记住，因此只需操作一次。如果某个已映射的房间日后从 Beds24 消失（被删除或重新标识），集成系统会发出提示，并保留最后已知的空房状态，而不是清空日历。

### 如果我还没有任何房源怎么办？

如果您的账户是新的、没有可映射的内容，请在映射标签页使用**"从 Beds24 导入"**。它会为每个尚未映射的 Beds24 房间创建一个房源，填入房间类型（Beds24 的*房间类型*会变成 Houseviser 房源），并自动映射每一个——这样空房状态同步和预订拉取就能立即开始。您不必全部导入：已映射的房间会被跳过，您可以在 Beds24 中添加房间后再次运行。

导入的房源以**草稿**形式出现。Beds24 不发送照片，而房源需要五张照片才能发布，因此每个草稿都会等待您添加照片并审核。草稿对公开网站隐藏，但仍在后台同步空房状态并拉取预订——在您完善它们期间，不会有任何阻塞。如果房间类型不能精确匹配，房源会默认为*公寓*；更正只需对草稿做一次快速编辑。

## 第四步 — 运行首次同步

完成房间映射后，触发一次同步，首次拉取空房情况和预订信息。首次拉取会回溯约一年的数据，以捕捉进行中和近期的入住记录，而不仅仅是未来的预订。此后，同步将采用增量方式进行。

从此以后，连接基本上可以自行维护：

- **每日后台检查**会保持存储凭证活跃，防止因长期未用而过期。
- 如果您的 Beds24 账户在同步期间触发了**速率限制**，集成系统会自动退避，并在限制窗口重置后重试——您无需做任何操作。
- 如果凭证真的过期或被撤销，页面会显示**"连接已过期——请重新连接"**的状态。重新连接只需重复第一步和第二步，使用新的邀请码；您的房间映射关系会被保留。

## 出现问题时如何排查

- **日历显示某些日期已被占用，但您预期应为空余。** Beds24 的数据是空房情况的权威来源。请直接在 Beds24 中核查这些日期；日历只是镜像渠道管理器所报告的内容。
- **某条预订未显示。** 只有已确认的预订才会同步。待确认或处于询问阶段的临时占用不会显示，直至其被确认为止。
- **页面显示连接已过期。** 在 Beds24 中生成新的邀请码并重新连接——映射关系不会丢失。

渠道管理器消除了导致重复预订的手动日历管理工作，连接操作只需一次性花费几分钟即可完成。一旦 Beds24 连接成功且房间映射完毕，您在所有已发布平台上的空房情况将始终保持一致。

## 链接

- [Beds24 — 渠道管理概述](https://beds24.com)
- [Beds24 API v2 文档](https://wiki.beds24.com/index.php/API_V2)
- [Beds24 控制面板（生成 API 邀请码）](https://beds24.com/control3.php?pagetype=apiv2)