Import / Export Dati

Importazione e esportazione CSV/XLSX per migrazione, backup e integrazione

v 2.0Manuale Utente

Riferimenti normativi

Art. 2214 CC — Conservazione scritture: Le scritture contabili vanno conservate per 10 anni. L'export periodico garantisce disponibilità dei dati.
GDPR art. 20 — Portabilità dati: L'interessato ha diritto di ricevere i dati in formato strutturato e leggibile da macchina. CSV e XLSX soddisfano questo requisito.
D.Lgs. 196/2003 art. 33 — Misure sicurezza: I file esportati possono contenere dati sensibili e vanno trattati con le stesse misure di sicurezza.
DM 17/06/2014 — Conservazione sostitutiva: L'export non sostituisce la conservazione a norma ma è una copia di sicurezza aggiuntiva.

1Panoramica

Il modulo consente di importare dati da file esterni (migrazione) e esportare dati di NOX per analisi, backup o commercialista.

ⓘAccessibile da: Documentale → Import / Export. Richiede ruolo ADMIN.

2Formati Supportati

Formato	Estensione	Separatore	Note
CSV	.csv	Punto e virgola (`;`)	Testo puro, encoding UTF-8
XLSX	.xlsx	—	Excel nativo, supporta formattazione

⚠Il separatore CSV è il punto e virgola (;), standard italiano per evitare conflitti con la virgola decimale.

3Moduli Disponibili (10)

Modulo	Import	Export	Contenuto
Anagrafica Soggetti	✔	✔	Clienti, fornitori, pazienti con CF, P.IVA, indirizzi
Catalogo Prodotti	✔	✔	Articoli con codice, prezzo, IVA, tipo
Listini Prezzi	✔	✔	Prezzi per articolo con scaglioni
Documenti	—	✔	Fatture, DDT, preventivi (solo export)
Scadenzario	✔	✔	Scadenze pagamento
Corrispettivi	✔	✔	Chiusure giornaliere RT
Movimenti Bancari	✔	✔	Per riconciliazione bancaria
Registro IVA	✔	✔	Registrazioni con protocollo
Prima Nota	✔	✔	Registrazioni partita doppia
Allegati	✔	✔	Metadati allegati

4Esportare Dati

Selezionare il modulo.
Il sistema carica i campi disponibili.
Attivare/disattivare campi e personalizzare alias.
Selezionare formato (CSV/XLSX).
Applicare filtri (periodo, stato, ecc.).
Premere Esporta: il file viene scaricato.

5Importare Dati

Selezionare il modulo di destinazione.
Scaricare il template per il formato corretto.
Preparare il file con i dati.
Premere Importa e selezionare il file.
Verificare il mapping campi nell'anteprima.
Premere Conferma importazione.
Consultare il riepilogo: totale/importati/errori.

⚠L'import aggiunge record, non sovrascrive. Verificare duplicati. Fare sempre backup prima.

6Selezione e Alias Campi

Per ogni modulo: checkbox per attivare/disattivare, alias per rinominare colonne, drag per riordinare. Gli alias permettono di mappare intestazioni di file esterni ai campi NOX.

7Profili di Configurazione

Selezione campi e alias vengono salvati in localStorage per modulo. Alla prossima sessione, il profilo viene ricaricato. Utile per export periodici con le stesse colonne.

8Template per Import

Il pulsante “Scarica Template” genera un file vuoto con le intestazioni corrette. Compilarlo e reimportarlo per un'importazione senza errori di mapping.

9Riepilogo Import

Voce	Descrizione
Totale righe	Righe nel file
Importati	Record importati con successo
Errori	Record con errori (campo mancante, formato, duplicato)

10Buone Pratiche

Backup prima di importare
Test su workspace di prova prima della produzione
Encoding UTF-8 per caratteri accentati
Verificare duplicati prima dell'import
File piccoli (< 10.000 righe per batch)

?Domande Frequenti (FAQ)

Quale separatore usa il CSV?

Punto e virgola (;), standard italiano.

Posso importare fatture?

I Documenti sono solo export. Importare Soggetti e Catalogo, poi ricreare i documenti. Oppure importare nel Registro IVA.

L'import sovrascrive dati esistenti?

No. L'import aggiunge nuovi record.

Cosa succede se manca un campo obbligatorio?

La riga viene segnalata come errore e non importata. Le altre righe valide procedono normalmente.

Posso importare da Excel?

Sì, il formato XLSX è supportato nativamente.

Come gestisco gli accenti nei nomi?

Salvare in UTF-8. Excel: Salva con nome → CSV UTF-8. LibreOffice: selezionare UTF-8 al salvataggio.

Limite righe per import?

Nessun limite tecnico, ma consigliato 5.000-10.000 righe per batch.

Il profilo funziona su altro browser?

No. Profili in localStorage del browser corrente.

Come esporto per il GDPR (portabilità)?

Esportare Anagrafica Soggetti filtrata per il soggetto specifico in CSV/XLSX (art. 20 GDPR).

I dati esportati sono sensibili?

Sì, possono contenere CF, P.IVA, indirizzi. Trattare i file con le stesse misure di sicurezza del GDPR.

+Hub Import / Export Fatture XML

La pagina Import / Export ora include un hub di shortcut in cima con due card navy che portano a procedure dedicate:

📥 Import XML fatture (bulk)

Card "Import XML fatture (bulk)" → pagina /import-export/xml-bulk. Permette di:

Drag&drop massivo di fino a 50 file XML / P7M insieme. Trascina i file dal Finder/File Explorer dentro la zona blu, oppure click per scegliere da disco.
Supporto P7M firmati digitalmente (CADES): l'app estrae automaticamente l'XML dalla busta firmata.
Selettore tipo: Passive (acquisti) o Attive ricevute. Le passive vengono importate direttamente; le attive ricevute vengono solo lette per evitare duplicati con fatture già emesse.
Idempotenza: se la stessa fattura (per P.IVA fornitore + numero + anno) è già presente, viene saltata invece di duplicata.
Stato per file: ogni file mostra il suo stato (in coda / parsing / importato / saltato / errore) con messaggio dettagliato.

🔄 Polling automatico Cassetto Fiscale (in fase di completamento)

Sulla stessa pagina c'è una sezione per configurare il polling automatico da Aruba, Buffetti, TS Digital o Agyo. Configura provider, username, password e intervallo (default 30 min): il sistema scarica e importa le fatture passive nuove automaticamente.

⚠La connessione effettiva al provider richiede la documentazione delle API del cassetto. Per ora il form salva la configurazione e il bottone "Esegui polling adesso" è disponibile come trigger manuale. Il cablaggio definitivo verrà completato quando il cliente fornirà le credenziali del proprio provider.

📊 Esporta al commercialista

Card "Esporta al commercialista" (sempre nell'hub) → porta direttamente alla procedura esistente /export-commercialista per generare il pacchetto periodico di fatture + registri da inviare allo studio.