Estados da NFS-e

Os 7 status de uma NFS-e emitida

                     POST /v1/nfse
                          |
                          v
                    transmitindo ----(30 min)----> aviso processamento_prolongado
                     |   |    |                    (só aviso; o status não muda)
                     |   |    +--(competência acabou num retry)--> aguardando_confirmacao
                     |   |                                          |
                     |   |              POST /v1/nfse/{id}/confirmacao
                     |   |                                          |
                     |   |    <-------------------------------------+
                     |   |
                     |   +--(recuperação desiste após 7 dias)--> falha_transmissao
                     |
         +-----------+-----------+
         v                       v
     autorizada              rejeitada
         |
         | cancelamento, ou substituição autorizada
         v
     cancelada

descartada não aparece no desenho: é a nota que voltou sem sucesso e foi descartada no painel, ou a linha válida de um lote que você deixou de fora em POST /v1/lotes/{id}/emissao.

Status	O que significa	O que fazer	Final?	Webhook
transmitindo	Na fila, enviando, ou recuperando uma falha técnica do Sistema Nacional.	Esperar. Não emita de novo.	Não	Nenhum ao entrar. NFSE_PROCESSAMENTO_PROLONGADO aos 30 minutos, uma vez, como aviso.
autorizada	NFS-e emitida. numero e chave_acesso preenchidos.	Baixar PDF e XML.	Sim (só pode virar cancelada)	NFSE_AUTORIZADA
rejeitada	O Sistema Nacional recusou. Motivo em rejeicao.	Corrigir e emitir uma nota nova, com outra referencia. Em lote, POST /v1/lotes/{id}/reprocessamento.	Sim, pela API	NFSE_REJEITADA
cancelada	Cancelada depois de autorizada. Protocolo em cancelamento. Se foi por substituição, substituida_por diz qual nota a substituiu.	Nada.	Sim	NFSE_CANCELADA
falha_transmissao	A transmissão não pôde ser concluída nem confirmada, e nada mais será tentado sozinho. Veja falha.dps_enviada.	Com "nao": emitir de novo é seguro. Com "desconhecido": conferir no Emissor Nacional antes.	Sim	NFSE_FALHA_TRANSMISSAO
aguardando_confirmacao	A competência da nota acabou antes de uma retentativa automática. Nada é transmitido até você decidir.	POST /v1/nfse/{id}/confirmacao, mantendo ou trocando a competência.	Não	NFSE_AGUARDANDO_CONFIRMACAO
descartada	Descartada no painel, ou linha válida de lote que não foi escolhida.	Nada.	Sim	Nenhum

Não existe status substituida: a nota substituída fica cancelada, com substituida_por.

A linha do tempo de cada nota está em eventos, no GET /v1/nfse/{id}: criada, cada envio, consulta_dps, correcao_automatica, recuperada e os demais passos, com a hora de cada um.

Por que a nota fica em transmitindo

Falha técnica do Sistema Nacional (timeout, instabilidade) não volta como erro para você. A nota continua transmitindo enquanto a Sudrel recupera: antes de qualquer reenvio, consulta se a DPS já virou nota, então a mesma DPS nunca gera duas notas. Se a recuperação não conseguir em 7 dias, ou se não houver como consultar a DPS (por exemplo, nota emitida pelo sistema da prefeitura), a nota vai para falha_transmissao.