# Descargar el comprobante de una planilla de Previred

> Antes de pedir datos nuevos, consulta atenciones en conexiones.estado.consultar.



{/* 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 y campo `connectionId` en el `execute` de MCP. 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`](/docs/referencia/conexiones/estado-consultar).

## Qué hace [#qué-hace]

Si sincronizarSirve es false, sigue hacer: las indicaciones para pedir datos nuevos que siguen no aplican hasta resolver esa atención. La consulta de datos ya guardados sigue disponible según el plan. Entrega un enlace firmado de vida corta al comprobante de pago en PDF de UNA planilla ya sincronizada, identificada por su folio. Ú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"}}'
```

```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.                                                   |
| `connection_not_found` | 404  | no           | Usa uno de los connectionId que lista el error, o revisa la conexión en /connections. No hace falta reactivar nada. |
| `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](/docs/referencia/errores).

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

* [`previred.conexion.sincronizar`](/docs/referencia/previred/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.


---

Esta página es parte de la documentación de Emisso. El índice completo, con cada página y su descripción, está en https://connect.emisso.ai/llms.txt. Esta misma página en HTML: https://connect.emisso.ai/docs/referencia/previred/comprobante-descargar.
