---
title: "Guia: emitir NFS-e pela API"
description: "Guia para emitir NFS-e no padrão nacional pela API: status da nota, pré-requisitos, campos da requisição, acompanhamento por webhook e tratamento de rejeições."
url: https://docs.emissordenota.com/guias/emitir-nfse
language: pt-BR
---
# 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.

| Status | Significado | O que fazer |
| --- | --- | --- |
| processando | Recebida, validada e na fila de transmissão | Aguarde o webhook ou consulte a nota |
| autorizada | Aceita, com número e chave de acesso | Baixe o XML e o PDF |
| rejeitada | Recusada na transmissão. Não tem valor fiscal | Corrija os dados e envie outra nota |
| cancelada | Cancelada depois de autorizada | 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**

```bash
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_id` (string, obrigatório): Empresa emissora. Precisa estar na carteira do escritório e liberada para a chave.
- `tomador.documento` (string, obrigatório): CNPJ ou CPF de quem contrata o serviço, só com dígitos.
- `servico.codigo_tributacao_nacional` (string, obrigatório): Código de seis dígitos da lista nacional de serviços.
- `servico.valor` (number, obrigatório): Valor do serviço em reais, com ponto decimal.
- `data_competencia` (date, opcional): Dia em que o serviço foi prestado. Sem ela, vale a data do envio.
- `referencia` (string, opcional): Identificador do seu sistema. Volta nas consultas e nos webhooks.

[Ver todos os campos na referência](https://docs.emissordenota.com/referencia/nfse)

## 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**

```json
{
  "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**

```json
{
  "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.
