GuiasEmitir NFS-e

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.

POST /v1/nfse
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": "financeiro@bemviver.com.br",      "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ório
Empresa emissora. Precisa estar na carteira do escritório e liberada para a chave.
tomador.documentostringobrigatório
CNPJ ou CPF de quem contrata o serviço, só com dígitos.
servico.codigo_tributacao_nacionalstringobrigatório
Código de seis dígitos da lista nacional de serviços.
servico.valornumberobrigatório
Valor do serviço em reais, com ponto decimal.
data_competenciadateopcional
Dia em que o serviço foi prestado. Sem ela, vale a data do envio.
referenciastringopcional
Identificador do seu sistema. Volta nas consultas e nos webhooks.
Ver todos os campos na referência

Acompanhe 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.

GET /v1/nfse/nfse_3Jt9wPz7Qa
{  "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.

GET /v1/nfse/nfse_7Qd1bRm5Ke
{  "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.