Демоверсія

API бронювання поромів

API поромів для агенцій і OTA: рейси, авто й квитки

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

  • Розклад і наявність місць
  • Авто, каюти й тварини
  • Електронні квитки та реєстрація
  • Подорож островами

Що це

API порому описує мережу портів, а не список продуктів

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

Приклад маршруту

  1. ПірейПорт на материкуДілянка 1 · кілька операторів
  2. НаксосОстрівний вузолДілянка 2 · сезонні рейси
  3. СанторініОстрів

  • 01Порти

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

  • 02Маршрути

    Лінії, що з’єднують два порти. Форма пошуку пропонує лише ті пари, якими підключений оператор справді ходить, тож пошуку неіснуючої переправи не буде.

  • 03Рейси

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

Лінія маршруту від порту на материку до двох островів: рейси, авто й квитки проходять між платформою бронювання та поромними операторами

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

Розклад і наявність місць

Два запити заповнюють табло відправлень

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

Відправлення · ПірейПт, 14 лист.
ВідправленняКудиСудноУ дорозіНаявність місць
07:00НаксосШвидкісний пором3 год 35 хвУ продажуЛише місця, без авто
07:25НаксосРо-пакс пором5 год 40 хвУ продажуМісця та стоянка для авто
07:30МіконосРо-пакс пором5 год 15 хвОстанні місцяМісця та стоянка для авто
13:00ПаросКатамаран3 год 10 хвУ продажуЛише місця, без авто
17:30СанторініРо-пакс пором7 год 50 хвОстанні місцяОстанні каюти
21:00ІракліонКруїзний пором9 год 00 хвМісць немаєЗапропоновано наступний рейс

Ілюстративні дані, спрощено

  1. Розклад

    Які рейси йдуть

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

  2. Наявність місць

    Чи є місце на борту

    Місця на палубі, крісла, каюти й смуги для авто — окремі місткості. На рейсі можуть лишитися крісла, але не бути місця для авто, тому перевірка йде для точної групи й транспорту.

  3. Ціна

    Скільки платить ця група

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

Чим пороми відрізняються

Бронь порому охоплює людей, транспорт і місце для сну

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

Пірей → Наксос · Пт, 14 лист. · 07:25Навіщо це API

01Пасажири за типами

  • Дорослий2
  • Дитина1
  • Немовля0
  • Пенсіонер0

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

02Транспорт

Легкове автоМотоциклКемпер
Довжина
До 5 м
Висота
Нижче 2 м

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

03На борту

  • ПалубаВільна посадка
  • Місце за квиткомЗ номером
  • КаютаСпальні місця, ціна за каюту

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

04Тварини

1 собака, у переноску

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

Разом для цієї групи–Портові збори включено

Ілюстративна форма, спрощено

Після бронювання

Видача квитків і реєстрація

Продаж порому не завершується оплатою. Мандрівникові ще треба сісти на борт, плани змінюються, а останнє слово буває за морем. Цим разом займаються API порому й ваша платформа.

  • Електронний квиток

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

  • Посадка в порту

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

  • Кінцеві терміни реєстрації

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

  • Зміни

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

  • Скасування через погоду

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

  • Скасування та повернення коштів

    Кожен тариф має власне правило повернення. Показуйте його до оплати, щоб мандрівник знав, що купив, і повертайте гроші тим самим способом оплати.

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

Готово в PHPTRAVELS

Поромні конектори, які ви вмикаєте зі своїм акаунтом

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

Інші способи заповнити табло

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

Подорож островами

Кілька ділянок, одна подорож, одна оплата

Подорож островами рідко обмежується однією переправою. Мандрівник прилітає, добирається до порту, пливе на один острів і далі на наступний. Об’єднання цих ділянок і є тією вигодою від API поромів у повноцінній платформі бронювання.

  • Перевірка стикуваньКожна ділянка може початися лише після прибуття попередньої із заданим вами мінімальним інтервалом, тому в подорожі не буває неможливих стикувань.
  • Одна оплатаДілянки можуть бути від різних операторів і джерел, але клієнт платить один раз і отримує квиток на кожну ділянку.
  • Дані переходять даліПасажири й авто переходять з ділянки на ділянку, і нікому не доводиться вводити одні й ті самі дані двічі.

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

  1. Переліт до АфінАвіаділянка від будь-якого підключеного постачальника авіаквитків.
  2. З аеропорту до ПіреяТрансфер з аеропорту до поромного терміналу.
  3. Пірей → НаксосПерша переправа з авто та двома дорослими на борту.
  4. 3 ночі на НаксосіПроживання в готелі між двома переправами.
  5. Наксос → СанторініДруга переправа, можливо, іншого оператора.

Запустіть API поромів на своєму сайті

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

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

Спробувати живе демоЗапитати про ваші маршрути

FAQ

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

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

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

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

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

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

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

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

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

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

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

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

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