# Latest Transactions

Este método se conecta a la cuenta especificada por el usuario en Banco Santander - Office Banking y retorna las transacciones más recientes con el límite determinado por el banco (también conocido como "Últimos movimientos").

El uso del campo CallbackUrl desencadenará un proceso asíncrono y los datos resultantes se enviarán más tarde al webhook especificado. Esta es la forma preferida de interactuar con nuestros servicios, ya que asegura que se harán todos los esfuerzos para extraer los datos y cumplir  con su solicitud dentro de un plazo razonable. Si desea la respuesta de inmediato, omita el campo CallbackUrl pero tenga en cuenta que puede provocar tiempos de espera dependiendo del tamaño del resultado de los datos y las condiciones de la red.

Endpoint: POST /v1/cl/banking/business/santander.cl/transactions
Version: v1.0
Security: JWT, Api-Key

## Request fields (application/json):

  - `RequestData` (object, required)
    Información necesaria para conectarse a la cuenta del usuario en el sitio web y extraer datos. Los campos obligatorios indican los valores necesarios para identificar la cuenta deseada.

  - `RequestData.AccountNumber` (string, required)
    Número de cuenta bancaria.
    Example: "11887755"

  - `RequestData.BookingDateStart` (string, required)
    Fecha de inicio en formato ISO 8601 (YYYY-MM) utilizada para obtener las transacciones.
    Example: "2022-07"

  - `RequestData.BookingDateEnd` (string, required)
    Fecha final en formato ISO 8601 (YYYY-MM) utilizada para obtener las transacciones.
    Example: "2022-07"

  - `RequestData.Currency` (string)
    Identificación de la moneda en la que se mantiene la cuenta. Utilización: La moneda sólo debe utilizarse en caso de que sea necesaria para identificar la cuenta.
    Example: "CLP"

  - `RequestData.AccountCredential` (any)
    Atención: El uso de este campo es obligatorio cuando se utiliza autenticación por Api Key.

  - `CallbackUrl` (string)
    URL para enviar el mensaje de respuesta utilizando un método POST.
    Example: "https://my-api.my-business.com/api/open-data-response"

## Response 200 fields (application/json):

  - `OperationId` (string, required)
    Identificador único de la operación.
    Example: "6baf6c19-e485-463b-ae24-a821b025c8a4"

  - `Status` (string, required)
    Estado de la operación. OK significa que el servicio se ha ejecutado correctamente aunque no devuelva datos. ERROR indica que ha ocurrido algo que ha impedido la finalización con éxito del proceso.
    Enum: "OK", "ERROR"

  - `Data` (object,null, required)
    Contenedor de transacciones.

  - `Data.Transaction` (array, required)
    Proporciona más detalles sobre las transacciones. Puede ser un arreglo vacío.

  - `Data.Transaction.AccountId` (string, required)
    Identificador único e inmutable utilizado para identificar el recurso de la cuenta.
    Example: "873458"

  - `Data.Transaction.BookingDateTime` (string, required)
    Fecha y hora en que se contabiliza una transacción de una cuenta en los libros del administrador de cuentas (también conocido como 'Fecha contable'). Utilización: La fecha de contabilización es la fecha de contabilización prevista, a menos que el estado sea 'Booked', en cuyo caso es la fecha de contabilización real.
    Example: "2017-07-22T00:00:00-0400"

  - `Data.Transaction.CreditDebitIndicator` (string, required)
    Indica si la transacción es una entrada de crédito o de débito.
    Enum: "Credit", "Debit"

  - `Data.Transaction.Status` (string, required)
    Estado de la transacción en los libros del administrador de cuentas.
    Enum: "Booked", "Pending", "Rejected"

  - `Data.Transaction.TransactionId` (string, required)
    Identificador único de la transacción. Este identificador es único para la consulta actual.
    Example: "c830d0c9a0904ea6badbaf8e25ff6e87"

  - `Data.Transaction.Amount` (object, required)
    Cantidad de dinero de la transacción.

  - `Data.Transaction.Amount.Amount` (number, required)
    Número de unidades monetarias especificadas en una moneda activa en la que la unidad monetaria es explícita y conforme con la norma ISO 4217.
    Example: 10000

  - `Data.Transaction.Amount.Currency` (string, required)
    Código asignado a una moneda por una Agencia de Mantenimiento con arreglo a un sistema de identificación internacional, tal como se describe en la última edición de la norma internacional ISO 4217 'Códigos para la representación de monedas y fondos'.
    Example: "CLP"

  - `Data.Transaction.AddressLine` (string)
    Información que localiza e identifica una dirección específica para una transacción, que se presenta en texto de formato libre.
    Example: "SUCURSAL SANTIAGO CENTRO"

  - `Data.Transaction.TransactionInformation` (string)
    Mayor información de la transacción. Se trata de la glosa de la transacción, que es un texto no estructurado.
    Example: "PAGO DE CUENTAS"

  - `Data.Transaction.TransactionReference` (string)
    Referencia única para la transacción. Este identificador es único e inmutable dentro de los registros del banco si es informado.
    Example: "09cce92d-494b-4f29-8584-6a0409a052c7"

  - `Data.Transaction.ValueDateTime` (string)
    Fecha y hora en la que la transacción fue cursada (también conocido como 'Fecha transaccional').
    Example: "2017-07-21T17:32:28-0400"

  - `Data.Transaction.Balance` (object)
    Conjunto de elementos utilizados para definir el saldo como representación numérica de los aumentos y disminuciones netos de una cuenta después de que se le aplique una transacción.

  - `Data.Transaction.Balance.CreditDebitIndicator` (string, required)
    Indica si el balance es crédito o débito.
    Enum: "Credit", "Debit"

  - `Data.Transaction.Balance.Amount` (object, required)
    Cantidad de dinero reportado después de aplicar a la cuenta una transacción.

  - `Data.Transaction.DebtorAccount` (object)
    Identificación inequívoca de la cuenta del deudor, en el caso de una operación de crédito.

  - `Data.Transaction.DebtorAccount.Name` (string)
    El nombre de la cuenta es el nombre o nombres del propietario o propietarios de la cuenta representados a nivel de cuenta. Tenga en cuenta que el nombre de la cuenta no es el nombre del producto ni el apodo de la cuenta.
    Example: "JOHN DOE"

  - `Data.Transaction.DebtorAccount.OwnerIdentification` (string)
    Número de identificación personal del titular de la cuenta (ej. RUT, RUN, DNI, CUIT).
    Example: "11111111K"

  - `Data.Transaction.SupplementaryData` (object)
    Información adicional que no puede capturarse en los campos estructurados y/o cualquier otro bloque específico.

  - `AdditionalInformation` (string,null, required)
    Este campo puede utilizarse para mostrar información relevante específica de la respuesta, por ejemplo indicando que el campo Data está incompleto.

  - `Error` (object,null, required)
    Objeto con los detalles del error, utilizado cuando Status=ERROR. Si Status=OK este campo será nulo. Puede leer una explicación completa de este objeto visitando [este enlace](https://docs.khipu.com/portal/en/errors/)

  - `Error.Code` (string)
    Código interno del sistema que identifica el error.
    Example: "E201"

  - `Error.Type` (string)
    Indica cómo tratar este código de error específico, en función del tipo de error.
    Enum: "RETRY_IMMEDIATELY", "DO_NOT_RETRY", "WAIT_4_HOURS_BEFORE_RETRY", "RETRY_AFTER_NOTIFICATION"

  - `Error.Description` (string)
    Descripción asociada al código de error.
    Example: "El servicio destino utilizado para la extracción de datos no se encuentra disponible."

  - `LifeSpan` (string,null, required)
    null en peticiones sincrónicas.

## Response 202 fields (application/json):

  - `OperationId` (string, required)
    Identificador único de la operación.
    Example: "6baf6c19-e485-463b-ae24-a821b025c8a4"

  - `Status` (string, required)
    Estado de la operación. Al realizar solicitudes asíncronas, siempre devolverá OK.
    Example: "OK"

  - `Data` (object, required)
    null en solicitudes asíncronas.

  - `AdditionalInformation` (string, required)
    Mensaje de la operación, puede usarse para mostrar información adicional.
    Example: "Data will be sent to the callback URL."

  - `Error` (object, required)
    null en solicitudes asíncronas.

  - `LifeSpan` (string, required)
    Fecha máxima estimada de entrega para solicitudes asíncronas, en formato de fecha y hora ISO 8601, zona horaria UTC.
    Example: "2017-07-22T00:00:00-0400"


## Response 400 fields

## Response 401 fields

## Response 404 fields

## Response 500 fields