# Как подключить Beds24 для синхронизации календаря и бронирований

> Пошаговое руководство по подключению менеджера каналов Beds24 для синхронизации доступности, календаря и бронирований на всех платформах одновременно.

Менеджер каналов — самый полезный инструмент для владельца, который размещает один объект сразу на нескольких платформах бронирования. Без него каждая платформа ведёт собственный календарь, и поддерживать их согласованность вручную — именно то, что приводит к двойным бронированиям. Подключите менеджер каналов один раз, и календари будут синхронизироваться автоматически: бронирование на любой платформе мгновенно блокирует эти даты везде.

Это руководство описывает подключение [Beds24](https://beds24.com) — широко используемого менеджера каналов — чтобы доступность, календарь и бронирования стекались в одно место. Предполагается, что у вас уже есть аккаунт Beds24 с настроенными объектами.

## Что даёт синхронизация

Подключение Beds24 поддерживает согласованность трёх вещей — в одном направлении или в обоих:

- **Доступность** — даты, когда объявление доступно для бронирования, поступают из Beds24, поэтому календарь никогда не показывает свободные даты, уже занятые на другой платформе. Это касается и случая заезда и выезда в один день, когда один гость выезжает, а другой заезжает.
- **Бронирования** — подтверждённые резервации отображаются в одном месте только для чтения, без необходимости заходить на каждую платформу отдельно.
- **Прямые бронирования** — когда гость бронирует напрямую у вас, это можно передать обратно в Beds24, чтобы менеджер каналов заблокировал эти даты на всех остальных подключённых платформах.

Что **не** синхронизируется — это контент объявления: фотографии, описания, удобства, цены. Они остаются там, где вы ими управляете сегодня. Менеджер каналов управляет календарём; он не берёт на себя ваше объявление.

## Перед началом

Вам потребуются две вещи:

1. **Аккаунт Beds24** с уже настроенными объектами и комнатами.
2. Возможность **генерировать инвайт-код** в этом аккаунте (это находится в разделе API панели управления Beds24).

Замечание по терминологии: в Beds24 *объект* (property) может содержать несколько *типов комнат* (room types). Каждый тип комнаты соответствует одному объявлению. Объект с двумя типами комнат — это два объявления на вашей стороне.

## Шаг 1 — Сгенерируйте инвайт-код в Beds24

Войдите в панель управления Beds24 и откройте раздел **API v2** (иногда обозначен как «API access»). Сгенерируйте инвайт-код и убедитесь, что включены разрешения для **бронирований, инвентаря и объектов** — они позволяют интеграции читать ваш календарь и бронирования, а также записывать подтверждённые прямые бронирования обратно.

Инвайт-код — это **одноразовый токен**. Вы вставляете его один раз; за кулисами он обменивается на долгосрочные учётные данные, поэтому хранить или повторно использовать сам код не нужно.

Если вы управляете чужими объектами через Beds24, при генерации кода отметьте опцию разрешить **связанные объекты** (linked properties), иначе они будут пропущены.

## Шаг 2 — Вставьте код для подключения

На странице интеграции Beds24 вставьте инвайт-код в поле подключения и отправьте. Интеграция обменяет код на учётные данные и сохранит их в защищённом виде. При успешном подключении страница переходит в состояние **«подключено»** с указанием времени последнего обновления учётных данных.

Если код неверный или истёкший, вы увидите чёткое сообщение об ошибке и сможете просто сгенерировать новый и попробовать ещё раз — от неудачной попытки ничего не сохраняется.

## Шаг 3 — Сопоставьте комнаты с объявлениями

После подключения вы сопоставляете каждую **комнату** Beds24 с соответствующим объявлением. Это указывает интеграции, какой календарь принадлежит какому объекту на вашей стороне. Сопоставление — **один к одному**: одна комната соответствует не более чем одному объявлению, и оно запоминается, так что вы делаете это только один раз. Если сопоставленная комната позднее исчезнет из Beds24 (удалена или переидентифицирована), интеграция отметит это для внимания и сохранит последнюю известную доступность вместо того, чтобы очистить календарь.

### Что если у меня ещё нет объявлений?

Если ваш аккаунт новый и сопоставлять нечего, используйте **«Импорт из Beds24»** на вкладке сопоставления. Он создаёт по одному объявлению на каждую ещё не сопоставленную комнату Beds24, заполняет тип комнаты (*тип комнаты* Beds24 становится объявлением Houseviser) и автоматически сопоставляет каждое — чтобы синхронизация доступности и загрузка бронирований могли начаться сразу. Импортировать всё необязательно: уже сопоставленные комнаты пропускаются, а импорт можно запустить позже, когда вы добавите комнаты в Beds24.

Импортированные объявления появляются как **черновики**. Beds24 не передаёт фотографии, а объявлению нужно пять фотографий для публикации, поэтому каждый черновик ждёт, пока вы добавите фотографии и одобрите его. Черновики скрыты с публичного сайта, но при этом синхронизируют доступность и загружают бронирования в фоне — пока вы их дорабатываете, ничего не блокируется. Если тип комнаты не совпадает точно, объявление по умолчанию получает тип *Квартира*; исправить это — быстрое редактирование черновика.

## Шаг 4 — Запустите первую синхронизацию

После сопоставления комнат запустите синхронизацию, чтобы впервые загрузить доступность и бронирования. Первая загрузка охватывает примерно год назад, чтобы захватить текущие и недавние пребывания, а не только предстоящие. Последующие синхронизации инкрементальные.

Дальше соединение в основном обслуживает себя само:

- **Ежедневная фоновая проверка** поддерживает сохранённые учётные данные активными, чтобы они не истекли от неиспользования.
- Если аккаунт Beds24 достигает **лимита запросов** во время синхронизации, интеграция делает паузу и повторяет попытку автоматически после сброса окна лимита — вам ничего делать не нужно.
- Если учётные данные когда-либо действительно истекают или отзываются, страница показывает состояние **«соединение истекло — переподключитесь»**. Повторное подключение — это просто шаги 1 и 2 с новым кодом; привязка комнат сохраняется.

## Если что-то выглядит неправильно

- **Календарь показывает занятые даты, которые должны быть свободными.** Доступность — это источник истины из 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)