Live demo

Cruise-boeking-API

Cruise-API voor reisbureaus: afvaarten, hutten en betaalschema's

Met een cruise-API toont uw website actuele afvaarten, prijst hutcategorieën en maakt cruiseboekingen aan bij de rederij. Deze pagina legt uit hoe de data eruitziet, hoe hutten en betalingen werken en welke twee wegen er zijn om cruiseaanbod op uw eigen PHPTRAVELS-site te krijgen.

  • Afvaarten en routes
  • Hutcategorieën en dekplattegronden
  • Aanbetaling en restbetaling
  • Maatwerk cruise-integraties

Wat een cruise-API teruggeeft

Eén afvaart, beschreven in data

Een cruise wordt verkocht als afvaart: één schip, één route, één vertrekdatum. Elke cruise-API, in welk formaat ook, is rond deze eenheid gebouwd.

Een zoekopdracht stuurt een regio, een maand of periode, de duur en het aantal gasten mee. Het antwoord is een lijst afvaarten, elk met schip, rederij, in- en uitscheepdatum, de aanloophavens met tijden, de dagen op zee en een vanafprijs per persoon voor elke nog open hutcategorie.

Daarna prijzen verdere aanroepen de gekozen categorie voor de echte gasten, tonen ze de te kiezen hutten, plaatsen ze een boeking en verwerken ze betalingen daarop. Namen en formaten verschillen per rederij, dus een platform zet elke bron om naar hetzelfde model van afvaart, hut en boeking voordat een gast het ziet.

Rederij

Uw partnerrederij

Partnerschip · 7 nachten

Open
Inscheping
2027-05-15
Terugkeer
2027-05-22

Route

  1. D1Southampton--:-- · 17:00
  2. D2Op zee
  3. D3Brugge (Zeebrugge)08:00 · 18:00
  4. D4Amsterdam09:00 · 19:00
  5. D5Op zee
  6. D6Kopenhagen07:00 · 17:00
  7. D7Oslo09:00 · 16:00
  8. D8Southampton07:00 · --:--
Vanafprijsper persoon, twee personen per hutEUR 899

Illustratief record, niet het formaat van één bepaalde rederij.

Eén cruiseboekingsplatform dat afvaarten, hutcategorieën en prijzen ontvangt uit het systeem van een rederij

Hutcategorieën

Vier treden op het schip: binnen, buitenhut, balkon, suite

Onder elke afvaart toont een cruise-API hutcategorieën. Ze bepalen vooral de prijs, en elke categorie verandert meerdere dingen tegelijk.

  1. 01BinnenhutGeen raam

    De instapprijs van de afvaart. Rederijen splitsen die vaak in meerdere categorieën naar dek en ligging, elk met een eigen code.

    Prijsniveau
  2. 02BuitenhutRaam of patrijspoort

    Een stap hoger voor daglicht. Sommige categorieën hebben beperkt uitzicht, wat de API in de categoriebeschrijving aangeeft.

    Prijsniveau
  3. 03BalkonEigen balkon

    Een eigen buitenruimte, met categorieën die wisselen naar dekhoogte en ligging midscheeps of achter.

    Prijsniveau
  4. 04SuiteBalkon en zitgedeelte

    De top van de prijslijst, vaak met extra's in het tarief, en de categorieën die het vaakst als vaste hut worden verkocht.

    Prijsniveau

Categoriecodes en tariefcodes

Elke categorie heeft een code, en elke afvaart kan onder meerdere tariefcodes worden verkocht: standaardtarieven, actietarieven en groeps- of agentuurtarieven. Dezelfde hut kan per tariefcode andere prijzen en voorwaarden hebben.

Gegarandeerd of vaste hut

Bij een gegarandeerde boeking koopt de gast een categorie en wijst de rederij de hut later toe, in die categorie of beter. Bij een vaste hut ligt het hutnummer bij het boeken al vast. Veel rederijen prijzen beide verschillend.

Hutkeuze

Kies de hut op de dekplattegrond

Als de rederij het boeken van een vaste hut toestaat, geeft de API de nog beschikbare hutten in de gekozen categorie terug, met dek, ligging en hoeveel gasten er slapen.

Dek 9

Selecteer een hut

VoorAchter
0814
242636
29
011119
  • Binnenhut
  • Buitenhut
  • Balkon
  • Suite
  • Niet beschikbaar

Hut 9110

Binnenhut

Binnenhut, de laagste prijs op dit dek. Verkocht als vaste hut of als gegarandeerde boeking.

Buitenhut

Hut met raam aan de voorkant, waar de romp bocht maakt. De API geeft de uitzichtopmerking mee met de categorie.

Balkon

Balkonhut midscheeps. De ligging op het dek is vaak een aparte categorie met een eigen prijs.

Suite

Suite aan de achterzijde met groter balkon. Meestal geboekt als vaste hut, niet als gegarandeerde boeking.

  1. 1.Hutten tonenNadat de gast een categorie heeft gekozen, vraagt het platform de rederij om de open hutten daarin en tekent ze op het dek.
  2. 2.Hut vasthoudenVeel cruise-API's laten u de gekozen hut kort vasthouden terwijl de gast namen invult en betaalt.
  3. 3.BoekenDe boeking bevestigt hutnummer, gasten en tariefcode, en de rederij geeft haar boekingsreferentie terug.

In de Cruises van PHPTRAVELS hebben schepen hun dekken en hutcategorieën en kiezen gasten met alle feiten voor zich, of de hutten nu van u zijn of van een gekoppelde rederij komen.

Betaalschema

Nu een aanbetaling, de rest voor vertrek

Cruises worden maanden vooruit geboekt en in termijnen betaald. De rederij bepaalt de data en bedragen per afvaart en tarief, en de API geeft ze mee met de boeking.

  1. 01

    Boeking en aanbetaling

    De gast betaalt een door de rederij bepaalde aanbetaling, per persoon of per boeking, om de hut te bevestigen.

  2. 02

    Restbetaling verschuldigd

    Het saldo is verschuldigd op een datum die de rederij voor vertrek vaststelt. Onbetaalde boekingen kan de rederij daarna annuleren.

  3. 03

    Documenten

    Zodra alles is betaald, geeft de rederij de cruisedocumenten vrij en vult de gast de incheckgegevens aan.

  4. 04

    Vertrekdag

    De gast gaat aan boord. Wijzigingen daarna worden aan boord of volgens de regels van de rederij afgehandeld.

Annuleringskosten per periode

AanbetalingsperiodeKosten lopen opHoogste kosten

Hoe dichter bij vertrek, hoe meer van de reissom bij annulering wordt ingehouden. De periodes en percentages horen bij elke rederij en elk tarief, dus een cruise-API stuurt ze mee met de boeking en uw platform toont ze de gast vóór de betaling.

Verkoopt u eigen ingekochte afvaarten, dan werkt de Cruises hetzelfde: u stelt per afvaart de aanbetaling en de uiterste datum voor het saldo in, en openstaande saldo's worden in het beheer bijgehouden tot ze betaald zijn.

Prijsopbouw bij cruises

Hoe een cruiseprijs is opgebouwd

Cruiseprijzen lezen anders dan hotel- of vluchtprijzen. Een cruise-API geeft de onderdelen apart terug, en uw boekingsmotor moet ze op dezelfde manier samenvoegen als de rederij.

Bovenop de prijs van de rederij past PHPTRAVELS uw opslagen en commissies toe per schip, afvaart of kanaal, en agenten in het B2B-reisportaal zien hun eigen nettotarieven.

  • Per persoon, niet per hut

    Cruisetarieven gelden per gast. Een hut voor twee kost tweemaal het tarief per persoon, en de API prijst elke gast naar leeftijd en plaats in de hut.

  • Gebaseerd op twee personen per hut

    Vanafprijzen gaan uit van twee gasten samen. Een derde en vierde gast betalen meestal een lager tarief, en wie alleen reist betaalt een eenpersoonstoeslag.

  • Belastingen, kosten en havengelden

    Overheidsbelastingen, kosten en havengelden komen per persoon bovenop het cruisetarief. Toon ze als aparte regels zodat het totaal geen verrassingen bevat.

  • Boordtegoed en extra's

    Sommige tarieven bevatten boordtegoed, een drankenpakket of fooien. De API geeft ze terug als tariefinclusies, en ze zijn een reden dat twee tarieven voor dezelfde hut verschillen.

Zo komt u aan cruiseaanbod

Uw eigen contracten of een rederij-API

Er zijn twee wegen naar cruises op uw site. Veel bureaus beginnen met de eerste en voegen de tweede toe zodra het volume dat rechtvaardigt.

Klaar in de Cruisemodule

Laad uw eigen cruisecontracten

Voer in het beheer de afvaarten in die u inkoopt: schepen, dekken, hutcategorieën, routes per haven, vertrekdata, tarieven per persoon, seizoenen, aanbetalingen en saldodata. Cruisepartners kunnen een leveranciersaccount krijgen om hun eigen afvaarten actueel te houden.

  • Groepsruimte en allotments die u vasthoudt
  • Commissie per rederij
  • Nettotarieven voor B2B-agenten
  • Live vanaf de dag van installatie
Maatwerkintegratie

Koppel een rederij- of consolidator-API

In de integratielijst van PHPTRAVELS staat geen kant-en-klare cruise-connector. Omdat elk abonnement de volledige broncode bevat, wordt de API van een rederij of cruiseconsolidator gekoppeld als API-integratie op maat, afgestemd op dezelfde afvaarten, hutten en boekingen die de module al toont.

  • U sluit de overeenkomst met de rederij of consolidator
  • U ontvangt en bewaart de API-inloggegevens
  • De connector koppelt afvaarten, categorieën en hutten
  • Boekingen, betalingen en annuleringen volgen de regels van de rederij

Op zoek naar leveranciers? De Travel XML API leverancierslijst toont rederijen die via API's distribueren, en Wat is API-integratie legt uit hoe zo'n koppeling wordt gebouwd.

Zie de cruiseboekingsflow in werking

Open de live demo om afvaarten te zoeken, hutcategorieën te vergelijken en te boeken met een aanbetaling, en vergelijk daarna de abonnementen op Prijzen.

FAQ

Vragen over de cruise-API

Praat met sales

Een cruise-API is een set webservices die een rederij of cruiseconsolidator openstelt voor reisverkopers. Uw systeem gebruikt die om afvaarten te zoeken, routes te lezen, hutcategorieën te prijzen, beschikbare hutten te tonen, boekingen te plaatsen en aanbetalingen en restbetalingen te verwerken.

Nee. De Cruisemodule is gebouwd rond aanbod dat u zelf beheert: schepen, hutcategorieën en afvaarten die u inkoopt. Een koppeling met een specifieke rederij of consolidator wordt als maatwerkintegratie ontwikkeld op de meegeleverde broncode.

U meldt zich als reisverkoper aan bij de rederij of een cruiseconsolidator. De toegangsvoorwaarden verschillen per rederij en markt. U sluit zelf de overeenkomst en ontvangt zelf de inloggegevens; PHPTRAVELS levert nooit leveranciersgegevens.

Een gegarandeerde boeking zekert een hutcategorie tegen een vaste prijs, en de rederij wijst de werkelijke hut later toe, in die categorie of hoger. Bij een vaste hut ligt het hutnummer bij het boeken al vast.

De rederij bepaalt ze per afvaart en tarief, en haar API geeft ze mee met de boeking. Voor afvaarten die u zelf laadt, stelt u de aanbetaling en de uiterste datum voor het saldo per afvaart in het beheer in.

Cruisetarieven gelden per gast, meestal uitgaande van twee gasten in een hut. Een derde en vierde gast betalen hun eigen tarief, een alleenreiziger betaalt een eenpersoonstoeslag, en belastingen, kosten en havengelden komen per persoon.

Ja. Agenten boeken in het B2B-portaal met hun eigen nettotarieven en commissies en betalen vanuit hun agentenwallet, vanuit dezelfde installatie als uw openbare site.

Het Enterprise-abonnement bevat de PHPTRAVELS REST API en webhooks met documentatie, en elk abonnement bevat de volledige broncode, zodat uw ontwikkelaars de cruiseboekingsmotor kunnen uitbreiden of aan andere systemen koppelen.

Begin met de afvaarten die u al inkoopt, laad ze in de Cruisemodule en kijk hoe ze verkopen. Wanneer een samenwerking met een rederij of het volume het waard maakt, voegt u de API van die rederij toe via een maatwerkintegratie.