> ## Documentation Index
> Fetch the complete documentation index at: https://docs.guito.pt/llms.txt
> Use this file to discover all available pages before exploring further.
# Conectar a Interactive Brokers
> Conecte a sua conta Interactive Brokers ao guito através do Client Portal para sincronizar posições, dinheiro e movimentos.
Depois de conectar a sua conta Interactive Brokers, o guito sincroniza automaticamente as posições, o dinheiro e os movimentos, que passam a aparecer junto do resto do seu património, sem registos manuais. Disponível no plano Plus.
O guito tem acesso apenas de leitura aos seus relatórios. Nunca executa ordens nem move dinheiro na sua conta Interactive Brokers.
## Conectar a sua conta
Vai precisar de um Token e de um Query ID, gerados no Client Portal da Interactive Brokers.
Aceda a **Conexões** na barra lateral, ou diretamente em `/connections`.
Clique em **Nova conexão** e, na lista de instituições, selecione **Interactive Brokers**.
Abra o Client Portal da Interactive Brokers e inicie sessão. Vá a **Performance & Reports**, abra o separador **Third-Party Reports** e, no cartão **Third-Party Services**, clique no botão **+**. Escreva "guito" na caixa de pesquisa e carregue em Enter, selecione o mosaico do guito e confirme em **Continue**.
*O guito não aparece entre as instituições mostradas por omissão, por isso pesquise em vez de o procurar na grelha.*
De volta ao cartão **Third-Party Services**, encontra uma linha com o nome **guito**, com as colunas Token e Query ID.
Cole o **Token** e o **Query ID** nos campos correspondentes no guito e confirme.
O Token tem uma data de validade, indicada junto dele nessa mesma tabela (por exemplo, "Expires: 2027/04/28") e em nenhum outro sítio. Quando o Token expirar, a sincronização é interrompida até colar um Token novo, por isso vale a pena tomar nota dessa data.
Se tiver outros serviços de terceiros ativos, a tabela terá mais do que uma linha: copie sempre o Token e o Query ID da linha do **guito**.
Na app, também pode tocar em **Adicionar** em Investimentos e escolher **Conectar corretora**: a lista mostra só as corretoras.
## Manter os dados atualizados
Não tem de fazer nada para manter a conta atualizada. O guito sincroniza a Interactive Brokers automaticamente uma vez por dia, de terça a sábado, a partir do relatório que a Interactive Brokers disponibiliza para o dia útil anterior. Não existe sincronização manual.
Se acabou de ativar o guito no Client Portal, a Interactive Brokers pode ainda não ter gerado o primeiro relatório. Até isso acontecer, a conexão não fica concluída: o guito avisa e pede-lhe para tentar novamente no dia útil seguinte.
## O que o guito sincroniza
As suas posições aparecem na carteira, com a quantidade e o custo médio.
O saldo é atualizado a partir do relatório diário da Interactive Brokers, por moeda.
Dividendos e juros são importados e classificados na categoria Investimentos.
Depósitos e levantamentos entram como Transferências; as comissões ficam em Taxas e comissões.
### Várias moedas
Se a sua conta Interactive Brokers tiver dinheiro em mais do que uma moeda, o guito trata cada moeda como uma conta de dinheiro própria (por exemplo, "Interactive Brokers (USD)"), cada uma com o seu histórico na moeda original e convertido para euros nos totais.
### Cotações
Para ativos menos comuns, que o fornecedor de dados de mercado do guito não cobre, a posição é avaliada ao preço de fecho indicado no relatório diário da Interactive Brokers. O gráfico mostra estes ativos a partir do dia em que esse preço foi aplicado pela primeira vez, normalmente o dia em que conectou a sua conta Interactive Brokers.
### Conflitos com transações manuais
Se já tinha registado manualmente uma compra ou venda que a Interactive Brokers agora também importa, o guito junta automaticamente os registos que são claramente a mesma operação. Os restantes possíveis duplicados ficam no painel **Duplicados a rever**, na página **Conexões**, onde confirma quais correspondem à mesma operação: os que confirmar são substituídos pela versão importada, e os restantes ficam como transações separadas.
## Atualizar credenciais, desconectar e reconectar
Se o Token expirar ou for revogado, escolha **Atualizar credenciais** no menu de ações do cartão da conexão e cole o Token e o Query ID atuais da linha do **guito**.
Para terminar a conexão, escolha **Desconectar** no mesmo menu. As contas Interactive Brokers são arquivadas e o Token e o Query ID são eliminados. Tudo o que já foi importado permanece visível.
Se o guito já estiver ativo no cartão Third-Party Services, adicioná-lo outra vez com o botão **+** dá o erro "The selected service is already enabled". Não precisa de voltar a conectar: use **Atualizar credenciais** com o Token e o Query ID da linha do **guito**.
## Limitações
* O guito importa até 3 anos de histórico. Compras e vendas mais antigas entram como um único registo de saldo inicial.
* Operações societárias como fusões ou aquisições não são aplicadas automaticamente: pode ter de ajustar a posição afetada manualmente. Os splits são a exceção — esses são aplicados automaticamente.
* Instrumentos como opções e warrants ainda não são suportados.
* Quando a Interactive Brokers não indica o custo de aquisição, como acontece com as ações transferidas de outra corretora, a posição entra na carteira sem custo e o ganho fica por calcular, indicado como "—".
* Disponível apenas no plano Plus.
## Páginas relacionadas
Veja como as suas posições e dinheiro da Interactive Brokers se juntam ao resto do património.
Outra corretora que o guito sincroniza automaticamente.
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.