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
D1Southampton--:-- · 17:00
D2Na morzu
D3Brugia (Zeebrugge)08:00 · 18:00
D4Amsterdam09:00 · 19:00
D5Na morzu
D6Kopenhaga07:00 · 17:00
D7Oslo09:00 · 16:00
D8Southampton07:00 · --:--
Rekord poglądowy, nie format żadnego konkretnego 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.
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
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
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
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
Korytarz
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.Wypisz kabinyGdy gość wybierze kategorię, platforma pyta armatora o wolne kabiny w jej ramach i rysuje je na pokładzie.
2.Zablokuj kabinęWiele API rejsów pozwala krótko zablokować wybraną kabinę, gdy gość wpisuje dane i płaci.
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ą.
01
Rezerwacja i zaliczka
Gość wpłaca zaliczkę ustaloną przez armatora, za osobę lub za rezerwację, aby potwierdzić kabinę.
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.
03
Dokumenty
Po pełnej wpłacie armator udostępnia dokumenty rejsu, a gość uzupełnia dane do odprawy.
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.
A
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.
B
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.
C
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.
D
Ś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
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.
Używamy plików cookie Google, aby mierzyć, które reklamy przyciągają odwiedzających i zapytania, oraz aby wyświetlać Państwu odpowiednie reklamy. Mogą Państwo je zaakceptować lub odrzucić, aby zachować tylko pliki cookie niezbędne do działania witryny. Oświadczenie o prywatności