Metadata-Version: 2.4
Name: ofxstatement-directa
Version: 1.0.0
Summary: Plugin per ofxstatement per importare transazioni dal broker finanziario Directa
Author-email: Alfystar <alfystar1701@gmail.com>
License: GPLv3
Project-URL: Homepage, https://github.com/Alfystar/ofxstatement-directa
Project-URL: Repository, https://github.com/Alfystar/ofxstatement-directa
Project-URL: Issues, https://github.com/Alfystar/ofxstatement-directa/issues
Keywords: ofx,banking,statement,directa,broker,trading
Classifier: Development Status :: 4 - Beta
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Natural Language :: Italian
Classifier: Topic :: Office/Business :: Financial :: Accounting
Classifier: Topic :: Utilities
Classifier: Environment :: Console
Classifier: Operating System :: OS Independent
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: ofxstatement
Provides-Extra: dev
Requires-Dist: pytest>=7.0.0; extra == "dev"
Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
Requires-Dist: black>=23.0.0; extra == "dev"
Requires-Dist: flake8>=6.0.0; extra == "dev"
Dynamic: license-file

# 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 directa 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
```

### Formato CSV non riconosciuto

Assicurati che il file CSV sia stato esportato correttamente da Directa. Il plugin supporta il formato standard di esportazione CSV di Directa.

## 📝 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

