# 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.



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

|                     |                                                                    |
| ------------------- | ------------------------------------------------------------------ |
| **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`](../conexiones/estado-consultar).

## Qué hace [#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 [#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. |

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

  ```json
  {
    "$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"
    ]
  }
  ```
</details>

## Ejemplo [#ejemplo]

```bash title="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"}}'
```

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

```json title="MCP · meta-tool execute"
{
  "tool": "previred.certificado.descargar",
  "params": {
    "rutTrabajador": "12345678-5"
  },
  "connectionId": "conn_9tKfR2mQx4Vb"
}
```

**Salida esperada (200):**

```json
{
  "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 [#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.                              |

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

  ```json
  {
    "$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
  }
  ```
</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.             |
| `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](../errores).

## Próximos pasos [#próximos-pasos]

* [`previred.conexion.sincronizar`](./conexion-sincronizar): la tool que escribe los datos que esta lectura devuelve.
* [Sincronizar y consultar](/docs/conceptos/sincronizar-consultar): por qué leer datos reales son dos pasos.