Salta ai contenuti

Esportazioni per il commercialista

In attesa di revisione del commercialista. Questa pagina e i contenuti della cartella ZIP toccano cedolare, ritenuta, P.IVA e tassa di soggiorno. Deve essere riveduta dal commercialista del pilota prima di essere considerata autorevole. Riferimenti: FISCAL_RULES.md §CS-001/§CS-002 (cedolare), §RIT-001/§RIT-002 (ritenuta), §PI-001 (P.IVA), §TS-009 (tassa di soggiorno).

La pagina Esportazioni è l’archivio delle cartelle ZIP che hai generato per il commercialista, in ordine cronologico. Da qui ne generi una nuova, ne scarichi una esistente, o ne apri il dettaglio.

Come ci arrivi

Dal menu a sinistra fai clic su Commercialista.

Cosa vedi quando la apri

In cima il titolo Esportazioni commercialista con un pulsante Nuova esportazione a destra.

Sotto, una tabella con sette colonne: Inizio periodo, Fine periodo, Generato il, Stato, N. file, Dimensione, Azioni.

Ogni riga ha due azioni: Visualizza (apre il dettaglio dell’esportazione) e Scarica ZIP (scarica direttamente il file).

Elenco esportazioni — vuoto nella seed dimostrativa.

Se non hai ancora generato nessuna esportazione, vedi Nessuna esportazione.

Cosa puoi fare

Generare una nuova esportazione

Fai clic su Nuova esportazione. Si apre la finestra Genera esportazione con due campi:

  1. Inizio periodo — data di inizio (formato 2026-04-01).
  2. Fine periodo — data di fine inclusa (formato 2026-04-30).

Fai clic su Genera. Il sistema crea la cartella ZIP in background; entro pochi secondi compare una nuova riga in tabella con lo stato completed. Se qualcosa va storto, vedi un errore nel form.

Scaricare un’esportazione

Fai clic su Scarica ZIP sulla riga che ti interessa. Il file parte in download come commercialista_{uuid}.zip.

Aprire il dettaglio

Fai clic su Visualizza sulla riga. Si apre la pagina di dettaglio con: i metadati dell’esportazione (chi l’ha generata e quando, l’hash SHA-256 del payload per verifica integrità), il periodo coperto, il numero di file e la dimensione totale.

Cosa c’è dentro la cartella ZIP

La cartella ZIP è la stessa che il commercialista del proprietario si aspetta per redigere la dichiarazione dei redditi del periodo. Vedi la pagina dedicata Commercialista → Per il tuo commercialista per il contenuto dettagliato.

Domande frequenti

Posso generare un’esportazione per un periodo già esportato? Sì. Non c’è un controllo di duplicazione. Ogni esportazione è una fotografia indipendente al momento della sua generazione. Se i dati sono cambiati dall’esportazione precedente (es. una spesa aggiunta retroattivamente), la nuova esportazione riflette i dati attuali.

Il commercialista può accedere direttamente alla piattaforma? Non al momento. Tu generi la cartella ZIP qui e gliela mandi (email, drive condiviso, WhatsApp). Una vista “commercialista diretto” è prevista in una versione futura.

Quanto tempo restano archiviate le esportazioni? Indefinitamente. Vengono cancellate solo se elimini manualmente una riga (dalla pagina di dettaglio). Sono utili come storico di audit.

Come verifica il commercialista che il file non è stato modificato dopo il download? Confronta lo SHA-256 indicato nella pagina di dettaglio con l’hash del file scaricato (shasum -a 256 commercialista_*.zip). Se i due valori coincidono, il file è autentico.

Periodo straddle dell’anno fiscale: come gestisco le prenotazioni a cavallo (es. check-in dicembre, check-out gennaio)? La piattaforma fa rientrare le prenotazioni nel periodo di check-in per il calcolo della cedolare/ritenuta. Per la tassa di soggiorno si usa il periodo di permanenza effettiva. Per una prenotazione 28 dicembre → 3 gennaio: cedolare → anno in cui cade il 28 dicembre; tassa → ripartita fra dicembre e gennaio per quanto pertiene a ciascun mese. Per casistiche di confine, verifica con il commercialista.

Il sistema mi avvisa quando è ora di generare l’esportazione del trimestre/anno? No, al momento. La generazione è manuale. Un promemoria automatico è previsto in una versione futura.