Consultar transferencias de Banco Security

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "periodo": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}$",
      "description": "Un mes, en formato AAAA-MM y en calendario chileno (por ejemplo '2026-07'). Cada sitio de uso afina qué significa ahí: en una sincronización es el mes que se va a traer, y en una consulta a la caché es el filtro. Esta descripción base existe para que el campo nunca llegue pelado a quien lee el contrato."
    },
    "direccion": {
      "description": "Filtra por dirección: 'enviadas' son las que la empresa cursó y 'recibidas' las que le llegaron. Omítelo para traer las dos juntas; el campo 'direction' de cada fila las distingue.",
      "type": "string",
      "enum": [
        "enviadas",
        "recibidas"
      ]
    },
    "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
    }
  }
}

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "transferencias": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "sourceTransferId": {
            "type": "string",
            "description": "Identificador estable de la transferencia dentro de Connect, compuesto por la dirección y el número de transacción (por ejemplo 'issued:39262015878491'). Sirve para reconocer la misma transferencia entre dos lecturas; el banco no lo muestra."
          },
          "direction": {
            "type": "string",
            "enum": [
              "issued",
              "received"
            ],
            "description": "'issued' es una transferencia que la empresa envió y 'received' una que recibió. Es el campo que las distingue cuando consultas sin filtrar por 'direccion'."
          },
          "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."
          },
          "numeroTransaccion": {
            "type": "string",
            "description": "El número de transacción que emite el banco. Viene como texto a propósito: tiene unos 14 dígitos y no cabe en un entero de 32 bits. Trátalo como identificador y no lo conviertas a número."
          },
          "transferredAt": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Cuándo se cursó la transferencia (ISO 8601). null si el banco no trajo la fecha."
          },
          "currency": {
            "type": "string",
            "description": "Moneda de la transferencia, en código ISO ('CLP' o 'USD')."
          },
          "statusCode": {
            "anyOf": [
              {
                "type": "integer",
                "minimum": -9007199254740991,
                "maximum": 9007199254740991
              },
              {
                "type": "null"
              }
            ],
            "description": "El código de estado que el banco asigna a la transferencia, tal cual, sin traducir. Solo viene en las enviadas ('issued'); en las recibidas es null."
          },
          "transferType": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Tipo de transferencia en el texto del propio banco (por ejemplo 'Transferencia a terceros'). null cuando no lo informa."
          },
          "nominaNumber": {
            "anyOf": [
              {
                "type": "integer",
                "minimum": -9007199254740991,
                "maximum": 9007199254740991
              },
              {
                "type": "null"
              }
            ],
            "description": "Número de la nómina de pago masiva de la que salió esta transferencia. null significa que no vino de una nómina."
          },
          "ownRut": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "RUT del lado propio de la operación: el de origen si la empresa envió la transferencia, el de destino si la recibió."
          },
          "ownAccount": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Número de la cuenta propia en esta transferencia: la de origen si la empresa la envió, la de destino si la recibió."
          },
          "monto": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Magnitud de la transferencia SIN signo. El sentido lo da 'type' y el signo visible lo trae 'display'. Un null significa que el banco no trajo la celda, que no es lo mismo que cero."
          },
          "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'."
          },
          "subject": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "El asunto con que se cursó la transferencia, tal como lo escribió quien la hizo (por ejemplo 'Pago factura 10452')."
          },
          "counterpartyRut": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "RUT de la contraparte: el destinatario si la transferencia salió, el emisor si entró."
          },
          "counterpartyName": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Nombre de la contraparte, tal como lo informa el banco."
          },
          "counterpartyBank": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Banco de la contraparte, en el texto del portal (por ejemplo 'Banco de Chile')."
          },
          "counterpartyAccount": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Número de cuenta de la contraparte."
          },
          "counterpartyEmail": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Correo al que el banco avisó la transferencia a la contraparte, cuando lo hay."
          },
          "creatorRut": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "RUT de quien creó la transferencia en el portal. Solo viene en las enviadas ('issued'); en las recibidas es null."
          },
          "approverRut": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "RUT de quien la aprobó en el portal. Solo viene en las enviadas ('issued'); en las recibidas es null."
          },
          "payerRut": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "RUT que el banco registra como pagador de la transferencia. Solo viene en las enviadas ('issued'); en las recibidas es null."
          },
          "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": [
          "sourceTransferId",
          "direction",
          "periodo",
          "numeroTransaccion",
          "transferredAt",
          "currency",
          "statusCode",
          "transferType",
          "nominaNumber",
          "ownRut",
          "ownAccount",
          "monto",
          "type",
          "display",
          "subject",
          "counterpartyRut",
          "counterpartyName",
          "counterpartyBank",
          "counterpartyAccount",
          "counterpartyEmail",
          "creatorRut",
          "approverRut",
          "payerRut",
          "ultimaLecturaEn"
        ],
        "additionalProperties": false
      },
      "description": "Las transferencias guardadas que calzan con los filtros, de la más reciente a la más antigua. Una lista vacía significa que ese período no se ha sincronizado, no que no haya transferencias."
    },
    "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": [
    "transferencias",
    "cursor"
  ],
  "additionalProperties": false
}