# Descargar el comprobante de una planilla de Previred

> Entrega un enlace firmado de vida corta al comprobante de pago en PDF de UNA planilla ya sincronizada, identificada por su folio.



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

|                     |                                                                    |
| ------------------- | ------------------------------------------------------------------ |
| **Tool ID**         | `previred.comprobante.descargar`                                   |
| **Nombre MCP**      | `previred__comprobante__descargar`                                 |
| **Conector**        | `previred`                                                         |
| **Plano**           | `action`                                                           |
| **Lee el alcance**  | `planillas` (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]

Úsala solo cuando necesites el documento: los datos de la planilla ya vienen en 'previred.planillas.consultar', y su campo 'comprobanteDisponible' dice si hay PDF. 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                                                               |
| ------- | ------ | --------- | ------------------------------------------------------------------------- |
| `folio` | string | sí        | El folio de la planilla, tal como lo trae 'previred.planillas.consultar'. |

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

  ```json
  {
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "type": "object",
    "properties": {
      "folio": {
        "type": "string",
        "minLength": 1,
        "description": "El folio de la planilla, tal como lo trae 'previred.planillas.consultar'."
      }
    },
    "required": [
      "folio"
    ]
  }
  ```
</details>

## Ejemplo [#ejemplo]

```bash title="curl"
curl -X POST https://connect.emisso.ai/api/v1/tools/previred.comprobante.descargar/execute \
  -H "Authorization: Bearer connect_sk_…" \
  -H "X-Connect-Connection: conn_9tKfR2mQx4Vb" \
  -H "Content-Type: application/json" \
  -d '{"input":{"folio":"2055260600000004"}}'
```

```ts title="SDK TypeScript"
const data = await connect.tools.previred.comprobante.descargar({ folio: "2055260600000004" }, { connectionId: "conn_9tKfR2mQx4Vb" });
```

```json title="MCP · meta-tool execute"
{
  "tool": "previred.comprobante.descargar",
  "params": {
    "folio": "2055260600000004"
  },
  "connectionId": "conn_9tKfR2mQx4Vb"
}
```

**Salida esperada (200):**

```json
{
  "data": {
    "folio": "2055260600000004",
    "url": "https://connect.emisso.ai/storage/v1/object/sign/comprobantes/previred/...",
    "venceEn": "2026-10-07T19:05:00.000Z"
  },
  "meta": {
    "request_id": "req_…",
    "tool_id": "previred.comprobante.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                                                                                                                            |
| --------- | ------ | --------- | -------------------------------------------------------------------------------------------------------------------------------------- |
| `folio`   | string | sí        | El folio de la planilla, igual al que se pidió.                                                                                        |
| `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": {
      "folio": {
        "type": "string",
        "description": "El folio de la planilla, igual al que se pidió."
      },
      "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": [
      "folio",
      "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.