# Consulte pelo n8n

Fonte: https://docs.ruralzap.com.br/receitas/n8n

Configure uma chamada HTTP mantendo a credencial fora do workflow exportado.





## Objetivo e pré-requisitos [#objetivo-e-pré-requisitos]

Criar um workflow de consulta de saldos. Você precisa de uma instância n8n e de uma integração com `balances:read`.

## 1. Cadastre a credencial [#1-cadastre-a-credencial]

Crie uma credencial de autenticação por cabeçalho no n8n, com nome `Authorization` e valor `Bearer SUA_CHAVE`. Insira o segredo diretamente no gerenciador de credenciais, nunca em um campo comum do workflow.

## 2. Configure o HTTP Request [#2-configure-o-http-request]

* Método: GET.
* URL: `https://api.finance.meyje.com.br/api/v1/integration/context`.
* Autenticação: selecione a credencial cadastrada.
* Resposta: JSON.

Execute uma vez e confira o Space e as capacidades. Depois troque o caminho final para `balances`.

## 3. Trate resultado e falhas [#3-trate-resultado-e-falhas]

Leia `data` e `totals`. Preserve valores como strings; não converta dinheiro com operações numéricas de ponto flutuante. Configure timeout e tentativas limitadas. Em 429, respeite `Retry-After`; não repita cegamente falhas de acesso.

## Resultado esperado [#resultado-esperado]

Uma saída JSON com carteiras, totais por moeda e instante de geração. Proteja o histórico de execuções do n8n, pois ele pode armazenar respostas financeiras.

## Erros comuns [#erros-comuns]

Chave cadastrada sem o prefixo Bearer retorna falha de autenticação. Credencial válida sem acesso ao recurso não resolve um 403. Não exporte o segredo junto ao workflow.

## Próximos passos [#próximos-passos]

Para lançamentos, configure a [paginação por cursor](/guias/paginacao), preservando filtros e verificando o término. Para relatórios, use a [receita específica](/receitas/relatorios).