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.


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.

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

Campo	Tipo	Requerido	Descripción
`folio`	string	sí	El folio de la planilla, tal como lo trae 'previred.planillas.consultar'.

JSON Schema de entrada

{
  "$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"
  ]
}

Ejemplo

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"}}'

SDK TypeScript

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

MCP · meta-tool execute

{
  "tool": "previred.comprobante.descargar",
  "params": {
    "folio": "2055260600000004"
  },
  "connectionId": "conn_9tKfR2mQx4Vb"
}

Salida esperada (200):

{
  "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

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.

JSON Schema de salida

{
  "$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
}

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.