Descargar el comprobante de una planilla de Previred

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

Tool IDprevired.comprobante.descargar
Nombre MCPprevired__comprobante__descargar
Conectorprevired
Planoaction
Lee el alcanceplanillas (debe estar habilitado en la conexión)
Scope (permiso)previred:read
Authnone
Versión1
Sensiblesí
Deprecadono
ComportamientoreadOnly=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.

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

CampoTipoRequeridoDescripción
foliostringsí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"}}'
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

CampoTipoRequeridoDescripción
foliostringsíEl folio de la planilla, igual al que se pidió.
urlstringsíEnlace firmado de vida corta para bajar el documento. No sirve para compartir: el documento trae datos personales de los trabajadores.
venceEnstringsí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ódigoHTTPReintentableQué hacer
connection_disabled403noReactívala en /connections o usa otra conexión del mismo sistema.
connection_not_found404noUsa uno de los connectionId que lista el error, o revisa la conexión en /connections. No hace falta reactivar nada.
alcance_not_enabled403noHabilita 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

En esta página