Documentação › Testes
Simulador de falhas
Provoque timeout, rejeição, Sefin fora e falha de transmissão com a chave de teste.
Só com a chave sdr_test_. Mande o cabeçalho X-Sudrel-Simular em
POST /v1/nfse (ou o campo simular em cada item de POST /v1/lotes).
A nota simulada passa pelos MESMOS estados, eventos, webhooks e linha do
tempo de uma nota real, mas nunca vai à Sefin, nem ao ambiente de
testes: quem responde é a Sudrel. Ela não consome a numeração da
empresa (a DPS sai na série 49998), a chave de acesso começa com sete
zeros, o PDF sai com a marca SIMULAÇÃO e o recurso traz simulacao
com o cenário. Com a chave de produção, o pedido de simulação é 422
simulacao_so_no_sandbox.
Os prazos reais andam acelerados nas notas simuladas: os 10 minutos até
a recuperação perguntar pela DPS viram 5 segundos, os 30 minutos do
aviso de processamento prolongado viram 20 segundos, e os 7 dias até
falha_transmissao viram 1 minuto.
| Cenário | O que você vê |
|---|---|
autorizada_lenta |
Com a espera padrão (10 s), 202 com transmitindo; autorizada em cerca de 15 s. Webhook NFSE_AUTORIZADA. |
rejeicao:<codigo> |
422 com a nota rejeitada, rejeicao.codigo_oficial igual ao código pedido e rejeicao.explicacao quando ele está no catálogo (ex.: rejeicao:E0240). Webhook NFSE_REJEITADA. |
timeout_depois_autorizada |
202 com transmitindo. A transmissão "cai", a recuperação consulta a DPS, acha a nota e ela fica autorizada, UMA só, sem reenviar. Linha do tempo: envio (erro técnico), consulta_dps (encontrada), recuperada. Webhook NFSE_AUTORIZADA. |
sefin_fora |
202 com transmitindo, e continua transmitindo enquanto a "Sefin está fora". A consulta da DPS diz que ela não chegou, a nota é reenviada e autorizada (envio, consulta_dps, reenfileirada, envio). A API não tem um status "agendada": a espera aparece como transmitindo. |
processamento_prolongado |
202. Depois de cerca de 20 s a nota ganha aviso: { codigo: "processamento_prolongado" } e sai o webhook NFSE_PROCESSAMENTO_PROLONGADO, uma vez; ela segue transmitindo e depois é autorizada. |
falha_transmissao_nao_enviada |
422 com falha_transmissao e falha.dps_enviada: "nao": a nota parou antes do envio. Webhook NFSE_FALHA_TRANSMISSAO. |
falha_transmissao_desconhecido |
202. O aviso de processamento prolongado aos 20 s e, cerca de 1 minuto depois, falha_transmissao com falha.dps_enviada: "desconhecido": o caso em que é preciso conferir no Emissor Nacional antes de emitir de novo. Webhook NFSE_FALHA_TRANSMISSAO. |
aguardando_confirmacao |
202 com aguardando_confirmacao e o webhook NFSE_AGUARDANDO_CONFIRMACAO. Confirmada em POST /v1/nfse/{id}/confirmacao, a nota é autorizada. |