Інтеграція 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. Протестувати синхронізацію на тестовому сайті та провести навантажувальне тестування.

Що входить у роботу з інтеграції?

Терміни реалізації

Вартість розраховується індивідуально. Оцінимо ваш проєкт після знайомства з архітектурою поточного сайту. Отримайте демо-доступ до інтеграції або замовте пілотний проєкт. Зв'яжіться з нами для консультації. Гарантуємо стабільну роботу синхронізації: всі критичні канали моніторимо спільно з вашою командою.