Enlace al PDF de un documento

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


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.

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

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)$`

JSON Schema de entrada

{
  "$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"
  ]
}

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.

JSON Schema de salida

{
  "$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
}

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.

Enlace al PDF de un documento

Qué hace

Entrada

Salida

Errores de esta tool

On this page