Come trovare l'API KEY Sinfonia Turismo della Regione Campania

A cosa serve l'API KEY Sinfonia

L'API KEY di Sinfonia Turismo SMART è la chiave che permette a Speedy Host di comunicare in automatico con il portale della Regione Campania per inviare ogni mese il Modello C/59 — la rilevazione obbligatoria dei flussi turistici (arrivi, presenze, partenze) che ogni struttura ricettiva in Campania deve trasmettere entro il 5 del mese successivo.

Insieme all'API KEY serve anche il CUSR (Codice Unico Struttura Ricettiva, 15 caratteri alfanumerici): i due codici identificano in modo univoco la tua struttura sul portale regionale. Una volta inseriti in Speedy Host, l'invio del Modello C/59 diventa automatico: basta confermare i dati aggregati dai check-in e cliccare «Invia al portale regionale».

Buona notizia: contrariamente a quanto accade in altre regioni, l'API KEY in Campania non va richiesta via email. È già disponibile nella tua area riservata del portale Sinfonia — basta sapere dove cercarla.

Prerequisiti

Prima di procedere, assicurati di avere:

1. Un'identità digitale: SPID, CIE o CNS. Senza una di queste non puoi accedere all'area riservata del portale regionale.
2. La struttura già censita dal Comune. Il CUSR viene rilasciato dal Comune in fase di SCIA (Segnalazione Certificata di Inizio Attività). Se non sei ancora censito, contatta l'Ufficio Turismo del tuo Comune.
3. La capacità ricettiva configurata su Sinfonia (posti letto, camere, carattere annuale/stagionale). Si configura una sola volta, sempre via SPID nell'area riservata. È un prerequisito per poter inviare il Modello C/59.

Come trovare l'API KEY su Sinfonia Turismo SMART

Segui questi passi nell'ordine indicato:

1. Apri il browser e vai al portale Sinfonia Turismo SMART: turismo.regione.campania.it. Nella sezione Utente strutture ricettive (colonna sinistra), clicca «Accedi all'area riservata».
2. Autenticati con SPID, CIE o CNS.
3. Dopo il login accedi alla home page dell'area riservata, che mostra sei riquadri: Profilo utente, Anagrafica, Movimentazione clienti, Comunicazione prezzi, Reportistica, Inserisci delegati struttura ricettiva.
4. Verifica la struttura selezionata. In alto a destra trovi un selettore con scritto «Struttura | [nome struttura]». Se hai più strutture associate al profilo, clicca l'icona matita accanto al nome per cambiare struttura prima di proseguire.
5. Clicca sul menu «Anagrafica» nella barra di navigazione in alto, poi seleziona «Gestione Anagrafica Struttura Ricettiva».
6. In cima alla pagina — appena sotto l'avviso «In caso di dati non corretti si prega di contattare il comune» — troverai la riga: «Per interoperare con questa struttura utilizzare l'API KEY:» seguita dal codice in formato UUID (es. 8778bac0-2563-4933-a0e0-01c7b283e186). Questo è il valore da copiare.

Suggerimento: seleziona l'API KEY con il mouse e copiala con Cmd+C (Mac) oppure Ctrl+C (Windows). Fai attenzione a non copiare spazi iniziali o finali.

Come trovare il CUSR della struttura

Il CUSR (15 caratteri alfanumerici, es. 15063060LOB0212) viene rilasciato dal Comune in fase di SCIA e è sempre visibile su Sinfonia:

1. Dalla home page dell'area riservata, clicca sul menu «Profilo utente» nella barra in alto, poi su «Visualizza le tue strutture ricettive».
2. Si apre la tabella delle strutture associate al tuo profilo. Il CUSR è riportato nella prima colonna di ogni riga.
3. In alternativa, il CUSR coincide spesso con il codice struttura che hai ricevuto via email al momento della censura da parte del Comune.

Come inserire le credenziali su Speedy Host

Una volta recuperati API KEY e CUSR, configurarli su Speedy Host richiede meno di un minuto:

1. Accedi alla dashboard di Speedy Host e apri la struttura che vuoi configurare.
2. Scorri fino alla sezione «Invio automatico ISTAT» e clicca il pulsante di modifica.
3. Dal menu a tendina «Regione struttura» seleziona Campania: compariranno i campi CUSR e apiKey.
4. Incolla il CUSR nel primo campo e l'API KEY nel secondo.
5. Clicca «Testa connessione» per verificare che il portale risponda correttamente. In caso di successo vedrai i dati della tua struttura (denominazione, CIN, comune, numero camere).
6. Clicca «Salva». Da questo momento, dal 1° del mese successivo potrai inviare il Modello C/59 con un click dalla sezione ISTAT della struttura.

Se qualcosa non funziona

Il portale non mostra l'API KEY nella scheda anagrafica. In alcuni casi l'API KEY non è ancora stata generata lato Regione. Prova a completare prima la capacità ricettiva (posti letto, camere, chiusure) nella sezione apposita di Sinfonia: in genere la chiave compare automaticamente una volta completato l'onboarding della struttura. In casi rari puoi contattare il supporto della Regione Campania all'indirizzo supporto.strutturericettive@regione.campania.it.

Credenziali rifiutate da Speedy Host. Le cause più comuni sono:

• Spazi bianchi all'inizio o alla fine dell'API KEY o del CUSR (copia-incolla senza selezionare spazi ulteriori).
• Credenziali copiate dall'anagrafica di una struttura diversa (verifica che in cima alla pagina del portale sia selezionata la struttura giusta).
• Capacità ricettiva non ancora configurata: l'API risponde con un errore generico finché la Regione non ha tutti i dati minimi di anagrafica.

Il mese risulta già «validato». Una volta che un mese viene validato manualmente da un operatore regionale, non è più modificabile via API. In questo caso eventuali correzioni vanno richieste al supporto Sinfonia.

Perché automatizzare l'invio del Modello C/59

Senza automazione, ogni mese l'host deve accedere manualmente al portale Sinfonia via SPID, calcolare giorno per giorno arrivi, presenze e partenze disaggregati per provenienza (provincia italiana o nazione estera), compilare il Modello C/59 e inviarlo entro il 5 del mese successivo. Per una struttura con una decina di check-in al mese è almeno un'ora di lavoro ripetitivo, con il rischio concreto di sanzioni se si salta la scadenza.

Speedy Host aggrega automaticamente i dati già raccolti per le schedine Alloggiati, calcola la movimentazione conforme alle specifiche regionali (incluse le presenze della notte precedente calcolate in modo ricorsivo), mostra un'anteprima con tutti i controlli di validazione e — una volta che confermi — trasmette il Modello C/59 a Sinfonia tramite le API gestionali ufficiali v1.3.0. Ricevi una notifica email di conferma e il file TXT dell'invio resta archiviato per eventuali verifiche.

Per un quadro completo degli adempimenti in Campania, consulta anche la guida agli obblighi legali per affitti brevi in Italia.