Descargar el certificado de cotizaciones de un trabajador
Antes de pedir datos nuevos, consulta atenciones en conexiones.estado.consultar.
| 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-Connectionen REST y campoconnectionIden elexecutede MCP. No hay resolución implícita, ni siquiera con una sola conexión activa: la conexión es la empresa. El id sale deconexiones.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 PDF del certificado de cotizaciones vigente de UN trabajador, identificado por su RUT. 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
| 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. |
JSON Schema de entrada
{
"$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"
]
}Ejemplo
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"}}'{
"tool": "previred.certificado.descargar",
"params": {
"rutTrabajador": "12345678-5"
},
"connectionId": "conn_9tKfR2mQx4Vb"
}Salida esperada (200):
{
"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
| 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. |
JSON Schema de salida
{
"$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
}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.
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.