Sudrel API
Painel Criar chave de API

Documentação › Testes

Guias

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.