Demo live

API di prenotazione crociere

API crociere per agenzie: partenze, cabine e piani di pagamento

Un'API crociere permette al vostro sito di mostrare partenze in tempo reale, quotare le categorie di cabina e creare prenotazioni di crociera con la compagnia. Questa pagina spiega come sono fatti i dati, come funzionano cabine e pagamenti e i due modi per portare l'inventario crociere sul vostro sito PHPTRAVELS.

  • Partenze e itinerari
  • Categorie di cabine e piante dei ponti
  • Caparre e saldo
  • Integrazioni crociere su misura

Cosa restituisce un'API crociere

Una partenza, descritta in dati

Una crociera si vende come partenza: una nave, un itinerario, una data. Ogni API crociere, qualunque sia il formato, è costruita attorno a questa unità.

Una ricerca invia una regione, un mese o un intervallo di date, una durata e il numero di ospiti. La risposta è un elenco di partenze, ciascuna con nave, compagnia, date di imbarco e rientro, porti di scalo con gli orari, giorni di navigazione e un prezzo base a persona per ogni categoria di cabina ancora disponibile.

Da lì, altre chiamate quotano la categoria scelta per gli ospiti reali, elencano le cabine selezionabili, registrano la prenotazione e incassano i pagamenti. Nomi e formati cambiano da compagnia a compagnia, quindi la piattaforma riporta ogni fonte allo stesso modello di partenza, cabina e prenotazione prima che l'ospite veda qualcosa.

Compagnia

La vostra compagnia partner

Nave partner · 7 notti

Aperta
Imbarco
2027-05-15
Rientro
2027-05-22

Itinerario

  1. D1Southampton--:-- · 17:00
  2. D2In mare
  3. D3Bruges (Zeebrugge)08:00 · 18:00
  4. D4Amsterdam09:00 · 19:00
  5. D5In mare
  6. D6Copenaghen07:00 · 17:00
  7. D7Oslo09:00 · 16:00
  8. D8Southampton07:00 · --:--
Prezzo basea persona, in due per cabinaEUR 899

Record illustrativo, non il formato di una compagnia specifica.

Una piattaforma di prenotazione crociere che riceve partenze, categorie di cabine e prezzi dal sistema di una compagnia

Categorie di cabine

Quattro gradini sulla nave: interna, vista mare, balcone, suite

Sotto ogni partenza, un'API crociere elenca le categorie di cabina. Sono il principale fattore di prezzo e ciascuna cambia più cose insieme.

  1. 01InternaSenza finestra

    Il prezzo d'ingresso della partenza. Le compagnie la dividono spesso in più categorie per ponte e posizione, ognuna con il proprio codice.

    Livello di prezzo
  2. 02Vista mareFinestra o oblò

    Un passo avanti per la luce naturale. Alcune categorie hanno la vista ostruita, e l'API lo segnala nella descrizione della categoria.

    Livello di prezzo
  3. 03BalconeVeranda privata

    Uno spazio esterno privato, con categorie che cambiano in base all'altezza del ponte e alla posizione a centro nave o a poppa.

    Livello di prezzo
  4. 04SuiteBalcone e zona soggiorno

    Il vertice del listino, spesso con extra inclusi nella tariffa, e le categorie che più facilmente si vendono come cabina specifica.

    Livello di prezzo

Codici di categoria e codici tariffa

Ogni categoria ha un codice e ogni partenza può essere venduta con più codici tariffa: tariffe standard, promozionali e di gruppo o per agenzie. La stessa cabina può avere prezzi e condizioni diversi a seconda del codice tariffa.

Garantita o cabina specifica

Con la prenotazione garantita l'ospite acquista una categoria e la compagnia assegna la cabina più tardi, in quella categoria o superiore. La prenotazione di cabina specifica fissa il numero della cabina al momento della prenotazione. Molte compagnie prezzano le due formule in modo diverso.

Scelta della cabina

Scegliete la cabina sulla pianta del ponte

Quando la compagnia consente la prenotazione di una cabina specifica, l'API restituisce le cabine ancora disponibili nella categoria scelta, con ponte, posizione e numero di ospiti che ciascuna può ospitare.

Ponte 9

Selezionate una cabina

PruaPoppa
0814
242636
29
011119
  • Interna
  • Vista mare
  • Balcone
  • Suite
  • Non disponibile

Cabina 9110

Interna

Cabina interna, il prezzo più basso su questo ponte. Venduta come cabina specifica o come garantita.

Vista mare

Cabina con finestra a prua, dove lo scafo si curva. L'API restituisce la nota sulla vista insieme alla categoria.

Balcone

Cabina con balcone a centro nave. La posizione sul ponte è spesso una categoria separata con un proprio prezzo.

Suite

Suite rivolta verso poppa con balcone più ampio. Di solito prenotata come cabina specifica, non come garantita.

  1. 1.Elencare le cabineDopo la scelta della categoria, la piattaforma chiede alla compagnia le cabine libere al suo interno e le disegna sul ponte.
  2. 2.Bloccare la cabinaMolte API crociere permettono di bloccare per poco tempo la cabina scelta mentre l'ospite inserisce i nomi e paga.
  3. 3.PrenotarlaLa prenotazione conferma numero di cabina, ospiti e codice tariffa, e la compagnia restituisce il proprio riferimento di prenotazione.

Nel Crociere di PHPTRAVELS le navi hanno i propri ponti e le proprie categorie di cabina e gli ospiti scelgono con i fatti davanti, che le cabine siano vostre o di una compagnia collegata.

Piano di pagamento

Caparra ora, il saldo prima della partenza

Le crociere si prenotano con mesi di anticipo e si pagano a rate. La compagnia stabilisce date e importi per ogni partenza e tariffa, e l'API li restituisce con la prenotazione.

  1. 01

    Prenotazione e caparra

    L'ospite versa una caparra fissata dalla compagnia, a persona o a prenotazione, per confermare la cabina.

  2. 02

    Saldo

    Il saldo scade a una data stabilita dalla compagnia prima della partenza. Le prenotazioni non saldate possono essere annullate dalla compagnia dopo quella data.

  3. 03

    Documenti

    A pagamento completato, la compagnia rilascia i documenti di crociera e l'ospite inserisce i dati per il check-in.

  4. 04

    Giorno della partenza

    L'ospite si imbarca. Le modifiche da questo momento si gestiscono a bordo o secondo le regole della compagnia.

Penali di cancellazione per fascia

Fascia della caparraLa penale crescePenale massima

Più ci si avvicina alla partenza, più la compagnia trattiene della tariffa in caso di cancellazione. Fasce e percentuali dipendono da ogni compagnia e tariffa, quindi un'API crociere le invia con la prenotazione e la vostra piattaforma le mostra all'ospite prima del pagamento.

Quando vendete partenze contrattate in proprio, il Crociere funziona allo stesso modo: stabilite caparra e scadenza del saldo per ogni partenza e i saldi aperti restano tracciati nell'area admin finché non vengono pagati.

Prezzi nelle crociere

Come si forma il prezzo di una crociera

I prezzi delle crociere si leggono diversamente da quelli di hotel e voli. Un'API crociere restituisce le componenti separate e il vostro booking engine deve ricomporle come fa la compagnia.

Sopra il prezzo della compagnia, PHPTRAVELS applica i vostri ricarichi e le commissioni per nave, partenza o canale, e gli agenti nel Portale di viaggi B2B vedono le proprie tariffe nette.

  • A persona, non a cabina

    Le tariffe crociera sono quotate per ospite. Una cabina per due costa il doppio della tariffa a persona e l'API prezza ogni ospite in base a età e posizione nella cabina.

  • Basato sull'occupazione doppia

    I prezzi base presuppongono due ospiti per cabina. Il terzo e il quarto ospite pagano di solito una tariffa ridotta, mentre chi viaggia da solo paga un supplemento singola.

  • Tasse, oneri e diritti portuali

    Tasse governative, oneri e diritti portuali si aggiungono a persona alla tariffa della crociera. Mostrateli come righe separate, così il totale non riserva sorprese.

  • Credito a bordo ed extra

    Alcune tariffe includono credito a bordo, pacchetto bevande o mance. L'API li restituisce come inclusioni della tariffa e sono uno dei motivi per cui due tariffe per la stessa cabina differiscono.

Come ottenere l'inventario crociere

I vostri contratti o l'API di una compagnia

Ci sono due strade per avere le crociere sul vostro sito. Molte agenzie iniziano dalla prima e aggiungono la seconda quando i volumi lo giustificano.

Pronto nel modulo Crociere

Caricate i vostri contratti di crociera

Inserite nell'area admin le partenze che contrattate: navi, ponti, categorie di cabine, itinerari porto per porto, date di partenza, tariffe a persona, stagioni, caparre e scadenze del saldo. Ai partner crociere si può dare un accesso fornitore per aggiornare da soli le proprie partenze.

  • Spazi di gruppo e allotment che detenete
  • Commissione per compagnia
  • Tariffe nette per gli agenti B2B
  • Attivo dal giorno dell'installazione
Integrazione su misura

Collegate l'API di una compagnia o di un consolidatore

Nell'elenco delle integrazioni di PHPTRAVELS non c'è un connettore crociere già pronto. Poiché ogni piano include il codice sorgente completo, l'API di una compagnia o di un consolidatore di crociere si collega come Integrazione API personalizzata, mappata sulle stesse partenze, cabine e prenotazioni che il modulo già mostra.

  • Firmate con la compagnia o il consolidatore
  • Ricevete e conservate le credenziali API
  • Il connettore mappa partenze, categorie e cabine
  • Prenotazioni, pagamenti e cancellazioni seguono le regole della compagnia

Cercate fornitori? L'Lista fornitori XML API per il travel elenca le compagnie di crociera che distribuiscono tramite API, e Cos'è l'integrazione API spiega come si costruisce un collegamento di questo tipo.

Guardate in azione il flusso di prenotazione crociere

Aprite la demo dal vivo per cercare partenze, confrontare le categorie di cabina e prenotare con una caparra, poi confrontate i piani su Prezzi.

FAQ

Domande sull'API crociere

Contatta il team vendite

Un'API crociere è un insieme di servizi web che una compagnia o un consolidatore di crociere apre ai venditori di viaggi. Il vostro sistema la usa per cercare partenze, leggere gli itinerari, quotare le categorie di cabina, elencare le cabine disponibili, registrare prenotazioni e incassare caparre e saldi.

No. Il modulo Crociere è costruito attorno all'inventario che gestite voi: navi, categorie di cabine e partenze che contrattate. Il collegamento a una specifica compagnia o consolidatore si sviluppa come integrazione su misura sul codice sorgente incluso.

Vi candidate alla compagnia o a un consolidatore di crociere come venditore di viaggi. Le condizioni di accesso cambiano per compagnia e mercato. Firmate voi l'accordo e ricevete voi le credenziali; PHPTRAVELS non fornisce mai credenziali di fornitori.

La prenotazione garantita assicura una categoria di cabina a un prezzo fissato, e la compagnia assegna la cabina effettiva più tardi, in quella categoria o superiore. La prenotazione di cabina specifica fissa il numero della cabina al momento della prenotazione.

La compagnia li stabilisce per ogni partenza e tariffa e la sua API li restituisce con la prenotazione. Per le partenze che caricate voi, impostate caparra e scadenza del saldo per ogni partenza nell'area admin.

Le tariffe crociera sono quotate per ospite, di solito su base due ospiti per cabina. Il terzo e il quarto ospite pagano la propria tariffa, chi viaggia da solo paga un supplemento singola, e tasse, oneri e diritti portuali si aggiungono a persona.

Sì. Gli agenti prenotano nel portale B2B con le proprie tariffe nette e commissioni e pagano dal proprio portafoglio agente, sulla stessa installazione del vostro sito pubblico.

Il piano Enterprise include la REST API e i webhook di PHPTRAVELS con documentazione, e ogni piano include il codice sorgente completo, quindi i vostri sviluppatori possono estendere il booking engine crociere o collegarlo ad altri sistemi.

Partite dalle crociere che già contrattate, caricate nel modulo Crociere, e vedete come si vendono. Quando una partnership con una compagnia o i volumi lo giustificano, aggiungete l'API di quella compagnia tramite un'integrazione su misura.