Emitir NFS-e
Do envio dos dados à nota autorizada no padrão nacional: o que mandar, o que volta e como acompanhar o processamento.
Como a emissão funciona
A emissão é assíncrona. Você envia a nota, a API valida os dados e responde 201 com o status processando. A transmissão acontece em seguida, e o resultado chega por webhook ou por consulta.
- processando
- Significado
- Recebida, validada e na fila de transmissão
- O que fazer
- Aguarde o webhook ou consulte a nota
- autorizada
- Significado
- Aceita, com número e chave de acesso
- O que fazer
- Baixe o XML e o PDF
- rejeitada
- Significado
- Recusada na transmissão. Não tem valor fiscal
- O que fazer
- Corrija os dados e envie outra nota
- cancelada
- Significado
- Cancelada depois de autorizada
- O que fazer
- Nada. O estado é final
Antes de emitir
- A empresa emissora precisa de certificado A1 válido. Consulte em GET /certificados.
- O serviço deve usar um código de tributação nacional aceito no município do prestador.
- A chave precisa do escopo nfse:escrever e de acesso à empresa emissora.
Monte a requisição
Envie o emissor, o tomador e o serviço. Os impostos do Simples Nacional são calculados a partir do cadastro da empresa; você só informa o que foge da regra, como ISS retido.
curl -X POST https://api.emissordenota.com/v1/nfse \ -H "Authorization: Bearer $EDN_KEY" \ -H "Idempotency-Key: fatura-2026-11-0042" \ -H "Content-Type: application/json" \ -d '{ "empresa_id": "emp_8Kq2mXv41c", "data_competencia": "2026-11-09", "referencia": "fatura-0042", "tomador": { "documento": "98765432000198", "nome": "Clínica Bem Viver Ltda", "email": "[email protected]", "endereco": { "cep": "01310100", "numero": "1578" } }, "servico": { "codigo_tributacao_nacional": "010701", "descricao": "Suporte técnico em informática - novembro/2026", "valor": 1500.00, "iss_retido": false } }'Campos principais
empresa_idstringobrigatóriotomador.documentostringobrigatórioservico.codigo_tributacao_nacionalstringobrigatórioservico.valornumberobrigatóriodata_competenciadateopcionalreferenciastringopcionalAcompanhe o resultado
Use o webhook nfse.autorizada ou consulte a nota pelo id. Quando autorizada, ela traz número, chave de acesso e os links dos arquivos.
{ "id": "nfse_3Jt9wPz7Qa", "status": "autorizada", "numero": "000000127", "chave_acesso": "35503082212345678000190000000000012726110912345678", "valor": 1500.00, "referencia": "fatura-0042", "autorizada_em": "2026-11-09T10:42:11-03:00", "xml_url": "https://api.emissordenota.com/v1/nfse/nfse_3Jt9wPz7Qa/xml", "pdf_url": "https://api.emissordenota.com/v1/nfse/nfse_3Jt9wPz7Qa/pdf"}Trate as rejeições
Uma nota rejeitada não pode ser reenviada. Leia os motivos, corrija os dados e crie outra nota com uma nova Idempotency-Key.
{ "id": "nfse_7Qd1bRm5Ke", "status": "rejeitada", "motivos": [ { "campo": "servico.codigo_tributacao_nacional", "mensagem": "Código de tributação não aceito no município do prestador." } ]}Evite notas duplicadas
Mande em toda emissão um Idempotency-Key único por nota, como o número da fatura no seu sistema. Se a conexão cair e você repetir a chamada com a mesma chave em até 24 horas, a API devolve a nota já criada em vez de emitir outra.