Demo live

API per alloggi

Un'API per soggiorni per hotel, appartamenti e case vacanza

Un'API per soggiorni porta ogni tipo di alloggio sul vostro sito di prenotazione: camere d'hotel, residence, case vacanza, ostelli e pensioni. Questa pagina spiega i dati che stanno dietro a un soggiorno, le regole che distinguono gli affitti dagli hotel e come PHPTRAVELS vende le vostre strutture e l'offerta dei fornitori in un'unica ricerca.

  • Struttura, unità, tariffa, calendario
  • Soggiorno minimo e costi
  • Finestre di cancellazione
  • Offerta propria e via API

Il modello dati

Quattro livelli in ogni soggiorno

Che si tratti di un hotel da 300 camere o di una singola casa sul mare, un'API per alloggi lo descrive negli stessi quattro livelli annidati. Ogni livello risponde a una domanda che l'ospite si pone prima di prenotare.

01Struttura

Il luogo stesso: nome, tipo, indirizzo e posizione sulla mappa, foto, servizi, classificazione a stelle o di qualità, regole della casa e orari di check-in.

property_id · type · address · geo · photos · amenities · check_in_from

02Camera o unità

Ciò che si prenota davvero: una tipologia di camera, un intero appartamento o un letto in dormitorio, con superficie, letti e occupazione massima.

unit_id · beds · size_m2 · max_adults · max_children

03Piano tariffario

Come si vende quell'unità: il trattamento, la politica di cancellazione, le condizioni di pagamento e chi può prenotarla, ad esempio pubblico o solo agenti.

rate_plan_id · board · cancel_policy · payment · channel

04Disponibilità

Una riga per notte: il prezzo, le unità rimaste, il soggiorno minimo e se arrivo o partenza sono consentiti quel giorno.

date · price · units_left · min_stay · closed_to_arrival

Un edificio, una camera, un cartellino tariffa e un calendario disegnati come livelli sovrapposti di un unico annuncio di alloggio

PHPTRAVELS chiama Stays il suo modulo per gli alloggi perché lo stesso modello copre molto più degli hotel. Una struttura contiene unità, un'unità si vende con uno o più piani tariffari e ogni piano ha un calendario notte per notte con prezzo e disponibilità. Se questi quattro livelli sono giusti, un posto letto in ostello, una suite d'hotel e una villa con tre camere entrano nella stessa ricerca e nello stesso checkout.

I fornitori chiamano i livelli in modo diverso e alcuni ne fondono due, ma la struttura c'è sempre. Il Hotel riconduce ogni fonte a questo schema, così l'ospite vede una pagina coerente.

Notte per notte

Nel calendario di disponibilità si vincono o si perdono i soggiorni

Ogni API per soggiorni finisce in un calendario. La ricerca restituisce una struttura solo se ogni notte del soggiorno richiesto è libera, con un prezzo e consentita dalle regole di soggiorno.

Appartamento con due camere · Tariffa standardNovembre 2026 · Prezzo a notte
  1. 26
  2. 27
  3. 28
  4. 29
  5. 30
  6. 31
  7. 1120
  8. 2120
  9. 3
  10. 4
  11. 5
  12. 6165
  13. 7140
  14. 8120
  15. 9
  16. 10
  17. 11
  18. 123+165
  19. 13165
  20. 14140
  21. 15120
  22. 16120
  23. 17120
  24. 18
  25. 19
  26. 20165
  27. 21140
  28. 22120
  29. 23120
  30. 24120
  31. 25120
  32. 263+165
  33. 27165
  34. 28140
  35. 29120
  36. 30120
  37. 1
  38. 2
  39. 3
  40. 4
  41. 5
  42. 6
  • Libero, con prezzo a notte
  • Già prenotato
  • Chiuso dal proprietario
  • Soggiorno minimo da questo arrivo
  • Arrivo non consentito

Dati illustrativi, semplificati

  • I prezzi sono a notteIl totale del soggiorno è la somma di ogni notte, quindi un venerdì e un sabato a tariffa weekend costano più di due giorni feriali. I prezzi giornalieri e stagionali stanno nel calendario, non nella struttura.
  • Regole di soggiorno minimoUn minimo di tre notti per gli arrivi del venerdì nasconde l'unità a una ricerca di due notti. Gli affitti usano queste regole molto più degli hotel, spesso più rigide nei weekend e in alta stagione.
  • Arrivo o partenza non consentitiUna notte può essere prenotabile all'interno di un soggiorno più lungo ma non come prima o ultima notte. I giorni di cambio delle case vacanza funzionano così.
  • Notti chiuse e stop-sellI proprietari bloccano le date per uso personale o manutenzione, e uno stop-sell toglie subito l'unità dalla vendita. Qualsiasi notte chiusa nelle date richieste esclude l'unità dai risultati.

Non tutti i soggiorni sono hotel

Hotel, appartamenti e case vacanza a confronto

Il modello dati è condiviso, ma ogni tipo di soggiorno lo compila in modo diverso. Sono le differenze che il vostro flusso di prenotazione deve gestire quando vendete più delle semplici camere d'hotel.

Hotel

Compresi ostelli e pensioni

Cosa si prenota
Una tipologia di camera con molte camere identiche, o un letto in dormitorio condiviso.
Prezzi
Una tariffa a notte per camera e trattamento; adulti o bambini in più possono modificarla.
Regole di soggiorno
Soggiorno minimo solo nelle date di punta; la maggior parte delle notti si prenota singolarmente.
Costi e cauzioni
Imposta di soggiorno, a volte una resort fee da pagare in struttura.
Arrivo
Reception h24 o presidiata; bastano gli orari di check-in riportati sul voucher.
Fonte tipica
Bedbank e grossisti, contratti diretti, channel manager.

Residence con servizi

Aparthotel e appartamenti in città

Cosa si prenota
Una tipologia di unità, spesso con cucina e camere separate.
Prezzi
Una tariffa a notte per unità, con prezzi settimanali o mensili per i soggiorni lunghi.
Regole di soggiorno
I soggiorni minimi sono comuni e i soggiorni lunghi pesano molto sulla domanda.
Costi e cauzioni
Una tassa di pulizia per soggiorno e una cauzione rimborsabile sono comuni.
Arrivo
Gli orari della reception variano; gli arrivi in ritardo richiedono una keybox o un codice.
Fonte tipica
Channel manager, contratti diretti e alcuni grossisti.

Case vacanza

Case, ville e chalet

Cosa si prenota
Una casa specifica. Di solito ne esiste una sola.
Prezzi
Una tariffa a notte per l'intera casa, più un supplemento per ogni ospite oltre un numero base.
Regole di soggiorno
Soggiorno minimo, giorni di cambio fissi e date con arrivo non consentito sono la norma.
Costi e cauzioni
Pulizie, cauzione per danni rimborsabile e imposte locali, ciascuna mostrata prima del pagamento.
Arrivo
Istruzioni di check-in, indirizzo e contatto vengono inviati prima dell'arrivo, mai sulla pagina pubblica.
Fonte tipica
Proprietari e gestori di immobili, direttamente o tramite un channel manager.

Vendete case di molti host invece che con contratti vostri? Quello è un marketplace, trattato nella pagina Portale BnB.

Finestre della politica di cancellazione

Una prenotazione, tre finestre di cancellazione

Una politica di cancellazione è una linea temporale calcolata a ritroso dalla data di arrivo. Ogni finestra indica cosa riceve indietro l'ospite se cancella al suo interno.

PrenotazioneCheck-in
  1. 01 · Fino a 14 giorni prima dell'arrivoCancellazione gratuitaL'ospite cancella e viene rimborsato per intero. È la scadenza che i viaggiatori cercano per prima, quindi mostratela come data, non come regola.
  2. 02 · Da 14 a 3 giorni primaPenale parzialeSi applica una penale, spesso la prima notte o una percentuale del soggiorno. Gli affitti possono trattenere la cauzione in questa finestra.
  3. 03 · Ultimi 3 giorni e mancata presentazioneNon rimborsabileL'intero importo viene trattenuto. Le tariffe vendute come non rimborsabili partono da questa finestra fin dal momento della prenotazione.
Finestre di esempio; ogni piano tariffario ha le proprie.
  • Per piano tariffario, non per strutturaLo stesso appartamento può avere una tariffa flessibile e una non rimborsabile più economica, quindi la politica appartiene al livello del piano tariffario.
  • Date nel fuso orario della struttura"14 giorni prima" si conta dalla data di arrivo nel luogo della struttura. Convertitela in una data e un'ora chiare sulla pagina e sul voucher.
  • Prevale la politica del fornitoreCon l'offerta via API non potete concedere condizioni più morbide di quelle del fornitore. Con i vostri contratti le finestre le decidete voi.

Offerta propria e via API

Le vostre strutture in contratto e le API dei fornitori in un'unica ricerca

La maggior parte dei venditori di alloggi fa entrambe le cose: carica le strutture che contratta direttamente e aggiunge le API dei fornitori per tutto il resto. Il viaggiatore non deve mai accorgersi da dove arriva un soggiorno.

Le vostre strutture

  • Caricate voi stessi strutture, unità e piani tariffari nell'admin
  • Date a proprietari e hotel un accesso extranet per gestire il calendario
  • Impostate prezzi, soggiorni minimi, date chiuse e finestre di cancellazione
  • Allotment con giorni di rilascio e stop-sell
  • Oppure ricevete tariffe e disponibilità da un channel manager

Offerta dei fornitori via API

  • Grandi cataloghi in destinazioni che non potreste mai contrattare
  • Prezzi e disponibilità in tempo reale al momento della ricerca
  • Trattamenti, politiche e costi del fornitore su ogni tariffa
  • Attivata con il vostro contratto e le vostre credenziali di fornitore
  • Prenotazione e cancellazione inviate direttamente al fornitore

Cosa ottiene l'ospite

  • Un unico elenco di risultati con una pagina per ogni struttura
  • La stessa camera da più fonti mostrata una volta, al vostro prezzo
  • I vostri ricarichi per fornitore, destinazione o canale, e tariffe per agenti B2B
  • Un solo formato di voucher, qualunque fonte abbia confermato

Il collegamento di un channel manager è trattato in Integrazione channel manager. Per le camere che avete in contratto, vedete Sistema di inventario prenotazioni.

Pronti in PHPTRAVELS

Fornitori di soggiorni già collegati

Questi fornitori di alloggi sono già collegati al modulo Stays. Firmate con il fornitore, inserite le vostre credenziali nell'admin, testate nel suo sandbox e andate online. L'elenco arriva in tempo reale dalla nostra directory delle integrazioni.

Vi serve un fornitore che non è in elenco, come una rete regionale di affitti? Si può aggiungere qualsiasi API per alloggi dotata di documentazione, vedete Integrazione API personalizzata. Per i tipi di fornitori hotel e la mappatura dei contenuti leggete la pagina API hotel, e le due guide ai maggiori bedbank: Integrazione API RateHawk e Integrazione API Hotelbeds.

Prenotate un soggiorno come lo farebbero i vostri ospiti

Cercate, confrontate le tariffe e prenotate nella demo dal vivo, poi diteci quali strutture e fornitori intendete vendere.

Provate la demo dal vivoChiedeteci dei vostri fornitori

State creando una vostra app o un feed per partner? La REST API di PHPTRAVELS serve ogni fonte di soggiorni collegata in un unico formato, con webhook per gli eventi di prenotazione. È inclusa nel piano Enterprise, vedete Prezzi e la documentazione per sviluppatori. Il quadro generale è su API di viaggio.

Domande frequenti

API per soggiorni: le domande di sviluppatori e agenzie

Contatta il team vendite

Un'API per soggiorni è un insieme di servizi web che permette a un sito di prenotazione di cercare alloggi, leggere prezzi e disponibilità per date e ospiti dati, e creare, consultare e cancellare prenotazioni. Copre gli hotel e ogni altro tipo di soggiorno: appartamenti, case vacanza, ostelli e pensioni.

Le chiamate di base sono le stesse. Un'API per soggiorni deve però gestire anche ciò che richiedono i soggiorni non alberghieri: prenotazioni dell'intera unità, soggiorni minimi e giorni di cambio, supplementi per ospiti extra, tasse di pulizia, cauzioni rimborsabili e istruzioni di check-in inviate prima dell'arrivo.

Sì. In PHPTRAVELS il modulo Stays usa un unico modello di struttura, unità, piano tariffario e disponibilità per ogni tipo di alloggio, quindi hotel, appartamenti e case vacanza compaiono nella stessa ricerca, ciascuno con le proprie regole.

Ogni notte del calendario può avere una durata minima del soggiorno, di solito legata alla data di arrivo. Se l'ospite cerca meno notti del minimo, l'unità non viene restituita. I flag di arrivo e partenza non consentiti funzionano allo stesso modo per i giorni di cambio.

Sì. Potete aggiungere strutture, unità, piani tariffari e calendari, dare ai proprietari un accesso extranet o ricevere le tariffe da un channel manager, e venderli accanto all'offerta dei fornitori in un unico elenco di risultati.

Dal piano tariffario. L'offerta dei fornitori porta con sé la loro politica, mentre le vostre strutture usano le finestre che impostate voi. La scadenza viene mostrata all'ospite prima del pagamento e stampata sul voucher.

No. Firmate con ogni fornitore di alloggi e inserite le vostre credenziali nell'admin. PHPTRAVELS fornisce la piattaforma di prenotazione, il modulo Stays e i connettori già pronti.

Sì. Con il piano Enterprise la REST API di PHPTRAVELS espone ricerca e prenotazione di ogni fonte collegata in un unico formato, con webhook per gli eventi di prenotazione e il codice sorgente completo per estenderla.

Una licenza PHPTRAVELS, un dominio vostro e almeno una fonte di offerta: strutture contrattate direttamente, un channel manager o un contratto con un grossista di alloggi. La demo dal vivo mostra prima l'intero flusso.

Continua a esplorare

Altro sulla piattaforma