ofxstatement-directa

Plugin per ofxstatement per importare transazioni dal broker finanziario italiano Directa.

Questo plugin converte i file CSV esportati da Directa in formato OFX, compatibile con software di contabilità come GnuCash, HomeBank, e altri.

📋 Requisiti

• Python 3.9 o superiore
• ofxstatement (installato automaticamente come dipendenza)

🚀 Installazione

Installazione da PyPI (consigliata)

pip install ofxstatement-directa

Installazione dal sorgente

git clone https://github.com/Alfystar/ofxstatement-directa.git
cd ofxstatement-directa
pip install -e .

Aggiornamento

Per aggiornare il plugin all'ultima versione:

pip install --upgrade ofxstatement-directa

⚙️ Configurazione

Prima di utilizzare il plugin, è necessario configurare il conto predefinito:

ofxstatement edit-config

Nel file di configurazione, aggiungi:

[DirectaConfig]
plugin = directa
account = K1234  # Il tuo numero conto Directa

Se hai più conti, puoi creare più configurazioni (DirectaConfig) e variare il codice account. Per specificare la configurazione che vuoi usare, vedi la sezione Utilizzo.

📖 Utilizzo

1. Scarica il file CSV da Directa

1. Accedi al tuo account Directa
2. Vai alla sezione "Movimenti" o "Estratto conto"
3. Esporta i movimenti in formato CSV
4. Salva il file (es. Movimenti.csv)

2. Converti il CSV in formato OFX

Usa il comando ofxstatement per convertire il file CSV:

ofxstatement convert -t DirectaConfig Movimenti.csv output.ofx

Dove:

• -t DirectaConfig: specifica di usare la configurazione DirectaConfig
• Movimenti.csv: il file CSV scaricato da Directa
• output.ofx: il file OFX di destinazione

3. Importa il file OFX nel tuo software di contabilità

Ora puoi importare il file output.ofx in GnuCash, HomeBank, o altri software compatibili.

Verifica della configurazione

Per verificare le impostazioni correnti:

ofxstatement list-plugins

Dovresti vedere directa nell'elenco dei plugin disponibili.

🐛 Risoluzione dei problemi

Errore: Plugin 'directa' non trovato

Assicurati che il plugin sia installato correttamente:

pip list | grep ofxstatement-directa

Se non appare, reinstalla:

pip install --force-reinstall ofxstatement-directa

Errore: Account non configurato

Verifica che il file di configurazione contenga la sezione [directa]:

ofxstatement edit-config

🔄 Alias (opzionale)

Per semplificare l'uso del comando di conversione puoi creare un alias (Linux / terminale emulato).
L'esempio seguente usa la configurazione DirectaConfig. Se usi un nome diverso, modificalo nell'alias.

printf '\n# Directa CSV -> OFX\nalias ofxDirecta="ofxstatement convert -t DirectaConfig"\n' >> ~/.bash_aliases

Poi ricarica il terminale (chiudi e riapri) oppure esegui:

source ~/.bash_aliases

Uso semplificato:

ofxDirecta Movimenti.csv output.ofx

Nota: se dopo il riavvio gli alias non sono attivi, verifica che in ~/.bashrc sia presente:

# Alias definitions.
if [ -f ~/.bash_aliases ]; then
    . ~/.bash_aliases
fi

📝 Licenza

Questo progetto è distribuito sotto licenza GPLv3. Vedi il file LICENSE per i dettagli.

👤 Autore

Alfystar

• Email: alfystar1701@gmail.com
• GitHub: @Alfystar

🤝 Contributi

I contributi sono benvenuti! Sentiti libero di:

1. Fare un fork del progetto
2. Creare un branch per la tua feature (git checkout -b feature/AmazingFeature)
3. Committare le modifiche (git commit -m 'Add some AmazingFeature')
4. Fare push del branch (git push origin feature/AmazingFeature)
5. Aprire una Pull Request

📚 Link utili

• ofxstatement - Framework base
• Directa SIM - Sito ufficiale del broker
• Formato OFX - Specifiche del formato OFX

📜 Changelog

v1.0.0 (2025-10-06)

• Prima release pubblica
• Supporto per conversione CSV di Directa in formato OFX
• Supporto per transazioni di trading e movimenti bancari
• Configurazione account tramite ofxstatement config