Salta ai contenuti
Custodir Docs

Configurazione Trade Republic

Trade Republic non offre un’API pubblica né l’export CSV completo. La nostra soluzione: Custodir legge le email di conferma operazione che TR ti manda per ogni acquisto, vendita, dividendo.

Cosa serve

  • Un account email (Gmail consigliato — il parser è ottimizzato per il formato Gmail).
  • Una password app Gmail (NON la tua password normale Google).
  • Le email Trade Republic in inbox (non cancellate, non spostate altrove).

Password app Gmail

Le password app sono credenziali secondarie usa-e-getta che Google ti permette di creare. Custodir le usa per leggere le email TR via IMAP senza chiederti mai la tua password Google vera.

  1. Vai su myaccount.google.com/apppasswords.
  2. Devi aver attivato l’autenticazione a 2 fattori sull’account (Google lo richiede per generare password app).
  3. Crea una password app per “Mail” → nome a piacere (“Custodir”).
  4. Google ti mostra una password di 16 caratteri (formato xxxx xxxx xxxx xxxx). Copiala subito, non viene mostrata di nuovo.

Setup in Custodir

  1. Impostazioni → Broker → Trade Republic.
  2. Inserisci:
    • Email (es. nome.cognome@gmail.com)
    • Password app (i 16 caratteri sopra, con o senza spazi)
    • Server IMAP: precompilato a imap.gmail.com per Gmail (cambia se usi altro provider)
    • Cartella: lascia INBOX salvo configurazioni custom
  3. Clicca Verifica connessione. Custodir prova IMAP + cerca almeno 1 email TR per confermare il setup.
  4. Salva. Lo scheduler parte e fa il primo full-sync (può richiedere 5-15 minuti la prima volta se hai mesi di email TR).

Cosa estrae

Il parser email TR riconosce:

  • Esecuzione ordini: buy/sell con prezzo medio, quantità, commissioni, valuta
  • Dividendi: importo lordo, ritenuta, importo netto, ticker
  • Cedole: stesso pattern dei dividendi
  • Versamenti/prelievi: SEPA in entrata e uscita
  • Operazioni straordinarie: split, fusioni, distribuzioni in natura (esperienza inferiore — verifica manualmente)

Ogni transazione ha il dedup_hash calcolato in modo che re-import successivi siano idempotenti.

Cosa NON estrae

  • Saldo cash: TR non lo riporta nelle email, quindi Custodir lo calcola dai cash flow netti. Se vedi una discrepanza tra Custodir e l’app TR, è quasi sempre un’email mancante.
  • Tasse pre-pagate (regime DE/IT): TR le mostra solo nel rendiconto annuale che spedisce a parte. Custodir non parsa ancora il PDF rendiconto — sotto-task in roadmap.
  • Crypto (se hai TR Krypto): supporto limitato; usa un broker dedicato.

Privacy

Le tue credenziali Gmail restano sul tuo PC nel vault cifrato. Nessuna password lascia il dispositivo. Le email TR non vengono mai inviate al cloud — solo il parser locale le tocca per estrarre i campi e poi sono dimenticate.

Troubleshooting

  • “Auth fallita”: stai usando la password normale Google invece della password app. Vai a generarne una.
  • “0 email parsate”: controlla che TR mandi davvero email all’indirizzo collegato. In TR app: Account → Notifiche → Email verifica Conferme operazioni: ON.
  • “Discrepanza saldo”: probabilmente manca un’email di versamento. Controlla la inbox per messaggi etichettati spam, oppure inserisci il movimento manualmente in Operazioni → Aggiungi.