Демоверсія

API розміщення

API розміщення для готелів, апартаментів і житла для відпочинку

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

  • Об'єкт, юніт, тариф, календар
  • Мінімальний термін і збори
  • Вікна скасування
  • Власний фонд і API-постачальники

Модель даних

Чотири рівні всередині кожного проживання

Чи це готель на 300 номерів, чи один будинок на узбережжі, API розміщення описує його тими самими чотирма вкладеними рівнями. Кожен рівень відповідає на окреме питання, яке гість ставить перед бронюванням.

01Об'єкт

Саме місце: назва, тип, адреса й позиція на карті, фотографії, зручності, зірковість або рейтинг якості, правила проживання та час заселення.

property_id · type · address · geo · photos · amenities · check_in_from

02Номер або юніт

Те, що реально бронюється: категорія номера, ціла квартира або ліжко в спільній кімнаті, з площею, ліжками та максимальною кількістю гостей.

unit_id · beds · size_m2 · max_adults · max_children

03Тариф

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

rate_plan_id · board · cancel_policy · payment · channel

04Доступність

Один рядок на ніч: ціна, залишок юнітів, мінімальний термін проживання і чи можна цього дня заїхати або виїхати.

date · price · units_left · min_stay · closed_to_arrival

Будівля, номер, цінник і календар, намальовані як окремі накладені шари одного оголошення про проживання

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

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

Ніч за ніччю

Календар доступності вирішує, чи продасться проживання

Кожен API розміщення зрештою приходить до календаря. Пошук повертає об'єкт, лише якщо кожна ніч запитаного періоду вільна, має ціну й дозволена правилами проживання.

Двоспальні апартаменти · Стандартний тарифЛистопад 2026 · Ціна за ніч
  1. 26
  2. 27
  3. 28
  4. 29
  5. 30
  6. 31
  7. 1120
  8. 2120
  9. 3
  10. 4
  11. 5
  12. 6165
  13. 7140
  14. 8120
  15. 9
  16. 10
  17. 11
  18. 123+165
  19. 13165
  20. 14140
  21. 15120
  22. 16120
  23. 17120
  24. 18
  25. 19
  26. 20165
  27. 21140
  28. 22120
  29. 23120
  30. 24120
  31. 25120
  32. 263+165
  33. 27165
  34. 28140
  35. 29120
  36. 30120
  37. 1
  38. 2
  39. 3
  40. 4
  41. 5
  42. 6
  • Вільно, ціна за ніч
  • Уже заброньовано
  • Закрито власником
  • Мінімальний термін при заїзді цього дня
  • Заїзд закрито

Умовні дані, спрощено

  • Ціни вказано за нічПідсумок за проживання дорівнює сумі за кожну ніч, тому п'ятниця й субота за вихідним тарифом коштують дорожче за два будні. Ціни за днями та сезонами зберігаються в календарі, а не в об'єкті.
  • Правила мінімального термінуМінімум у три ночі при заїзді в п'ятницю приховує юніт із пошуку на дві ночі. Оренда використовує такі правила значно частіше за готелі, нерідко суворіші у вихідні та в сезон.
  • Заїзд або виїзд закритоНіч може бути доступна у складі довшого проживання, але не як перша чи остання. Так працюють дні зміни гостей у будинках для відпочинку.
  • Закриті ночі та стоп-сейлВласники закривають дати для особистого користування чи ремонту, а стоп-сейл миттєво знімає юніт із продажу. Будь-яка закрита ніч у запитаних датах прибирає юніт із видачі.

Не кожне житло — готель

Готелі, апартаменти й оренда для відпочинку

Модель даних спільна, але кожен вид житла заповнює її по-своєму. Ось відмінності, які має враховувати ваш процес бронювання, якщо ви продаєте не лише готельні номери.

Готелі

Зокрема хостели та гостьові будинки

Що бронюється
Категорія номера з багатьма однаковими номерами або ліжко у спільній кімнаті.
Ціна
Ціна за ніч за номер і харчування; додаткові дорослі чи діти можуть її змінювати.
Правила проживання
Мінімальний термін лише на пікові дати; більшість ночей можна бронювати окремо.
Збори та депозити
Міський або туристичний податок, іноді курортний збір, який сплачують на місці.
Заїзд
Цілодобова або обслуговувана стійка; достатньо часу заїзду у ваучері.
Типове джерело
Бедбанки й оптовики, прямі контракти, channel-менеджери.

Сервісні апартаменти

Апарт-готелі та міські квартири

Що бронюється
Тип юніта, часто з кухнею та окремими спальнями.
Ціна
Ціна за ніч за юніт, для довгого проживання є тижневі та місячні ціни.
Правила проживання
Мінімальний термін трапляється часто, а довге проживання становить велику частину попиту.
Збори та депозити
Плата за прибирання за проживання й депозит, що повертається, — звичайна справа.
Заїзд
Години роботи рецепції різні; для пізнього заїзду потрібні сейф із ключем або код.
Типове джерело
Channel-менеджери, прямі контракти та деякі оптовики.

Оренда для відпочинку

Будинки, вілли та котеджі

Що бронюється
Конкретний будинок. Зазвичай такий один.
Ціна
Ціна за ніч за весь будинок плюс доплата за кожного гостя понад базову кількість.
Правила проживання
Мінімальний термін, фіксовані дні зміни гостей і дати із закритим заїздом — норма.
Збори та депозити
Прибирання, депозит за збитки, що повертається, і місцеві податки, кожен показано до оплати.
Заїзд
Інструкції із заїзду, адресу та контакт надсилають до прибуття, а не на публічній сторінці.
Типове джерело
Власники та керуючі компанії, напряму або через channel-менеджер.

Продаєте будинки різних господарів, а не за власними контрактами? Це маркетплейс, його описано на сторінці BnB-портал.

Вікна скасування

Одне бронювання, три вікна скасування

Умови скасування — це шкала часу, що відлічується назад від дати заїзду. Кожне вікно визначає, що повернеться гостю, якщо він скасує бронювання всередині нього.

БронюванняЗаїзд
  1. 01 · До 14 днів до заїздуБезкоштовне скасуванняГість скасовує й отримує повне відшкодування. Саме цей термін мандрівники шукають насамперед, тож показуйте його датою, а не правилом.
  2. 02 · Від 14 до 3 днів до заїздуЧасткова неустойкаДіє неустойка, часто це перша ніч або відсоток від вартості. В оренді в цьому вікні депозит можуть утримати.
  3. 03 · Останні 3 дні та незаїздБез поверненняУтримується вся сума. Тарифи без повернення потрапляють у це вікно з моменту бронювання.
Приклади вікон; кожен тариф має власні.
  • На тариф, а не на об'єктВ одних і тих самих апартаментах можуть бути гнучкий тариф і дешевший невідшкодовуваний, тому умови належать до рівня тарифу.
  • Дати в часовому поясі об'єкта«За 14 днів» відлічується від дати заїзду за часом місця, де розташований об'єкт. Перетворіть це на чітку дату й час на сторінці та у ваучері.
  • Пріоритет умов постачальникаЗ API-фондом не можна пропонувати м'якші умови, ніж дає постачальник. Зі власними контрактами вікна ви задаєте самі.

Власний фонд і API-фонд

Ваші об'єкти за контрактами та API постачальників в одному пошуку

Більшість продавців житла роблять і те, і те: завантажують об'єкти, з якими уклали договори самі, а решту добирають через API постачальників. Мандрівник не повинен помічати, звідки прийшло житло.

Ваші об'єкти

  • Завантажуйте об'єкти, юніти й тарифи самі в адмінпанелі
  • Дайте власникам і готелям вхід в екстранет для керування календарем
  • Задавайте ціни, мінімальний термін, закриті дати та вікна скасування
  • Аллотменти зі строками зняття та стоп-сейлом
  • Або отримуйте тарифи й доступність із channel-менеджера

Фонд API-постачальників

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

Що отримує гість

  • Один список результатів і одна сторінка об'єкта на кожне місце
  • Один і той самий номер із кількох джерел показується один раз за вашою ціною
  • Ваші націнки за постачальником, напрямком чи каналом і B2B-тарифи для агентів
  • Один формат ваучера, яке б джерело не підтвердило бронь

Підключення channel-менеджера описано на сторінці Інтеграція з channel manager. Про номери, які ви тримаєте за контрактом, читайте в розділі Система інвентарю бронювань.

Готово в PHPTRAVELS

Уже підключені постачальники житла

Ці постачальники розміщення вже підключені до модуля Stays. Ви укладаєте договір із постачальником, вводите свої ключі в адмінпанелі, тестуєте в його пісочниці й запускаєтеся. Список підтягується в реальному часі з нашого каталогу інтеграцій.

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

Забронюйте житло так, як це зроблять ваші гості

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

Відкрити живе демоОбговорити постачальників

Створюєте власний застосунок або фід для партнерів? REST API PHPTRAVELS віддає всі підключені джерела житла в одному форматі та підтримує вебхуки подій бронювання. Він входить у план Enterprise, див. Ціни і документація для розробників. Загальну картину описано на сторінці Travel API.

Запитання та відповіді

API розміщення: запитання розробників і агенцій

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

API розміщення — це набір вебсервісів, за допомогою якого сайт бронювання шукає житло, отримує ціни й доступність на задані дати та кількість гостей, а також створює, читає й скасовує бронювання. Він охоплює готелі та будь-яке інше житло: апартаменти, оренду для відпочинку, хостели й гостьові будинки.

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

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

Для кожної ночі в календарі можна задати мінімальну тривалість проживання, зазвичай прив'язану до дати заїзду. Якщо гість шукає менше ночей, ніж потрібно, юніт не повертається. Прапорці закритого заїзду й закритого виїзду працюють так само для днів зміни гостей.

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

З тарифу. Фонд постачальників має умови постачальника, ваші об'єкти — вікна, які задали ви. Крайній термін показується гостю до оплати й друкується у ваучері.

Ні. Ви укладаєте договір з кожним постачальником житла та вводите свої ключі в адмінпанелі. PHPTRAVELS надає платформу бронювання, модуль Stays і готові конектори.

Так. У плані Enterprise REST API PHPTRAVELS відкриває пошук і бронювання за всіма підключеними джерелами в одному форматі, з вебхуками подій бронювання та повним вихідним кодом для розширення.

Ліцензія PHPTRAVELS, ваш домен і принаймні одне джерело фонду: об'єкти, з якими ви уклали договори самі, channel-менеджер або договір з оптовиком із розміщення. Увесь процес спершу можна побачити в живому демо.

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

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