Atendimento

Status da SEFAZ

Consulte se o web service da SEFAZ de uma UF está em operação.

GET /api/v1/status-servico consulta o status do web service de autorização da SEFAZ de uma UF (NfeStatusServico). É um dado público: não exige token nem X-Emitente-Id.

curl -s "https://api.u2dnotafiscal.com.br/api/v1/status-servico?uf=SP&modelo=NFCE"
QueryObrigatórioValoresPadrão
ufsimsigla maiúscula (SP, RS...)—
modelonãoNFE, NFCENFE
ambientenãoHOMOLOGACAO, PRODUCAOHOMOLOGACAO

Resposta

200 com uf, modelo, ambiente, cStat, xMotivo, emOperacao (cStat 107), tempoMedioSegundos, dataHoraRecebimento, dataHoraRetorno, observacao e consultadoEm. Campos ausentes vêm null.

  • SEFAZ fora de operação (ex.: cStat 108 ou 109) também é 200, com emOperacao: false.
  • O resultado fica em cache por 60 segundos por UF, modelo e ambiente, para não gerar consumo indevido na SEFAZ (cStat 656). consultadoEm mostra quando a SEFAZ foi de fato consultada.

Erros

StatusQuando
400Parâmetro ausente ou inválido
502 sefaz-indisponivelFalha de comunicação ou timeout com a SEFAZ
503 certificado-indisponivelCertificado da plataforma indisponível

A rota tem rate limit por IP (veja Rate limit). Para emitir, você não precisa consultá-la: a emissão já trata SEFAZ lenta ou fora do ar (na NFC-e, com contingência offline).

Nesta página