Converti OFX in CSV

Le banche e le applicazioni di gestione delle finanze personali forniscono comunemente gli estratti conto in formato OFX, mentre i fogli di calcolo, le importazioni contabili e gli script di analisi dei dati richiedono spesso CSV. La conversione dell'estratto conto rende le transazioni modificabili e più facili da condividere o elaborare, ma può rimuovere i metadati dell'account e delle transazioni.

Cos'è il formato OFX

OFX (Open Financial Exchange) è un formato strutturato per lo scambio di dati bancari, relativi a carte di credito, investimenti e altri dati finanziari. Un estratto conto può contenere dettagli dell'account, saldi, date delle transazioni, importi, beneficiari, memo, tipi di transazione, valute e identificatori univoci come FITID.

I portali di online banking offrono comunemente download .ofx. I file .qfx utilizzano una versione o variante di OFX specifica di Intuit e possono richiedere software che supporti le importazioni QFX. Le applicazioni per la gestione delle finanze personali, tra cui GnuCash, Quicken, Moneydance e Microsoft Money, possono importare alcuni file OFX o QFX.

OFX 1.x è simile a SGML e può omettere i tag di chiusura; OFX 2.x è basato su XML. Le banche possono differire nei tag, nella codifica dei caratteri, nei formati delle date e nei campi facoltativi, quindi un file OFX è destinato allo scambio tramite software e non alla modifica diretta in un foglio di calcolo.

Cos'è il formato CSV

CSV (comma-separated values) è testo normale organizzato in record e campi. Un'esportazione delle transazioni contiene solitamente colonne come data, importo, beneficiario, memo, account, tipo di transazione e ID transazione. CSV non definisce uno schema finanziario unico: un programma può usare colonne separate per debiti e crediti, mentre un altro può usare un'unica colonna per l'importo con segno.

Excel, LibreOffice Calc, Google Sheets, gli strumenti per database e i linguaggi di programmazione possono aprire CSV. Il formato è facile da esaminare, modificare, filtrare ed elaborare, ma normalmente non conserva i saldi OFX, gli identificatori dell'account, i metadati bancari, la valuta, i tipi di transazione o le regole per il rilevamento dei duplicati, a meno che il convertitore non aggiunga colonne esplicite.

Convertire con GnuCash

1. Installare GnuCash da gnucash.org e creare o aprire un file di dati GnuCash.
2. Usare File → Import → Import OFX/QFX, quindi selezionare il file .ofx o .qfx supportato.
3. Assegnare l'importazione all'account GnuCash corretto. Esaminare date, beneficiari, importi, valute, suddivisioni e corrispondenze con transazioni duplicate prima di accettarla.
4. Selezionare l'account contenente le transazioni importate e usare File → Export → Export Transactions to CSV. Alcune versioni rendono disponibile il comando dal registro dell'account o usano una dicitura di menu leggermente diversa.
5. Scegliere il nome del file, l'account, l'intervallo di date, il delimitatore e la codifica, se la finestra di dialogo per l'esportazione fornisce queste opzioni; salvare un file come transactions.csv.

GnuCash è adatto quando l'estratto conto deve essere esaminato, sottoposto a un controllo dei duplicati, associato agli account o corretto prima dell'esportazione. Potrebbe rappresentare le transazioni suddivise in modo diverso rispetto all'OFX originale, quindi esaminare le righe risultanti.

Convertire con Moneydance

1. Aprire Moneydance e usare il comando File → Import per .ofx o .qfx.
2. Scegliere l'account di destinazione ed esaminare le transazioni importate verificando duplicati, segni, date e categorie.
3. Usare File → Export, selezionare CSV se il formato è disponibile nella versione installata, scegliere l'account e l'intervallo di date, quindi salvare il file.

I nomi dei menu e i formati di esportazione disponibili in Moneydance variano a seconda della versione. Se CSV non è disponibile, esportare in un formato intermedio supportato e usare un convertitore o uno script dedicato, quindi verificare la mappatura dei campi.

Usare un convertitore online

Servizi come Zamzar e Convertio possono accettare un file OFX e restituire CSV. Caricare il file, scegliere CSV, scaricare il risultato e aprirlo in un editor di testo o in un foglio di calcolo per esaminarlo. I file nello stile SGML precedente, le codifiche insolite e i tag specifici delle banche potrebbero essere rifiutati o convertiti in modo errato.

Gli estratti conto contengono informazioni finanziarie sensibili. Quando possibile, preferire GnuCash o un'altra applicazione locale; in caso contrario, controllare l'informativa sulla privacy del servizio, il periodo di conservazione, la crittografia e i controlli per l'eliminazione, quindi rimuovere le copie caricate e scaricate dopo la verifica.

Automatizzare le conversioni ricorrenti

Per le operazioni ripetute, usare un parser compatibile con OFX invece di dividere il testo in base alle virgole o presumere una transazione per riga. Il parser deve gestire le varianti SGML e XML, i caratteri con escape, i memo su più righe, i campi facoltativi, gli offset del fuso orario, gli importi negativi, le codifiche dei caratteri e gli identificatori duplicati.

Definire una mappatura di output fissa, conservare FITID quando disponibile, racchiudere tra virgolette i campi contenenti virgole o virgolette e scrivere CSV UTF-8 con un delimitatore documentato e un formato di data come YYYY-MM-DD. Un comando come python convert_ofx.py statement.ofx transactions.csv è solo un esempio; lo script deve implementare il proprio parser, la mappatura dei campi, la convalida e la gestione degli errori.

Controllare il file convertito

• Verificare i segni degli importi e la valuta. Confermare che depositi, prelievi, commissioni e rimborsi abbiano i segni previsti. Aggiungere una colonna per la valuta se il CSV non la rende univoca.
• Controllare date e fusi orari. I timestamp OFX possono includere offset e il software per fogli di calcolo potrebbe visualizzarli o convertirli usando il fuso orario locale del computer.
• Conservare gli identificatori. Mantenere FITID e i numeri degli account quando possibile. Importarli come testo in modo che il software per fogli di calcolo non rimuova gli zeri iniziali o utilizzi la notazione scientifica.
• Controllare delimitatori e codifica. Un'installazione regionale del software per fogli di calcolo potrebbe aspettarsi punti e virgola invece delle virgole. Confermare che i nomi accentati e i simboli rimangano corretti dopo l'apertura del file.
• Prevedere la perdita di campi e struttura. CSV potrebbe omettere i saldi iniziali e finali, i metadati dell'account, il tipo di transazione, la valuta, i riferimenti bancari e le relazioni tra transazioni suddivise.
• Riconciliare i totali. Confrontare il numero di righe, i totali delle transazioni e i saldi iniziali o finali disponibili con l'OFX originale prima di archiviarlo o eliminarlo.