Consultar o status da SEFAZ para a DC-e
GET/v1/subscriptions/:subscriptionId/taxpayers/:taxpayerId/sefaz/dce-status
Pergunta à SEFAZ se o serviço de autorização da DC-e está em operação, no ambiente pedido.
A consulta é autenticada com o certificado do contribuinte do caminho — por isso a rota
leva o taxpayerId e verifica que ele é da assinatura antes de consultar.
online é true só quando a SEFAZ responde cStat 107 (serviço em operação). A
resposta pode vir de um cache de até 5 minutos por ambiente; checkedAt é o instante em
que a SEFAZ foi de fato consultada.
Request
Responses
- 200
- 400
- 401
- 403
- 404
- 422
- 503
A resposta da SEFAZ.
environment ausente, fora de 1 e 2, ou não alcançável a partir deste serviço.
Token ausente, expirado ou inválido. O token tem validade curta: ao receber 401, peça um
token novo e repita a chamada.
O token autentica, mas a assinatura da URL não é a do token (nem uma a que o usuário tem
acesso). O type é …/subscription-scope-undetermined.
O contribuinte do caminho ({taxpayerId}) não existe ou não pertence à assinatura da URL.
A resposta é a mesma nos dois casos, e vem antes de qualquer coisa do pedido ser lida.
A empresa do caminho não tem certificado que sirva para autenticar na SEFAZ. Cadastre ou renove o certificado da empresa.
Não deu para perguntar: a SEFAZ não foi 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. Falha ao perguntar nunca vira online: false.