Демоверсія

API бронювання круїзів

API круїзів для агенцій: рейси, каюти та графіки платежів

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

  • Рейси та маршрути
  • Категорії кают і плани палуб
  • Депозити та остаточна оплата
  • Індивідуальні круїзні інтеграції

Що повертає API круїзів

Один рейс у вигляді даних

Круїз продається як рейс: одне судно, один маршрут, одна дата відправлення. Будь-який API круїзів, у якому б форматі він не був, побудований навколо цієї одиниці.

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

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

Круїзна лінія

Ваша лінія-партнер

Судно-партнер · 7 ночей

Є місця
Посадка
2027-05-15
Повернення
2027-05-22

Маршрут

  1. D1Саутгемптон--:-- · 17:00
  2. D2У морі
  3. D3Брюгге (Зебрюгге)08:00 · 18:00
  4. D4Амстердам09:00 · 19:00
  5. D5У морі
  6. D6Копенгаген07:00 · 17:00
  7. D7Осло09:00 · 16:00
  8. D8Саутгемптон07:00 · --:--
Стартова цінана людину, за розміщення вдвохEUR 899

Умовний запис, а не формат якоїсь конкретної круїзної лінії.

Одна платформа бронювання круїзів отримує рейси, категорії кают і ціни із системи круїзної лінії

Категорії кают

Чотири сходинки на борту: внутрішня, з вікном, з балконом, сюїт

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

  1. 01ВнутрішняБез вікна

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

    Рівень ціни
  2. 02З видом на мореВікно або ілюмінатор

    Крок угору заради природного світла. У деяких категорій вид частково закритий, і API позначає це в описі категорії.

    Рівень ціни
  3. 03З балкономВласний балкон

    Особистий простір просто неба. Категорії відрізняються висотою палуби та розташуванням посередині чи на кормі.

    Рівень ціни
  4. 04СюїтБалкон і вітальня

    Верх прайс-листа: до тарифу часто додаються додаткові опції, а продаються такі каюти найчастіше як конкретний номер.

    Рівень ціни

Коди категорій і тарифів

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

Гарантована чи конкретна каюта

За гарантованого бронювання гість купує категорію, а лінія пізніше призначає каюту цієї чи вищої категорії. За бронювання конкретної каюти її номер фіксується одразу. Багато ліній оцінюють ці варіанти по-різному.

Вибір каюти

Оберіть каюту на плані палуби

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

Палуба 9

Виберіть каюту

НісКорма
0814
242636
29
011119
  • Внутрішня
  • З видом на море
  • З балконом
  • Сюїт
  • Недоступна

Каюта 9110

Внутрішня

Внутрішня каюта з найнижчою ціною на цій палубі. Продається як конкретна каюта або за гарантією.

З видом на море

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

З балконом

Каюта з балконом посередині судна. Розташування на палубі нерідко виділяють в окрему категорію зі своєю ціною.

Сюїт

Сюїт із великим балконом, що виходить на корму. Зазвичай бронюється як конкретна каюта, а не за гарантією.

  1. 1.Список каютКоли гість обрав категорію, платформа запитує в лінії вільні каюти в ній і малює їх на палубі.
  2. 2.Утримання каютиУ багатьох API круїзів вибрану каюту можна ненадовго утримати, поки гість вводить імена й оплачує.
  3. 3.БронюванняБронювання фіксує номер каюти, гостей і код тарифу, а лінія повертає свій номер броні.

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

Графік платежів

Спершу депозит, решта до відплиття

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

  1. 01

    Бронювання та депозит

    Щоб підтвердити каюту, гість вносить депозит, розмір якого визначає лінія, на людину або на бронювання.

  2. 02

    Строк остаточної оплати

    Решту потрібно оплатити до дати, яку лінія призначає перед відправленням. Після неї лінія може анулювати неоплачені бронювання.

  3. 03

    Документи

    Після повної оплати лінія видає круїзні документи, а гість заповнює дані для реєстрації.

  4. 04

    День відплиття

    Гість піднімається на борт. Зміни після цього вирішуються на судні або за правилами лінії.

Штрафи за скасування за періодами

Період депозитуШтраф зростаєМаксимальний штраф

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

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

Ціни в круїзах

Як формується ціна круїзу

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

Поверх ціни лінії PHPTRAVELS застосовує ваші націнки та комісії за судном, рейсом або каналом, а агенти в B2B тревел-портал бачать власні нетто-тарифи.

  • За людину, а не за каюту

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

  • Основа: двомісне розміщення

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

  • Податки, збори та портові платежі

    Державні податки, збори й портові платежі додаються на людину понад круїзний тариф. Показуйте їх окремими рядками, щоб в остаточній сумі не було сюрпризів.

  • Бортовий кредит і додатки

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

Як отримати круїзний інвентар

Власні контракти або API круїзної лінії

Є два шляхи, щоб круїзи з'явилися на вашому сайті. Багато агенцій починають із першого й підключають другий, коли обсяги це виправдовують.

Готово в модулі круїзів

Завантажте власні круїзні контракти

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

  • Групові місця й квоти, які ви тримаєте
  • Комісія за кожною круїзною лінією
  • Нетто-тарифи для B2B-агентів
  • Працює з першого дня після встановлення
Індивідуальна інтеграція

Підключіть API круїзної лінії або консолідатора

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

  • Ви укладаєте договір із лінією або консолідатором
  • Ви самі отримуєте й зберігаєте облікові дані API
  • Конектор зіставляє рейси, категорії та каюти
  • Бронювання, платежі й скасування підпорядковуються правилам лінії

Шукаєте постачальників? У Список постачальників travel XML API зібрано круїзні лінії, що працюють через API, а Що таке інтеграція API пояснює, як будується таке підключення.

Подивіться, як працює бронювання круїзів

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

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

Запитання про API круїзів

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

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

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

Ви подаєте заявку круїзній лінії або консолідатору як продавець турів. Умови доступу залежать від лінії та ринку. Договір ви підписуєте й облікові дані отримуєте самі; PHPTRAVELS ніколи не надає облікових даних постачальників.

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

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

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

Так. Агенти бронюють у B2B-порталі за власними нетто-тарифами та комісіями й платять із гаманця агента, на тій самій інсталяції, що й ваш публічний сайт.

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

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