CONTRATTO ESECUTIVO PER L'AFFIDAMENTO DI "TOURISM DIGITAL HUB - TDH" MEDIANTE ORDINATIVO DI FORNITURA NELL'AMBITO DELL'ACCORDO QUADRO PER I SERVIZI APPLICATIVI PER LE PUBBLICHE AMMINISTRAZIONI STIPULATO DA CONSIP - ID 2212 – LOTTO 1
TDH – Avviso di Pubblico Interesse (Online booking hotel) – Requisiti tecnici
CONTRATTO ESECUTIVO PER L'AFFIDAMENTO DI "TOURISM DIGITAL HUB - TDH" MEDIANTE ORDINATIVO DI FORNITURA NELL'AMBITO DELL'ACCORDO QUADRO PER I SERVIZI APPLICATIVI PER LE PUBBLICHE AMMINISTRAZIONI STIPULATO DA CONSIP - ID 2212 – LOTTO 1
CIG DERIVATO 8924679E15 – CUP J51B21002940006
Version: 1.0 Date: 04/08/2022
VERSIONS TABLE | |||
Data | Versione | Descrizione | Edited par. |
04/08/2022 | 1.0 | Primo draft | All |
LEGENDA
4 Interconnection format and method 4
Il pagamento deve essere gestito da un provider esterno certificato che deve gestire la transazione
restituire un feedback/conferma sull’avvenuto pagamento 7
Nessun dato personale del cliente (cartaDiCredito e/ altro) deve essere salvato 7
9.1 Booking status – Request 7
9.2 Booking status – Response 7
1 Obiettivo del documento
L’obiettivo del documento è quello di condividere informazioni architetturali riguardo l’implementazione delle API tra TDH e gli operatori di Hotellerie che vogliono iscriversi ad esso. A questo proposito, le seguenti API dovranno essere prese in considerazione:
• Ingestion
• Research
• Booking
• Payment
• Booking Status
Attraverso le API appena citate, gli operatori di Hotellerie iscritti al Tourism Digital Hub (TDH) potranno esportare informazioni sulle strutture connesse, consentire la possibilità di prenotare una camera, pagarla e mostrare lo stato della prenotazione.
2 Acronimi e definizioni
Acronimo | Descrizione |
AEM | Adobe Experience Manager |
API | Application Program Interface |
REST | Representational State Transfer |
SOAP | Simple Object Access Protocol |
TDH | Tourism Digital Hub |
Tabella 1 – Acronimi e definizioni
3 Autorizzazione
Per gestire le API è richiesto il seguente metodo di autenticazione: Ouath2.
Verranno condivisi “ApplicationID” e “ApplicationSecret” con i quali, chiamando un servizio in BasicAutenthication verrà restituito un Codice Temporaneo Alfanumerico (Bearer)
Il Bearer deve essere usato come Authorizzation in tutte le chiamate API ed ha una scadenza:
- Temporale
- Temporale/numero di chiamate
Il Bearer deve essere salvato ed utilizzato per tutte le chiamate fino alla sua scadenza. A scadenza deve essere rigenerato.
all the interconnections until its expiration. After the expiration it should be regenerated
4 Interconnection format and method
I servizi saranno esposti mediante protocollo API/REST o SOAP. Swagger e WSDL saranno disponibili sul Developer Portal
I servizi saranno invocabili solo mediante i metodi HTTP POST e GET
5 Ingestion
Deve essere reso disponibile uno o più metodi per gestire l’ingestion di tutti le strutture ricettive connesse.
Nella Request della chiamata ci aspettiamo i seguenti parametri:
Campi obbligatori:
- Lingua 🡪 lingua per l’export dei campi
Campi preferibili:
- Regione 🡪 Regione di interesse dell’export
- lastUpdate 🡪 Campo per gestire eventuali delta nell’export
Nella Response della chiamata ci aspettiamo i seguenti parametri:
Campi obbligatori:
- ID Struttura
- Nome struttura
- Posizione
- Indirizzo
- Descrizione
- Review
- Comodità
Campi preferibili:
- lastUpdate 🡪 Campo per gestire eventuali delta nell’export
6 Research
Deve essere reso disponibile uno o più metodi per ricercare una struttura ricettiva al fine di ricevere le disponibilità delle stanze.
Nella Request della chiamata ci aspettiamo i seguenti parametri:
Campi obbligatori:
- ID Struttura
- City 🡪 per ricercare l’albergo migliore nella città (da valutare)
- Regione 🡪 per ricercare l’albergo migliore nella regione (da valutare)
- Check-in
- Check-out
- Persone
Campi preferibili:
- Filtri 🡪 per migliorare la ricerca (ranking, prezzi, tipologia) (da valutare)
Nella Response della chiamata ci aspettiamo i seguenti parametri:
Campi obbligatori:
- Dettaglio stanza
o ID Stanza
o Descrizione
o Comodità
o Prezzo (tasse incluse/escluse)
- Policy di cancellazione
- Metodi di pagamento
Campi preferibili:
- Servizi
- Review
- Ratings
- Info varie (parcheggio, Reception..)
7 Booking
Deve essere reso disponibile uno o più metodi per prenotare/disdire/modificare una prenotazione
Nella Request della chiamata ci aspettiamo i seguenti parametri:
Campi obbligatori:
- ID Struttura
- ID Stanza
- Azione 🡪 Prenota, Modifica, Cancella
- Metodo di pagamento
- Check-in
- Check-out
- Persone
- Persone_bambini
Campi preferibili:
- Xxxxxxxxx Xxxxxxxxxx
Nella Response della chiamata ci aspettiamo i seguenti parametri
Campi obbligatori:
- ID Prenotazione
- ID Ordine
- Metodi di pagamento
8 Payment
un feedback/conferma sull’avvenuto pagamento.
Nessun dato personale del cliente (cartaDiCredito e/ altro) deve essere salvato
9 Booking Status
Deve essere reso disponibile uno o più metodi per ricevere informazioni sullo stato della prenotazione.
Nella Request della chiamata ci aspettiamo i seguenti parametri:
Mandatory fields:
- ID Prenotazione
Nella Response della chiamata ci aspettiamo i seguenti parametri:
Campi obbligatori:
- Status
Campi preferibili:
- Order Info