Flash Booking On-Line 2.0 Specifiche di collegamento 2009 Athena Solutions Srl All rights reserved. Le informazioni contenute in questo documento rappresentano l'attuale posizione di Athena Solutions sui temi trattati, alla data di pubblicazione. Athena Solutions deve rispondere alle mutevoli condizioni del mercato e per questo motivo questo documento non deve essere interpretato come un impegno da parte di Athena Solutions, e Athena Solutions non può garantire l'esattezza delle informazioni presentate dopo la data di pubblicazione. Questo documento è esclusivamente per scopi informativi.
Sommario Sommario 1 Informazioni su HermesHotels.com... 3 1.1 Chi Siamo... 3 1.2 Contatti... 3 2 Overview... 4 3 Note tecniche... 4 4 Inserimento BOL... 5 4.1 Codici canale e hotel... 5 4.2 Intestazione HTML... 5 4.3 Maschera da visualizzare... 5 4.3.1 Lista Hotel del canale... 5 4.3.2 Scelta date di arrivo... 6 4.3.3 Visualizzazione camere disponibili... 6 4.3.4 Recupera prenotazione... 7 4.4 Prenotazione singola tariffa o pacchetto... 9 4.5 Lingue... 10 5 Esempi Html... 11 5.1 Ingresso con scelta hotel... 11 5.2 Ingresso con scelta date (per hotel specifico)... 11 5.3 Ingresso con lista camere disponibili (per hotel e date specifiche)... 12 6 Tabella delle revisioni... 13 2
1 Informazioni su HermesHotels.com 1.1 Chi Siamo HermesHotels, un marchio di Athena Solutions srl, è protagonista dell innovazione nel mercato del Turismo e dell Hotellerie dal 2005. HermesHotels è il primo sistema di Channel Management evoluto in Europa. La prima società ad utilizzare connessioni Xml 2 vie, coniando la definizione, con portali internet indipendenti. Primi ad utilizzare complesse tecnologie di interfaccia sposandole a meccanismi di revenue management per il mercato alberghiero, Athena Solutions srl è stata premiata nel 2009 dal Presidente della Repubblica Italiana per innovazione nel turismo. Nel 2009 Athena Solutions vara il primo sistema al mondo di prenotazione alberghiera su piattaforma sms/mobile, smshotels, confermando il suo ruolo di pioniere nella ricerca e nelle applicazioni tecnologiche per il turismo. Per ulteriori informazioni: http://www.athenasolutions.it http://www.hermeshotels.it +3906873701 1.2 Contatti Roberto Santececca Corporate & Marketing Director e-mail: r.santececca@athenasolutions.it tel: +3906873701 cell: +393406304601 Contatti Commerciali Marco D Amore Managing Director e-mail: m.damore @athenasolutions.it tel: +3906873701 cell: +393334276622 Contatti Tecnici Roberto Romano IT Director e-mail: r.romano@athenasolutions.it tel: +3906873701 cell: +393485592637 3
2 Overview Lo scopo di questo documento è quello di fornire ai partner di HermesHotels.com le istruzioni per l inserimento del Booking Engine Flash all interno del proprio sito. Il Booking Engine Flash rende prenotabile un sito web in modalità White Label, senza cioè uscire mai dal sito stesso e senza modificare l indirizzo web da cui avviene l accesso. Le funzioni garantite dal Booking Engine Flash sono quelle di: Scelta Hotel da prenotare (solo per canali con più di un hotel) Ricerca Disponibilità hotel Prenotazione Hotel Recupero/Cancellazione Prenotazione 3 Note tecniche Se state inserendo nel vostro sito il Booking Engine Flash di HermesHotels.com, si deve prendere nota che: HermesHotels.com fornirà l accesso solo ai partner approvati Il Booking Engine sfrutta un applicazione Flash, chi lo utilizza deve necessariamente avere installato sul proprio PC l apposito lettore. La visualizzazione del Booking Engine è legata ad uno script lato client Javascript. Il corretto funzionamento è legato quindi all abilitazione dei Javascript sul browser di chi lo utilizza Le richieste di disponibilità, inserimento prenotazione, recupero e cancellazione prenotazione vengono inviate ad un indirizzo proprietario di HermesHotels.com in background rispetto alla navigazione dell utente che si collega al Booking Engine Flash La richiesta di inserimento prenotazione viaggia su connessione sicura (SSL), protetta da certificato di protezione 128 bit GEOTRUST di proprietà HermesHotels.com 4
4 Inserimento BOL 4.1 Codici canale e hotel L inserimento del Booking On Line Flash all interno del proprio sito web, prevede un accordo di collaborazione con HermesHotels.com. HermesHotels.com fornirà quindi su richiesta dei codici necessari al corretto funzionamento del Booking On Line Flash, più precisamente: Un codice canale (ca), identificativo del sito web stesso su cui inserire il BOL Un codice hotel (ho) per ogni hotel che si vuole rendere prenotabile dal proprio sito 4.2 Intestazione HTML Per rendere visibile il Booking On Line Flash all interno di una pagina del vostro sito web, è necessario inserire le seguenti porzioni di codice HTML: 1) L intestazione (DOC-TYPE) come segue per garantire la corretta compatibilità con tutti i browser <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/tr/html4/loose.dtd"> 2) All interno dei tag <HEAD></HEAD> vanno inseriti i seguenti script/css <head> <link rel="stylesheet" type="text/css" href="http://www.hermeshotels.com/customersflash/shadowlight/shadowbox.css"> <script type="text/javascript" src="http://www.hermeshotels.com/customersflash/shadowlight/shadowbox.js"></script> <script type="text/javascript" src="http://www.hermeshotels.com/customersflash/scripts/hermes_res.js"></script> </head> 4.3 Maschera da visualizzare La visualizzazione del Booking On Line flash sul vostro sito può avere diversi punti di partenza, che potrete scegliere liberamente e che sono: 4.3.1 Lista Hotel del canale Utilizzando questo punto di partenza del BOL Flash, all utente verrà visualizzata come maschera iniziale di questo una lista contenente la lista di tutti gli hotel associati al vostro canale (sito). L utente sceglierà quindi uno di questi e successivamente effettuerà le operazioni di prenotazione. Per avere questo punto di partenza il link da inserire all interno della vostra pagina di prenotazione dovrà essere come segue: <a href=" http://www.hermeshotels.com/customersflash/flashres.jsp?ca=x &ln=z" rel="shadowbox;height=520;width=915">testo</a> dove: - x, deve essere sostituito con il codice canale identificativo del vostro sito web (vedi CAPITOLO 4.1) - z, deve essere sostituito con il codice della lingua in cui si vuole visualizzare il BOL Flash - l attributo rel="shadowbox;height=520;width=915" garantisce al link l effetto grafico LightBox e le dimensioni del layer di prenotazione. Suggeriamo a chi si occupa dell inserimento del BOL nelle pagine del vostro sito di non modificare i parametri width e height (larghezza e altezza) da quelli sopra indicati (915x520) 5
4.3.2 Scelta date di arrivo Utilizzando questo punto di partenza del BOL Flash, all utente verrà visualizzata come maschera iniziale di questo il calendario per la scelta delle date di arrivo e partenza dall hotel scelto. In questo caso è obbligatorio passare come parametro anche il codice hotel, in quanto questa maschera indica i filtri di ricerca per prenotare un hotel specifico Per avere questo punto di partenza il link da inserire all interno della vostra pagina di prenotazione dovrà essere come segue: <a href=" http://www.hermeshotels.com/customersflash/flashres.jsp?ca=x&ho=y &ln=z" rel="shadowbox;height=520;width=915">testo</a> dove: - x, deve essere sostituito con il codice canale identificativo del vostro sito web (vedi CAPITOLO 4.1) - y, deve essere sostituito con il codice hotel identificativo di uno degli hotel associati al vostro canale(vedi CAPITOLO 4.1) - z,, deve essere sostituito con il codice della lingua in cui si vuole visualizzare il BOL Flash - l attributo rel="shadowbox;height=520;width=915" garantisce al link l effetto grafico LightBox e le dimensioni del layer di prenotazione. Suggeriamo a chi si occupa dell inserimento del BOL nelle pagine del vostro sito di non modificare i parametri width e height (larghezza e altezza) da quelli sopra indicati (915x520) 4.3.3 Visualizzazione camere disponibili Utilizzando questo punto di partenza del BOL Flash, all utente verrà visualizzata come maschera iniziale di questo la lista delle camere disponibili di un hotel associato al vostro canale per una data e un numero di notti che devono essere passati come parametri obbligatoriamente. Questo tipo di visualizzazione prevede che all interno del vostro sito web l utente abbia la possibilità di scegliere sia l hotel da prenotare che le date di arrivo e partenza in hotel. Per ovviare all impossibilità di rendere dinamico il link tramite l attributo <a href indicando quindi anche le date di arrivo è necessario utilizzare uno script javascript che richiama il filmato flash utilizzando la funzione lightbox passando all url indicato anche i parametri presenti all interno di un vostro form. Tale script deve essere come segue: <script language="javascript"> function apribol(){ var codicecanale = "x"; var codicehotel = "y"; var codicelingua = "z"; var dataarrivoinhotel = document.getelementbyid("dataarrivo"); var notti = document.getelementbyid("notti"); var adulti = document.getelementbyid("adulti"); var bambini = document.getelementbyid("bambini"); var camere = document.getelementbyid("camere"); var urldaraggiungere = "http://www.hermeshotels.com/customersflash/flashres.jsp?"; urldaraggiungere += "ca=" + codicecanale; urldaraggiungere += "&ho=" + codicehotel; urldaraggiungere += "&ln=" + codicelingua; urldaraggiungere += "&date1=" + dataarrivoinhotel; urldaraggiungere += "&nights=" + notti; urldaraggiungere += "&adults=" + adulti; urldaraggiungere += "&childs=" + bambini; urldaraggiungere += "&rooms=" + camere; //apre il bol con effetto lightbox 6
} </script> Shadowbox.open({ content: urldaraggiungere, player: "iframe", title: "", height: 520, width: 915 }); <body> <input type="text" id="dataarrivo" value="20100901"></input> <input type="text" id="notti" value="1"></input> <input type="text" id="adulti" value="2"></input> <input type="text" id="bambini" value="0"></input> <input type="text" id="camere" value="1"></input> </body> Dove i parametri devono essere: - ca, deve essere sostituito con il codice canale identificativo del vostro sito web (vedi CAPITOLO 4.1) - ho, deve essere sostituito con il codice hotel identificativo di uno degli hotel associati al vostro canale(vedi CAPITOLO 4.1) - ln, deve essere sostituito con il codice della lingua in cui si vuole visualizzare il BOL Flash - date1, deve essere sostituito con la data di arrivo in hotel in formato YYYYMMDD - nights, deve essere sostituito con il numero di notti di soggiorno in hotel - adults, deve essere sostituito con il numero di adulti per camera - childs, deve essere sostituito con il numero di bambini per camera - rooms, deve essere sostituito con il numero di camere richiesto Se anche soltanto uno dei parametri sopra indicati non è presente o non è corretto verrà visualizzata la maschera di scelta date (vedi CAPITOLO 4.3.2) invece di quella con la lista delle camere disponibili La funzione sopra descritta può essere chiaramente modificata da voi a seconda delle vostre esigenze e può essere invocata allo scatenarsi di un evento che sarete voi stessi a decidere (click di un bottone, ecc..) L unico vincolo è quello di richiamare la funzione Shadowbox.open inserendo nell opzione content la url hermeshotels completa di tutti i parametri sopra descritti 4.3.4 Recupera prenotazione Utilizzando questo punto di partenza del BOL Flash, all utente verrà visualizzata come maschera iniziale di questo la maschera di recupero prenotazione per eventuali cancellazioni o modifiche da parte dell utente. Per avere questo punto di partenza il link da inserire all interno della vostra pagina di prenotazione dovrà essere come segue: <a href=" http://www.hermeshotels.com/customersflash/flashres.jsp?ca=x &ln=z&retrieve=1" rel="shadowbox;height=520;width=915">testo</a> dove: - x, deve essere sostituito con il codice canale identificativo del vostro sito web (vedi CAPITOLO 4.1) - z, deve essere sostituito con il codice della lingua in cui si vuole visualizzare il BOL Flash - l attributo rel="shadowbox;height=520;width=915" garantisce al link l effetto grafico LightBox e le dimensioni del layer di prenotazione. Suggeriamo a chi si occupa dell inserimento del BOL nelle pagine del vostro sito di non modificare i parametri width e height (larghezza e altezza) da quelli sopra indicati (915x520) 7
Basterà quindi aggiungere alla normale apertura del BOL Flash vista ai punti precedenti un parametro denominato retrieve con valore = 1 IMPORTANTE: Nel caso questo parametro sia presente, eventuali altri parametri aggiuntivi contenenti i filtri di ricerca di disponibilità (date, notti, ecc..) verranno ignorati e si passerà sempre e comunque alla visualizzazione della maschera di recupero prenotazione 8
4.4 Prenotazione singola tariffa o pacchetto In aggiunta a tutte le possibilità di collegamento sopra descritte il BOL Flash di HermesHotels permette a chi lo utilizza anche la possibilità di aprirlo ed effettuare una ricerca soltanto per una tariffa o pacchetto tra tutte quelle utilizzate dall hotel all interno del DMS HermesHotels. L esempio più classico da questo punto di vista è relativo alle offerte speciali, che di solito all interno dei siti alberghiere vengono pubblicizzate singolarmente con pagina dedicata. Per aggiungere quindi un bottone Acquista il pacchetto dedicato è necessario utilizzare il codice descritto nei 3 paragrafi precedenti (visualizzazione maschera di apertura) al quale va aggiunto un solo parametro aggiuntivo denomitato mt Nel caso il valore del parametro passato sia maggiore di 0 il BOL Flash si aprirà normalmente alla maschera di arrivo scelta, ma una volta arrivati alla ricerca di disponibilità elencherà soltanto le disponibilità della tariffa indicato. I codici delle tariffe o pacchetti potranno essere richiesti direttamente allo staff di HermesHotels ogni qual volta si necessita l utilizzo di questa funzione Un esempio HTML di un bottone personalizzato può essere <a href=" http://www.hermeshotels.com/customersflash/flashres.jsp?ca=x&ho=y &ln=z&mt=w" rel="shadowbox;height=520;width=915">testo</a> dove: - x, deve essere sostituito con il codice canale identificativo del vostro sito web (vedi CAPITOLO 4.1) - y, deve essere sostituito con il codice hotel identificativo di uno degli hotel associati al vostro canale(vedi CAPITOLO 4.1) - z,, deve essere sostituito con il codice della lingua in cui si vuole visualizzare il BOL Flash - w, deve essere sosituito con il codice della tariffa o pacchetto di cui ricercare la disponibilità - l attributo rel="shadowbox;height=520;width=915" garantisce al link l effetto grafico LightBox e le dimensioni del layer di prenotazione. Suggeriamo a chi si occupa dell inserimento del BOL nelle pagine del vostro sito di non modificare i parametri width e height (larghezza e altezza) da quelli sopra indicati (915x520) IMPORTANTE: l esempio sopra riportato è relativo all apertura del BOL visualizzando la maschera di scelta date come maschera di partenza, ma il parametro mt può essere aggiunto a tutte le maschere di apertura elencate nei paragrafi 4.1, 4.2 e 4.3 9
4.5 Lingue Il Booking Engine Flash può essere visualizzato per il momento in: - Inglese (default), codice 1 - Italiano, codice 2 - Tedesco, codice 3 - Francese, codice 4 - Spagnolo, codice 5 10
5 Esempi Html Di seguito riportiamo alcuni esempi di codice HTML valido per l inserimento del BOL all interno del di una pagina web. Si tenga presente che i codici canale/hotel inseriti rappresentano un sito web e un hotel di test predisposto da HermesHotels.com 5.1 Ingresso con scelta hotel <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/tr/html4/loose.dtd"> <html> <head> <title>:: Flash BOL V1::</title> <META HTTP-EQUIV="PRAGMA" CONTENT="NO-CACHE"> <META HTTP-EQUIV="Cache-Control" CONTENT="no-cache"> <META HTTP-EQUIV="Expires" CONTENT="0"> <link rel="stylesheet" type="text/css" href="http://www.hermeshotels.com/customersflash/shadowlight/shadowbox.css"> <script type="text/javascript" src="http://www.hermeshotels.com/customersflash/shadowlight/shadowbox.js"></script> <script type="text/javascript" src="http://www.hermeshotels.com/customersflash/scripts/hermes_res.js"></script> </head> <body> <a href=" http://www.hermeshotels.com/customersflash/flashres.jsp?ca=138&ln=1" rel="shadowbox;height=520;width=915">clicca qui per prenotare</a> </body> </html> 5.2 Ingresso con scelta date (per hotel specifico) <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/tr/html4/loose.dtd"> <html> <head> <title>:: Flash BOL V1::</title> <META HTTP-EQUIV="PRAGMA" CONTENT="NO-CACHE"> <META HTTP-EQUIV="Cache-Control" CONTENT="no-cache"> <META HTTP-EQUIV="Expires" CONTENT="0"> <link rel="stylesheet" type="text/css" href="http://www.hermeshotels.com/customersflash/shadowlight/shadowbox.css"> <script type="text/javascript" src="http://www.hermeshotels.com/customersflash/shadowlight/shadowbox.js"></script> <script type="text/javascript" src="http://www.hermeshotels.com/customersflash/scripts/hermes_res.js"></script> </head> <body> <a href=" http://www.hermeshotels.com/customersflash/flashres.jsp?ca=138&ho=1045&ln=1" rel="shadowbox;height=520;width=915">clicca qui per prenotare</a> </body> </html> 11
5.3 Ingresso con lista camere disponibili (per hotel e date specifiche) <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/tr/html4/strict.dtd"> <html> <head> <title>:: Flash BOL V1::</title> <META HTTP-EQUIV="PRAGMA" CONTENT="NO-CACHE"> <META HTTP-EQUIV="Cache-Control" CONTENT="no-cache"> <META HTTP-EQUIV="Expires" CONTENT="0"> <link rel="stylesheet" type="text/css" href="http://www.hermeshotels.com/customersflash/shadowlight/shadowbox.css"> <script type="text/javascript" src="http://www.hermeshotels.com/customersflash/shadowlight/shadowbox.js"></script> <script type="text/javascript" src="http://www.hermeshotels.com/customersflash/scripts/hermes_res.js"></script> <script language="javascript"> function apribol(){ } </script> var codicecanale = "x"; var codicehotel = "y"; var codicelingua = "z"; var dataarrivoinhotel = document.getelementbyid("dataarrivo").value; var notti = document.getelementbyid("notti").value; var adulti = document.getelementbyid("adulti").value; var bambini = document.getelementbyid("bambini").value; var camere = document.getelementbyid("camere").value; var urldaraggiungere = "http://www.hermeshotels.com/customersflash/flashres.jsp?"; urldaraggiungere += "ca=" + codicecanale; urldaraggiungere += "&ho=" + codicehotel; urldaraggiungere += "&ln=" + codicelingua; urldaraggiungere += "&date1=" + dataarrivoinhotel; urldaraggiungere += "&nights=" + notti; urldaraggiungere += "&adults=" + adulti; urldaraggiungere += "&childs=" + bambini; urldaraggiungere += "&rooms=" + camere; //apre il bol con effetto lightbox Shadowbox.open({ content: urldaraggiungere, player: "iframe", title: "", height: 520, width: 915 }); </head> <body> Data Arrivo: <input type="text" id="dataarrivo" value="20100901"></input></br> Notti: <input type="text" id="notti" value="1"></input></br> Adulti: <input type="text" id="adulti" value="2"></input></br> Bambini: <input type="text" id="bambini" value="0"></input></br> Camere: <input type="text" id="camere" value="1"></input><br> <input type="button" value="prenota" onclick="apribol()"> </body> </html> 12
6 Tabella delle revisioni Data Versione Note 13/04/2010 1.1.0 Inserite le funzioni di scelta hotel e ingresso con lista camere disponibili 29/10/2010 2.0.0 Aggiunta la ricerca di tariffa singola o pacchetto 13