Демоверсия

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
  • Коннектор сопоставляет рейсы, категории и каюты
  • Бронирования, платежи и отмены подчиняются правилам линии

Ищете поставщиков? В Список XML API поставщиков собраны круизные линии, работающие через API, а Что такое интеграция API объясняет, как строится такое подключение.

Посмотрите, как работает бронирование круизов

Откройте живую демоверсию: найдите рейсы, сравните категории кают и забронируйте с депозитом, а затем сравните тарифы на странице Цены.

Вопросы и ответы

Вопросы об API круизов

Отдел продаж

API круизов — это набор веб-сервисов, которые круизная линия или консолидатор открывает для продавцов туров. С его помощью ваша система ищет рейсы, читает маршруты, считает цены по категориям кают, выводит свободные каюты, оформляет бронирования и принимает депозиты и окончательные платежи.

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

Вы подаёте заявку круизной линии или консолидатору как продавец туров. Условия доступа зависят от линии и рынка. Договор вы подписываете и учётные данные получаете сами; PHPTRAVELS никогда не предоставляет учётные данные поставщиков.

Гарантированное бронирование закрепляет категорию каюты по оговорённой цене, а конкретную каюту линия назначает позже, этой же или более высокой категории. При бронировании конкретной каюты её номер фиксируется в момент брони.

Их определяет круизная линия для каждого рейса и тарифа, а её API возвращает данные вместе с бронированием. Для рейсов, которые вы загружаете сами, депозит и срок оплаты остатка вы задаёте в админке по каждому рейсу.

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

Да. Агенты бронируют в B2B-портале по своим нетто-тарифам и комиссиям и платят из кошелька агента, на той же установке, что и ваш публичный сайт.

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

Начните с рейсов, которые у вас уже законтрактованы: загрузите их в модуль круизов и посмотрите, как они продаются. Когда партнёрство с линией или объёмы это оправдают, подключите её API через индивидуальную интеграцию.