Ir para conteúdo principal

Alerta "Problemas com a conexão via API"

⚪️ Guia do usuário

Quando receber este alerta, significa que as APIs que está a utilizar para ligar a sua plataforma de câmbio deixaram de funcionar.

Isto pode acontecer por várias razões, tais como chaves caducadas ou inválidas, ou permissões incorretas definidas aquando da criação da API.

⚠️ Encerramento de contas de uma exchange

Se pretende encerrar a sua conta numa exchange a qual se encontra conectada ao Finbooks, por favor, indique-nos tal antes de prosseguir.

Isto permite-nos congelar a ligação antecipadamente e evitar alertas de erro que, de outra forma, surgiriam assim que as chaves da API deixassem de estar ativas.


O que é uma ligação API?

Uma ligação API é a conexão segura entre o Finbooks e a sua exchange ou carteira.Através desta ligação, o software importa automaticamente todas as suas transações, saldos e dados históricos.

Se a API não estiver a funcionar, o Finbooks não consegue descarregar as suas transações mais recentes, o que significa que a sua carteira e os seus relatórios fiscais podem ficar incompletos ou imprecisos.


Por que razão ocorrem problemas com a API?

Há várias razões comuns para que uma API deixe de funcionar:

  • as chaves API expiraram após um determinado período

  • a plataforma de câmbio atualizou as suas políticas de segurança e as chaves antigas já não são válidas

  • as permissões concedidas aquando da criação das chaves (ler saldos, ler transações, etc.) estão incompletas

  • as chaves API foram eliminadas ou revogadas manualmente pela plataforma de câmbio

  • a conta na plataforma de câmbio foi encerrada e as chaves API já não existem


Onde verá este alerta

Este alerta aparece no Centro de Notificações, que pode abrir clicando em Notificações no menu principal, na parte inferior da barra lateral. Encontrá-lo-á na secção Ação necessária, na parte superior da página, identificado com a etiqueta Crypto, e o ícone vermelho no item do menu irá lembrá-lo de que algo requer a sua atenção.

O alerta permanece visível até que a ligação seja corrigida: abrir o Centro de Notificações não faz com que desapareça, pois a sua resolução requer uma ação da sua parte.

Na mesma secção, encontrará também um link «O que causa os erros?», que abre uma explicação passo a passo sobre os problemas mais comuns.

Pode saber mais sobre como funcionam os alertas e as notificações no nosso artigo sobre o Centro de Notificações.


O que acontece se a API não for corrigida?

Se o problema não for resolvido, o Finbooks deixará de conseguir importar as tuas transações da exchange afetada. Como resultado:

  • os saldos apresentados na plataforma deixarão de estar atualizados

  • os relatórios fiscais poderão apresentar lacunas de dados e tornar-se imprecisos

  • poderá ter de importar manualmente as transações através de CSV, o que requer um esforço adicional


Como resolver problemas com a API

Clique no alerta na secção «Ação necessária»: será redirecionado diretamente para a ligação afetada. Ao clicar em «Corrigir», pode atualizar as APIs com as novas que criou anteriormente na bolsa.

Isto garantirá que todos os dados históricos da ligação sejam mantidos na sua conta.

Introduza as novas APIs e, em seguida, clique em «Guardar e...»

Assim que a ligação voltar a funcionar, o alerta é resolvido e desaparece da secção «Ação necessária».


Mantenha os seus dados precisos com o Finbooks

Manter uma ligação API ativa é essencial para manter os seus saldos, ganhos e perdas atualizados automaticamente. Se as suas chaves API não forem válidas, o Finbooks irá notificá-lo imediatamente para que possa tomar medidas.

Isto respondeu à sua pergunta?