Import manuale CSV

Se il tuo broker non è ancora supportato nativamente (Fineco e Trade Republic lo sono), puoi sempre importare un CSV nel formato Custodir generico.

Formato CSV Custodir

Il CSV deve avere questa intestazione esatta (UTF-8, separatore virgola):

executed_at,type,ticker,isin,quantity,price_eur,fee_eur,tax_eur,note

Colonna	Tipo	Note
`executed_at`	ISO 8601	Es. `2026-03-15T10:32:00Z`. Anche `2026-03-15` va bene (mezzogiorno UTC).
`type`	enum	Uno di: `buy`, `sell`, `dividend`, `interest`, `deposit`, `withdraw`, `fee`, `tax`.
`ticker`	string	Simbolo del titolo (es. `VWCE`, `AAPL`). Lascia vuoto per `deposit`/`withdraw`/`fee`/`tax` generici.
`isin`	string	ISIN del titolo. Opzionale se il ticker è univoco.
`quantity`	number	Numero di quote. Lascia vuoto per movimenti non legati a un titolo.
`price_eur`	number	Prezzo unitario in EUR.
`fee_eur`	number	Commissione totale (opzionale).
`tax_eur`	number	Imposta trattenuta (opzionale).
`note`	string	Testo libero per il tuo riferimento.

Esempio minimo

executed_at,type,ticker,isin,quantity,price_eur,fee_eur,tax_eur,note
2025-12-01,buy,VWCE,IE00BK5BQT80,10,113.50,0.99,,Primo PAC 2025
2025-12-15,dividend,VWCE,IE00BK5BQT80,,,0,3.12,Dividendo trimestrale (lordo 15.60 - tax 12.48)

Come importarlo

Operazioni → Importa CSV.
Trascina il file. Custodir prova il riconoscimento automatico — se non identifica un broker specifico, applica il parser generico (cioè questo formato).
Anteprima: controlla che gli importi siano corretti, conferma.
Le righe vengono inserite con dedup_hash calcolato → re-import dello stesso CSV è idempotente.

Errori comuni

“Riga 23: type non valido”: hai scritto purchase invece di buy, o usato traduzioni italiane. Usa solo i 8 valori della tabella sopra.
“price_eur deve essere positivo”: hai messo segno meno su una vendita. Custodir tratta sempre gli importi come positivi; il type (sell vs buy) determina la direzione.
“ISIN inesistente”: se non passi l’ISIN ma il ticker non è univoco (es. BABA esiste su NYSE e HKEX), Custodir te lo chiede in interactive prompt. Pre-compila l’ISIN per evitare la domanda.

Cosa fare per broker grandi non supportati

Se vuoi supporto nativo per un altro broker (Directa, IWBank, Degiro, BinckBank…), scrivi a supporto@custodir.com indicando:

Nome broker + paese
Tipo export disponibile (CSV, PDF, API, email)
Un export di esempio (può essere demo / pubblico)

Aggiungiamo regolarmente nuovi parser su richiesta utenti.