Preferes a sincronização automática em vez de carregamentos manuais de CSV? Liga a tua conta da Interactive Brokers com um token do Flex Web Service só de leitura e a Oitava mantém a tua carteira atualizada.
A sincronização com a IBKR precisa de duas coisas do Client Portal: uma Activity Flex Query que diz quais os dados a enviar e um token do Flex Web Service que permite à Oitava pedi-los. Configuras isto uma só vez e, depois disso, a sincronização é automática e não precisas de voltar aqui.
1
Abre as definições do Flex Web Service
No Client Portal, vai a "Performance & Reports" → "Flex Queries". À direita, no painel "Flex Web Service Configuration": (1) clica no ícone da roda dentada.
2
Ativa o serviço e gera o teu token
(1) Marca "Flex Web Service Status". (2) Clica em "Generate New Token". Aparece um menu "Expire after": escolhe 1 ano, porque a opção por omissão de 6 horas faria a sincronização deixar de funcionar no próprio dia. (3) Clica em "Save". (4) Copia o "Current Token".
Deixa "Valid for IP Address" vazio.
3
Inicia o construtor de consultas com IA
Volta a "Flex Queries". No painel "Configure with AI" no topo: (1) clica em "Configure with AI".
4
Cola este pedido
(1) Cola o seguinte na caixa de descrição e depois (2) clica em "Generate Flex Query":
"Activity Flex Query, XML, period Last 365 Calendar Days. Sections: Trades, Cash Transactions, Corporate Actions, Financial Instrument Information, Include Currency Rates. Select all fields in each"
A IBKR limita esta caixa a 200 caracteres, por isso o pedido está escrito para caber. Mantém-no em inglês, tal como está.
5
Ativa "Include Currency Rates"
A IA ignora esta opção, por isso tem de ser definida à mão. No ecrã "Review Flex Query": (1) clica em "Edit Manually", (2) procura "Include Currency Rates?" em "General Configuration" e define como "Yes", (3) clica em "Save".
Isto permite que a Oitava use as taxas de câmbio da própria IBKR nas tuas transações, em vez de as estimar.
6
Copia o Query ID
No topo de "Review Flex Query": (1) copia o "Query ID", um número de 7 dígitos. Não o confundas com o número da tua conta, que começa por U.
7
Cola ambos na Oitava
Introduz o token e o Query ID nas definições de sincronização da tua carteira. Ambos são encriptados antes de serem guardados e o token é só de leitura. Consegue obter extratos, mas não consegue negociar nem movimentar dinheiro.
Nota: Preferes construir a consulta tu mesmo, em vez de usar a IA? Clica no + ao lado de "Activity Flex Query" e marca cinco secções, "Trades", "Cash Transactions", "Corporate Actions", "Financial Instrument Information" e "Include Currency Rates", clicando em "Select All" dentro de cada uma. Não precisas de escolher campos individuais. "Cash Transactions" é a que as pessoas esquecem: contém os teus dividendos, depósitos, levantamentos, comissões e juros, e sem ela a Oitava vê as tuas operações mas nada do teu numerário. "Corporate Actions" permite à Oitava atribuir à empresa certa o dinheiro de um direito de dividendo, que a IBKR regista com o nome do próprio direito.
Alguns limites que convém conhecer. A IBKR só disponibiliza através do Flex os últimos quatro anos civis mais o ano atual, por isso, se a tua conta for mais antiga, sincroniza o que for possível e importa um extrato de atividade em CSV para os anos anteriores. Cada pedido está limitado a 365 dias, por isso históricos mais longos são obtidos em lotes. Os dados do Flex chegam até ao dia útil anterior, ou seja, as operações de hoje aparecem amanhã, e as contas novas que aguardam o primeiro financiamento ainda não conseguem gerar extratos, por isso dá-lhe um dia depois de abrires a conta. Gerar um novo token invalida o anterior, por isso, se o voltares a gerar mais tarde, atualiza-o também na Oitava.
