Descargar el XML o el PDF de un DTE


Tool ID	`notta.dte.descargar`
Nombre MCP	`notta__dte__descargar`
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

Para consumo programático (REST/SDK). En conversación prefiere notta.dte.reenviar: el base64 de un PDF es inmanejable en chat. Un documento recién emitido todavía no está firmado: hasta que lo esté, la descarga falla de forma reintentable.

Entrada

Campo	Tipo	Requerido	Descripción
`id`	string	sí	El id del documento en Notta: el que devolvió notta.dte.emitir, o el de una fila de notta.dte.listar.
`formato`	`"xml"` · `"pdf"`	sí	'xml' entrega el XML firmado que se le envió al SII y 'pdf' su representación impresa. Los dos existen recién cuando el documento está firmado.

JSON Schema de entrada

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "minLength": 1,
      "description": "El id del documento en Notta: el que devolvió notta.dte.emitir, o el de una fila de notta.dte.listar."
    },
    "formato": {
      "type": "string",
      "enum": [
        "xml",
        "pdf"
      ],
      "description": "'xml' entrega el XML firmado que se le envió al SII y 'pdf' su representación impresa. Los dos existen recién cuando el documento está firmado."
    }
  },
  "required": [
    "id",
    "formato"
  ]
}

Salida

Campo	Tipo	Requerido	Descripción
`contenido_base64`	string	sí	El archivo completo, codificado en base64. Decodifícalo antes de guardarlo. En una conversación prefiere notta.dte.reenviar: el base64 de un PDF es inmanejable en un chat.
`content_type`	string	sí	El tipo MIME que Notta declaró para el archivo: application/xml o application/pdf.

JSON Schema de salida

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "contenido_base64": {
      "type": "string",
      "description": "El archivo completo, codificado en base64. Decodifícalo antes de guardarlo. En una conversación prefiere notta.dte.reenviar: el base64 de un PDF es inmanejable en un chat."
    },
    "content_type": {
      "type": "string",
      "description": "El tipo MIME que Notta declaró para el archivo: application/xml o application/pdf."
    }
  },
  "required": [
    "contenido_base64",
    "content_type"
  ],
  "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. El candado es por conexión y se suelta solo.
`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.

Descargar el XML o el PDF de un DTE

Qué hace

Entrada

Salida

Errores de esta tool

On this page