Demo na żywo

API rezerwacji rejsów

API rejsów dla biur podróży: rejsy, kabiny i harmonogramy płatności

API rejsów pozwala Twojej stronie pokazywać aktualne rejsy, wyceniać kategorie kabin i tworzyć rezerwacje u armatora. Ta strona wyjaśnia, jak wyglądają dane, jak działają kabiny i płatności oraz na jakie dwa sposoby dodać ofertę rejsów do własnej strony PHPTRAVELS.

  • Rejsy i trasy
  • Kategorie kabin i plany pokładów
  • Zaliczki i płatność końcowa
  • Integracje rejsów na zamówienie

Co zwraca API rejsów

Jeden rejs opisany danymi

Rejs sprzedaje się jako pojedynczy termin: jeden statek, jedna trasa, jedna data wypłynięcia. Każde API rejsów, niezależnie od formatu, jest zbudowane wokół tej jednostki.

Wyszukiwanie przekazuje region, miesiąc lub zakres dat, długość rejsu i liczbę pasażerów. Odpowiedzią jest lista rejsów, a w każdym statek, armator, daty wejścia na pokład i powrotu, porty zawinięcia z godzinami, dni na morzu oraz cena wyjściowa za osobę dla każdej wciąż dostępnej kategorii kabin.

Następne zapytania wyceniają wybraną kategorię dla prawdziwych pasażerów, wypisują kabiny do wyboru, składają rezerwację i przyjmują płatności. Nazwy i formaty różnią się między armatorami, dlatego platforma sprowadza każde źródło do jednego modelu rejsu, kabiny i rezerwacji, zanim zobaczy go gość.

Armator

Twój armator partnerski

Statek partnerski · 7 nocy

Dostępny
Wejście na pokład
2027-05-15
Powrót
2027-05-22

Trasa

  1. D1Southampton--:-- · 17:00
  2. D2Na morzu
  3. D3Brugia (Zeebrugge)08:00 · 18:00
  4. D4Amsterdam09:00 · 19:00
  5. D5Na morzu
  6. D6Kopenhaga07:00 · 17:00
  7. D7Oslo09:00 · 16:00
  8. D8Southampton07:00 · --:--
Cena wyjściowaza osobę, dwie osoby w kabinieEUR 899

Rekord poglądowy, nie format żadnego konkretnego armatora.

Platforma rezerwacji rejsów odbierająca rejsy, kategorie kabin i ceny z systemu armatora

Kategorie kabin

Cztery stopnie na statku: wewnętrzna, z widokiem na morze, z balkonem, apartament

Pod każdym rejsem API rejsów wypisuje kategorie kabin. To one w największym stopniu kształtują cenę, a każda zmienia kilka rzeczy naraz.

  1. 01WewnętrznaBez okna

    Cena wejściowa rejsu. Armatorzy często dzielą ją na kilka kategorii według pokładu i położenia, każda z własnym kodem.

    Poziom ceny
  2. 02Z widokiem na morzeOkno lub bulaj

    Wyższy stopień dzięki naturalnemu światłu. Niektóre kategorie mają ograniczony widok, co API oznacza w opisie kategorii.

    Poziom ceny
  3. 03Z balkonemPrywatny balkon

    Prywatna przestrzeń na zewnątrz, z kategoriami zależnymi od wysokości pokładu oraz położenia na śródokręciu lub na rufie.

    Poziom ceny
  4. 04ApartamentBalkon i część dzienna

    Szczyt cennika, często z dodatkami wliczonymi w cenę, oraz kategorie najczęściej sprzedawane jako konkretna kabina.

    Poziom ceny

Kody kategorii i kody taryf

Każda kategoria ma kod, a każdy rejs można sprzedawać według kilku kodów taryf: standardowych, promocyjnych oraz grupowych lub agencyjnych. Ta sama kabina może mieć różne ceny i warunki w zależności od kodu taryfy.

Gwarantowana lub konkretna kabina

Przy rezerwacji gwarantowanej gość kupuje kategorię, a armator przydziela kabinę później, w tej kategorii lub wyższej. Rezerwacja konkretnej kabiny ustala jej numer w chwili rezerwacji. Wielu armatorów wycenia te opcje inaczej.

Wybór kabiny

Wybierz kabinę na planie pokładu

Gdy armator pozwala rezerwować konkretną kabinę, API zwraca kabiny wciąż dostępne w wybranej kategorii wraz z pokładem, położeniem i liczbą osób, które każda mieści.

Pokład 9

Wybierz kabinę

DzióbRufa
0814
242636
29
011119
  • Wewnętrzna
  • Z widokiem na morze
  • Z balkonem
  • Apartament
  • Niedostępna

Kabina 9110

Wewnętrzna

Kabina wewnętrzna, najniższa cena na tym pokładzie. Sprzedawana jako konkretna kabina lub gwarantowana.

Z widokiem na morze

Kabina z oknem na dziobie, tam gdzie kadłub się zwęża. API zwraca uwagę o widoku razem z kategorią.

Z balkonem

Kabina z balkonem na śródokręciu. Położenie na pokładzie często tworzy osobną kategorię z własną ceną.

Apartament

Apartament skierowany na rufę z większym balkonem. Zwykle rezerwowany jako konkretna kabina, nie gwarantowana.

  1. 1.Wypisz kabinyGdy gość wybierze kategorię, platforma pyta armatora o wolne kabiny w jej ramach i rysuje je na pokładzie.
  2. 2.Zablokuj kabinęWiele API rejsów pozwala krótko zablokować wybraną kabinę, gdy gość wpisuje dane i płaci.
  3. 3.ZarezerwujRezerwacja potwierdza numer kabiny, pasażerów i kod taryfy, a armator zwraca swój numer rezerwacji.

W module Rejsy PHPTRAVELS statki mają własne pokłady i kategorie kabin, a goście wybierają, mając przed oczami wszystkie fakty, niezależnie od tego, czy kabiny są Twoje, czy pochodzą od podłączonego armatora.

Harmonogram płatności

Zaliczka teraz, reszta przed rejsem

Rejsy rezerwuje się z miesięcznym wyprzedzeniem i płaci w ratach. Armator ustala terminy i kwoty dla każdego rejsu i taryfy, a API zwraca je razem z rezerwacją.

  1. 01

    Rezerwacja i zaliczka

    Gość wpłaca zaliczkę ustaloną przez armatora, za osobę lub za rezerwację, aby potwierdzić kabinę.

  2. 02

    Płatność końcowa

    Pozostała kwota jest płatna do daty wyznaczonej przez armatora przed wypłynięciem. Nieopłacone rezerwacje armator może anulować po tym terminie.

  3. 03

    Dokumenty

    Po pełnej wpłacie armator udostępnia dokumenty rejsu, a gość uzupełnia dane do odprawy.

  4. 04

    Dzień wypłynięcia

    Gość wchodzi na pokład. Zmiany od tej chwili załatwia się na statku lub według zasad armatora.

Opłaty za rezygnację według okresu

Okres zaliczkiOpłata rośnieNajwyższa opłata

Im bliżej wypłynięcia, tym większą część ceny zatrzymuje się przy rezygnacji. Okresy i wartości procentowe zależą od armatora i taryfy, więc API rejsów wysyła je z rezerwacją, a Twoja platforma pokazuje je gościowi przed płatnością.

Gdy sprzedajesz rejsy kontraktowane samodzielnie, Rejsy działa tak samo: ustalasz zaliczkę i termin dopłaty dla każdego rejsu, a niezapłacone salda są śledzone w panelu administracyjnym do czasu wpłaty.

Ceny w rejsach

Jak powstaje cena rejsu

Ceny rejsów czyta się inaczej niż ceny hoteli czy lotów. API rejsów zwraca składniki osobno, a Twój system rezerwacji musi je złożyć tak samo jak armator.

Na cenie armatora PHPTRAVELS nakłada Twoje marże i prowizje według statku, rejsu lub kanału, a agenci w Portal turystyczny B2B widzą własne ceny netto.

  • Za osobę, nie za kabinę

    Ceny rejsów podaje się za pasażera. Kabina dla dwóch osób kosztuje dwukrotność ceny za osobę, a API wycenia każdego pasażera według wieku i miejsca w kabinie.

  • Na podstawie zakwaterowania we dwoje

    Ceny wyjściowe zakładają dwóch pasażerów w kabinie. Trzecia i czwarta osoba zwykle płacą niższą stawkę, a osoba podróżująca samotnie dopłaca dodatek za pojedyncze zakwaterowanie.

  • Podatki, opłaty i opłaty portowe

    Podatki państwowe, opłaty i opłaty portowe są doliczane od osoby do ceny rejsu. Pokaż je w osobnych wierszach, aby suma nie zaskakiwała.

  • Środki na pokładzie i dodatki

    Niektóre taryfy obejmują środki na pokładzie, pakiet napojów lub napiwki. API zwraca je jako elementy wliczone w taryfę i to jeden z powodów, dla których dwie taryfy na tę samą kabinę się różnią.

Skąd wziąć ofertę rejsów

Własne kontrakty lub API armatora

Rejsy na Twojej stronie można mieć na dwa sposoby. Wiele biur zaczyna od pierwszego i dodaje drugi, gdy uzasadnia to wolumen.

Gotowe w module Rejsy

Wczytaj własne kontrakty na rejsy

Wprowadź w panelu rejsy, które kontraktujesz: statki, pokłady, kategorie kabin, trasy port po porcie, daty wypłynięcia, ceny za osobę, sezony, zaliczki i terminy dopłat. Partnerzy rejsowi mogą dostać login dostawcy, by samodzielnie aktualizować swoje rejsy.

  • Pule grupowe i kontyngenty, które posiadasz
  • Prowizja według armatora
  • Ceny netto dla agentów B2B
  • Działa od dnia instalacji
Integracja na zamówienie

Podłącz API armatora lub konsolidatora

Na liście integracji PHPTRAVELS nie ma gotowego konektora rejsów. Ponieważ każdy plan zawiera pełny kod źródłowy, API armatora lub konsolidatora rejsów podłącza się jako Integracja API na zamówienie, odwzorowane na te same rejsy, kabiny i rezerwacje, które moduł już pokazuje.

  • Podpisujesz umowę z armatorem lub konsolidatorem
  • Otrzymujesz i przechowujesz dane dostępowe do API
  • Konektor odwzorowuje rejsy, kategorie i kabiny
  • Rezerwacje, płatności i anulacje podlegają zasadom armatora

Szukasz dostawców? Lista dostawców travel XML API wymienia armatorów, którzy dystrybuują przez API, a Czym jest integracja API wyjaśnia, jak buduje się takie połączenie.

Zobacz, jak działa rezerwacja rejsu

Otwórz demo na żywo, aby wyszukać rejsy, porównać kategorie kabin i zarezerwować z zaliczką, a potem porównaj plany na stronie Cennik.

FAQ

Pytania o API rejsów

Kontakt ze sprzedażą

API rejsów to zestaw usług sieciowych, które armator lub konsolidator rejsów udostępnia sprzedawcom podróży. Twój system używa go do wyszukiwania rejsów, odczytu tras, wyceny kategorii kabin, wypisywania dostępnych kabin, składania rezerwacji oraz przyjmowania zaliczek i płatności końcowych.

Nie. Moduł Rejsy opiera się na ofercie, którą zarządzasz sam: statkach, kategoriach kabin i rejsach, które kontraktujesz. Połączenie z konkretnym armatorem lub konsolidatorem powstaje jako integracja na zamówienie na bazie dołączonego kodu źródłowego.

Zgłaszasz się do armatora lub konsolidatora rejsów jako sprzedawca podróży. Warunki dostępu różnią się według armatora i rynku. Umowę podpisujesz i dane dostępowe odbierasz sam; PHPTRAVELS nigdy nie dostarcza danych dostępowych dostawców.

Rezerwacja gwarantowana zabezpiecza kategorię kabiny po ustalonej cenie, a armator przydziela konkretną kabinę później, w tej kategorii lub wyższej. Rezerwacja konkretnej kabiny ustala jej numer w chwili rezerwacji.

Ustala je armator dla każdego rejsu i taryfy, a jego API zwraca je razem z rezerwacją. Dla rejsów, które wprowadzasz sam, zaliczkę i termin dopłaty ustawiasz w panelu dla każdego rejsu.

Ceny rejsów podaje się za pasażera, zwykle przy założeniu dwóch osób w kabinie. Trzecia i czwarta osoba płacą własne stawki, osoba podróżująca samotnie dopłaca za pojedyncze zakwaterowanie, a podatki, opłaty i opłaty portowe są doliczane od osoby.

Tak. Agenci rezerwują w portalu B2B po własnych cenach netto i z własnymi prowizjami, a płacą z portfela agenta, w tej samej instalacji co Twoja strona publiczna.

Plan Enterprise zawiera REST API i webhooki PHPTRAVELS wraz z dokumentacją, a każdy plan zawiera pełny kod źródłowy, więc Twoi programiści mogą rozbudować system rezerwacji rejsów lub połączyć go z innymi systemami.

Zacznij od rejsów, które już kontraktujesz, wczytanych do modułu Rejsy, i sprawdź, jak się sprzedają. Gdy współpraca z armatorem lub wolumen to uzasadni, dodaj API tego armatora przez integrację na zamówienie.