Descargar el certificado de cotizaciones de un trabajador

Entrega un enlace firmado de vida corta al PDF del certificado de cotizaciones vigente de UN trabajador, identificado por su RUT.


Tool ID	`previred.certificado.descargar`
Nombre MCP	`previred__certificado__descargar`
Conector	`previred`
Plano	`action`
Lee el alcance	`certificados` (debe estar habilitado en la conexión)
Scope (permiso)	`previred:read`
Auth	`none`
Versión	`1`
Sensible	sí
Deprecado	no
Comportamiento	readOnly=true, destructive=false, idempotent=true, openWorld=false

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

Los datos de cada certificado vienen en 'previred.certificados.consultar', y su campo 'certificadoDisponible' dice si está guardado. Si la conexión no tiene ese documento, o todavía no se ha descargado, responde 'previred_documento_not_found'.

Entrada

Campo	Tipo	Requerido	Descripción
`rutTrabajador`	string `^\d{1,8}-[\dkK]$`	sí	El RUT del trabajador, sin puntos y con guion antes del dígito verificador.

JSON Schema de entrada

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "rutTrabajador": {
      "type": "string",
      "pattern": "^\\d{1,8}-[\\dkK]$",
      "description": "El RUT del trabajador, sin puntos y con guion antes del dígito verificador."
    }
  },
  "required": [
    "rutTrabajador"
  ]
}

Ejemplo

curl

curl -X POST https://connect.emisso.ai/api/v1/tools/previred.certificado.descargar/execute \
  -H "Authorization: Bearer connect_sk_…" \
  -H "X-Connect-Connection: conn_9tKfR2mQx4Vb" \
  -H "Content-Type: application/json" \
  -d '{"input":{"rutTrabajador":"12345678-5"}}'

SDK TypeScript

const data = await connect.tools.previred.certificado.descargar({ rutTrabajador: "12345678-5" }, { connectionId: "conn_9tKfR2mQx4Vb" });

MCP · meta-tool execute

{
  "tool": "previred.certificado.descargar",
  "params": {
    "rutTrabajador": "12345678-5"
  },
  "connectionId": "conn_9tKfR2mQx4Vb"
}

Salida esperada (200):

{
  "data": {
    "rutTrabajador": "12345678-5",
    "periodoDesde": "2023-07",
    "periodoHasta": "2026-06",
    "url": "https://connect.emisso.ai/storage/v1/object/sign/comprobantes/previred-certificados/...",
    "venceEn": "2026-10-07T19:05:00.000Z"
  },
  "meta": {
    "request_id": "req_…",
    "tool_id": "previred.certificado.descargar",
    "plane": "action",
    "latency_ms": 24,
    "audit_status": "recorded"
  }
}

El enlace caduca a los cinco minutos: pídelo justo antes de abrirlo.

Salida

Campo	Tipo	Requerido	Descripción
`rutTrabajador`	string	sí	El RUT del trabajador, igual al que se pidió.
`periodoDesde`	string	sí	Primer mes que cubre el certificado, en formato AAAA-MM.
`periodoHasta`	string	sí	Último mes que cubre el certificado, en formato AAAA-MM.
`url`	string	sí	Enlace firmado de vida corta para bajar el documento. No sirve para compartir: el documento trae datos personales de los trabajadores.
`venceEn`	string	sí	Cuándo caduca el enlace (ISO 8601, UTC). Son pocos minutos: pídelo justo antes de usarlo y no lo guardes.

JSON Schema de salida

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "rutTrabajador": {
      "type": "string",
      "description": "El RUT del trabajador, igual al que se pidió."
    },
    "periodoDesde": {
      "type": "string",
      "description": "Primer mes que cubre el certificado, en formato AAAA-MM."
    },
    "periodoHasta": {
      "type": "string",
      "description": "Último mes que cubre el certificado, en formato AAAA-MM."
    },
    "url": {
      "type": "string",
      "description": "Enlace firmado de vida corta para bajar el documento. No sirve para compartir: el documento trae datos personales de los trabajadores."
    },
    "venceEn": {
      "type": "string",
      "description": "Cuándo caduca el enlace (ISO 8601, UTC). Son pocos minutos: pídelo justo antes de usarlo y no lo guardes."
    }
  },
  "required": [
    "rutTrabajador",
    "periodoDesde",
    "periodoHasta",
    "url",
    "venceEn"
  ],
  "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.
`alcance_not_enabled`	403	no	Habilita el alcance en /connections o quítalo del input de la sincronización.

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.

Próximos pasos

previred.conexion.sincronizar: la tool que escribe los datos que esta lectura devuelve.
Sincronizar y consultar: por qué leer datos reales son dos pasos.