Demo live

Integrazione fornitori hotel

Integrazione API Hotelbeds: contenuti, mappatura e prenotazioni in tempo reale

Un'integrazione API Hotelbeds è composta da due lavori, non da uno. Scaricate e salvate i contenuti degli hotel, poi prenotate su tariffe in tempo reale. PHPTRAVELS fa entrambe le cose nel suo modulo hotel, con il vostro contratto e le vostre chiavi Hotelbeds.

  • Sincronizzazione Content API
  • Flusso Booking API
  • Tariffe BOOKABLE e RECHECK
  • Mappatura hotel

Come si combinano le API di Hotelbeds

Integrazione API Hotelbeds: i contenuti da una parte, la prenotazione dall'altra

Hotelbeds divide le sue API hotel in due. La Content API restituisce dati statici: descrizioni, immagini, servizi, trattamenti e camere. La Booking API restituisce disponibilità e prezzi in tempo reale ed esegue la prenotazione. Scegliete un passaggio al centro per vedere quali chiamate utilizza.

Content API

Statica, salvata sul vostro sistema
  • Elenco hotelhotels · from=1&to=1000Tutti gli hotel del vostro portafoglio, in pagine fino a 1.000 hotel per richiesta.
  • Servizi, trattamenti e camerefacilities · boards · roomsLe tabelle dei codici che trasformano i codici della Booking API in parole comprensibili per i vostri ospiti.
  • Immaginiphotos.hotelbeds.com/giata/Percorsi parziali delle immagini, uniti all'host fotografico di Hotelbeds nella dimensione che vi serve.
  • Modifiche giornalierelastUpdateTimeDopo il primo caricamento, una richiesta al giorno con lastUpdateTime restituisce solo ciò che è cambiato.

Flusso delle richieste

Booking API

In tempo reale, chiamata per ogni ospite
  • DisponibilitàPOST /hotelsCamere, trattamenti, prezzi e penali di cancellazione per i vostri codici hotel, date e occupazione.
  • Verifica tariffaPOST /checkratesPrezzo e condizioni aggiornati per una tariffa contrassegnata RECHECK, con opzioni di upselling.
  • PrenotazionePOST /bookingsConferma il rateKey scelto con i nomi del titolare e degli ospiti e restituisce il riferimento.
  • CancellazioneDELETE /bookings · simulateSimula una cancellazione per mostrare la penale, oppure cancella davvero la prenotazione.
Schermata di esempio. Chiamate come documentate su developer.hotelbeds.com; il flusso è quello usato da PHPTRAVELS.

La maggior parte dei progetti Hotelbeds falliti confonde i due lati. Chiamano la Content API durante la ricerca dell'ospite, il che è lento e, come avverte Hotelbeds, può far bloccare le vostre credenziali. Oppure cercano in tempo reale senza codici salvati e non possono mostrare immagini o servizi. PHPTRAVELS tiene separati i due lati: i contenuti vengono sincronizzati in background e solo le chiamate di disponibilità, verifica tariffa e prenotazione avvengono mentre l'ospite attende.

Se cercate informazioni sul fornitore stesso, sui suoi prodotti e su come aprire un account, leggete il profilo del fornitore Hotelbeds. Questa pagina riguarda l'integrazione tecnica.

Tipi di tariffa

I quattro campi tariffari che cambiano il vostro checkout

Ogni tariffa Hotelbeds contiene alcuni attributi che stabiliscono se potete prenotarla subito, quale prezzo potete mostrare e chi incassa il denaro. Sono quelli che il vostro motore deve leggere in ogni risultato.

CampoPrimo casoSecondo casoCosa fa PHPTRAVELS

Prenotabile o da verificare

rateType		BOOKABLE

La tariffa è aggiornata. Potete prenotarla senza un'altra chiamata.

RECHECK

Dovete prima chiamare verifica tariffa per ottenere prezzo e condizioni aggiornati.

Esegue la verifica tariffa prima del pagamento per le tariffe RECHECK e mostra all'ospite eventuali variazioni.

Netta o commissionabile

net · sellingRate		net

Modello netto: i prezzi sono netti, quindi aggiungete il vostro margine.

sellingRate

Modello commissionabile: la commissione è già inclusa in sellingRate e quel prezzo è definitivo.

Applica le vostre regole di ricarico alle tariffe nette e vende le tariffe commissionabili a sellingRate.

Prezzo di vendita fisso

hotelMandatory		true

hotelMandatory è true: dovete vendere a sellingRate.

false · null

False o vuoto su una tariffa netta: potete stabilire il vostro margine.

Blocca il prezzo mostrato su sellingRate quando l'hotel lo richiede, qualunque sia la regola di ricarico.

Quando paga l'ospite

paymentType		AT_WEB

Il pagamento viene incassato al momento della prenotazione, tramite il vostro sito.

AT_HOTEL

L'ospite paga direttamente l'hotel.

Etichetta la tariffa come paga ora o paga in hotel e adatta il checkout di conseguenza.

Il modello di prezzo che ottenete dipende dal vostro contratto Hotelbeds. Come indica Hotelbeds, il vostro sales manager consiglia il modello adatto alla vostra attività.

Mappatura hotel

Abbinate gli hotel Hotelbeds agli hotel che vendete già

Se avete contratti diretti o un secondo fornitore, lo stesso hotel arriverà con codici diversi. La mappatura li collega, così l'ospite vede un solo hotel con la tariffa migliore, non tre copie.

Come funziona la mappatura in PHPTRAVELS

Dopo ogni sincronizzazione dei contenuti, PHPTRAVELS confronta gli hotel Hotelbeds con il vostro elenco per nome, indirizzo, città e coordinate. Le corrispondenze sicure vengono collegate automaticamente. Quelle dubbie attendono la conferma di una persona, e gli hotel senza corrispondenza possono essere importati come nuove strutture o ignorati.

Gli hotel mappati condividono una pagina, una galleria e un punteggio di recensioni nel modulo Hotel, mentre ogni fornitore mantiene le proprie tariffe e regole. La stessa mappatura è usata dal vostro sito pubblico e dal vostro Portale di viaggi B2B.

Mappatura hotel
  • Harbour View HotelLisbona48291397%Abbinato
  • Old Town SuitesPraga11735492%Abbinato
  • Palm Court ResortDubai66201874%Verificare
  • Casa Azul BoutiqueSiviglia–0%Nessuna corrispondenza
  • Northern Lights LodgeTromsø90522766%Verificare
  • Riverside ApartmentsBudapest33076198%Abbinato

Schermata di esempio con hotel e codici inventati.

Hotelbeds XML o JSON

Ogni richiesta è firmata e i test partono in piccolo

Molti team cercano ancora Hotelbeds XML, ma la documentazione attuale mostra richieste JSON. In ogni caso si tratta dello stesso insieme di operazioni, e ogni richiesta porta due header.

availability-request.sh (esempio)
 1# X-Signature = SHA256(api key + secret + unix time in seconds) 2TS=$(date +%s) 3SIG=$(printf "%s%s%s" "$API_KEY" "$SECRET" "$TS" | sha256sum | cut -d" " -f1) 4 5curl -X POST https://api.test.hotelbeds.com/hotel-api/1.0/hotels \ 6  -H "Api-key: $API_KEY" \ 7  -H "X-Signature: $SIG" \ 8  -H "Accept: application/json" \ 9  -H "Content-Type: application/json" \10  -d '{11    "stay": { "checkIn": "2026-11-14", "checkOut": "2026-11-17" },12    "occupancies": [{ "rooms": 1, "adults": 2, "children": 0 }],13    "hotels": { "hotel": [482913, 117354] }14  }'1516# hotel codes come from your stored Content API data, never a live content call
Api-keyX-Signatureapi.test.hotelbeds.com
Due header
Api-key con la vostra chiave e X-Signature: un hash SHA256 della chiave, del secret e dell'ora corrente in secondi.
Host di test
Come indica Hotelbeds, i server di test corrispondono alla produzione, ma le prenotazioni lì non sono reali e le carte non vengono addebitate.
50 richieste al giorno
Le nuove chiavi aprono un ambiente di valutazione con una quota di 50 richieste al giorno. La certificazione ne sblocca di più.
Nessuna chiamata ai contenuti in tempo reale
Hotelbeds avverte che chiamare la Content API in tempo reale può far bloccare le credenziali. PHPTRAVELS non lo fa mai.

Pianificatore di sincronizzazione

Quante chiamate alla Content API servono al vostro elenco hotel

Come indica Hotelbeds, l'elenco hotel arriva in pagine fino a 1.000 hotel e, dopo il primo caricamento, una richiesta giornaliera con lastUpdateTime restituisce solo le modifiche. Inserite i vostri numeri per pianificare la sincronizzazione.

Richieste per il primo caricamento completo
20
Richieste per aggiornamento giornaliero
3
Giorni per un caricamento completo con la quota di valutazione
1

Solo una stima, per l'elenco hotel. Tabelle dei codici e immagini aggiungono alcune chiamate. Con la quota di valutazione di 50 richieste al giorno, provate prima con una sola destinazione.

Checklist per il go-live

Cosa preparare prima di passare in produzione

Hotelbeds vi porta dalla valutazione alla certificazione e poi alle chiavi di produzione tramite la sua dashboard. Questi sono i punti che un'integrazione API Hotelbeds deve coprire per primi, e come li copre PHPTRAVELS.

  • Chiavi di valutazione inserite nel pannello, host di test selezionato
  • Content API sincronizzata con il vostro database, con aggiornamento giornaliero programmato
  • Hotel mappati con il vostro elenco, corrispondenze dubbie verificate
  • Le tariffe RECHECK passano dalla verifica tariffa prima del pagamento
  • sellingRate rispettato quando hotelMandatory è true
  • Note tariffarie e penali di cancellazione mostrate prima che l'ospite paghi
  • Il voucher mostra il riferimento Hotelbeds e le note tariffarie
  • Cancellazione prima simulata, poi confermata, con la penale registrata

I passaggi di certificazione e l'accesso in produzione sono stabiliti da Hotelbeds in base al vostro contratto e mercato.

Costi

Una licenza per il motore, il vostro contratto con Hotelbeds

PHPTRAVELS è una licenza una tantum con il codice sorgente. Hotelbeds è un accordo separato tra voi e Hotelbeds, quindi le tariffe nette e le chiavi restano vostre.

Startup
Licenza una tantum
licenza una tantum
Agency
Licenza una tantum
licenza una tantum
Enterprise
Licenza una tantum
licenza una tantum

Hotelbeds è una delle diverse fonti hotel che potete usare in parallelo. Scoprite come si affianca a RateHawk nella panoramica delle API di viaggio o confrontate i fornitori nella lista dei fornitori XML.

Vedi i prezziProvate la demo hotel

FAQ

Domande sull'integrazione API Hotelbeds

Cosa chiedono sviluppatori e aziende di viaggio prima di collegare Hotelbeds.

Contatta il team vendite

Due parti. Una sincronizzazione in background con la Content API, che salva hotel, immagini, servizi, trattamenti e camere nel vostro database, e un flusso in tempo reale con la Booking API per disponibilità, verifica tariffa, prenotazione e cancellazione. PHPTRAVELS gestisce entrambe nel suo modulo hotel.

Molti la chiamano ancora Hotelbeds XML, ma la documentazione attuale di Hotelbeds mostra richieste e risposte JSON. Le operazioni sono le stesse in entrambi i casi e PHPTRAVELS gestisce il formato per voi.

Una tariffa BOOKABLE è già aggiornata e può essere prenotata subito. Una tariffa RECHECK richiede prima una chiamata di verifica tariffa, che restituisce prezzo e condizioni attuali. PHPTRAVELS esegue questa chiamata prima del pagamento.

È lento, e Hotelbeds avverte che usare la Content API in tempo reale può portare al blocco delle credenziali. I contenuti vanno scaricati a pagine, salvati e aggiornati una volta al giorno con lastUpdateTime, ed è così che funziona PHPTRAVELS.

Sì. Vi registrate con Hotelbeds, firmate il contratto e ricevete la vostra chiave API e il vostro secret. Le nuove chiavi funzionano in un ambiente di valutazione con 50 richieste al giorno finché non completate la certificazione.

Sì. La mappatura hotel collega la stessa struttura tra le diverse fonti, così gli ospiti vedono un solo hotel con la migliore tariffa disponibile, mentre ogni fonte mantiene il proprio ricarico e le proprie regole.

I piani PHPTRAVELS partono come licenza una tantum con il codice sorgente. Il vostro contratto Hotelbeds è separato e concordato direttamente con Hotelbeds. Consultate la pagina dei prezzi o chiedete un preventivo al reparto vendite.

Continua a esplorare

Altro sulla piattaforma