Da primeira chamada à nota que vale.
Dez tutoriais curtos, com exemplo pronto para copiar: emitir nota de produto e de serviço, não emitir em dobro, lidar com a Sefaz em silêncio, receber o aviso da nota e passar para produção sem susto.
Da conta à primeira nota.
Do cadastro à primeira nota de teste: o roteiro da API de nota fiscal
Cinco passos antes da primeira chamada: conta, dados da empresa, certificado digital, chave de API e o ambiente de teste. O que cada um faz e onde fica.
Ler Nota de produto · 2 minEmita sua primeira NF-e pela API, passo a passo
Uma chamada POST com a nota inteira no corpo: os cabeçalhos, um exemplo de JSON que fecha a conta, a resposta da Sefaz e como baixar o XML e o PDF.
Ler Nota de serviço · 3 minNota de serviço pela API: a NFS-e do padrão nacional
Como emitir a nota de serviço pelo emissor nacional com a mesma API: o que a empresa precisa ter, o corpo da chamada, as retenções e os limites de hoje.
LerSem nota em dobro, sem nota perdida.
Como nunca emitir nota em dobro: a Idempotency-Key
A internet caiu no meio do envio e o sistema tentou de novo. Com a mesma Idempotency-Key, a segunda tentativa devolve a mesma nota. Os cenários e o que fazer em cada um.
Ler Integração segura · 2 minNota pendente: a Sefaz não respondeu. E agora?
O 202 significa que a nota foi enviada e a Sefaz ficou em silêncio. Por que a API não devolve o número nessa hora e como resolver a pendência com uma chamada.
Ler Integração segura · 2 minReceba o aviso da nota no seu sistema e confira que ele é nosso
Configure o endereço, conheça os eventos e confira a assinatura de cada aviso em poucas linhas de código, com exemplo em Node.js e em Python.
Ler Erros · 2 minOs erros da API de nota fiscal: o que cada código quer dizer
Do 201 ao 503: o que cada resposta significa e o que o seu sistema deve fazer. E como ler uma recusa da Sefaz sem precisar adivinhar o campo.
LerCancelar, corrigir, imposto e produção.
Cancelar a nota ou corrigir com carta de correção: quando cada um serve
Errou a nota? Às vezes cancela, às vezes corrige. O que a carta de correção não pode mudar, o prazo do cancelamento e as chamadas da API para os dois.
Ler Impostos · 2 minOs impostos da nota pela API: o que você manda e o que a API calcula
Quem decide o imposto é a sua empresa; a API confere se fecha. CSOSN ou CST, IBS e CBS de 2026, DIFAL, tributos aproximados e o que ainda não é suportado.
Ler Produção · 2 minDa homologação para a produção: a lista antes de a nota valer
Os cenários que o seu sistema precisa ter visto em teste, como liberar a produção, o que passa a contar na conta e como guardar o XML pelo prazo da lei.
Ler