Consultar certificados de cotizaciones de Previred

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

Tool IDprevired.certificados.consultar
Nombre MCPprevired__certificados__consultar
Conectorprevired
Planoaction
Lee el alcancecertificados (debe estar habilitado en la conexión)
Scope (permiso)previred:read
Authnone
Versión2
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. Lee los certificados oficiales de cotizaciones ya emitidos para esta conexión, uno por trabajador. Es el documento que Previred firma y que una persona pide para probar lo que se le cotizó: 'certificadoDisponible' dice si el PDF ya está guardado y 'previred.certificado.descargar' entrega el enlace. Hay un certificado VIGENTE por trabajador, que cada sincronización reemplaza, y cubre la ventana máxima que Previred admite terminando en el período sincronizado; 'periodoDesde' y 'periodoHasta' dicen cuál es. Si lo que buscas son los montos y no el documento, 'previred.cotizaciones.consultar' los tiene sin descargar nada. Lectura pura: NO contacta a Previred ni dispara una sincronización. Si el período nunca se sincronizó devuelve una lista vacía, que NO significa que no haya datos en Previred. Para traer datos nuevos, usa 'previred.conexion.sincronizar' primero. Pagina con 'cursor': cuando la respuesta trae 'cursor' distinto de null hay más filas, reenvía ese valor tal cual; nunca lo construyas a mano.

Entrada

CampoTipoRequeridoDescripción
rutTrabajadorstring ^\d{1,8}-[\dkK]$noFiltra por UN trabajador. El RUT va sin puntos y con guion antes del dígito verificador: se guarda cifrado y el filtro corre sobre un índice ciego, así que solo calza escrito exactamente en esa forma.
cursorstringnoContinúa desde donde quedó la página anterior: reenvía tal cual el 'cursor' que vino en la respuesta. Es opaco, así que nunca lo construyas a mano. Sin él, la consulta empieza por el principio.
limitentero 1-500no · default 100Cuántas filas traer como máximo, entre 1 y 500. Si se omite, 100.
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": "Filtra por UN trabajador. El RUT va sin puntos y con guion antes del dígito verificador: se guarda cifrado y el filtro corre sobre un índice ciego, así que solo calza escrito exactamente en esa forma."
    },
    "cursor": {
      "description": "Continúa desde donde quedó la página anterior: reenvía tal cual el 'cursor' que vino en la respuesta. Es opaco, así que nunca lo construyas a mano. Sin él, la consulta empieza por el principio.",
      "type": "string"
    },
    "limit": {
      "default": 100,
      "description": "Cuántas filas traer como máximo, entre 1 y 500. Si se omite, 100.",
      "type": "integer",
      "minimum": 1,
      "maximum": 500
    }
  }
}

Ejemplo

curl
curl -X POST https://connect.emisso.ai/api/v1/tools/previred.certificados.consultar/execute \
  -H "Authorization: Bearer connect_sk_…" \
  -H "X-Connect-Connection: conn_9tKfR2mQx4Vb" \
  -H "Content-Type: application/json" \
  -d '{"input":{"rutTrabajador":"12345678-5"}}'
MCP · meta-tool execute
{
  "tool": "previred.certificados.consultar",
  "params": {
    "rutTrabajador": "12345678-5"
  },
  "connectionId": "conn_9tKfR2mQx4Vb"
}

Salida esperada (200):

{
  "data": {
    "certificados": [
      {
        "rutTrabajador": "12345678-5",
        "nombreTrabajador": "PEREZ SOTO JUAN ANDRES",
        "periodoDesde": "2023-07",
        "periodoHasta": "2026-06",
        "bytes": 25147,
        "certificadoDisponible": true,
        "certificadoUrl": null,
        "syncedAt": "2026-08-11T14:02:11.000Z"
      }
    ],
    "cursor": null
  },
  "meta": {
    "request_id": "req_…",
    "tool_id": "previred.certificados.consultar",
    "plane": "action",
    "latency_ms": 24,
    "audit_status": "recorded"
  }
}

El RUT se guarda cifrado y el filtro corre sobre un índice ciego: mándalo sin puntos y con guion.

Salida

CampoTipoRequeridoDescripción
certificadoslista de objetosíLos certificados guardados: hay uno vigente por trabajador, y cada sincronización lo reemplaza por uno más nuevo en vez de acumular uno por mes.
certificados[].rutTrabajadorstringsíEl RUT del trabajador al que pertenece el certificado, sin puntos y con guion.
certificados[].nombreTrabajadorstringnullsí
certificados[].periodoDesdestringsíPrimer mes que cubre el certificado, en formato AAAA-MM. No lo elige quien llama: el conector usa la ventana más ancha que Previred admite, terminando en el período que se sincronizó.
certificados[].periodoHastastringsíÚltimo mes que cubre el certificado, en formato AAAA-MM: el período que se sincronizó.
certificados[].bytesenterosíTamaño del PDF en bytes.
certificados[].certificadoDisponiblebooleanosítrue cuando el PDF del certificado ya está guardado en Emisso: pídelo con 'previred.certificado.descargar' y el RUT del trabajador. false cuando todavía no se ha emitido.
certificados[].certificadoUrlstringnullsí
certificados[].syncedAtstringsíCuándo se guardó esta fila en Emisso (ISO 8601). Dice qué tan fresca está la caché: si la última sincronización es vieja, lo que falta puede existir en Previred y todavía no haberse traído.
cursorstringnullsí
JSON Schema de salida
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "certificados": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "rutTrabajador": {
            "type": "string",
            "description": "El RUT del trabajador al que pertenece el certificado, sin puntos y con guion."
          },
          "nombreTrabajador": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "El nombre del trabajador según Previred, o null si el portal no lo trajo."
          },
          "periodoDesde": {
            "type": "string",
            "description": "Primer mes que cubre el certificado, en formato AAAA-MM. No lo elige quien llama: el conector usa la ventana más ancha que Previred admite, terminando en el período que se sincronizó."
          },
          "periodoHasta": {
            "type": "string",
            "description": "Último mes que cubre el certificado, en formato AAAA-MM: el período que se sincronizó."
          },
          "bytes": {
            "type": "integer",
            "minimum": -9007199254740991,
            "maximum": 9007199254740991,
            "description": "Tamaño del PDF en bytes."
          },
          "certificadoDisponible": {
            "type": "boolean",
            "description": "true cuando el PDF del certificado ya está guardado en Emisso: pídelo con 'previred.certificado.descargar' y el RUT del trabajador. false cuando todavía no se ha emitido."
          },
          "certificadoUrl": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "deprecated": true,
            "description": "Se retira el 2026-10-14. Usa 'certificadoDisponible' para saber si el documento existe y pide el enlace con 'previred.certificado.descargar' solo cuando lo necesites. Enlace firmado de vida corta para descargar el PDF del certificado, o null si todavía no se ha emitido. Caduca a los pocos minutos y no sirve para compartir."
          },
          "syncedAt": {
            "type": "string",
            "description": "Cuándo se guardó esta fila en Emisso (ISO 8601). Dice qué tan fresca está la caché: si la última sincronización es vieja, lo que falta puede existir en Previred y todavía no haberse traído."
          }
        },
        "required": [
          "rutTrabajador",
          "nombreTrabajador",
          "periodoDesde",
          "periodoHasta",
          "bytes",
          "certificadoDisponible",
          "certificadoUrl",
          "syncedAt"
        ],
        "additionalProperties": false
      },
      "description": "Los certificados guardados: hay uno vigente por trabajador, y cada sincronización lo reemplaza por uno más nuevo en vez de acumular uno por mes."
    },
    "cursor": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Cuando no es null quedan más filas: reenvíalo tal cual en 'cursor' para pedir la página siguiente. En null significa que esta fue la última."
    }
  },
  "required": [
    "certificados",
    "cursor"
  ],
  "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