Configurazione Fineco

Custodir supporta Fineco in due modalità: CSV manuale (più semplice, controllo totale) e IMAP automatico (più magia, richiede setup email).

Modalità A — CSV manuale

Funziona sempre. Niente credenziali da inserire.

Come scaricare il CSV

1. Login su fineco.it.
2. Vai in Conto Corrente → Estratto Conto (o Investimenti → Movimenti).
3. Imposta il periodo (consiglio: tutto lo storico la prima volta, poi mensile).
4. Esporta in CSV (Fineco mostra anche XLS — non usare quello, ha colonne diverse).

Come importarlo in Custodir

1. Vai in Operazioni → Importa CSV.
2. Trascina il file CSV nel box di upload.
3. Custodir riconosce automaticamente il formato Fineco e fa il mapping colonne. Verifica l’anteprima.
4. Clicca Importa.

Cosa importa Custodir dal CSV

• Acquisti e vendite (azioni, ETF, fondi)
• Dividendi e cedole obbligazionarie
• Bonifici in entrata/uscita
• Commissioni e bolli (separati per analisi costi)
• Imposte (capital gain, dividendi esteri)

Cosa NON importa

• Movimenti carta di credito (non sono “investimenti”)
• Transazioni in valute esotiche oltre EUR/USD/GBP/CHF (verifica caso per caso)

Modalità B — IMAP automatico

Fineco invia per email gli avvisi di esecuzione ordine e gli estratti conto mensili. Custodir può leggerli da inbox.

Setup

1. Vai in Impostazioni → Broker → Fineco → Email.
2. Inserisci:
   • Server IMAP: dipende dal tuo provider email (Gmail: imap.gmail.com, Outlook: outlook.office365.com)
   • Email e password app (NON la password normale)
   • Cartella: di solito INBOX o una etichetta dedicata se hai filtri Fineco
3. Custodir prova subito una connessione di test. Se OK, salva.

Come funziona dopo

Lo scheduler controlla la inbox ogni 30 minuti, identifica le email Fineco tramite mittente e oggetto, estrae le transazioni con un parser dedicato e le inserisce con dedup_hash per evitare duplicati.

Le credenziali email vengono salvate nel vault locale cifrato (vault.enc), mai trasmesse al cloud.

Deduplicazione

Se importi lo stesso CSV due volte, o se IMAP e CSV registrano la stessa transazione, Custodir calcola un hash di ogni operazione (data + importo + ticker + tipo + account) e ignora duplicati. Vedi in log un evento transaction_duplicate_skipped.

Troubleshooting comuni

• “Formato CSV non riconosciuto”: hai esportato XLS invece di CSV, oppure il CSV è stato aperto in Excel e salvato con punto e virgola al posto di virgola. Riesporta da Fineco.
• “Importazione email vuota”: controlla che la cartella IMAP sia quella giusta. Fineco a volte spedisce da un dominio secondario — controlla i filtri della tua casella.
• “Auth fallita”: hai usato la password normale invece della password app. Vedi guida Trade Republic per il pattern delle password app →