Pular para o conteúdo principal

Fluxo de exemplo: consultar CNPJ

Um fluxo pronto para importar. Ele consulta os dados de uma empresa pelo CNPJ e mostra o resultado.

Comece por ele. É a forma mais rápida de confirmar que a sua credencial está certa — e nenhuma nota fiscal é emitida, então não há risco de gerar documento por engano.

O que este exemplo consome

A consulta de CNPJ conta na franquia de consultas do seu plano — é barata, mas não é zero. O que ela não faz é emitir documento nem gerar efeito fiscal.

Antes de começar​

Se ainda não criou, faça isso primeiro — o fluxo não vai funcionar sem ela.

1. Baixe o fluxo​

Baixar conota-consultar-cnpj.json

Se o arquivo abrir no navegador em vez de baixar, clique com o botão direito no link e escolha "Salvar link como...".

2. Importe no n8n​

  1. no n8n, abra o menu do canto superior direito;
  2. escolha Import from File...;
  3. selecione o arquivo que você baixou.

O fluxo aparece na tela com quatro blocos e duas notas amarelas explicando cada parte.

Também dá para colar

Se preferir, abra o arquivo em um editor de texto, copie todo o conteúdo, clique na tela em branco do n8n e cole com Ctrl+V. O n8n reconhece e monta o fluxo.

3. Escolha a sua credencial​

Este é o único passo que você precisa fazer — o fluxo vem sem credencial de propósito.

  1. clique no bloco CONOTA - Consultar CNPJ;
  2. procure o campo Credential for Header Auth;
  3. escolha a credencial que você criou (Conota — homologação);
  4. feche o bloco.
O bloco aparece marcado até você fazer isso

Se o n8n mostrar um aviso vermelho no bloco, é exatamente isso: falta escolher a credencial. Não é erro do fluxo.

4. Execute​

Clique em Execute workflow, no rodapé da tela.

Se tudo estiver certo, o bloco fica verde e o resultado aparece do lado direito:

{
  "cnpj": "00000000000191",
  "dados": {
    "razao_social": "BANCO DO BRASIL SA",
    "situacao": "ATIVA",
    "municipio": "BRASILIA",
    "uf": "DF"
  },
  "sucesso": true
}
Deu certo?

Então sua credencial está correta e o n8n consegue falar com o Conota. Todo o resto é variação disto — muda o endereço chamado e os dados enviados.

O que cada bloco faz​

BlocoPara quê
When clicking 'Execute workflow'dispara o teste quando você clica. Num fluxo de verdade, vira um Webhook — quem dispara é a sua loja ou o seu sistema
CNPJexemplodefine o CNPJ que será consultado. É aqui que, num fluxo real, chegariam os dados de fora
CONOTA - Consultar CNPJfaz a chamada à API do Conota, usando a sua credencial

Trocar o CNPJ consultado​

  1. clique no bloco CNPJexemplo;
  2. troque o número dentro de "CNPJexemplo";
  3. execute de novo.
Aqui vai sem a barra

O CNPJ entra no endereço da chamada. A barra da máscara é separador de endereço: mandando 00.000.000/0001-91, a URL vira /v1/cnpj/00.000.000/0001-91 e você recebe 404 — rota não encontrada.

O que digitarFunciona?
00000000000191✅ use este
00.000.000/0001-91❌ 404 — a barra quebra o endereço
00.000.0000001-91✅ ponto e hífen passam; só a barra não

Em CPF a máscara completa funciona (125.244.567-90), porque CPF não tem barra.

O formato novo de CNPJ, com letras, é aceito — ver Atualizações fiscais.

Se algo deu errado​

O que apareceO que éO que fazer
401 · API Key invalidaa chave está errada, ou o cabeçalho não é X-API-Keyconfira os dois campos na credencial
Aviso vermelho no blocofalta escolher a credencialpasso 3 acima
429a franquia de consultas do plano acabouveja o consumo em console.conota.dev
400 · CNPJ inválidoo número não tem 14 posiçõesconfira o valor no bloco CNPJexemplo

A lista completa de comportamentos está em Erros e rejeições.

E agora?​

Este fluxo é o "olá mundo" da integração. O próximo passo natural é emitir, e aí valem os cuidados que uma consulta não exige:

  • mandar uma referencia_externa para o fluxo não emitir duas vezes ao ser reexecutado — ver Referência externa e idempotência;
  • entender que a resposta é assíncrona: o Conota confirma que recebeu, e o resultado chega depois — ver Sua primeira emissão;
  • decidir de onde vêm os dados fiscais dos produtos (NCM, CFOP, CST), que a sua loja provavelmente não tem — ver Conota Connect.
Mais exemplos em breve

Estamos publicando outros fluxos prontos: emitir NFS-e, emitir NF-e a partir de um pedido, receber o retorno da emissão e tratar rejeição.

Última atualização em