Che cosa viene verificato in un file di estratto conto

Queste righe non hanno tante colonne quante l’intestazione. Il colpevole abituale è una virgola non racchiusa tra virgolette dentro una descrizione («Bonifico a Marco, risparmi»). Gli importatori spostano allora tutte le colonne successive o rifiutano il file. Va corretto a mano: una riparazione automatica dovrebbe indovinare quale virgola sia reale.

Diversi importatori smettono di leggere alla prima riga vuota e scartano in silenzio tutto ciò che segue: il classico «è stata importata solo metà delle mie operazioni». Le righe vuote possono essere rimosse automaticamente.

Excel aggiunge questo marcatore salvando come «CSV UTF-8». Alcuni programmi di finanza lo leggono come parte del nome della prima colonna («Data» invece di «Data») e non trovano più l’intestazione attesa. Se il tuo importatore si lamenta di una prima colonna sconosciuta, rimuovilo.

È esattamente ciò che YNAB segnala come «file vuoto» e altri programmi come «0 operazioni importate». L’esportazione della tua banca non conteneva righe: di solito un periodo senza movimenti, oppure un pulsante di esportazione che ha prodotto solo i titoli delle colonne.

Le esportazioni Excel italiane ed europee separano le colonne con «;». Gli importatori che si aspettano virgole (YNAB, molti moduli di caricamento) leggono l’intera riga come una sola colonna. Il file può essere riscritto con le virgole automaticamente; i campi tra virgolette vengono preservati correttamente.

Nomi di beneficiari come «AT&T» o «H&M» devono essere scritti «AT&T» dentro un file OFX/QFX. Una «&» grezza interrompe l’analisi SGML/XML esattamente in quel punto: uno dei motivi più comuni per cui un file non si importa pur aprendosi senza problemi in un editor.

Il file inizia con un marcatore UTF-8 invisibile. Molti analizzatori OFX pretendono che i primissimi caratteri siano «OFXHEADER» e altrimenti rifiutano il file come non valido. È una causa frequente dell’errore «file non valido» per file che in un editor di testo appaiono perfettamente normali.

L’aggregato <OFX> non viene mai chiuso. Di solito significa che il download è stato interrotto dalla banca o dal browser. La maggior parte degli importatori si limita a dire «impossibile leggere il file». Il tag di chiusura può essere aggiunto, ma verifica che l’elenco delle operazioni sia completo.

Le date OFX devono essere scritte come AAAAMMGG (facoltativamente con orario e fuso). Valori come «2026-08-01» o «01/08/2026» portano l’importatore a rifiutare l’operazione o l’intero file.

Ogni <STMTTRN> deve portare un FITID univoco: è così che Quicken, QuickBooks e YNAB sanno se un’operazione è già stata importata. Le operazioni che ne sono prive vengono scartate in silenzio o fanno fallire l’intera importazione. Identificativi stabili possono essere generati da data, importo e beneficiario.

Un file OFX 1.x deve iniziare con un blocco di intestazione (OFXHEADER:100, DATA:OFXSGML, VERSION, ENCODING …) prima del corpo <OFX>. Senza di essa Quicken, QuickBooks e GnuCash rifiutano il file. Un’intestazione standard può essere anteposta automaticamente.

I valori TRNAMT devono essere numeri semplici con il punto come separatore decimale (per esempio -1234.56). Separatori delle migliaia, simboli di valuta o spazi fanno saltare l’operazione.

Nomi con lettere accentate (é, ü, à …) compaiono in un file la cui intestazione dichiara ASCII puro. Alcuni importatori li sostituiscono con caratteri illeggibili, altri si interrompono. Chiedi alla banca un’esportazione UTF-8. Nessuna traslitterazione automatica viene applicata, deliberatamente, per non alterare i nomi.

Due operazioni diverse condividono lo stesso FITID. Gli importatori trattano le voci con FITID uguale come una sola operazione e saltano tutte tranne la prima: il classico «dopo l’importazione mancano delle operazioni». I duplicati possono essere resi univoci con un suffisso numerico.

Il file si legge correttamente ma non contiene alcun <STMTTRN>. I programmi lo segnalano come «file vuoto» o «0 operazioni importate». Le banche producono file vuoti quando il periodo scelto non contiene movimenti: riscarica con un intervallo più ampio.

I file QFX e QBO contengono di norma un tag <INTU.BID> che identifica una banca autorizzata per Web Connect. Se manca, Quicken può rifiutare il file con «non è un file Web Connect valido». Questo strumento non inserisce identificativi bancari: quel valore è assegnato alla banca da Intuit. In alternativa importa via CSV.

Questo è un estratto di deposito titoli (INVSTMTRS), i cui movimenti sono acquisti, vendite e trasferimenti anziché scritture bancarie. Il file non è vuoto. I controlli sull’intero documento — intestazione, codifica dei caratteri, date, troncamento — sono stati eseguiti; i controlli sugli identificativi delle singole operazioni non sono ancora supportati per i titoli.

Ogni operazione QIF deve terminare con una riga che contiene solo «^». I record privi di questo terminatore si fondono con l’operazione successiva o spariscono del tutto: il classico «solo una parte delle mie operazioni è stata importata».

Un file QIF deve iniziare con una dichiarazione di tipo come «!Type:Bank» o «!Type:CCard». Senza di essa GnuCash e Quicken rifiutano il file o importano zero operazioni. Può essere anteposta un’intestazione generica «!Type:Bank»; per le carte di credito cambiala in !Type:CCard.

Importi come «1,234.56» confondono diversi importatori, che leggono la virgola come separatore di campo o decimale. Le virgole possono essere rimosse automaticamente («1234.56»).

Un marcatore UTF-8 invisibile precede la prima riga «!». I vecchi importatori QIF lo leggono come dati spuri e rifiutano l’intestazione. Può essere rimosso senza rischi.

Le date QIF si scrivono, a seconda del paese, come M/G/AA, M/G/AAAA o G/M/AA. Altre forme (ISO 2026-08-01, nomi di mese …) fanno saltare i record in silenzio. Poiché QIF non dichiara il proprio ordine di data, riscriverla automaticamente sarebbe un’ipotesi: imposta il formato nella finestra di importazione.

Non è stato trovato alcun record in una sezione !Type:Bank/CCard/Cash, quindi il file non contiene nulla da importare. Se ti aspettavi dei dati, l’intervallo di esportazione era probabilmente vuoto.