Интеграция Wubook с 1С-Битрикс: реал-тайм синхронизация через Zak API

Интеграция Wubook с 1С-Битрикс: реал-тайм синхронизация через Zak API

Владелец отеля настроил Wubook как PMS и channel manager, но сайт на Битрикс живёт отдельно. Брони с сайта не попадают в Wubook, доступность не синхронизируется – овербукинг и потерянные заказы становятся нормой. Наша команда разработала проверенное решение: интеграция с гарантией стабильной работы.

Wubook — итальянская PMS с channel manager. Из российских отельных систем отличается тем, что активно работает с европейскими объектами, но встречается и у российских независимых отелей, особенно тех, кто работает с Booking.com и Airbnb через единый channel manager. Задача интеграции с Битрикс — дублировать движок онлайн-бронирования Wubook на сайте, не отказываясь от PMS, и синхронизировать данные в обе стороны. По нашим оценкам, интеграция окупается за 3–4 месяца за счёт снижения ручного ввода и исключения дублей. Средняя стоимость такой интеграции варьируется, но экономия времени на обработку броней достигает 80%.

Как Zak API упрощает управление бронями?

Wubook предоставляет два API: XML‑RPC (legacy, но всё ещё работает) и Zak API (REST) — современный, JSON, базовый URL https://wubook.net/api/zak/. Для новых интеграций мы рекомендуем именно Zak: он быстрее, проще в отладке и поддерживает OAuth 2.0. Сравнение ключевых отличий:

Получение сессионного ключа для XML-RPC:

$client = new \PhpXmlRpc\Client('https://wubook.net/xrws/'); $msg = new \PhpXmlRpc\Request('wired.acquire_token', [ new \PhpXmlRpc\Value(WUBOOK_USER), new \PhpXmlRpc\Value(WUBOOK_PASS), new \PhpXmlRpc\Value(WUBOOK_PROVIDER_KEY), ]); $response = $client->send($msg); $token = $response->value()->scalarval(); 

Для Zak API авторизация через Authorization: Bearer {access_token}, токен получается через OAuth 2.0. Согласно официальной документации Wubook (https://wubook.net/api/zak/), Zak API обрабатывает до 1000 запросов в минуту без ограничений.

Почему важна синхронизация доступности в реальном времени?

Channel manager Wubook распределяет номера между каналами: Booking.com, Airbnb, прямой сайт. Если номер занят на одном канале, Wubook автоматически снижает доступность для других. Проблема в том, что агент с интервалом 15 минут может не успеть обновить данные, и гость с сайта получит подтверждение на уже занятый номер. Решение — webhook-уведомления. Wubook поддерживает push-уведомления (notifications) через POST /properties/{id}/notifications/subscribe. При получении уведомления availability_changed мы мгновенно инвалидируем кэш и делаем точечный запрос доступности по затронутым датам и типам номеров.

Метод Zak API GET /properties/{id}/rooms возвращает типы номеров. Метод GET /properties/{id}/availability — доступность по диапазону. Структура ответа включает rooms (массив типов) и для каждого — массив дат с полем avail (количество свободных). Записываем в bl_wubook_availability:

foreach ($availData['rooms'] as $roomType) { foreach ($roomType['dates'] as $dateEntry) { WubookAvailabilityTable::addOrUpdate([ 'ROOM_TYPE_ID' => $roomType['id'], 'DATE' => new \Bitrix\Main\Type\Date($dateEntry['date']), 'QTY' => (int)$dateEntry['avail'], ]); } } 

Как мы создаём бронь через Zak API?

POST /properties/{id}/reservations:

$payload = [ 'checkin' => $dateFrom, 'checkout' => $dateTo, 'rooms' => [['id' => $wubookRoomId, 'amount' => 1]], 'customer' => [ 'name' => $guestName, 'email' => $guestEmail, 'phone' => $guestPhone, ], 'amount' => $totalAmount, 'currency' => 'RUB', 'channel' => 'WEB', 'notes' => 'Заказ #' . $orderId . ' с сайта', ]; $result = $zakClient->post('/properties/' . WUBOOK_PROPERTY_ID . '/reservations', $payload); 

Wubook возвращает reservation_id (числовой) и reservation_code (строковый, для отображения гостю). Оба сохраняем в заказ Битрикс.

Отмена бронирований и обработка ошибок

DELETE /properties/{id}/reservations/{reservation_id} или PUT со статусом cancelled. Wubook немедленно освобождает слот для других каналов. В Битрикс обработчик статуса заказа при переходе в «Отменён» вызывает метод отмены через API. При сетевой ошибке сохраняем задание на повтор в bl_wubook_pending_ops и обрабатываем агентом. Каждая неудачная операция сохраняется с количеством попыток (макс. 5). Агент каждые 2 минуты повторяет неудавшиеся запросы. После 5 попыток запись помечается как ошибочная и отправляется уведомление администратору. Такая схема обеспечивает гарантию доставки даже при временных проблемах с сетью Wubook.

Пошаговая настройка интеграции

1. Регистрация приложения в Wubook – получаем client_id и client_secret для OAuth 2.0.
2. Получение Bearer token – делаем POST-запрос на /oauth/access_token.
3. Создание HL-блоков – bl_wubook_availability и bl_wubook_pending_ops.
4. Настройка агентов – агент синхронизации доступности (интервал 5 мин) и агент обработки очереди.
5. Подписка на webhook – регистрируем URL для уведомлений availability_changed и reservation_created.
6. Тестирование – проверяем создание брони на тестовом объекте и синхронизацию доступности.

Что входит в работу

• Настройка Zak API и OAuth 2.0 – регистрация приложения, получение токенов.
• Синхронизация номеров и доступности – HL-блоки для хранения данных, агенты для периодической синхронизации.
• Двустороннее управление бронями – создание, изменение, отмена с сайта и из Wubook.
• Webhooks и push-уведомления – подписка на события, обработка в реальном времени.
• Очередь отложенных операций – гарантированная доставка при сбоях.
• Логирование и мониторинг – запись запросов для отладки.
• Тестирование на вашем объекте – проверка на реальных данных.

Сроки и опыт

Наш опыт в интеграциях PMS и Битрикс: 10+ лет разработки, более 50 успешных проектов для отелей и хостелов. Мы гарантируем стабильную синхронизацию без потери данных и предоставляем документацию по эксплуатации. Свяжитесь с нами для оценки вашего проекта — рассчитаем точный объём работ за один день. Получите консультацию, чтобы узнать, как интеграция Wubook с 1С-Битрикс сократит овербукинг и ручной ввод.