fiscalbroker

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
  1. Prima di iniziare
  2. 1Entra nel Client Portal e apri Flex Queries
  3. 2Crea una nuova Activity Flex Query
  4. 3Seleziona le sezioni che servono
  5. 4Imposta formato XML, date e ore
  6. 5Esegui la query per un anno intero
  7. 6Ripeti per ogni anno dall'apertura del conto
  8. 7Carica i file su Fiscal Broker
  9. Checklist finale
  10. Errori comuni e soluzioni
  11. 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?

Prepara un file per ogni anno dall'apertura del conto, anche gli anni in cui non hai venduto nulla. Servono per ricostruire il costo d'acquisto dei titoli con il metodo LIFO. Lo spieghiamo al passo 6.

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.

Schema del menu del Client Portal: la voce Performance & Reports apre il sottomenu con Flex Queries.

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.

Schema della pagina Flex Queries: il riquadro Activity Flex Query con il pulsante per creare una nuova query.

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à.

Schema della lista Sections: ogni sezione richiesta va spuntata e, dentro, si scelgono tutti i campi (Select All).
Schema dell'interno della sezione Trades: Options con il livello Executions e il pulsante Select All per i campi.
  1. Account Informationtutti i campi

    Valuta di base del conto e società IBKR che lo custodisce (serve per il quadro RW).

  2. Cash Reporttutti i campi

    Totali di cassa per valuta: li usiamo come controllo incrociato.

  3. Cash Transactionstutti i campi

    Dividendi, ritenute, interessi, commissioni, depositi e prelievi.

  4. Corporate ActionsDetail

    Frazionamenti, fusioni, diritti: senza questi la storia dei lotti non torna.

  5. Financial Instrument Informationtutti i campi

    ISIN, tipo di strumento, paese dell'emittente: distingue azioni, ETF, ETC.

  6. Interest Accrualstutti i campi

    Ratei di interesse attivi e passivi, per il valore del conto a fine anno.

  7. Hard to Borrow Detailstutti i campi

    Costo del prestito titoli sulle vendite allo scoperto, giorno per giorno.

  8. Net Asset Value (NAV) in Basetutti i campi

    Valore giornaliero del conto: è la base del quadro RW e dell'IVAFE.

  9. Open PositionsSummary e Lot

    Posizioni aperte a fine periodo: controllano che abbiamo ricostruito tutto.

  10. Option Exercises, Assignments and Expirationstutti i campi

    Opzioni esercitate, assegnate o scadute: cambiano il costo delle azioni.

  11. Statement of Fundstutti i campi

    Il registro di cassa per valuta: serve per la soglia sulle valute estere.

  12. TradesExecutions

    Ogni eseguito, con commissioni e tasse: è la base del calcolo LIFO.

  13. Transaction Taxestutti i campi

    Imposte di borsa (per esempio Hong Kong o Regno Unito) da aggiungere al costo.

  14. Transferstutti i campi

    Trasferimenti di titoli in entrata o uscita, con i lotti originali.

Trades: solo Executions

Se in Trades spunti anche Orders o Closed Lots, le stesse operazioni compaiono più volte e i totali non tornano. In Corporate Actions scegli Detail; in Open Positions servono sia Summary sia Lot.

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.

Schema della Delivery Configuration: formato XML, periodo personalizzato, formato data yyyyMMdd e ora HHmmss.

Delivery Configuration

Format
XML

Non CSV: il file XML contiene tutti i campi che ci servono.

Period
Custom Date Range

Lo scegli al momento del download: un anno solare per file.

Date Format
yyyyMMdd

Per esempio 20250131.

Time Format
HHmmss

Per esempio 143005.

Date/Time Separator
; (semicolon)

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»

Di solito la data di fine cade di sabato o in un giorno festivo. Usa il 31 dicembre, oppure l'ultimo giorno lavorativo del periodo, e riprova.
Schema della query salvata: l'icona Run (freccia) la esegue, la matita la modifica.
Schema della finestra Run: periodo personalizzato dal 1° gennaio al 31 dicembre 2025, formato XML.

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.

Un file per ogni anno solare, dal primo anno del conto a quello da dichiarare. L'anno in corso serve solo per una stima.

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.

Schema del caricamento su Fiscal Broker: tutti i file insieme, la copertura degli anni e il pulsante Calcola.

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.
Vedi i tuoi numeri gratisNessuna carta richiesta · 29 € solo se vuoi il report completo

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