Estados de la NFS-e

Los 7 status de una 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 no aparece en el diagrama: es la nota fiscal que volvió sin éxito y se descartó en el panel, o la línea válida de un lote que dejaste fuera en POST /v1/lotes/{id}/emissao.

Status	Qué significa	Qué hacer	¿Final?	Webhook
transmitindo	En la cola, enviándose o recuperándose de una falla técnica del Sistema Nacional.	Esperar. No emitas de nuevo.	No	Ninguno al entrar. NFSE_PROCESSAMENTO_PROLONGADO a los 30 minutos, una vez, como aviso.
autorizada	NFS-e emitida. numero y chave_acesso completos.	Descargar PDF y XML.	Sí (solo puede pasar a cancelada)	NFSE_AUTORIZADA
rejeitada	El Sistema Nacional la rechazó. Motivo en rejeicao.	Corregir y emitir una nota fiscal nueva, con otra referencia. En lote, POST /v1/lotes/{id}/reprocessamento.	Sí, por la API	NFSE_REJEITADA
cancelada	Cancelada después de autorizada. Protocolo en cancelamento. Si fue por sustitución, substituida_por indica qué nota fiscal la sustituyó.	Nada.	Sí	NFSE_CANCELADA
falha_transmissao	La transmisión no se pudo concluir ni confirmar, y no se intentará nada más automáticamente. Revisa falha.dps_enviada.	Con "nao": emitir de nuevo es seguro. Con "desconhecido": verificar antes en el Emissor Nacional.	Sí	NFSE_FALHA_TRANSMISSAO
aguardando_confirmacao	El período de competencia de la nota fiscal terminó antes de un reintento automático. No se transmite nada hasta que decidas.	POST /v1/nfse/{id}/confirmacao, manteniendo o cambiando el período de competencia.	No	NFSE_AGUARDANDO_CONFIRMACAO
descartada	Descartada en el panel, o línea válida de lote que no fue elegida.	Nada.	Sí	Ninguno

No existe el status substituida: la nota fiscal sustituida queda cancelada, con substituida_por.

La línea de tiempo de cada nota fiscal está en eventos, en el GET /v1/nfse/{id}: criada, cada envio, consulta_dps, correcao_automatica, recuperada y los demás pasos, con la hora de cada uno.

Por qué la nota fiscal queda en transmitindo

Una falla técnica del Sistema Nacional (timeout, inestabilidad) no vuelve como error para ti. La nota fiscal sigue en transmitindo mientras Sudrel la recupera: antes de cualquier reenvío, consulta si la DPS ya se convirtió en nota fiscal, así que la misma DPS nunca genera dos notas fiscales. Si la recuperación no lo logra en 7 días, o si no hay forma de consultar la DPS (por ejemplo, nota fiscal emitida por el sistema de la alcaldía), la nota fiscal pasa a falha_transmissao.