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

Esta página mostra como conectar a sua conta Interactive Brokers ao guito. Depois de ligada, o guito sincroniza automaticamente posições, dinheiro, dividendos, juros, depósitos, levantamentos e comissões, que passam a aparecer junto do resto do seu património sem registos manuais. Esta funcionalidade está disponível no plano Plus.

<Note>
  O guito tem acesso apenas de leitura aos seus relatórios. Nunca executa ordens nem move dinheiro na sua conta Interactive Brokers.
</Note>

## Conectar a sua conta

Vai precisar de um Token e de um Query ID, gerados no Client Portal da Interactive Brokers.

<Steps>
  <Step title="Abra a página de conexões">
    Aceda a **Conexões** na barra lateral, ou diretamente em `/connections`.
  </Step>

  <Step title="Conecte a Interactive Brokers">
    Clique em **Nova conexão** e, na lista de instituições, selecione **Interactive Brokers**.
  </Step>

  <Step title="Autorize o guito no Client Portal">
    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**, carregue no botão **+**. Escreva "guito" na caixa de pesquisa e carregue em Enter, selecione o mosaico do guito e confirme em **Continue**.

    <Frame>
      <img src="https://mintcdn.com/guito/VDQhC04OZMfT5Dwt/images/ibkr/third-party-services-picker.png?fit=max&auto=format&n=VDQhC04OZMfT5Dwt&q=85&s=5b0e739286e57e06e2f24ecfd97118ce" alt="A janela Add Third-Party Services no Client Portal da Interactive Brokers, com o guito pesquisado e o seu mosaico selecionado" width="1542" height="742" data-path="images/ibkr/third-party-services-picker.png" />
    </Frame>

    *O guito não aparece entre as instituições mostradas por omissão, por isso pesquise em vez de o procurar na grelha.*
  </Step>

  <Step title="Copie o Token e o Query ID">
    De volta ao cartão **Third-Party Services**, encontra uma linha com o nome **guito**, com as colunas Token e Query ID.

    <Frame>
      <img src="https://mintcdn.com/guito/VDQhC04OZMfT5Dwt/images/ibkr/third-party-services-table.png?fit=max&auto=format&n=VDQhC04OZMfT5Dwt&q=85&s=fa0a61d47ecd2fc2c7e20979e938080f" alt="Tabela de serviços de terceiros no Client Portal, com as colunas Token e Query ID da linha do guito" width="1568" height="444" data-path="images/ibkr/third-party-services-table.png" />
    </Frame>

    *O Token e o Query ID nesta captura de ecrã estão ocultos. No seu ecrã aparecem por extenso.*
  </Step>

  <Step title="Cole os valores e confirme">
    Cole o **Token** e o **Query ID** nos campos correspondentes no guito e confirme.
  </Step>
</Steps>

<Warning>
  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 para até colar um Token novo, por isso vale a pena tomar nota dessa data.
</Warning>

<Tip>
  O Token é partilhado por todos os serviços de terceiros ativos na sua conta, por isso aparece igual em todas as linhas da tabela. Já o Query ID é diferente em cada serviço: copie sempre o da linha do **guito**, nunca o de outra linha.
</Tip>

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

<Note>
  Se acabou de ativar o guito no Client Portal, o primeiro relatório pode só ficar disponível no dia útil seguinte.
</Note>

## O que o guito sincroniza

<CardGroup cols={2}>
  <Card title="Posições" icon="https://mintcdn.com/guito/Z2-mKthyIORVPFl5/icons/chart-line.svg?fit=max&auto=format&n=Z2-mKthyIORVPFl5&q=85&s=cf550edb08c858b12e2d7f0b5d18ee20" width="24" height="24" data-path="icons/chart-line.svg">
    As suas posições aparecem na carteira com a quantidade e o custo médio que a Interactive Brokers reporta à data em que conectou a conta.
  </Card>

  <Card title="Dinheiro" icon="https://mintcdn.com/guito/Z2-mKthyIORVPFl5/icons/wallet.svg?fit=max&auto=format&n=Z2-mKthyIORVPFl5&q=85&s=fe7531f58f311ad5a6aad3bb2cfe062e" width="24" height="24" data-path="icons/wallet.svg">
    O saldo é atualizado a partir do relatório diário da Interactive Brokers, por moeda.
  </Card>

  <Card title="Dividendos e juros" icon="https://mintcdn.com/guito/qyCDktPAmiF08sQd/icons/coins.svg?fit=max&auto=format&n=qyCDktPAmiF08sQd&q=85&s=d1d1eba874bd25515843d79238b73d17" width="24" height="24" data-path="icons/coins.svg">
    Dividendos e juros são importados e classificados na categoria Investimentos.
  </Card>

  <Card title="Depósitos, levantamentos e comissões" icon="https://mintcdn.com/guito/Z2-mKthyIORVPFl5/icons/arrow-left-right.svg?fit=max&auto=format&n=Z2-mKthyIORVPFl5&q=85&s=40dcd9f3b41b775fc907ffd01c3261e1" width="24" height="24" data-path="icons/arrow-left-right.svg">
    Depósitos e levantamentos entram como Transferências; as comissões ficam em Taxas e comissões.
  </Card>
</CardGroup>

### Histórico importado

Ao conectar a conta, o guito importa até 3 anos de dividendos, juros, comissões, depósitos e levantamentos. As suas posições, no entanto, arrancam com a quantidade e o custo médio da data em que conectou a conta: compras e vendas anteriores a essa data não são importadas individualmente. A partir daí, cada compra ou venda executada na Interactive Brokers passa a entrar como uma transação própria, também classificada em Investimentos.

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

### Conflitos com transações manuais

Se já tinha registado manualmente uma compra ou venda que a Interactive Brokers agora também importa, o guito assinala os possíveis duplicados numa lista de revisão. Aí pode escolher, registo a registo, 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, for revogado, ou simplesmente quiser gerar novas credenciais, escolha **Atualizar credenciais** no menu de ações do cartão da conexão e cole o Token e o Query ID atuais, copiados da linha do **guito** no Client Portal.

Para terminar a conexão, escolha **Desconectar** no mesmo menu. A conta de dinheiro é arquivada e o Token e o Query ID são eliminados do cofre. As transações, posições e o histórico de dividendos e movimentos já importados permanecem visíveis.

<Warning>
  Se o guito já estiver ativo no cartão Third-Party Services e tentar adicioná-lo outra vez a partir do botão **+**, a Interactive Brokers recusa o pedido com o erro "The selected service is already enabled". Não precisa de voltar a conectar a conta: use **Atualizar credenciais** e copie o Token e o Query ID da linha do **guito** que já existe.
</Warning>

## Limitações

* Compras e vendas anteriores à data em que conectou a conta não são importadas individualmente; a posição arranca com a quantidade e o custo médio que a Interactive Brokers reportava nessa data.
* Ações corporativas, como splits, não são aplicadas automaticamente: pode ter de ajustar a posição afetada manualmente.
* Instrumentos como opções e warrants ainda não são suportados.
* Disponível apenas no plano Plus.

## Páginas relacionadas

<CardGroup cols={2}>
  <Card title="Visão geral do património" icon="https://mintcdn.com/guito/Z2-mKthyIORVPFl5/icons/house.svg?fit=max&auto=format&n=Z2-mKthyIORVPFl5&q=85&s=94cc77f0619465f49834864f88fc8397" href="/pt/features/net-worth-overview" width="24" height="24" data-path="icons/house.svg">
    Veja como as suas posições e dinheiro da Interactive Brokers se juntam ao resto do património.
  </Card>

  <Card title="Conectar a Trading 212" icon="https://mintcdn.com/guito/Z2-mKthyIORVPFl5/icons/cable.svg?fit=max&auto=format&n=Z2-mKthyIORVPFl5&q=85&s=2399c861dd1227ca95e22d6c16cbe093" href="/pt/features/trading-212" width="24" height="24" data-path="icons/cable.svg">
    Outra corretora que o guito sincroniza automaticamente.
  </Card>
</CardGroup>
