# Descargar el PDF de una factura, guía o nota

> Descarga el PDF oficial de una factura 33 o 34, guía de despacho 52 o nota 56 o 61 emitida con el Facturador Gratuito del SII, por REST, MCP o SDK.



`sii.dte.descargar` entrega el PDF oficial de un documento que la empresa de la conexión emitió con el
Facturador Gratuito del SII: el mismo que muestra el portal en **Documentos emitidos**, con su timbre. Sirve
para lo emitido por Connect y para lo emitido directo en el portal. No emite ni guarda nada: Connect busca el
documento, baja el PDF y te lo entrega.

Pide el tipo, el folio y la fecha de emisión. La empresa la fija la conexión, no un parámetro:

```bash
curl -X POST https://connect.emisso.ai/api/v1/tools/sii.dte.descargar/execute \
  -H "Authorization: Bearer connect_sk_…" \
  -H "X-Connect-Connection: conn_9tKfR2mQx4Vb" \
  -H "Content-Type: application/json" \
  -d '{"input": {"tipoDte": "52", "folio": "18", "fechaEmision": "2026-10-06"}}'
```

Salida esperada (`200`, campo `data`, recortada):

```json
{
  "tipoDte": "52",
  "folio": "18",
  "nombreArchivo": "dte52_folio18.pdf",
  "contentType": "application/pdf",
  "byteLength": 220136,
  "sha256": "<64 caracteres hexadecimales>",
  "contenidoBase64": "JVBERi0xLjQK…"
}
```

Decodifica `contenidoBase64` y guárdalo con `nombreArchivo`. `sha256` sirve para comprobar que los bytes
llegaron enteros. Por MCP es una herramienta de lectura: va por `execute`.

| Campo          | Qué va                                                                                                          |
| -------------- | --------------------------------------------------------------------------------------------------------------- |
| `tipoDte`      | `"33"` factura, `"34"` factura exenta, `"52"` guía de despacho, `"56"` nota de débito o `"61"` nota de crédito. |
| `folio`        | Folio del documento, en texto y sin ceros a la izquierda. Es el que devuelve `sii.dte.emitir`.                  |
| `fechaEmision` | Fecha de emisión, AAAA-MM-DD, la misma que devuelve `sii.dte.emitir`.                                           |

Requiere la conexión de representante con el permiso `sii:write`, la misma con que se emite. Para una boleta
39 o 41 se usa [`sii.boleta.descargar`](/docs/emitir/boletas#3-descarga-el-pdf).

## Errores frecuentes [#errores-frecuentes]

| Código y detalle                                                       | Cuándo                                                                                                                                                 | Qué hacer                              |
| ---------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------- |
| `upstream_unexpected_response` · `sii_dte_pdf_documento_no_encontrado` | El documento no está entre los emitidos de la empresa en el Facturador Gratuito: el tipo, el folio o la fecha no calzan, o se emitió con otro sistema. | Revisa tipo, folio y fecha de emisión. |
| `upstream_unexpected_response` · `sii_dte_pdf_documento_no_emitido`    | El documento está en el portal pero no llegó a emitirse, por ejemplo quedó en vista previa.                                                            | No tiene PDF de emisión.               |
| `upstream_error`                                                       | El portal no respondió o entregó algo que no es el PDF.                                                                                                | Intenta de nuevo en unos minutos.      |

La referencia completa del contrato está en [`sii.dte.descargar`](/docs/referencia/sii/dte-descargar).