---
title: "DACE e XML da DC-e"
description: "Como baixar a DACE em PDF (completa ou resumida) e o XML autorizado — URLs temporárias, tarja de homologação, e por que o XML é o documento fiscal e o PDF é só representação."
source_url: https://nfe.io/docs/documentacao/declaracao-de-conteudo-eletronica/integracao-api/dace-e-xml
last_updated: 2026-09-04
---

# DACE e XML da DC-e

A DC-e tem dois artefatos de download, cada um com sua própria rota — **não existe campo de URL no corpo da [consulta](./como-consultar-uma-declaracao-de-conteudo.md)**.

## Baixar a DACE (PDF)

```
GET /v2/companies/{companyId}/ContentDeclarations/{id}/pdf?layout=full
```

DACE é o documento auxiliar da DC-e — representação visual, não o documento fiscal em si. Dois layouts:

| `layout` | Conteúdo |
|---|---|
| `full` (padrão) | Completo |
| `summary` | Resumido |

Qualquer valor diferente de `summary` devolve o layout completo.

Em homologação, a DACE sai com a tarja **"EMITIDO EM HOMOLOGAÇÃO — SEM VALOR FISCAL"**.

## Baixar o XML autorizado

```
GET /v2/companies/{companyId}/ContentDeclarations/{id}/xml
```

É o arquivo a guardar para fins fiscais — **o XML é o documento**; o PDF da DACE é só representação.

## Os dois respondem com redirecionamento temporário

```
302 Found
Location: https://<url-pré-assinada>
```

A resposta de ambos os endpoints é um `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`.

:::caution Sem `accessKey`/`documentUrl` no corpo — a única forma de obter o arquivo é por estas rotas
Diferente de outros documentos da NFE.io, a consulta de uma DC-e não traz nenhum campo de URL do PDF ou XML. Chame `GET {id}/pdf` ou `GET {id}/xml` diretamente, usando o `id` que você já tem.
:::

## Antes de a nota ser autorizada

Enquanto a DC-e não é `Authorized`, não existe artefato para baixar — **`404`** em ambas as rotas. Acompanhe o `status` por [consulta](./como-consultar-uma-declaracao-de-conteudo.md) antes de tentar.

## Erros

| Código | O que significa |
|---|---|
| `401` | Token ausente, expirado, com audiência errada, ou chave de API no lugar de JWT |
| `403` | Token válido mas sem o escopo/papel da operação, ou assinatura não determinada |
| `404` | Documento inexistente, **ou** o artefato ainda não foi gerado — a nota não está autorizada |

## Veja também

- [Como consultar uma DC-e](./como-consultar-uma-declaracao-de-conteudo.md)
- [Emitir uma DC-e](./emitir-uma-declaracao-de-conteudo.md)
- [Cancelamento de DC-e](./cancelamento.md)