Premessa
Quanto descritto nel presente documento è riferito alla nuova modalità di Export dati ISTAT e Contributo di Soggiorno all'intermediario LTS tramite web services verso la piattaforma ASTAT, che raccoglie i dati statistici di chi alloggia nelle strutture ricettive della provincia di Bolzano.
N.B.: Ad ogni invio dati saranno inviati elementi sia per ISTAT sia per Contributo di Soggiorno. Per quanto riguarda i codici esenzione del Contributo di Soggiorno non occorre gestire alcuna configurazione tabellare in quanto già cablati nella procedura.
La procedura implementata prevede la creazione e l'invio silente (in automatico) di un file contenente i dati relativi agli ospiti alloggiati, arrivati nell'arco della giornata o intervallo periodo impostato nella maschera di lancio del foglio Excel (Ver. 23.3.0), tramite processo di export lanciato manualmente dall'utente.
N.B.: la procedura è attivata dal foglio Excel nel quale occorre definire i classici parametri di lancio, comprensivi del percorso di registrazione dei file di log, nel quale verranno salvati due file per ogni giorno esportato, uno contenente i dati inviati e uno contenente la risposta del portale.
La procedura prevede che l'utente sia in possesso dei seguenti dati, comunicati dalla piattaforma ASTAT in fase di registrazione struttura (i codici visualizzati di seguito sono di puro esempio):
URL (endpoint del portale LTS): https://go.lts.it/api/
Codice Struttura: codice OTA della struttura che invia i dati, così come indicato nel portale LTS.
UserID: TeamSystem
Password: TeamSystem
Client ID: codice del PMS di riferimento che va inserito nella maschera di dialogo aperta su Excel (es. BB123455).
Configurazioni TSH
Strutture Codice ISTAT
Nella sezione Dati Statistici della struttura occorre impostare il valore ASTAT nel campo ISTAT.
Parametri
Il sistema di export necessita di alcune transcodifiche relative al tipo di arrangiamento utilizzato durante il soggiorno degli ospiti, come riportato nella sezione MealPlan del documento di specifiche LTS:
1: All inclusive.
3: Bed and breakfast.
10: Full board.
12: Half board (or 3/4 board).
14: Room only.
Poiché in TSH non è definito un codice univoco per l’arrangiamento ALL INCLUSIVE è stato creato un parametro per definire quale sia il tipo addebito di Arrangiamento per la struttura di pertinenza.
Il parametro definisce gli addebiti che devono essere considerati di tipo ALL INCLUSIVE. Occorre inserire i codici addebito separati da virgola.
Avvio procedura Export Dati
All’avvio del report, Ver. 23.3.0, occorre definire i classici parametri di lancio, comprensivi del percorso di registrazione dei file di log.
Seguito selezione pulsante di lancio estrazione dati, il sistema apre la maschera sotto riportata, da compilare con i dati comunicati dall'intermediario ASTAT.
Al termine della fase silente di invio dati, l'operatore riceve l'esito (Operazione completata con successo in esempio) che determina la conclusione dell’operazione di invio.
Nella cartella di log la procedura deposita due file per ogni giorno esportato, uno di log (Astat_Log_20240101.txt) e uno di response (Astat_Response_20240101.txt, che riporta i seguenti valori: {"success": true, "data": {"accommodation": {"id":0000}}}).
Nel foglio Excel, sezione Astat Dettagli, è riportato il riepilogo dei dati inviati. Per comodità dell’operatore nell’ultima colonna del report è stato riportato in chiaro il nome dell’ospite e la data di arrivo.
N.B.: il nominativo in chiaro è riportato solo in questo contesto e non è oggetto di esportazione verso il sistema di statistiche ASTAT.
Commenti
0 commenti
Questo articolo è chiuso ai commenti.