Status da SEFAZ para a DC-e
GET /v1/subscriptions/{subscriptionId}/taxpayers/{taxpayerId}/sefaz/dce-status?environment=2
Pergunta à SEFAZ-PR se o serviço de autorização da DC-e está em operação no ambiente pedido. Use antes de emitir — ou antes de um lote grande — para saber se uma falha de transmissão é sua ou do autorizador.
environment é obrigatório e usa os mesmos valores do corpo da emissão: 1 produção, 2 homologação. Pergunte pelo ambiente em que a empresa emite.
A SEFAZ exige certificado digital em toda consulta, e esta usa o certificado da empresa da URL ({taxpayerId}). Por isso a rota leva a empresa, e confere que ela é da assinatura antes de consultar.
A resposta
{
"environment": 2,
"online": true,
"cStat": 107,
"message": "Servico em Operacao",
"checkedAt": "2026-10-23T14:05:11.482Z"
}
| Campo | O que é |
|---|---|
environment | O ambiente consultado: 1 produção, 2 homologação |
online | true só quando a SEFAZ respondeu cStat 107 (serviço em operação) |
cStat | O código de status que a SEFAZ respondeu |
message | O motivo (xMotivo) que a SEFAZ respondeu, em português, como veio |
checkedAt | O instante em que a SEFAZ foi de fato consultada |
A resposta da SEFAZ fica guardada por até 5 minutos por ambiente. Uma resposta em cache mantém o checkedAt original — é por ele que você sabe a idade da informação.
online: false é uma resposta da SEFAZ, não uma falha de comunicaçãoonline: false só aparece quando a SEFAZ respondeu com um cStat diferente de 107. Quando não deu para perguntar — SEFAZ fora do alcance, certificado indisponível —, a resposta é um erro (503 ou 422, abaixo), nunca online: false.
Erros
| Código | O que significa |
|---|---|
400 | environment ausente, fora de 1 e 2, ou não alcançável a partir deste serviço |
401 | Token ausente, inválido ou expirado — peça um novo token (veja Autenticação) |
403 | A assinatura da URL não é a do token nem uma que o usuário acessa (type termina em subscription-scope-undetermined) |
404 | Empresa da URL inexistente ou fora da assinatura (type termina em company-not-in-subscription) |
422 | A empresa não tem certificado que sirva para autenticar na SEFAZ — cadastre ou renove o certificado da empresa |
503 | A SEFAZ não pôde ser alcançada ou respondeu com falha, o certificado da empresa está momentaneamente indisponível, ou a titularidade da empresa não pôde ser verificada agora. Tente de novo |
Os parâmetros e o formato completo estão na referência da operação.