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

> Descarga desde el Facturador Gratuito del SII el PDF oficial de un documento emitido por la empresa de la conexión: factura 33 o 34, guía de despacho 52 o nota 56 o 61, por tipo, folio y fecha de emisión.



{/* AUTO-GENERATED by @emisso/codegen. DO NOT EDIT. */}

|                     |                                                                   |
| ------------------- | ----------------------------------------------------------------- |
| **Tool ID**         | `sii.dte.descargar`                                               |
| **Nombre MCP**      | `sii__dte__descargar`                                             |
| **Conector**        | `sii`                                                             |
| **Plano**           | `action`                                                          |
| **Scope (permiso)** | `sii:write`                                                       |
| **Auth**            | `connection_credentials`                                          |
| **Versión**         | `1`                                                               |
| **Sensible**        | sí                                                                |
| **Deprecado**       | no                                                                |
| **Comportamiento**  | readOnly=true, destructive=false, idempotent=true, openWorld=true |

> **Requiere conexión.** Indica cuál en cada llamada: header `X-Connect-Connection` en REST, campo `connectionId` en el `execute` de MCP y en las opciones del SDK. No hay resolución implícita, ni siquiera con una sola conexión activa: la conexión es la empresa. El id sale de [`conexiones.estado.consultar`](../conexiones/estado-consultar).

## Qué hace [#qué-hace]

Lo devuelve en base64 con su SHA-256. Sirve para documentos emitidos por Connect o directo en el portal; no emite ni guarda nada. Requiere la conexión de representante con el permiso sii:write.

## Entrada [#entrada]

| Campo          | Tipo                                       | Requerido | Descripción                                                                                                     |
| -------------- | ------------------------------------------ | --------- | --------------------------------------------------------------------------------------------------------------- |
| `tipoDte`      | `"33"` · `"34"` · `"52"` · `"56"` · `"61"` | sí        | Tipo del documento: 33 factura, 34 factura exenta, 52 guía de despacho, 56 nota de débito o 61 nota de crédito. |
| `folio`        | string `^[1-9][0-9]{0,17}$`                | sí        | Folio del documento, en texto y sin ceros a la izquierda.                                                       |
| `fechaEmision` | string                                     | sí        | Fecha de emisión del documento, AAAA-MM-DD, como la muestra el SII.                                             |

<details>
  <summary>
    JSON Schema de entrada
  </summary>

  ```json
  {
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "type": "object",
    "properties": {
      "tipoDte": {
        "type": "string",
        "enum": [
          "33",
          "34",
          "52",
          "56",
          "61"
        ],
        "description": "Tipo del documento: 33 factura, 34 factura exenta, 52 guía de despacho, 56 nota de débito o 61 nota de crédito."
      },
      "folio": {
        "type": "string",
        "pattern": "^[1-9][0-9]{0,17}$",
        "description": "Folio del documento, en texto y sin ceros a la izquierda."
      },
      "fechaEmision": {
        "type": "string",
        "x-emisso-formato": "AAAA-MM-DD",
        "description": "Fecha de emisión del documento, AAAA-MM-DD, como la muestra el SII."
      }
    },
    "required": [
      "tipoDte",
      "folio",
      "fechaEmision"
    ],
    "additionalProperties": false
  }
  ```
</details>

## Salida [#salida]

| Campo             | Tipo                                       | Requerido | Descripción                                                                                                     |
| ----------------- | ------------------------------------------ | --------- | --------------------------------------------------------------------------------------------------------------- |
| `tipoDte`         | `"33"` · `"34"` · `"52"` · `"56"` · `"61"` | sí        | Tipo del documento: 33 factura, 34 factura exenta, 52 guía de despacho, 56 nota de débito o 61 nota de crédito. |
| `folio`           | string `^[1-9][0-9]{0,17}$`                | sí        | Folio del documento, en texto y sin ceros a la izquierda.                                                       |
| `nombreArchivo`   | string                                     | sí        | Nombre sugerido para guardar el archivo, como «dte52\_folio18.pdf».                                             |
| `contentType`     | string                                     | sí        | Tipo de contenido del archivo.                                                                                  |
| `byteLength`      | entero                                     | sí        | Tamaño del PDF en bytes.                                                                                        |
| `sha256`          | string `^[0-9a-f]{64}$`                    | sí        | SHA-256 del PDF en hexadecimal, para verificar los bytes decodificados.                                         |
| `contenidoBase64` | string                                     | sí        | El PDF en base64. Es el documento oficial que muestra el Facturador Gratuito.                                   |

<details>
  <summary>
    JSON Schema de salida
  </summary>

  ```json
  {
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "type": "object",
    "properties": {
      "tipoDte": {
        "type": "string",
        "enum": [
          "33",
          "34",
          "52",
          "56",
          "61"
        ],
        "description": "Tipo del documento: 33 factura, 34 factura exenta, 52 guía de despacho, 56 nota de débito o 61 nota de crédito."
      },
      "folio": {
        "type": "string",
        "pattern": "^[1-9][0-9]{0,17}$",
        "description": "Folio del documento, en texto y sin ceros a la izquierda."
      },
      "nombreArchivo": {
        "type": "string",
        "minLength": 1,
        "maxLength": 64,
        "description": "Nombre sugerido para guardar el archivo, como «dte52_folio18.pdf»."
      },
      "contentType": {
        "type": "string",
        "const": "application/pdf",
        "description": "Tipo de contenido del archivo."
      },
      "byteLength": {
        "type": "integer",
        "exclusiveMinimum": 0,
        "maximum": 3145728,
        "description": "Tamaño del PDF en bytes."
      },
      "sha256": {
        "type": "string",
        "pattern": "^[0-9a-f]{64}$",
        "description": "SHA-256 del PDF en hexadecimal, para verificar los bytes decodificados."
      },
      "contenidoBase64": {
        "type": "string",
        "minLength": 1,
        "description": "El PDF en base64. Es el documento oficial que muestra el Facturador Gratuito."
      }
    },
    "required": [
      "tipoDte",
      "folio",
      "nombreArchivo",
      "contentType",
      "byteLength",
      "sha256",
      "contenidoBase64"
    ],
    "additionalProperties": false
  }
  ```
</details>

## Errores de esta tool [#errores-de-esta-tool]

| Código                           | HTTP | Reintentable | Qué hacer                                                                                                                                                                                |
| -------------------------------- | ---- | ------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `connection_disabled`            | 403  | no           | Reactívala en /connections o usa otra conexión del mismo sistema.                                                                                                                        |
| `connection_credential_required` | 428  | no           | Crea un enlace con conexiones.enlace.crear (modo reconectar si la conexión ya existe) y pide a la persona que entregue la credencial de nuevo. No reintentes con la credencial anterior. |
| `connection_busy`                | 409  | sí           | Espera unos segundos y reintenta. Es una espera transitoria: no necesitas volver a conectar ni ingresar la credencial otra vez.                                                          |
| `upstream_error`                 | 502  | sí           | Reintenta más tarde. Si persiste, el problema está en el sistema externo, no en tu integración.                                                                                          |
| `timeout`                        | 504  | sí           | Reintenta. Para sincronizaciones largas usa la vía asíncrona y consulta el estado del trabajo.                                                                                           |

Toda llamada puede devolver además los códigos transversales (`validation_error`, `unauthorized`, `scope_not_granted`, `rate_limited`, entre otros): el detalle vive en el [catálogo de errores](../errores).