Consultar cotizaciones por trabajador de Previred

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "periodo": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}$",
      "description": "Filtra por un mes, en formato AAAA-MM. Sin él, la consulta trae todas las filas guardadas de esta conexión."
    },
    "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": {
    "cotizaciones": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "rutTrabajador": {
            "type": "string",
            "description": "El RUT del trabajador, sin puntos y con guion."
          },
          "nombreTrabajador": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "El nombre del trabajador tal como lo informa el comprobante, o null si no venía."
          },
          "periodo": {
            "type": "string",
            "description": "El mes de remuneraciones al que corresponde la cotización, en formato AAAA-MM. No es el mes en que se pagó: eso lo dice la fecha de pago de su planilla, que cae al mes siguiente."
          },
          "institucion": {
            "type": "string",
            "description": "La institución previsional, con el nombre que le da Previred (la AFP, Fonasa o la isapre, el seguro de cesantía, la mutual, la caja de compensación)."
          },
          "tipoInstitucion": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "La familia de la institución, que es el eje por el que Previred agrupa y filtra (por ejemplo 'AFP' o 'MUTUAL'). null cuando el portal no la informó."
          },
          "rentaImponible": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "La renta imponible sobre la que se calculó ESTA cotización, en pesos. Un mismo trabajador y mes tienen una renta imponible distinta por institución, cada una con su propio tope: no las sumes ni las trates como el sueldo. null cuando el comprobante no traía el dato."
          },
          "montoCotizacion": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Lo cotizado a esa institución en el período, en pesos. null cuando el comprobante no traía el dato."
          },
          "diasTrabajados": {
            "anyOf": [
              {
                "type": "integer",
                "minimum": -9007199254740991,
                "maximum": 9007199254740991
              },
              {
                "type": "null"
              }
            ],
            "description": "Días trabajados informados en el período. Solo algunas instituciones los declaran (lo hace el Seguro Social y las demás no), así que en la mayoría de las filas viene null: eso es lo que dice el comprobante, no un hueco."
          },
          "folio": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "El folio de la planilla que incluye esta cotización: el puente hacia previred.planillas.consultar. null cuando no se pudo determinar."
          }
        },
        "required": [
          "rutTrabajador",
          "nombreTrabajador",
          "periodo",
          "institucion",
          "tipoInstitucion",
          "rentaImponible",
          "montoCotizacion",
          "diasTrabajados",
          "folio"
        ],
        "additionalProperties": false
      },
      "description": "Las cotizaciones guardadas. Un mismo trabajador y mes traen varias filas, una por institución."
    },
    "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": [
    "cotizaciones",
    "cursor"
  ],
  "additionalProperties": false
}