# ofxstatement-directa
Plugin per [ofxstatement](https://github.com/kedder/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)
```bash
pip install ofxstatement-directa
```
### Installazione dal sorgente
```bash
git clone https://github.com/Alfystar/ofxstatement-directa.git
cd ofxstatement-directa
pip install -e .
```
### Aggiornamento
Per aggiornare il plugin all'ultima versione:
```bash
pip install --upgrade ofxstatement-directa
```
## ⚙️ Configurazione
Prima di utilizzare il plugin, è necessario configurare il conto predefinito:
```bash
ofxstatement edit-config
```
Nel file di configurazione, aggiungi:
```ini
[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:
```bash
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:
```bash
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:
```bash
pip list | grep ofxstatement-directa
```
Se non appare, reinstalla:
```bash
pip install --force-reinstall ofxstatement-directa
```
### Errore: Account non configurato
Verifica che il file di configurazione contenga la sezione `[directa]`:
```bash
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.
```bash
printf '\n# Directa CSV -> OFX\nalias ofxDirecta="ofxstatement convert -t DirectaConfig"\n' >> ~/.bash_aliases
```
Poi ricarica il terminale (chiudi e riapri) oppure esegui:
```bash
source ~/.bash_aliases
```
Uso semplificato:
```bash
ofxDirecta Movimenti.csv output.ofx
```
Nota: se dopo il riavvio gli alias non sono attivi, verifica che in `~/.bashrc` sia presente:
```bash
# Alias definitions.
if [ -f ~/.bash_aliases ]; then
. ~/.bash_aliases
fi
```
## 📝 Licenza
Questo progetto è distribuito sotto licenza GPLv3. Vedi il file [LICENSE](LICENSE) per i dettagli.
## 👤 Autore
**Alfystar**
- Email: alfystar1701@gmail.com
- GitHub: [@Alfystar](https://github.com/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](https://github.com/kedder/ofxstatement) - Framework base
- [Directa SIM](https://www.directa.it/) - Sito ufficiale del broker
- [Formato OFX](http://www.ofx.net/) - 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
Raw data
{
"_id": null,
"home_page": null,
"name": "ofxstatement-directa",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": null,
"keywords": "ofx, banking, statement, directa, broker, trading",
"author": null,
"author_email": "Alfystar <alfystar1701@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/d1/a6/3fb9726e352d29d94a1d137deca217b7aa34d6b3e74eb44c5a6a09c83f12/ofxstatement_directa-1.0.0.post1.tar.gz",
"platform": null,
"description": "# ofxstatement-directa\n\nPlugin per [ofxstatement](https://github.com/kedder/ofxstatement) per importare transazioni dal broker finanziario italiano **Directa**.\n\nQuesto plugin converte i file CSV esportati da Directa in formato OFX, compatibile con software di contabilit\u00e0 come GnuCash, HomeBank, e altri.\n\n## \ud83d\udccb Requisiti\n\n- Python 3.9 o superiore\n- `ofxstatement` (installato automaticamente come dipendenza)\n\n## \ud83d\ude80 Installazione\n\n### Installazione da PyPI (consigliata)\n\n```bash\npip install ofxstatement-directa\n```\n\n### Installazione dal sorgente\n\n```bash\ngit clone https://github.com/Alfystar/ofxstatement-directa.git\ncd ofxstatement-directa\npip install -e .\n```\n\n### Aggiornamento\n\nPer aggiornare il plugin all'ultima versione:\n\n```bash\npip install --upgrade ofxstatement-directa\n```\n\n## \u2699\ufe0f Configurazione\n\nPrima di utilizzare il plugin, \u00e8 necessario configurare il conto predefinito:\n\n```bash\nofxstatement edit-config\n```\n\nNel file di configurazione, aggiungi:\n\n```ini\n[DirectaConfig]\nplugin = directa\naccount = K1234 # Il tuo numero conto Directa\n```\n\nSe hai pi\u00f9 conti, puoi creare pi\u00f9 configurazioni (`DirectaConfig`) e variare il codice account. \nPer specificare la configurazione che vuoi usare, vedi la sezione Utilizzo.\n\n## \ud83d\udcd6 Utilizzo\n\n### 1. Scarica il file CSV da Directa\n\n1. Accedi al tuo account Directa\n2. Vai alla sezione \"Movimenti\" o \"Estratto conto\"\n3. Esporta i movimenti in formato CSV\n4. Salva il file (es. `Movimenti.csv`)\n\n### 2. Converti il CSV in formato OFX\n\nUsa il comando `ofxstatement` per convertire il file CSV:\n\n```bash\nofxstatement convert -t DirectaConfig Movimenti.csv output.ofx\n```\n\nDove:\n- `-t DirectaConfig`: specifica di usare la configurazione DirectaConfig\n- `Movimenti.csv`: il file CSV scaricato da Directa\n- `output.ofx`: il file OFX di destinazione\n\n### 3. Importa il file OFX nel tuo software di contabilit\u00e0\n\nOra puoi importare il file `output.ofx` in GnuCash, HomeBank, o altri software compatibili.\n\n### Verifica della configurazione\n\nPer verificare le impostazioni correnti:\n\n```bash\nofxstatement list-plugins\n```\n\nDovresti vedere `directa` nell'elenco dei plugin disponibili.\n\n\n## \ud83d\udc1b Risoluzione dei problemi\n\n### Errore: Plugin 'directa' non trovato\n\nAssicurati che il plugin sia installato correttamente:\n\n```bash\npip list | grep ofxstatement-directa\n```\n\nSe non appare, reinstalla:\n\n```bash\npip install --force-reinstall ofxstatement-directa\n```\n\n### Errore: Account non configurato\n\nVerifica che il file di configurazione contenga la sezione `[directa]`:\n\n```bash\nofxstatement edit-config\n```\n\n\n## \ud83d\udd04 Alias (opzionale)\n\nPer semplificare l'uso del comando di conversione puoi creare un alias (Linux / terminale emulato). \nL'esempio seguente usa la configurazione `DirectaConfig`. Se usi un nome diverso, modificalo nell'alias.\n\n```bash\nprintf '\\n# Directa CSV -> OFX\\nalias ofxDirecta=\"ofxstatement convert -t DirectaConfig\"\\n' >> ~/.bash_aliases\n```\n\nPoi ricarica il terminale (chiudi e riapri) oppure esegui:\n```bash\nsource ~/.bash_aliases\n```\n\nUso semplificato:\n```bash\nofxDirecta Movimenti.csv output.ofx\n```\n\nNota: se dopo il riavvio gli alias non sono attivi, verifica che in `~/.bashrc` sia presente:\n```bash\n# Alias definitions.\nif [ -f ~/.bash_aliases ]; then\n . ~/.bash_aliases\nfi\n```\n\n\n## \ud83d\udcdd Licenza\n\nQuesto progetto \u00e8 distribuito sotto licenza GPLv3. Vedi il file [LICENSE](LICENSE) per i dettagli.\n\n## \ud83d\udc64 Autore\n\n**Alfystar**\n- Email: alfystar1701@gmail.com\n- GitHub: [@Alfystar](https://github.com/Alfystar)\n\n## \ud83e\udd1d Contributi\n\nI contributi sono benvenuti! Sentiti libero di:\n\n1. Fare un fork del progetto\n2. Creare un branch per la tua feature (`git checkout -b feature/AmazingFeature`)\n3. Committare le modifiche (`git commit -m 'Add some AmazingFeature'`)\n4. Fare push del branch (`git push origin feature/AmazingFeature`)\n5. Aprire una Pull Request\n\n## \ud83d\udcda Link utili\n\n- [ofxstatement](https://github.com/kedder/ofxstatement) - Framework base\n- [Directa SIM](https://www.directa.it/) - Sito ufficiale del broker\n- [Formato OFX](http://www.ofx.net/) - Specifiche del formato OFX\n\n## \ud83d\udcdc Changelog\n\n### v1.0.0 (2025-10-06)\n- Prima release pubblica\n- Supporto per conversione CSV di Directa in formato OFX\n- Supporto per transazioni di trading e movimenti bancari\n- Configurazione account tramite ofxstatement config\n\n",
"bugtrack_url": null,
"license": "GPLv3",
"summary": "Plugin per ofxstatement per importare transazioni dal broker finanziario Directa",
"version": "1.0.0.post1",
"project_urls": {
"Homepage": "https://github.com/Alfystar/ofxstatement-directa",
"Issues": "https://github.com/Alfystar/ofxstatement-directa/issues",
"Repository": "https://github.com/Alfystar/ofxstatement-directa"
},
"split_keywords": [
"ofx",
" banking",
" statement",
" directa",
" broker",
" trading"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "6af96db980013e386c16b30cc95aa13e86c6c194df3102789faa6c62437b9be4",
"md5": "1dac5fb4672edfff76614239d05c0fbf",
"sha256": "3829afbc9bb0c175e34cc95e9f0d42e30411b2efcd9bc7d6347e83c30bbfd15d"
},
"downloads": -1,
"filename": "ofxstatement_directa-1.0.0.post1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "1dac5fb4672edfff76614239d05c0fbf",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 7663,
"upload_time": "2025-10-06T14:30:55",
"upload_time_iso_8601": "2025-10-06T14:30:55.858204Z",
"url": "https://files.pythonhosted.org/packages/6a/f9/6db980013e386c16b30cc95aa13e86c6c194df3102789faa6c62437b9be4/ofxstatement_directa-1.0.0.post1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "d1a63fb9726e352d29d94a1d137deca217b7aa34d6b3e74eb44c5a6a09c83f12",
"md5": "b3c3066c0c9eb6df9184a4770687b398",
"sha256": "398880d3c1386e3e35fb116d8df3e4650322313314e16301e26bf94c30ad7dd2"
},
"downloads": -1,
"filename": "ofxstatement_directa-1.0.0.post1.tar.gz",
"has_sig": false,
"md5_digest": "b3c3066c0c9eb6df9184a4770687b398",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 9084,
"upload_time": "2025-10-06T14:30:57",
"upload_time_iso_8601": "2025-10-06T14:30:57.538640Z",
"url": "https://files.pythonhosted.org/packages/d1/a6/3fb9726e352d29d94a1d137deca217b7aa34d6b3e74eb44c5a6a09c83f12/ofxstatement_directa-1.0.0.post1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-10-06 14:30:57",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "Alfystar",
"github_project": "ofxstatement-directa",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "ofxstatement-directa"
}
JSON
