Baixar a DACE (PDF)
GET/v1/subscriptions/:subscriptionId/taxpayers/:taxpayerId/contentdeclarations/:id/pdf
Baixa a DACE em PDF, o documento auxiliar da DC-e.
Por padrão a resposta é um redirecionamento (302) para uma URL temporária, válida por
5 minutos: use-a para baixar na hora, não a guarde nem a repasse.
A maioria dos clientes HTTP segue o redirecionamento sozinha; se o seu não segue, leia o
cabeçalho Location — ou peça ?format=uri, que devolve a mesma URL temporária em JSON
(200, corpo { "uri": "…" }), como as APIs irmãs da plataforma.
Dois layouts: full (completo, o padrão) e summary (resumido).
📌 Para saber se a DACE já existe sem tentar o download, leia artifacts.hasFull e
artifacts.hasSummary em GET {id}. Documento autorizado nem sempre tem DACE na mesma
hora — a geração é um passo próprio, depois da autorização.
Em homologação a DACE sai com a tarja "EMITIDO EM HOMOLOGAÇÃO — SEM VALOR FISCAL".
Request
Responses
- 200
- 302
- 400
- 401
- 403
- 404
Com format=uri: a URL temporária do PDF, em JSON.
Sem format (ou format=redirect): redirecionamento para a URL temporária do PDF.
Response Headers
URL pré-assinada, válida por 5 minutos.
format com valor diferente de redirect e uri.
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.
Contribuinte fora da assinatura (type …/company-not-in-subscription), documento
inexistente, ou DACE ainda não gerada. Enquanto a DC-e não é autorizada não existe
artefato para baixar — consulte artifacts em GET {id} antes de tentar.