Come collegare il gestionale alberghiero con PayTourist tramite API

È possibile collegare il proprio gestionale alberghiero a PayTourist tramite integrazione API, consentendo ai due sistemi di comunicare e scambiare automaticamente i dati.

Prima di procedere con la configurazione, ti consigliamo di verificare che il tuo gestionale alberghiero sia presente tra quelli compatibili con l'integrazione API, potrai consultare l'elenco dei gestionali integrati accedendo al seguente link-> Elenco Gestionali Alberghieri Integrati tramite Api

Quali dati sono necessari per effettuare l'integrazione?
 

Per collegare il tuo gestionale a PayTourist, dovrai fornire alla tua software house i seguenti dati:

• Token di accesso API
• ID della struttura

Di seguito ti illustriamo come recuperare entrambi i dati direttamente dalla piattaforma PayTourist.

Come creare un utente di tipo Booking

Per prima cosa, dovrai creare un apposito utente di tipo Booking, attraverso il quale sarà possibile configurare l'integrazione API.

Segui questi passaggi:

1. Accedi alla piattaforma PayTourist.

   Dal menù laterale sinistro, seleziona la voce "Utenti".

   

   Clicca sul pulsante "+ Nuovo Utente", situato in alto a destra.

   Seleziona come tipologia di utente "Booking".

   

   Compila tutti i campi richiesti e completa la creazione del nuovo utente.

   Attenzione! In questa fase è fondamentale inserire un indirizzo email diverso da quello già utilizzato per l'account Amministratore.

   N.B. Se il tuo gestionale gestisce più strutture, durante la fase di creazione del Booking Struttura dovrai selezionare tutte le strutture di tua proprietà.

   

Una volta creato l'utente Booking, potrai procedere con la generazione del Token di accesso API.

Come generare il Token di accesso API

Dopo aver creato l'utente Booking, segui questi passaggi:

1. Torna nel menù laterale sinistro e seleziona nuovamente la voce "Utenti".

   Individua l'utente Booking appena creato.

   Clicca sul pulsante arancione "Modifica".

    

   

   Seleziona in basso a destra il software gestionale che desideri associare all'utente e clicca il tasto ''Salva''.

   Clicca sul pulsante "Token di accesso API", situato a sinistra.

   

    

   Clicca sul pulsante ''+ Crea Token'' in alto a destra

   

   Se richiesto, inserisci un nome identificativo per il Token (il campo è facoltativo).

   

A questo punto, il sistema genererà il tuo Token di accesso API.

Attenzione!

Il Token generato sarà visibile una sola volta. Ti consigliamo di copiarlo immediatamente per intero e conservarlo in un luogo sicuro, ad esempio in un file di testo sul tuo computer, così da poterlo recuperare facilmente in caso di necessità.

Successivamente, dovrai comunicarlo alla tua software house, affinché possa completare la configurazione dell'integrazione con PayTourist.

Come recuperare l'ID della struttura

Oltre al Token di accesso API, dovrai comunicare alla tua software house anche l'ID della struttura ricettiva.

Per recuperarlo, segui questo percorso:

Menù laterale sinistro → Struttura → Info

All'interno della sezione "Info", troverai in alto a sinistra, evidenziato in verde, il codice identificativo della tua struttura (ID struttura).

Se il tuo gestionale gestisce più strutture ricettive, dovrai tenere presente che:

• Il Token di accesso API sarà unico 
• L'ID struttura sarà diverso per ciascuna struttura ricettiva.

Pertanto, dovrai spostarti da una struttura all'altra utilizzando l'apposito pulsante di selezione presente nella piattaforma e recuperare l'ID identificativo di ciascuna struttura.

Assicurati di annotare tutti gli ID, in modo da poterli comunicare correttamente alla tua software house.

Per maggiori dettagli su come generare il Token potrai consultare la nostra guida a questo link ->Utente Tipo Booking - Come creare e gestire un Token utente

Una volta completati tutti i passaggi, avrai a disposizione i dati necessari per consentire alla tua software house di configurare il collegamento tra il gestionale alberghiero e PayTourist.

Prima di procedere, verifica di aver recuperato entrambi i seguenti dati:

• Token di accesso API: il codice generato attraverso l'utente Booking.
• ID della struttura: il codice identificativo di ciascuna struttura da collegare al gestionale.

Una volta trasmessi questi dati alla tua software house, quest'ultima potrà procedere con la configurazione dell'integrazione API.