Come Collegare ROSS 1000 a Speedy Host: Credenziali e CIR
Tredici regioni italiane raccolgono la movimentazione turistica sul portale ROSS 1000, gestito dal sistema GIES: Abruzzo, Basilicata, Calabria, Emilia-Romagna, Lazio, Liguria, Lombardia, Marche, Molise, Piemonte, Sardegna, Toscana (province di Firenze, Pistoia e Prato) e Veneto. Collegando il portale a Speedy Host, la comunicazione mensile parte da sola: niente accessi manuali, niente file da preparare a fine mese.
Il collegamento richiede tre dati e, nella pratica, si inceppa quasi sempre sugli stessi due punti. Questa guida li affronta entrambi in modo esplicito.
Le credenziali del web service non sono quelle del sito
È l'equivoco che blocca più host, e vale la pena chiarirlo prima di tutto il resto.
Sul portale ROSS 1000 esistono due utenze diverse. Quella con cui accedi al sito, per consultare i dati e caricare i file a mano. E quella per la trasmissione automatica da software gestionale, che è un'utenza tecnica separata e in molte regioni va richiesta o abilitata espressamente.
Se inserisci in Speedy Host le credenziali con cui fai login sul sito, il portale rifiuta la connessione — anche se quelle credenziali sono perfettamente valide per l'uso manuale. Non è un errore tuo e non è un problema di password sbagliata: sono semplicemente credenziali per un altro scopo.
Quando scrivi all'ente regionale, la formula che evita il fraintendimento è:
«Gestisco una struttura ricettiva e desidero attivare la trasmissione automatica dei dati di movimentazione turistica tramite web service da software gestionale. Vi chiedo le credenziali dedicate (username e password) e la conferma del codice di collegamento della struttura.»
L'ente competente varia per regione: può essere l'APT provinciale, l'assessorato regionale al turismo o l'ufficio statistiche. In alternativa puoi scrivere al supporto GIES all'indirizzo info@gies.sm.
I tre dati che servono
| Dato | Cos'è | Dove si trova |
|---|---|---|
| Username | Utenza tecnica del web service | Fornita dall'ente regionale su richiesta |
| Password | Password della stessa utenza tecnica | Fornita insieme all'username |
| Codice Collegamento (CIR) | Identifica la singola struttura | Anagrafica della struttura sul portale ROSS 1000 |
Il terzo è quello che viene dimenticato più spesso, perché molte istruzioni parlano solo di «username e password». Senza CIR il collegamento non può funzionare: è il codice che dice al portale quale struttura sta trasmettendo.
Il Codice Collegamento (CIR): come si scrive
Il CIR va copiato esattamente come appare sul portale, punteggiatura compresa. Il formato non è uniforme: cambia da regione a regione, e questa è la fonte di errore più frequente dopo le credenziali sbagliate.
| Regione | Formato tipico | Struttura |
|---|---|---|
| Veneto, Lombardia, Piemonte | 025001-ALB-00039 | codice comune · sigla tipo struttura · progressivo |
| Lazio | 056036-B&B-00010 | stessa struttura, ma la sigla può contenere la & |
| Liguria | 009064-LT-0063 | sigla di due lettere, progressivo più corto |
| Sardegna | 090047C2000U1192 | nessun separatore |
Sulla & in particolare: se la tua struttura è registrata come bed & breakfast, in alcune regioni la sigla del tipo struttura è letteralmente B&B, con la e commerciale. Va scritta così com'è. Sostituirla con BEB o con altro produce un codice che il portale non riconosce, e l'invio viene rifiutato con il messaggio «Non è presente alcuna struttura attiva per il codice ricevuto».
Come inserire le credenziali su Speedy Host
- Accedi alla dashboard di Speedy Host e apri la struttura da configurare.
- Vai su Impostazioni e clicca «Modifica credenziali».
- Dal menu «Regione struttura» seleziona la tua regione: compariranno i campi dedicati a ROSS 1000.
- Compila Username GIES, Password GIES e Codice Collegamento (CIR).
- Clicca «⚡ Testa connessione». In pochi secondi il portale risponde: se qualcosa non va, il messaggio indica quale dei tre dati controllare.
- Clicca «Salva». Dal 1° del mese successivo potrai inviare la movimentazione con un click dalla sezione ISTAT della struttura.
Ogni struttura ha il proprio CIR. Se gestisci più appartamenti registrati separatamente, ognuno va configurato con il suo codice. Se invece più unità condividono lo stesso codice struttura, Speedy Host le aggrega automaticamente in un unico invio: è il portale a pretenderlo, la movimentazione è per struttura e non per appartamento.
Gli errori più comuni e cosa significano
Speedy Host traduce le risposte del portale in messaggi comprensibili. Ecco cosa vuol dire ciascuno e come si risolve.
«Le credenziali del web service non sono state accettate»
Il portale ha rifiutato la connessione prima ancora di guardare i dati. Nella quasi totalità dei casi significa che stai usando le credenziali del sito invece di quelle del web service: torna al primo capitolo di questa guida e richiedile all'ente. Più raramente l'utenza esiste ma non è ancora stata abilitata alla trasmissione automatica.
«Non trova nessuna struttura attiva per il codice»
Le credenziali sono state riconosciute, ma il CIR non corrisponde a nessuna struttura attiva per quell'utenza. Controlla due cose sul portale: che il codice sia identico a quello in anagrafica, separatori e & compresi, e che la struttura risulti attiva e associata alla tua utenza.
«Il portale ha rifiutato i dati di N ospiti»
Il collegamento funziona: il portale ha accettato l'invio ma ha scartato singole schede. Speedy Host elenca gli ospiti per nome e il motivo di ciascuno — di solito un dato di provenienza mancante o non riconosciuto. Correggi le schede indicate e rimanda.
«Capacità struttura non allineata»
Il numero di camere o posti letto dichiarato non corrisponde a quello registrato in anagrafica sul portale. Si risolve allineando l'anagrafica lato portale regionale.
«Mese già validato dalla Regione»
Un operatore regionale ha chiuso il mese: da quel momento non è più modificabile per via telematica. Eventuali correzioni vanno richieste direttamente alla Regione.
Se la scadenza è vicina e il collegamento non parte
Sistemare le credenziali con un ente regionale può richiedere giorni. Non serve rischiare la scadenza: il tracciato ufficiale ROSS 1000 prevede due modalità di trasmissione, e la seconda non ha bisogno del collegamento automatico.
- Dalla pagina ISTAT del mese, clicca «Rivedi anteprima».
- Clicca il pulsante «⇣ TXT»: scarichi il file della movimentazione del mese, già nel formato richiesto.
- Accedi al portale ROSS 1000 con le tue credenziali abituali — quelle del sito, qui vanno benissimo — e caricalo nella sezione di importazione da software gestionale.
Non rinominare il file. La specifica richiede che il nome inizi con il codice della struttura, ed è già così com'è stato generato.
Il mese risulta comunicato a tutti gli effetti. Il collegamento automatico si sistema con calma, senza la scadenza sul collo.
Domande frequenti
Posso usare le credenziali con cui accedo al sito ROSS 1000?
Quasi mai. Sono un'utenza distinta da quella per la trasmissione automatica, che in molte regioni va richiesta a parte. Se le usi, il portale rifiuta la connessione pur essendo credenziali valide per l'uso manuale.
Devo rifare la configurazione ogni mese?
No. Le credenziali si inseriscono una volta sola. Da lì in avanti ogni check-in approvato alimenta la movimentazione, e l'invio del mese si fa con un click — con il promemoria che ti avvisa quando si avvicina la scadenza.
Le credenziali sono al sicuro?
Sì. Sono salvate con accesso limitato esclusivamente alla tua struttura (Row Level Security) e non vengono mai condivise con altri utenti.
La mia regione non usa ROSS 1000: come funziona?
La Campania usa Sinfonia Turismo SMART, con API Key e CUSR al posto di username e password: trovi la procedura nella guida dedicata all'API Key Sinfonia. La Puglia usa SPOT, dove l'ultimo passaggio è un caricamento manuale su dms.puglia.it. Per il quadro completo delle regioni supportate, vedi la panoramica delle 15 regioni.
Vuoi che la comunicazione ISTAT si mandi da sola?
Prova Speedy Host gratis per 14 giorni· Speedy Host
Domande frequenti
- Posso usare le credenziali con cui accedo al sito ROSS 1000?
- Quasi mai. Sul portale ROSS 1000 esistono due utenze distinte: quella per accedere al sito e quella per la trasmissione automatica tramite web service da software gestionale, che in molte regioni va richiesta o abilitata espressamente. Se inserisci quelle del sito, il portale rifiuta la connessione anche se sono perfettamente valide per l'uso manuale.
- Cos'è il Codice Collegamento (CIR) e dove lo trovo?
- È il codice che identifica la tua struttura sul portale regionale, e si trova nell'anagrafica della struttura sul ROSS 1000. Il formato cambia da regione a regione: in Veneto e Lombardia è del tipo 025001-ALB-00039, in Lazio 056036-B&B-00010, in Liguria 009064-LT-0063, in Sardegna 090047C2000U1192 senza separatori. Va copiato esattamente com'è, punteggiatura compresa.
- Il mio CIR contiene una & : devo sostituirla?
- No, va scritta così com'è. In alcune regioni, tra cui il Lazio, la sigla del tipo struttura per un bed & breakfast è letteralmente B&B con la e commerciale. Sostituirla con BEB o con altro produce un codice che il portale non riconosce, e l'invio viene rifiutato con il messaggio «Non è presente alcuna struttura attiva per il codice ricevuto».
- Quali dati servono per collegare ROSS 1000 a Speedy Host?
- Tre: username e password dell'utenza dedicata al web service, e il Codice Collegamento (CIR) della struttura. Molte istruzioni citano solo username e password: senza il CIR il collegamento non può funzionare, perché è il codice che dice al portale quale struttura sta trasmettendo.
- Il collegamento non funziona e la scadenza è vicina: cosa faccio?
- Il tracciato ufficiale ROSS 1000 prevede due modalità di trasmissione. Dalla pagina di anteprima ISTAT scarichi il file TXT del mese con il pulsante ⇣ TXT e lo carichi a mano sul portale, nella sezione di importazione da software gestionale, usando le tue credenziali abituali del sito. Il mese risulta comunicato a tutti gli effetti, e il collegamento automatico si sistema con calma. Importante: non rinominare il file, il nome deve iniziare con il codice della struttura.
- Quali regioni usano ROSS 1000?
- Tredici: Abruzzo, Basilicata, Calabria, Emilia-Romagna, Lazio, Liguria, Lombardia, Marche, Molise, Piemonte, Sardegna, Toscana (province di Firenze, Pistoia e Prato) e Veneto. La Campania usa invece Sinfonia Turismo SMART e la Puglia il sistema SPOT.