Consultar certificados de cotizaciones de Previred

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

{
  "$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."
          },
          "certificadoUrl": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "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 Connect (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",
          "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
}