Interactive Brokers (IBKR)

Trandence supporta due modalità per importare le tue operazioni da Interactive Brokers (IBKR): Sincronizzazione automatica via Flex Web Service (consigliata) o Importazione manuale di file CSV/TXT.

---

Opzione 1: Sincronizzazione automatica (Flex Web Service)

La sincronizzazione automatica Flex Web Service consente a Trandence di recuperare le tue esecuzioni di azioni ed ETF in background senza dover esportare e caricare manualmente file CSV ad ogni sessione.

1. Aprire Flex Queries in IBKR

1. Accedi al tuo Client Portal IBKR (ad es. interactivebrokers.com, interactivebrokers.ie o interactivebrokers.co.uk).
2. Nel menu principale, vai su Performance & Reports → Flex Queries.

2. Creare una Activity Flex Query

1. Nella sezione Activity Flex Query, fai clic sul pulsante + (punto 1 nello screenshot sopra).
2. Assegna un nome alla query (ad es. Trandence Sync).
3. In Sections, fai clic su Trades e seleziona Execution.
4. Seleziona la casella Select All per includere tutti i campi di esecuzione.

5. In Delivery Configuration:
   • Imposta il Format su XML.
   • Imposta il Period su Last 30 Calendar Days (o Last 365 Calendar Days).
6. Fai clic su Save Changes / Continue in fondo alla pagina.
7. Nella pagina principale Flex Queries, fai clic sull’icona ⓘ (o sulla matita ✏️) accanto al nome della tua query per copiare il tuo Flex Query ID (ad es. 1604659).

3. Copiare il Flex Token

1. Nel riquadro Flex Web Service Configuration a destra, fai clic su ⚙️ (icona a forma di ingranaggio, punto 2 nello screenshot).
2. Assicurati che lo stato sia Enabled e copia il Flex Token (Current Token).

4. Connettere in Trandence

1. In Trandence, apri Broker Sync dalla barra laterale.
2. Fai clic su Configure IBKR nella scheda Interactive Brokers.
3. Incolla il tuo Flex Token e il tuo Flex Query ID (Account ID facoltativo).
4. Fai clic su Test & Save Connection.
5. Una volta connesso, le operazioni verranno sincronizzate automaticamente o tramite il pulsante Sync Trades.

---

Risoluzione dei problemi (Troubleshooting)

[!NOTE] Tempo di attivazione di 5–15 minuti
Dopo la creazione di una nuova query Flex, i server di IBKR impiegano da 5 a 15 minuti per attivare il flusso API. Se visualizzi Error (1003): Statement is not available, attendi qualche istante e riprova.

[!NOTE] Liquidazione di fine giornata per gli ordini odierni
I report Activity Flex Query vengono generati dopo la liquidazione notturna del mercato (tra le 23:00 e le 02:00 EST). Le esecuzioni intraday di oggi saranno disponibili al termine del clearing.

---

Opzione 2: Importazione manuale di file CSV

1. Crea un report Flex Query in formato CSV su IBKR.
2. Fai clic su Run (➔) e scarica il file .csv.
3. Caricalo su Trandence tramite Trades → Import Trades → Upload CSV/TXT.

---

Dati letti da Trandence

Trandence legge campi come DataDiscriminator, Symbol, Date/Time, Quantity, T. Price e Comm/Fee per azioni ed ETF (STK). Le transazioni in valuta estera vengono convertite automaticamente in USD in base ai tassi ufficiali della BCE.

File di esempio: Scarica file CSV di esempio IBKR