Guida · Interactive Brokers
Come scaricare la Flex Query da Interactive Brokers
Il file che ci serve si chiama Activity Flex Query ed è in formato XML. Qui lo imposti una volta sola, poi lo riscarichi ogni anno in un minuto. Nessuna credenziale da condividere: il file lo scarichi tu.
- 5 minuti la prima volta, 1 minuto le successive
- Aggiornata il 22 settembre 2026
- Nessuna password richiesta
In questa paginaApri
- Prima di iniziare
- 1Entra nel Client Portal e apri Flex Queries
- 2Crea una nuova Activity Flex Query
- 3Seleziona le sezioni che servono
- 4Imposta formato XML, date e ore
- 5Esegui la query per un anno intero
- 6Ripeti per ogni anno dall'apertura del conto
- 7Carica i file su Fiscal Broker
- Checklist finale
- Errori comuni e soluzioni
- Domande frequenti
Prima di iniziare
Una Flex Query è un report su misura che Interactive Brokers genera dal tuo conto. Tu decidi quali sezioni contiene e in quale formato scaricarlo. Per il report fiscale ci serve la versione Activity in XML, con le sezioni della lista qui sotto: contengono ogni operazione, ogni dividendo, ogni cambio e il valore del conto giorno per giorno.
- Cosa ti serve: l'accesso al Client Portal di Interactive Brokers e cinque minuti.
- Cosa ottieni: un file XML per ogni anno solare, da caricare tutti insieme.
- Cosa non ti chiediamo mai: nome utente, password, token o codici del conto.
Hai un conto da più anni?
Entra nel Client Portal e apri Flex Queries
Accedi al Client Portal dal sito di Interactive Brokers (non dalla piattaforma di trading). Nel menu a sinistra apri Performance & Reports e poi Flex Queries. Se il menu è compresso, trovi la stessa voce sotto Menu → Reporting → Flex Queries.
Le voci di menu sono in inglese anche con il portale in italiano: se non le trovi, usa la lente di ricerca in alto e scrivi Flex.
Crea una nuova Activity Flex Query
Nella pagina ci sono due riquadri. Quello giusto è Activity Flex Query: clicca su Create (l'icona con il segno più). Il riquadro Trade Confirmation Flex Query non serve.
In Query Name scrivi un nome che riconoscerai fra un anno, per esempio Fiscal Broker. Il nome è solo tuo: non compare nel file.
Seleziona le sezioni che servono
È il passo più lungo, ma si fa una volta sola. Sotto Sections clicca su ogni sezione della tabella qui sotto: si apre l'elenco dei campi. Premi Select All per includerli tutti e, dove c'è un riquadro Options, scegli solo il livello indicato nella colonna «Livello». Poi torna alla lista e passa alla sezione successiva.
Puoi aggiungere altre sezioni se ti fanno comodo: non danno fastidio. Ma se ne manca una di queste, il report non si può calcolare e l'anteprima te lo dirà.
| Sezione (nome nel menu) | Livello | A cosa serve |
|---|---|---|
| Account Information | tutti i campi | Valuta di base del conto e società IBKR che lo custodisce (serve per il quadro RW). |
| Cash Report | tutti i campi | Totali di cassa per valuta: li usiamo come controllo incrociato. |
| Cash Transactions | tutti i campi | Dividendi, ritenute, interessi, commissioni, depositi e prelievi. |
| Corporate Actions | Detail | Frazionamenti, fusioni, diritti: senza questi la storia dei lotti non torna. |
| Financial Instrument Information | tutti i campi | ISIN, tipo di strumento, paese dell'emittente: distingue azioni, ETF, ETC. |
| Interest Accruals | tutti i campi | Ratei di interesse attivi e passivi, per il valore del conto a fine anno. |
| Hard to Borrow Details | tutti i campi | Costo del prestito titoli sulle vendite allo scoperto, giorno per giorno. |
| Net Asset Value (NAV) in Base | tutti i campi | Valore giornaliero del conto: è la base del quadro RW e dell'IVAFE. |
| Open Positions | Summary e Lot | Posizioni aperte a fine periodo: controllano che abbiamo ricostruito tutto. |
| Option Exercises, Assignments and Expirations | tutti i campi | Opzioni esercitate, assegnate o scadute: cambiano il costo delle azioni. |
| Statement of Funds | tutti i campi | Il registro di cassa per valuta: serve per la soglia sulle valute estere. |
| Trades | Executions | Ogni eseguito, con commissioni e tasse: è la base del calcolo LIFO. |
| Transaction Taxes | tutti i campi | Imposte di borsa (per esempio Hong Kong o Regno Unito) da aggiungere al costo. |
| Transfers | tutti i campi | Trasferimenti di titoli in entrata o uscita, con i lotti originali. |
- Account Informationtutti i campi
Valuta di base del conto e società IBKR che lo custodisce (serve per il quadro RW).
- Cash Reporttutti i campi
Totali di cassa per valuta: li usiamo come controllo incrociato.
- Cash Transactionstutti i campi
Dividendi, ritenute, interessi, commissioni, depositi e prelievi.
- Corporate Actions
DetailFrazionamenti, fusioni, diritti: senza questi la storia dei lotti non torna.
- Financial Instrument Informationtutti i campi
ISIN, tipo di strumento, paese dell'emittente: distingue azioni, ETF, ETC.
- Interest Accrualstutti i campi
Ratei di interesse attivi e passivi, per il valore del conto a fine anno.
- Hard to Borrow Detailstutti i campi
Costo del prestito titoli sulle vendite allo scoperto, giorno per giorno.
- Net Asset Value (NAV) in Basetutti i campi
Valore giornaliero del conto: è la base del quadro RW e dell'IVAFE.
- Open Positions
Summary e LotPosizioni aperte a fine periodo: controllano che abbiamo ricostruito tutto.
- Option Exercises, Assignments and Expirationstutti i campi
Opzioni esercitate, assegnate o scadute: cambiano il costo delle azioni.
- Statement of Fundstutti i campi
Il registro di cassa per valuta: serve per la soglia sulle valute estere.
- Trades
ExecutionsOgni eseguito, con commissioni e tasse: è la base del calcolo LIFO.
- Transaction Taxestutti i campi
Imposte di borsa (per esempio Hong Kong o Regno Unito) da aggiungere al costo.
- Transferstutti i campi
Trasferimenti di titoli in entrata o uscita, con i lotti originali.
Trades: solo Executions
Imposta formato XML, date e ore
Scorri fino a Delivery Configuration e imposta i valori della tabella. Il formato data e ora sono importanti: con altri formati il file viene rifiutato al caricamento.
Nella parte General Configuration lascia i valori predefiniti; le uniche cose da controllare sono nella seconda tabella. Poi premi Continue e, nella schermata di riepilogo, Create.
Delivery Configuration
- Format
XML- Period
Custom Date Range- Date Format
yyyyMMdd- Time Format
HHmmss- Date/Time Separator
; (semicolon)
Non CSV: il file XML contiene tutti i campi che ci servono.
Lo scegli al momento del download: un anno solare per file.
Per esempio 20250131.
Per esempio 143005.
Il valore predefinito va bene.
General Configuration
- Profit and Loss
Default- Include Canceled Trades?
No- Include Currency Rates?
Sì (facoltativo)- Include Audit Trail Fields?
No- Display Account Alias in Place of Account ID?
No- Breakout by Day?
No
Se il portale ti mostra opzioni in più, lascia i valori predefiniti.
Esegui la query per un anno intero
La query ora compare nella lista. Clicca sull'icona Run (la freccia). Nella finestra scegli Custom Date Range e imposta il periodo dal 1° gennaio al 31 dicembre dell'anno da dichiarare, per esempio 01/01/2025 – 31/12/2025. Conferma che il formato sia XML e premi Run.
Il portale prepara il file in qualche secondo (qualche minuto se hai migliaia di operazioni) e lo scarica nella cartella Download del browser. Il nome è composto dal numero di conto e dalle date del periodo.
Se compare «Statement is not available»
Ripeti per ogni anno dall'apertura del conto
Interactive Brokers permette al massimo 365 giorni per file. Rilancia la stessa query cambiando solo le date: un file per ogni anno solare, dal primo anno del conto fino a quello da dichiarare. Se hai aperto il conto a metà anno, parti comunque dal 1° gennaio di quell'anno: il periodo vuoto non dà problemi.
Perché servono anche gli anni vecchi? Perché la legge (art. 67, comma 1-bis del TUIR) chiede di abbinare ogni vendita agli acquisti più recenti, il metodo LIFO, e quegli acquisti possono risalire ad anni prima. Lo storico si carica gratis e resta a disposizione per gli anni successivi.
Carica i file su Fiscal Broker
Vai su Nuovo report, scegli Interactive Brokers e trascina tutti i file XML nella casella di caricamento, anche in ordine sparso. Per ogni file vedi il periodo coperto e le sezioni lette; una linea del tempo ti mostra se manca qualche anno.
Scegli l'anno da dichiarare e premi Calcola. In pochi secondi vedi i controlli incrociati con i dati del broker e le imposte stimate. È gratis: paghi solo se vuoi sbloccare i quadri compilati.
Checklist finale
Prima di caricare, un controllo veloce. Se una voce non torna, guarda gli errori comuni.
- Il file ha estensione .xml (non .csv, non .pdf).
- Le 14 sezioni della lista sono tutte selezionate, con tutti i campi.
- Trades è a livello Executions; Corporate Actions a livello Detail; Open Positions con Summary e Lot.
- Il periodo è un anno solare intero: dal 1° gennaio al 31 dicembre.
- Hai un file per ogni anno dall'apertura del conto (anche gli anni in cui non hai venduto nulla).
- Il formato data è yyyyMMdd e quello dell'ora è HHmmss.
- Non hai condiviso con nessuno le credenziali del conto: a noi serve solo il file.
Errori comuni e soluzioni
I problemi che vediamo più spesso, con la soluzione. Se il tuo non c'è, scrivici.
«Statement is not available»
Lanci la query con un periodo personalizzato e IBKR risponde che l'estratto non è disponibile.
Soluzione. Succede spesso quando la data di fine cade di sabato o in un giorno festivo. Metti come data di fine il 31 dicembre oppure l'ultimo giorno lavorativo del periodo e riprova. Se è l'anno in corso, usa l'ultimo giorno lavorativo prima di oggi.
Il periodo non può superare 365 giorni
Provi a scaricare due o più anni in un solo file e il portale rifiuta il periodo.
Soluzione. È un limite di Interactive Brokers: al massimo 365 giorni per file. Scarica un file per ogni anno solare (1 gennaio – 31 dicembre) e caricali tutti insieme: li uniamo noi.
«Manca la sezione …» nell'anteprima
Dopo il caricamento, Fiscal Broker segnala una o più sezioni mancanti nel file.
Soluzione. Torna in Flex Queries, apri la tua query con l'icona di modifica (la matita), aggiungi la sezione indicata selezionando tutti i campi, salva e scarica di nuovo il file dello stesso anno. Poi sostituisci il file nel caricamento.
Il file è .csv e non .xml
Il caricamento rifiuta il file perché non è nel formato atteso.
Soluzione. Nella query, in Delivery Configuration, imposta Format su XML. Il CSV di IBKR non contiene la struttura che ci serve per distinguere le sezioni.
Operazioni contate due volte o posizioni che non tornano
L'anteprima segnala un numero di operazioni doppio o posizioni a fine anno diverse da quelle del broker.
Soluzione. In Trades hai selezionato più livelli (per esempio Executions e Orders). Lascia solo Executions. In Corporate Actions lascia solo Detail. In Open Positions servono sia Summary sia Lot.
Il conto è stato trasferito da una società IBKR a un'altra
Per esempio dal Regno Unito (IBUK) all'Irlanda (IB-IE) nel 2021: le posizioni compaiono come «trasferite» e gli anni prima del trasferimento non si trovano.
Soluzione. Scarica comunque tutti gli anni disponibili dal conto attuale: i trasferimenti in entrata portano con sé data e costo dei lotti originali. Se il portale non mostra gli anni del vecchio conto, scrivici e vediamo insieme come completare lo storico.
Un anno vecchio non si può scaricare
Il calendario del periodo personalizzato non permette di andare abbastanza indietro.
Soluzione. Interactive Brokers mette a disposizione gli ultimi anni; per quelli più vecchi non sempre la Flex Query è generabile. Carica quello che riesci a scaricare: l'anteprima ti dice se le posizioni di apertura sono spiegate. Se mancano, ti indichiamo come inserire i lotti iniziali a mano.
Ho più conti (o un conto cointestato)
La query include più conti e il caricamento segnala «conti diversi nello stesso file».
Soluzione. In Delivery Configuration scegli un solo conto per volta e scarica una serie di file per ogni conto. Ogni conto ha il suo report: il primo costa 29 €, gli altri 19 € l'uno. La quota di possesso si imposta nel report.
Il file è molto grande o la generazione è lenta
Con migliaia di operazioni la query impiega qualche minuto e il file supera i 20 MB.
Soluzione. È normale: aspetta che compaia il link di download senza rilanciare la query. Il limite di caricamento è 60 MB per file. Se lo superi, scrivici: possiamo indicarti quali sezioni facoltative togliere.
Non trovo il file scaricato
Hai cliccato su Run ma non vedi nessun file.
Soluzione. Il browser lo salva nella cartella Download con un nome simile a «U1234567_20250101_20251231.xml» (l'esempio è fittizio). Se la generazione è ancora in corso, il portale mostra un'icona di attesa: attendi e riapri la pagina Flex Queries.
Domande frequenti
Devo darvi l'accesso al mio conto IBKR?
No, mai. Ci serve solo il file XML che scarichi tu dal Client Portal. Non chiediamo nome utente, password né il token del Flex Web Service.
Quanto ci vuole davvero?
La prima volta circa cinque minuti: crei la query una volta sola. Dagli anni successivi basta rilanciarla con il nuovo periodo: un minuto.
Posso usare l'Activity Statement in PDF o il report annuale?
No. Il PDF e il report annuale non contengono il dettaglio dei singoli eseguiti né i lotti originali dei trasferimenti. Serve l'Activity Flex Query in XML con le sezioni della lista.
Perché servono anche gli anni in cui non ho venduto niente?
Perché il metodo LIFO abbina ogni vendita agli acquisti più recenti, anche se fatti anni prima. Senza lo storico non sappiamo quanto hai pagato i titoli venduti. Lo storico si carica gratis: paghi solo l'anno che vuoi sbloccare.
Posso scaricare anche l'anno in corso?
Sì, con periodo dal 1° gennaio all'ultimo giorno lavorativo prima di oggi. Serve solo per una stima: il report definitivo si fa a gennaio con l'anno completo.
Vuoi sapere cosa facciamo con il file? Leggi come calcoliamo e l'informativa privacy.
Hai il file? Vedi i numeri gratis
Carica il file