A conexão com a Conta Azul é feita pelo login da sua própria conta (OAuth): você é direcionado à Conta Azul, autoriza o acesso e volta à Toca. Nenhuma chave é digitada à mão.
Esta integração está em homologação: a conexão funciona normalmente, mas as consultas no chat ainda estão em validação.
Antes de começar
- Tenha o plano Conta Azul Pro: é o único com acesso à API. Em outros planos a conexão até conclui, mas as consultas não retornam dados.
- Tenha o login da conta à mão: a autorização acontece na tela da própria Conta Azul.
Passo a passo
- Acesse
Configurações → Integraçõesna Toca. - Localize o card Conta Azul e clique no botão de conexão.
- Você será direcionado à Conta Azul: entre com a sua conta e autorize o acesso solicitado.
- De volta à Toca, o card fica marcado como conectado e a Toca já consegue consultar o ERP.
O que a Toca acessa
Com a conexão ativa, a Toca lê notas fiscais emitidas, contas a pagar e a receber, fluxo de caixa, produtos e serviços, e o cadastro de clientes e fornecedores da Conta Azul. O acesso é somente de leitura: a Toca não altera dados na sua conta. Conectar a Conta Azul não desativa a integração da sua loja virtual ou marketplace — as conexões convivem, e a Toca cruza os dados do ERP com os da loja.
Manutenção da conexão
A Toca renova a autorização automaticamente. Se o acesso for revogado na Conta Azul, ou
se a renovação falhar, refaça a conexão pelo mesmo card em
Configurações → Integrações.
Problemas comuns
- Conectou, mas as consultas não retornam nada — verifique o plano: só o Conta Azul Pro tem acesso à API. Uma lista vazia nesse caso costuma ser falta de plano, não falta de dado.
- A conexão caiu — um acesso revogado na Conta Azul exige reconectar pelo card. A renovação da autorização é automática enquanto o acesso estiver válido.
- Dúvida sobre o que o plano inclui — confirme na documentação oficial da Conta Azul quais recursos o seu plano libera para integrações.