Simulador de fallos

Solo con la clave sdr_test_. Envía el encabezado X-Sudrel-Simular en POST /v1/nfse (o el campo simular en cada ítem de POST /v1/lotes). La nota fiscal simulada pasa por los MISMOS estados, eventos, webhooks y línea de tiempo de una nota fiscal real, pero nunca va a la Sefin, ni al entorno de pruebas: quien responde es Sudrel. No consume la numeración de la empresa (la DPS sale en la serie 49998), la clave de acceso empieza con siete ceros, el PDF sale con la marca SIMULAÇÃO (SIMULACIÓN) y el recurso trae simulacao con el escenario. Con la clave de producción, la solicitud de simulación es 422 simulacao_so_no_sandbox.

Los plazos reales se aceleran en las notas fiscales simuladas: los 10 minutos hasta que la recuperación consulta la DPS pasan a 5 segundos, los 30 minutos del aviso de procesamiento prolongado pasan a 20 segundos, y los 7 días hasta falha_transmissao pasan a 1 minuto.

Escenario	Qué ves
autorizada_lenta	Con la espera predeterminada (10 s), 202 con transmitindo; autorizada en unos 15 s. Webhook NFSE_AUTORIZADA.
rejeicao:<codigo>	422 con la nota fiscal rejeitada, rejeicao.codigo_oficial igual al código pedido y rejeicao.explicacao cuando está en el catálogo (ej.: rejeicao:E0240). Webhook NFSE_REJEITADA.
timeout_depois_autorizada	202 con transmitindo. La transmisión "se cae", la recuperación consulta la DPS, encuentra la nota fiscal y queda autorizada, UNA sola, sin reenviar. Línea de tiempo: envio (error técnico), consulta_dps (encontrada), recuperada. Webhook NFSE_AUTORIZADA.
sefin_fora	202 con transmitindo, y sigue en transmitindo mientras la "Sefin está caída". La consulta de la DPS indica que no llegó, la nota fiscal se reenvía y se autoriza (envio, consulta_dps, reenfileirada, envio). La API no tiene un status "programada": la espera aparece como transmitindo.
processamento_prolongado	202. Después de unos 20 s la nota fiscal recibe aviso: { codigo: "processamento_prolongado" } y sale el webhook NFSE_PROCESSAMENTO_PROLONGADO, una vez; sigue en transmitindo y después se autoriza.
falha_transmissao_nao_enviada	422 con falha_transmissao y falha.dps_enviada: "nao": la nota fiscal se detuvo antes del envío. Webhook NFSE_FALHA_TRANSMISSAO.
falha_transmissao_desconhecido	202. El aviso de procesamiento prolongado a los 20 s y, cerca de 1 minuto después, falha_transmissao con falha.dps_enviada: "desconhecido": el caso en que hay que verificar en el Emissor Nacional antes de emitir de nuevo. Webhook NFSE_FALHA_TRANSMISSAO.
aguardando_confirmacao	202 con aguardando_confirmacao y el webhook NFSE_AGUARDANDO_CONFIRMACAO. Al confirmarla en POST /v1/nfse/{id}/confirmacao, la nota fiscal se autoriza.