> ## Documentation Index
> Fetch the complete documentation index at: https://docs.notasx.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Ciclo da Nota

> Do pedido à NFS-e: os status, a diferença entre Rejeição e Falha e por que uma Nota nunca vira duas NFS-e.

Uma **Nota** é o registro de uma emissão pretendida. Ela existe antes, durante e depois do envio à Sefin,
e pode nunca virar NFS-e. A **NFS-e** só existe quando a Sefin devolve a chave de acesso (50 dígitos).

```mermaid theme={null}
stateDiagram-v2
    [*] --> pendente: POST /v1/notas
    pendente --> processando: emissão começa
    processando --> emitida: Sefin autorizou
    processando --> rejeitada: Sefin recusou
    processando --> falhou: impedimento ou sem resposta
    processando --> processando: nova tentativa (mesma DPS)
    emitida --> [*]
    rejeitada --> [*]
    falhou --> [*]
```

| Status | O que significa | O que fazer |
| - | - | - |
| `pendente` | Criada e na fila. | Aguardar. |
| `processando` | Montando, assinando ou enviando a DPS. | Aguardar. |
| `emitida` | **NFS-e emitida.** Tem `chave_acesso` e `numero_nfse`. | Baixar o XML, entregar ao Tomador. |
| `rejeitada` | **Rejeição**: a Sefin recusou a DPS. | Ler `resultado_codigo`, corrigir e criar **outra** Nota. |
| `falhou` | **Falha**: não virou NFS-e por motivo que não é recusa fiscal. | Ler `resultado_mensagem`, resolver a causa e criar outra Nota. |

`emitida`, `rejeitada` e `falhou` são finais: a Nota não muda mais.

## Rejeição × Falha

**Rejeição** é a Sefin dizendo "não" à DPS: dado fiscal inválido, código de serviço não permitido, e assim
por diante. Reenviar a mesma DPS não muda o resultado. `resultado_codigo` traz os códigos da Sefin
(ex.: `E0123`) e `resultado_mensagem`, a explicação.

**Falha** é quando a Nota não chegou a uma resposta fiscal. `resultado_codigo` diz qual:

* `impedimento`: algo impede a emissão antes de qualquer envio útil. Prestador sem Certificado ou com
  Certificado vencido, município não conveniado ao Padrão Nacional, ou número de DPS já usado fora do NotasX.
* `sem_resposta`: a Sefin não respondeu depois das novas tentativas automáticas.

## Uma Nota, uma DPS, no máximo uma NFS-e

Cada Nota tem **uma única DPS**, com um número reservado no primeiro envio. Quando a Sefin não responde,
o NotasX reenvia **a mesma DPS**, com o mesmo número. Se a Sefin já tinha autorizado e só a resposta se
perdeu, o NotasX recupera a NFS-e existente em vez de emitir outra.

Por isso, depois de `rejeitada` ou `falhou`, corrigir significa **criar uma Nota nova**, com outro
`Idempotency-Key`. Não existe "reenviar" uma Nota.

## Quanto tempo leva

Em homologação, a emissão costuma terminar em poucos segundos. Com a Sefin instável, as novas tentativas
espaçadas podem levar alguns minutos antes de `falhou` por `sem_resposta`.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.