Демоверсія

Інтеграція постачальника готелів

Інтеграція Hotelbeds API: контент, мапінг і живе бронювання

Інтеграція Hotelbeds API складається з двох завдань, а не одного. Спочатку ви завантажуєте та зберігаєте контент готелів, потім бронюєте за актуальними тарифами. PHPTRAVELS виконує обидва завдання у своєму модулі готелів, з вашим власним контрактом і ключами Hotelbeds.

  • Синхронізація Content API
  • Процес Booking API
  • Тарифи BOOKABLE і RECHECK
  • Мапінг готелів

Як поєднуються API Hotelbeds

Інтеграція Hotelbeds API: контент з одного боку, бронювання з іншого

Hotelbeds ділить свої API для готелів на два. Content API повертає статичні дані: описи, зображення, зручності, типи харчування та номери. Booking API повертає актуальну наявність і ціни та приймає бронювання. Оберіть крок посередині, щоб побачити, які виклики він використовує.

Content API

Статичні дані, зберігаються у вас
  • Список готелівhotels · from=1&to=1000Усі готелі вашого портфеля, сторінками до 1 000 готелів за запит.
  • Зручності, харчування та номериfacilities · boards · roomsДовідники кодів, які перетворюють коди Booking API на зрозумілі гостям слова.
  • Зображенняphotos.hotelbeds.com/giata/Часткові шляхи до зображень, які поєднуються з фотохостом Hotelbeds у потрібному розмірі.
  • Щоденні зміниlastUpdateTimeПісля першого завантаження один запит на день з lastUpdateTime повертає лише зміни.

Порядок запитів

Booking API

Живі дані, виклик для кожного гостя
  • НаявністьPOST /hotelsНомери, харчування, ціни та штрафи за скасування для ваших кодів готелів, дат і розміщення.
  • Перевірка тарифуPOST /checkratesОновлена ціна та умови для тарифу з позначкою RECHECK, а також варіанти апселу.
  • БронюванняPOST /bookingsПідтверджує обраний rateKey з іменами замовника та гостей і повертає номер бронювання.
  • СкасуванняDELETE /bookings · simulateМоделює скасування, щоб показати штраф, або скасовує бронювання по-справжньому.
Приклад екрана. Виклики описано на developer.hotelbeds.com; процес показує, як їх використовує PHPTRAVELS.

Більшість невдалих проєктів з Hotelbeds плутають ці дві сторони. Вони викликають Content API під час пошуку гостя, що повільно і, як попереджає Hotelbeds, може призвести до блокування облікових даних. Або шукають у реальному часі без збережених кодів і не можуть показати зображення та зручності. PHPTRAVELS розділяє їх: контент синхронізується у фоні, а поки гість чекає, виконуються лише виклики наявності, перевірки тарифу та бронювання.

Якщо вас цікавить сам постачальник, його продукти та відкриття акаунта, прочитайте профіль постачальника Hotelbeds. Ця сторінка присвячена технічній інтеграції.

Типи тарифів

Чотири поля тарифу, які змінюють оформлення замовлення

Кожен тариф Hotelbeds містить кілька атрибутів. Вони визначають, чи можна забронювати його одразу, яку ціну дозволено показувати і хто отримує гроші. Ваш рушій має читати їх у кожному результаті.

ПолеПерший випадокДругий випадокЩо робить PHPTRAVELS

Bookable чи recheck

rateType		BOOKABLE

Тариф актуальний. Його можна забронювати без додаткового виклику.

RECHECK

Спочатку треба викликати перевірку тарифу, щоб отримати оновлену ціну та умови.

Запускає перевірку тарифу перед оплатою для тарифів RECHECK і показує гостю будь-які зміни.

Нетто чи комісійний

net · sellingRate		net

Модель нетто: ціни нетто, ви додаєте власну націнку.

sellingRate

Комісійна модель: комісія вже входить у sellingRate, і ця ціна остаточна.

Застосовує ваші правила націнки до нетто-тарифів і продає комісійні тарифи за sellingRate.

Фіксована ціна продажу

hotelMandatory		true

hotelMandatory дорівнює true: продавати треба за sellingRate.

false · null

False або порожньо для нетто-тарифу: можна встановити власну націнку.

Фіксує показану ціну на sellingRate, коли цього вимагає готель, незалежно від правила націнки.

Коли платить гість

paymentType		AT_WEB

Оплата стягується під час бронювання, через ваш сайт.

AT_HOTEL

Гість платить безпосередньо готелю.

Позначає тариф як оплату зараз або оплату в готелі та налаштовує оформлення замовлення відповідно.

Модель ціноутворення залежить від вашого контракту з Hotelbeds. Як зазначає Hotelbeds, модель для вашого бізнесу рекомендує ваш менеджер з продажу.

Мапінг готелів

Зіставте готелі Hotelbeds з готелями, які ви вже продаєте

Якщо у вас є власні контракти або другий постачальник, той самий готель надійде під різними кодами. Мапінг пов'язує їх, і гість бачить один готель з найкращим тарифом, а не три копії.

Як працює мапінг у PHPTRAVELS

Після кожної синхронізації контенту PHPTRAVELS порівнює готелі Hotelbeds з вашим списком за назвою, адресою, містом і координатами. Близькі збіги пов'язуються автоматично. Сумнівні чекають підтвердження співробітником, а готелі без збігу можна імпортувати як нові об'єкти або пропустити.

Зіставлені готелі мають спільну сторінку, галерею та рейтинг відгуків у Готелі, а кожен постачальник зберігає свої тарифи та правила. Той самий мапінг використовують ваш публічний сайт і ваш B2B тревел-портал.

Мапінг готелів
  • Harbour View HotelЛісабон48291397%Зіставлено
  • Old Town SuitesПрага11735492%Зіставлено
  • Palm Court ResortДубай66201874%Перевірити
  • Casa Azul BoutiqueСевілья–0%Немає збігу
  • Northern Lights LodgeТромсе90522766%Перевірити
  • Riverside ApartmentsБудапешт33076198%Зіставлено

Приклад екрана з вигаданими готелями та кодами.

Hotelbeds XML чи JSON

Кожен запит підписаний, а тестування починається з малого

Багато хто досі шукає Hotelbeds XML, але поточна документація показує запити в JSON. У будь-якому разі це той самий набір операцій, і кожен запит містить два заголовки.

availability-request.sh (приклад)
 1# X-Signature = SHA256(api key + secret + unix time in seconds) 2TS=$(date +%s) 3SIG=$(printf "%s%s%s" "$API_KEY" "$SECRET" "$TS" | sha256sum | cut -d" " -f1) 4 5curl -X POST https://api.test.hotelbeds.com/hotel-api/1.0/hotels \ 6  -H "Api-key: $API_KEY" \ 7  -H "X-Signature: $SIG" \ 8  -H "Accept: application/json" \ 9  -H "Content-Type: application/json" \10  -d '{11    "stay": { "checkIn": "2026-11-14", "checkOut": "2026-11-17" },12    "occupancies": [{ "rooms": 1, "adults": 2, "children": 0 }],13    "hotels": { "hotel": [482913, 117354] }14  }'1516# hotel codes come from your stored Content API data, never a live content call
Api-keyX-Signatureapi.test.hotelbeds.com
Два заголовки
Api-key з вашим ключем і X-Signature: хеш SHA256 з вашого ключа, секрету та поточного часу в секундах.
Тестовий хост
Як зазначає Hotelbeds, тестові сервери відповідають робочим, але бронювання там не справжні, а з карток нічого не списується.
50 запитів на день
Нові ключі відкривають середовище оцінювання з квотою 50 запитів на день. Більше дає сертифікація.
Без живих викликів контенту
Hotelbeds попереджає, що виклик Content API у реальному часі може призвести до блокування облікових даних. PHPTRAVELS ніколи так не робить.

Планувальник синхронізації контенту

Скільки викликів Content API потрібно для вашого списку готелів

Як зазначає Hotelbeds, список готелів надходить сторінками до 1 000 готелів, а після першого завантаження щоденний запит з lastUpdateTime повертає лише зміни. Введіть свої дані, щоб спланувати синхронізацію.

Запитів для першого повного завантаження
20
Запитів на щоденне оновлення
3
Днів на одне завантаження за квоти оцінювання
1

Лише оцінка, для списку готелів. Довідники кодів і зображення додають ще кілька викликів. За квоти оцінювання 50 запитів на день спочатку протестуйте один напрямок.

Чек-лист запуску

Що підготувати перед переходом у робочий режим

Hotelbeds переводить вас з оцінювання до сертифікації, а потім до робочих ключів через свою панель. Ось пункти, які інтеграція Hotelbeds API має закрити насамперед, і як їх закриває PHPTRAVELS.

  • Ключі оцінювання додано в адмін-панелі, обрано тестовий хост
  • Content API синхронізовано з вашою базою, щоденне оновлення заплановано
  • Готелі зіставлено з вашим списком, сумнівні збіги перевірено
  • Тарифи RECHECK проходять перевірку тарифу до оплати
  • sellingRate дотримується, коли hotelMandatory дорівнює true
  • Коментарі до тарифу та штрафи за скасування показано до оплати
  • Ваучер містить номер бронювання Hotelbeds і коментарі до тарифу
  • Скасування спочатку моделюється, потім підтверджується, штраф фіксується

Етапи сертифікації та доступ до робочого середовища Hotelbeds визначає для вашого контракту та ринку.

Вартість

Одна ліцензія на рушій, власний контракт з Hotelbeds

PHPTRAVELS продається як разова ліцензія з вихідним кодом. Hotelbeds оформлюється окремою угодою між вами та Hotelbeds, тож нетто-тарифи та ключі залишаються вашими.

Startup
Разова ліцензія
разова ліцензія
Agency
Разова ліцензія
разова ліцензія
Enterprise
Разова ліцензія
разова ліцензія

Hotelbeds є одним з кількох джерел готелів, які можна підключити паралельно. Подивіться, як він поєднується з RateHawk, в огляді туристичних API або порівняйте постачальників у розділі список XML-постачальників.

Переглянути ціниВідкрити демо готелів

FAQ

Питання про інтеграцію Hotelbeds API

Про що питають розробники та туристичні компанії перед підключенням Hotelbeds.

Відділ продажів

З двох частин. Фонова синхронізація з Content API, яка зберігає готелі, зображення, зручності, харчування та номери у вашій базі, і живий процес з Booking API для наявності, перевірки тарифу, бронювання та скасування. PHPTRAVELS виконує обидві частини у своєму модулі готелів.

Його досі називають Hotelbeds XML, але поточна документація Hotelbeds показує запити та відповіді в JSON. Операції в будь-якому разі ті самі, а формат PHPTRAVELS обробляє за вас.

Тариф BOOKABLE уже актуальний, і його можна забронювати одразу. Для тарифу RECHECK спочатку потрібен виклик перевірки тарифу, який повертає поточну ціну та умови. PHPTRAVELS робить цей виклик перед оплатою.

Це повільно, і Hotelbeds попереджає, що використання Content API у реальному часі може призвести до блокування облікових даних. Контент треба завантажувати сторінками, зберігати та оновлювати раз на день з lastUpdateTime. Саме так працює PHPTRAVELS.

Так. Ви реєструєтеся в Hotelbeds, підписуєте контракт і отримуєте власні API-ключ і секрет. Нові ключі працюють у середовищі оцінювання з лімітом 50 запитів на день, доки ви не пройдете сертифікацію.

Так. Мапінг готелів пов'язує той самий об'єкт з різних джерел, і гості бачать один готель з найкращим доступним тарифом, а кожне джерело зберігає свою націнку та правила.

Тарифи PHPTRAVELS починаються від за разову ліцензію з вихідним кодом. Контракт з Hotelbeds окремий і укладається безпосередньо з Hotelbeds. Перегляньте сторінку цін або запросіть пропозицію у відділу продажу.

Дізнайтеся більше

Ще про платформу