Conota Connect

Conectar a sua plataforma de venda ou cobrança ao Conota, para que a nota saia sozinha quando o pedido é pago.

O que está disponível hoje

Esta página descreve o que já funciona — não um roadmap

Integrações nativas estão em construção. Enquanto elas não chegam, o caminho disponível é o n8n, e ele não é um paliativo: é uma automação de verdade, que roda em produção e que você controla.

Caminho	Estado	Quando usar
n8n	disponível	qualquer plataforma; o caminho mais rápido hoje
API REST direta	disponível	você tem time técnico e volume alto
Conectores nativos	em construção	quando chegarem, para as plataformas cobertas

Como escolher

Sua plataforma tem nó no n8n?
        │
        ├── sim  → n8n. Fluxo pronto em horas, sem escrever código.
        │
        └── não  → tem API ou webhook?
                    │
                    ├── sim → n8n com nó HTTP Request
                    │
                    └── não → integração direta pela nossa API,
                              a partir do seu sistema

O que qualquer integração precisa resolver

Independente do caminho, quatro coisas decidem se a integração funciona em produção ou dá dor de cabeça no fechamento do mês. Elas valem para n8n, para código próprio e para qualquer conector.

1. Não emitir duas vezes

Todo gatilho pode disparar duas vezes — reenvio da plataforma, reexecução do fluxo, clique duplicado. Mande uma referencia_externa derivada de algo que já existe do seu lado (o número do pedido, o id da cobrança).

Reenviar a mesma referência devolve o job existente em vez de emitir de novo. Ver Referência externa e idempotência.

2. Saber de onde vêm os dados fiscais

A plataforma de venda sabe preço, cliente e quantidade. Ela não sabe NCM, CFOP nem CST.

É aqui que a maioria das integrações trava

Para NFS-e, costuma bastar um serviço fixo — o mesmo em toda emissão. É simples.

Para NF-e, cada produto precisa da sua classificação fiscal. Esses dados precisam vir de algum lugar: campos personalizados na própria plataforma, uma planilha de/para, ou o cadastro do seu ERP. Decida isso antes de montar o fluxo, não depois.

3. Tratar o retorno assíncrono

A emissão responde 202 com um job_id — aceita, ainda não autorizada. O resultado chega depois, por webhook ou consulta.

Um fluxo que trata 202 como sucesso vai dizer "nota emitida" para uma nota que pode ser rejeitada segundos depois. Ver Status das emissões.

4. Separar rejeição de erro técnico

Rejeição fiscal é o autorizador recusando por uma regra — repetir dá o mesmo resultado, alguém precisa corrigir o dado. Falha técnica pode ser repetida.

Tratar os dois igual leva ao pior comportamento possível: reenviar em laço uma nota que vai ser recusada de novo. Ver Erros e rejeições.

Próximos passos

• Automação com n8n — o caminho disponível hoje
• Onboarding da integração — se for integrar direto
• Referência da API — todas as rotas