# Enlace al PDF de un documento

> Devuelve un enlace temporal a la representación impresa (PDF) de un documento emitido.



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

|                     |                                                                   |
| ------------------- | ----------------------------------------------------------------- |
| **Tool ID**         | `notta.dte.enlace_pdf`                                            |
| **Nombre MCP**      | `notta__dte__enlace_pdf`                                          |
| **Conector**        | `notta`                                                           |
| **Plano**           | `action`                                                          |
| **Scope (permiso)** | `notta:read`                                                      |
| **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]

El enlace sirve el archivo sin sesión ni credencial y vence a los 15 minutos, así que se entrega apenas se recibe y no se guarda. Un documento recién emitido todavía no está firmado, y hasta entonces el PDF no existe.

## Entrada [#entrada]

| Campo | Tipo                                                                                                       | Requerido                            | Descripción                              |    |                                                                                                                                                              |
| ----- | ---------------------------------------------------------------------------------------------------------- | ------------------------------------ | ---------------------------------------- | -- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `id`  | string \`^(\[0-9a-fA-F]{8}-\[0-9a-fA-F]{4}-\[1-8]\[0-9a-fA-F]{3}-\[89abAB]\[0-9a-fA-F]{3}-\[0-9a-fA-F]{12} | 00000000-0000-0000-0000-000000000000 | ffffffff-ffff-ffff-ffff-ffffffffffff)$\` | sí | Identificador del documento dentro de Notta, un UUID. Es el que reciben las demas tools de este sistema para pedir el detalle, el PDF, el XML o los eventos. |

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

  ```json
  {
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "type": "object",
    "properties": {
      "id": {
        "type": "string",
        "format": "uuid",
        "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
        "description": "Identificador del documento dentro de Notta, un UUID. Es el que reciben las demas tools de este sistema para pedir el detalle, el PDF, el XML o los eventos."
      }
    },
    "required": [
      "id"
    ]
  }
  ```
</details>

## Salida [#salida]

| Campo        | Tipo   | Requerido | Descripción                                                                                                                                                            |
| ------------ | ------ | --------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `url`        | string | sí        | Enlace-capacidad de un solo documento (`https://app.notta.cl/d/\<token>`). Sirve el PDF SIN sesión ni Bearer: el token es la credencial. Vence a los 15 minutos (D12). |
| `expires_at` | string | sí        | Vencimiento del enlace, ISO 8601.                                                                                                                                      |

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

  ```json
  {
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "type": "object",
    "properties": {
      "url": {
        "type": "string",
        "description": "Enlace-capacidad de un solo documento (`https://app.notta.cl/d/<token>`). Sirve el PDF SIN sesión ni Bearer: el token es la credencial. Vence a los 15 minutos (D12)."
      },
      "expires_at": {
        "type": "string",
        "description": "Vencimiento del enlace, ISO 8601."
      }
    },
    "required": [
      "url",
      "expires_at"
    ],
    "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).