Consultar los pagos de una nómina de Banco Security

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "idNomina": {
      "type": "string",
      "minLength": 1,
      "description": "La nómina cuyas líneas de pago quieres leer. Sale del campo 'idNomina' de una cabecera de 'banco_security.nominas.consultar'; no es el 'numeroNomina' que el banco muestra en su listado."
    },
    "cursor": {
      "description": "Puntero opaco a la página siguiente. Reenvía tal cual el 'cursor' que devolvió la llamada anterior; nunca lo construyas a mano. Omítelo para pedir la primera página.",
      "type": "string"
    },
    "limit": {
      "default": 100,
      "description": "Cuántas filas trae la página, entre 1 y 500. Por omisión, 100.",
      "type": "integer",
      "minimum": 1,
      "maximum": 500
    }
  },
  "required": [
    "idNomina"
  ]
}

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "pagos": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "idNomina": {
            "type": "string",
            "description": "El identificador de la nómina a la que pertenece esta línea: el mismo que pediste en la entrada."
          },
          "linea": {
            "type": "integer",
            "minimum": -9007199254740991,
            "maximum": 9007199254740991,
            "description": "Posición de esta línea dentro de la nómina, empezando en 1. Es un ordinal de la nómina completa, no de la página del portal de donde se leyó."
          },
          "tipoCuenta": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Tipo de cuenta del beneficiario según el banco (por ejemplo 'Cuenta Corriente' o 'Cuenta Vista')."
          },
          "estado": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Estado del pago en el texto del propio banco (por ejemplo 'Pagado'). Cuando el banco lo rechazó, el motivo va en 'motivoRechazo'."
          },
          "periodo": {
            "type": "string",
            "description": "El mes (AAAA-MM) con el que se sincronizó esta fila. Es cómo se pidió el dato, no una propiedad del objeto: no entra en su identidad, así que volver a traerlo bajo otro período no crea una fila nueva."
          },
          "rut": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "RUT del beneficiario del pago, tal como lo escribe el banco."
          },
          "nombre": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Nombre del beneficiario del pago."
          },
          "numeroCuenta": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "La cuenta de destino del beneficiario. Esta tool no ofrece filtro por cuenta: la columna va cifrada y un filtro sobre ella devolvería cero filas."
          },
          "banco": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Banco del beneficiario, en el texto del portal."
          },
          "mail": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Correo al que el banco avisó el pago al beneficiario, cuando lo hay."
          },
          "monto": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "El monto de esta línea, como magnitud SIN signo. El sentido lo da 'type', que en un pago de nómina es siempre 'credit' porque la plata sale de la empresa."
          },
          "type": {
            "anyOf": [
              {
                "type": "string",
                "enum": [
                  "credit",
                  "debit"
                ]
              },
              {
                "type": "null"
              }
            ],
            "description": "Eje crédito/débito del LIBRO DEL BANCO, no el de la cartola: 'debit' es plata que ENTRA a la cuenta (un abono) y 'credit' es plata que SALE (un cargo). Es al revés de la lectura intuitiva y está así a propósito. El campo 'monto' es la magnitud SIN signo; el signo lo lleva 'display' ('credit' → negativo). 'null' significa que el banco no informó el tipo: no asumas ninguno de los dos."
          },
          "display": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "El monto ya formateado a la chilena y CON signo, derivado de 'type' ('credit', plata que sale, se muestra negativo). Es una comodidad de presentación: se calcula en la lectura y no se persiste. Para operar con el número usa 'monto' (magnitud sin signo) junto con 'type'."
          },
          "glosa": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "La glosa con que el pago se identifica ante el beneficiario (por ejemplo 'Sueldo julio 2026')."
          },
          "motivoRechazo": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Por qué el banco rechazó este pago, en su propio texto. null cuando no hubo rechazo."
          },
          "ultimaLecturaEn": {
            "type": "string",
            "description": "Cuándo se leyó esta fila del banco (ISO 8601). Si está vieja, la caché puede haber dejado de moverse (por ejemplo, con la conexión pausada tras varios fallos de credencial) mientras esta tool sigue respondiendo con filas antiguas. Entre dos filas del mismo hecho, gana la de 'ultimaLecturaEn' mayor."
          }
        },
        "required": [
          "idNomina",
          "linea",
          "tipoCuenta",
          "estado",
          "periodo",
          "rut",
          "nombre",
          "numeroCuenta",
          "banco",
          "mail",
          "monto",
          "type",
          "display",
          "glosa",
          "motivoRechazo",
          "ultimaLecturaEn"
        ],
        "additionalProperties": false
      },
      "description": "Las líneas de pago de la nómina pedida, en orden ascendente de 'linea'. Una lista vacía significa que esa nómina no se ha sincronizado."
    },
    "cursor": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Puntero a la página siguiente. Si viene distinto de null hay más filas: vuelve a llamar reenviándolo tal cual en 'cursor'. Un null significa que no queda nada por traer."
    }
  },
  "required": [
    "pagos",
    "cursor"
  ],
  "additionalProperties": false
}