Automação com n8n

O n8n conecta sistemas montando um fluxo com blocos, arrastando na tela. Você não escreve código: liga um bloco no outro.

Como a API do Conota é aberta e simples, um bloco de "requisição HTTP" já emite nota fiscal.

Isto já funciona hoje

Nada aqui depende de recurso futuro. É a mesma API que já está em produção.

Por onde começar

Faça nesta ordem. Cada página leva poucos minutos.

	Página	O que você faz
1	Criar a credencial	guarda sua chave no n8n com segurança — faça isto primeiro
2	Fluxo de exemplo: consultar CNPJ	importa um fluxo pronto e vê funcionando

Depois desses dois, você já entendeu o mecanismo inteiro — todo o resto muda só o endereço e os dados enviados.

Para quem é

Situação	n8n resolve?
Meu sistema não tem integração com o Conota	sim — é o caminho mais rápido
Quero emitir a partir de uma planilha ou de um formulário	sim
Quero avisar o cliente por e-mail ou WhatsApp quando a nota sair	sim
Minha loja é WooCommerce, Shopify, Nuvemshop...	sim — o n8n já conversa com elas
Emito milhares de notas por dia pelo meu sistema	não — integre direto
Quero perguntar sobre as notas em linguagem natural	não — use o MCP

Como um fluxo do Conota se parece

Todos têm a mesma forma. Muda o que dispara e o que é enviado.

1. Algo acontece          (um pedido é pago, uma linha entra na planilha)
        ↓
2. Você monta os dados    (bloco "Edit Fields")
        ↓
3. Chama o Conota         (bloco "HTTP Request")
        ↓
4. Guarda o resultado     (o número do trabalho, para acompanhar depois)

Três avisos que evitam a maior parte dos problemas

Estão detalhados nas páginas seguintes, mas vale ler antes de começar.

1. Nunca escreva sua chave dentro de um bloco

Fluxos do n8n são compartilhados como arquivo. Se a chave estiver escrita dentro de um bloco, ela vai junto — e quem receber o arquivo consegue emitir nota fiscal em nome da sua empresa.

Use sempre a credencial do n8n. É o assunto da primeira página.

2. Um fluxo pode rodar duas vezes

Você clica em "Execute" de novo, o sistema de origem reenvia o aviso, alguém testa. Sem proteção, cada repetição é uma nota nova.

A proteção é mandar uma referencia_externa — explicada em Referência externa e idempotência.

3. "Aceito" não é "autorizado"

Quando você pede uma emissão, o Conota responde na hora que recebeu o pedido. A nota ainda vai ser processada e enviada ao órgão que autoriza — e isso leva alguns segundos.

Um fluxo que avisa "nota emitida" nesse momento pode estar avisando sobre uma nota que será recusada. Ver Status das emissões.

Onde o n8n não é a ferramenta certa

Caminho	Quando
n8n	sem código; sua plataforma não tem integração pronta
API direta	volume alto, rotina sempre igual — ver Onboarding
MCP	perguntar sobre as notas conversando

Próximo passo

Criar a credencial →