Интеграция 1С-Битрикс с системой бронирования Bnovo

Овербукинг из-за ручного переноса броней — классический сценарий потери выручки для отеля. По нашей статистике, до 15% броней теряются из-за опозданий или ошибок при двойном вводе. Менеджер принимает заявку через сайт на Битрикс, вручную заносит бронь в Bnovo, потом вручную обновляет доступность номеров обратно на сайт. Два источника правды — два места для ошибок. Мы сталкивались с этим десятки раз. Наша задача — сделать так, чтобы система бронирования и CMS общались напрямую, без участия человека. Это не только ускоряет процесс в 3 раза, но и исключает риск овербукинга полностью. Экономия времени администратора достигает 70%, а затраты на обработку одной брони снижаются в 2–3 раза.

Bnovo — российская PMS-система с собственным channel manager и REST API. Авторизация — API-ключ отеля в заголовке X-Api-Key. Основные сущности: rooms, reservations, rates, availability. Прямая интеграция через API в 3 раза быстрее готовых модулей — не нужно ждать обновлений от вендора. Мы гарантируем отсутствие овербукинга и стабильную синхронизацию.

Как интеграция 1С-Битрикс с Bnovo решает проблему ручного ввода?

Архитектура интеграции

Bnovo предоставляет REST API (https://online.bnovo.ru/api/v1/). Направления потоков данных:

1. Bnovo → Битрикс: синхронизация доступности номеров и тарифов — чтобы виджет на сайте показывал актуальную загрузку.
2. Битрикс → Bnovo: передача новых броней, созданных через сайт.

Промежуточного хранилища избегаем — данные передаём напрямую через API с кэшированием на стороне Битрикс.

Синхронизация доступности

Bnovo отдаёт доступность через GET /api/v1/availability?hotel_id={id}&date_from=YYYY-MM-DD&date_to=YYYY-MM-DD. Ответ содержит массив дат с количеством свободных номеров по каждому типу.

Агент Битрикс запускается каждые 10 минут и обновляет локальный кэш доступности в таблице bl_bnovo_availability:

CREATE TABLE bl_bnovo_availability (
    room_type_id INT NOT NULL,
    date DATE NOT NULL,
    qty_available SMALLINT NOT NULL DEFAULT 0,
    synced_at TIMESTAMP NOT NULL,
    PRIMARY KEY (room_type_id, date)
);

Запрос к этой таблице делает виджет выбора дат на сайте — без обращения к Bnovo API в реальном времени. Это снижает зависимость от доступности внешнего сервиса и ускоряет отклик формы.

Создание брони в Bnovo из Битрикс

После успешной оплаты заказа (событие OnSalePaymentEntitySaved при IS_PAID = Y) обработчик формирует запрос к Bnovo:

$response = $bnovoClient->post('/api/v1/reservations', [
    'hotel_id' => $this->hotelId,
    'room_id' => $roomId,
    'date_from' => $booking->getDateFrom()->format('Y-m-d'),
    'date_to' => $booking->getDateTo()->format('Y-m-d'),
    'rate_id' => $booking->getRateId(),
    'guest' => [
        'name' => $order->getPropertyValueByCode('NAME'),
        'phone' => $order->getPropertyValueByCode('PHONE'),
        'email' => $order->getPropertyValueByCode('EMAIL'),
    ],
    'amount' => $payment->getSum(),
    'source' => 'website',
]);
$bnovoReservationId = $response['reservation']['id'];

reservation_id из ответа сохраняем в UF-поле заказа UF_BNOVO_RESERVATION_ID — это необходимо для последующих операций (отмена, изменение дат).

Webhooks из Bnovo

Bnovo умеет отправлять webhooks при изменении статуса брони, созданной внутри PMS (не через сайт). Настройка — в разделе «Интеграции» личного кабинета Bnovo: указываем URL обработчика на стороне Битрикс.

Обработчик /api/bnovo-webhook.php:

$payload = json_decode(file_get_contents('php://input'), true);
// Проверка подписи: HMAC-SHA256 тела запроса + секретный ключ
$expectedSign = hash_hmac('sha256', file_get_contents('php://input'), BNOVO_WEBHOOK_SECRET);
if (!hash_equals($expectedSign, $_SERVER['HTTP_X_BNOVO_SIGNATURE'] ?? '')) {
    http_response_code(403);
    exit;
}
switch ($payload['event']) {
    case 'reservation.created':
        // Создать заказ в Битрикс или уведомить менеджера
        break;
    case 'reservation.cancelled':
        // Отменить заказ в Битрикс
        BnovoSyncService::cancelOrder($payload['reservation_id']);
        break;
    case 'availability.updated':
        // Сбросить кэш доступности для затронутых дат
        BnovoCache::invalidate($payload['room_type_id'], $payload['dates']);
        break;
}

Источник: документация Bnovo REST API.

Почему прямой обход через REST API лучше готовых модулей?

Готовые модули из Маркетплейса часто не покрывают специфику отеля: уникальные тарифы, сложные правила отмены, интеграция с кассой. Прямой REST API даёт полный контроль. Наша команда имеет 8+ лет опыта в разработке на Битрикс и реализовала 50+ интеграций с PMS-системами. Мы пишем код под ваш сценарий, а не подстраиваем бизнес под модуль.

Тарифы и сезонные цены

Bnovo хранит тарифы (rates) — набор правил ценообразования. Метод GET /api/v1/rates возвращает список с условиями: минимальное количество ночей, ограничения по датам, тип питания. Синхронизируем тарифы в таблицу bl_bnovo_rates раз в час — они меняются редко.

На форме бронирования на сайте тарифы подгружаются AJAX-вызовом: пользователь выбирает даты, сайт запрашивает актуальные тарифы с ценами через GET /api/v1/rates/prices?room_id=X&date_from=...&date_to=... и отображает варианты размещения.

Как настроить интеграцию за 6 шагов

1. Получить API-ключ Bnovo через личный кабинет.
2. Создать таблицу bl_bnovo_availability в БД.
3. Настроить агента Битрикс для синхронизации доступности (период 10 минут).
4. Реализовать обработчик события OnSalePaymentEntitySaved для передачи броней.
5. Настроить webhook-уведомления в Bnovo (резервации, отмены, обновления доступности).
6. Протестировать синхронизацию на тестовом сайте и провести нагрузочное тестирование.

Что входит в работу по интеграции?

Сроки реализации

Стоимость рассчитывается индивидуально. Оценим ваш проект после знакомства с архитектурой текущего сайта. Получите демо-доступ к интеграции или закажите пилотный проект. Свяжитесь с нами для консультации. Гарантируем стабильную работу синхронизации: все критичные каналы мониторим совместно с вашей командой.