Consultar uma DC-e
GET/v1/subscriptions/:subscriptionId/taxpayers/:taxpayerId/contentdeclarations/:id
Devolve o estado atual de uma DC-e.
Traz situação, chave de acesso, protocolo, numeração, emitente, destinatário, valor total, os itens declarados e quais artefatos já podem ser baixados.
| Situação | Onde ler o motivo |
|---|---|
Refused — parou por veredito nosso (cadastro, certificado, validação local) | refusedStep e refusedReasons |
Rejected — recusado pela SEFAZ | rejectionCStat e rejectionReason (o xMotivo) |
| cancelamento respondido pela SEFAZ | cancellationCStat e, na recusa, cancellationReason |
📌 artifacts diz se a DACE e o XML já existem — consulte-o antes de chamar /pdf ou
/xml, em vez de tentar e receber 404.
⚠️ Os endereços de emitente e destinatário não estão nesta resposta. Guarde o corpo que você enviou, ou baixe o XML autorizado, se precisar deles.
Concorrência
O cabeçalho ETag da resposta traz a versão do documento (W/"<versão>"). É esse valor
que vai no If-Match do cancelamento.
Request
Responses
- 200
- 401
- 403
- 404
Documento encontrado.
Response Headers
A versão atual do documento, como ETag fraca (W/"<versão>"). Envie-a de volta no
If-Match do cancelamento para que ele seja recusado com 412 se o documento mudar
no meio.
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.
Documento inexistente ou fora da assinatura e do contribuinte da URL — ou contribuinte
inexistente ou de outra assinatura, com type …/company-not-in-subscription.