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"| Query | Obrigatório | Valores | Padrão |
|---|---|---|---|
uf | sim | sigla maiúscula (SP, RS...) | — |
modelo | não | NFE, NFCE | NFE |
ambiente | não | HOMOLOGACAO, PRODUCAO | HOMOLOGACAO |
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.:
cStat108 ou 109) também é200, comemOperacao: false. - O resultado fica em cache por 60 segundos por UF, modelo e ambiente, para não gerar consumo indevido na SEFAZ
(
cStat656).consultadoEmmostra quando a SEFAZ foi de fato consultada.
Erros
| Status | Quando |
|---|---|
400 | Parâmetro ausente ou inválido |
502 sefaz-indisponivel | Falha de comunicação ou timeout com a SEFAZ |
503 certificado-indisponivel | Certificado 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).