Interactive Brokers (IBKR)

Trandence suporta dois métodos para importar as suas operações da Interactive Brokers (IBKR): Sincronização automática via Flex Web Service (recomendado) ou Importação manual de ficheiros CSV/TXT.

---

Opção 1: Sincronização automática (Flex Web Service)

A sincronização automática do Flex Web Service permite ao Trandence obter as suas execuções de ações e ETFs em segundo plano, sem necessidade de exportar e carregar ficheiros CSV a cada sessão.

1. Abrir Flex Queries na IBKR

1. Inicie sessão no seu IBKR Client Portal (por exemplo, interactivebrokers.com, interactivebrokers.ie ou interactivebrokers.co.uk).
2. No menu superior, navegue até Performance & Reports → Flex Queries.

2. Criar uma Activity Flex Query

1. Na secção Activity Flex Query, clique no botão + (item 1 na captura acima).
2. Dê um nome à consulta (por exemplo, Trandence Sync).
3. Em Sections, clique em Trades e selecione Execution.
4. Marque a caixa Select All para incluir todos os campos de execução.

5. Em Delivery Configuration:
   • Defina o Format para XML.
   • Defina o Period para Last 30 Calendar Days (ou Last 365 Calendar Days).
6. Clique em Save Changes / Continue no fundo da página.
7. Na página principal do Flex Queries, clique no ícone ⓘ (ou no lápis ✏️) ao lado do nome da sua consulta para copiar o seu Flex Query ID (por exemplo, 1604659).

3. Copiar o Flex Token

1. No quadro Flex Web Service Configuration à direita, clique em ⚙️ (ícone de engrenagem, item 2 na captura).
2. Verifique se o estado está Enabled e copie o Flex Token (Current Token).

4. Ligar no Trandence

1. No Trandence, abra Broker Sync na barra lateral.
2. Clique em Configure IBKR no cartão da Interactive Brokers.
3. Cole o seu Flex Token e o seu Flex Query ID (Account ID opcional).
4. Clique em Test & Save Connection.
5. As suas operações serão sincronizadas automaticamente em segundo plano ou através do botão Sync Trades.

---

Resolução de problemas (Troubleshooting)

[!NOTE] Tempo de ativação de 5 a 15 minutos
Após criar uma nova consulta Flex, os servidores da IBKR demoram entre 5 e 15 minutos para disponibilizá-la na API. Se vir Error (1003): Statement is not available, aguarde alguns minutos e tente novamente.

[!NOTE] Liquidação de fecho de mercado para ordens de hoje
Os relatórios Activity Flex Query são gerados após o processamento noturno da bolsa (entre 23:00 e 02:00 EST). As execuções intraday de hoje ficam disponíveis após o fecho.

---

Opção 2: Importação manual de ficheiro CSV

1. Crie um relatório Flex Query no formato CSV na IBKR.
2. Clique em Run (➔) e descarregue o ficheiro .csv.
3. Carregue no Trandence em Trades → Import Trades → Upload CSV/TXT.

---

Dados lidos pelo Trandence

Trandence lê campos como DataDiscriminator, Symbol, Date/Time, Quantity, T. Price e Comm/Fee para ações e ETFs (STK). As transações em moeda estrangeira são convertidas automaticamente para USD com base nas taxas oficiais do BCE.

Ficheiro de exemplo: Descarregar ficheiro CSV de exemplo IBKR