# Booked Range Transactions / Card Purchases

This method connects to the user's specified account in  and returns the  booked transactions for purchases made with the specified credit card registered in the  statements issued by the bank within the specified date range (also known as "Movimientos facturados").

Using the  field will trigger an asynchronous process and the resulting data will be sent later to the specified webhook. This is the preferred way to interact with our services, as it assures that all efforts will be made to extract the data to fulfill  your request within a reasonable time frame. If you want the response immediately, skip the field  but bear in mind that it can result in timeouts depending on the data's result size and the network conditions.

Endpoint: POST /v1/cl/banking/personal/itau.cl/booked/range/transactions/card-purchases
Version: v1.0
Security: JWT, Api-Key

## Request fields (application/json):

  - `RequestData` (object, required)
    Information needed to connect to the user's bank account and extract data. Mandatory fields indicates values that are necessary to identify the desired account.

  - `RequestData.LastDigits` (string, required)
    A four-digit number used to identify the card which corresponds to the last four digits of the card number.
    Example: "9999"

  - `RequestData.BookingDateStart` (string, required)
    Start date used for fetch the transactions, in ISO 8601 format (yyyy-mm)
    Example: "2022-07"

  - `RequestData.BookingDateEnd` (string, required)
    Start date used for fetch the transactions, in ISO 8601 format (yyyy-mm)
    Example: "2022-07"

  - `RequestData.AccountCredential` (any)
    Attention: The use of this field is mandatory when using Api Key authentication.

  - `CallbackUrl` (string)
    URL to send the response message using a POST verb.
    Example: "https://my-api.my-business.com/api/open-data-response"

## Response 200 fields (application/json):

  - `OperationId` (string, required)
    Unique identifier of the operation.
    Example: "6baf6c19-e485-463b-ae24-a821b025c8a4"

  - `Status` (string, required)
    Operation status.  means that the service was executed successfully even if it does not return Data.  indicates that something happened that prevented the successful completion of the process.
    Enum: "OK", "ERROR"

  - `Data` (object,null, required)
    Container for Card Purchase. Can be an empty array.

  - `Data.CardInstrument` (object, required)
    Provides further details of the card instrument.

  - `Data.CardInstrument.Identification` (string, required)
    A four-digit number used to identify the card which corresponds to the last four digits of the card number.
    Example: "9999"

  - `Data.CardInstrument.Type` (string, required)
    Description that identifies the card type in the way the bank service calls it.
    Example: "Mastercard Black"

  - `Data.CardInstrument.Status` (string)
    Status of the card.
    Enum: "Active", "Inactive"

  - `Data.CardInstrument.Cardholder` (object)
    Provides further details of the cardholder.

  - `Data.CardInstrument.Cardholder.Identification` (string)
    A unique and immutable identifier used to identify the cardholder (RUT, DNI).
    Example: "11.111.111-1"

  - `Data.CardInstrument.Cardholder.Name` (string)
    Description that identifies the cardholder.
    Example: "Joe Bloggs"

  - `Data.Statement` (array)
    Provides further details on a statement resource.

  - `Data.Statement.MainCardId` (string, required)
    A four-digit number used to identify the card which corresponds to the last four digits of the card number.
    Example: "9999"

  - `Data.Statement.CreationDateTime` (string, required)
    Date and time at which the resource was created.
    Example: "2017-07-21T17:32:28-0400"

  - `Data.Statement.EndDateTime` (string, required)
    Date and time at which the statement period ends.
    Example: "2017-06-30T23:59:59-0400"

  - `Data.Statement.ExpirationDateTime` (string, required)
    Date and time at which the invoice payment expires.
    Example: "2017-06-01T00:00:00-0400"

  - `Data.Statement.Type` (string, required)
    Statement type, in a coded form.
    Enum: "AccountClosure", "AccountOpening", "Annual", "Interim", "RegularPeriodic"

  - `Data.Statement.StartDateTime` (string)
    Date and time at which the statement period starts.
    Example: "2017-06-01T00:00:00-0400"

  - `Data.Statement.InvoicedAmountLCY` (object)
    Amount invoiced in local currency.

  - `Data.Statement.InvoicedAmountLCY.Amount` (number, required)
    A number of monetary units specified in an active currency where the unit of currency is explicit and compliant with ISO 4217.
    Example: 10000

  - `Data.Statement.InvoicedAmountLCY.Currency` (string, required)
    A code allocated to a currency by a Maintenance Agency under an international identification scheme, as described in the latest edition of the international standard ISO 4217 "Codes for the representation of currencies and funds".
    Example: "CLP"

  - `Data.Statement.InvoicedAmountFCY` (object)
    Amount invoiced in foreign currency.

  - `Data.Statement.MinimumPayment` (object)
    Minimum amount invoiced for payment.

  - `Data.Transaction` (array)
    Provides further details on an entry in the report.

  - `Data.Transaction.BookingDateTime` (string, required)
    Date and time when a transaction entry is posted to an account on the account servicer's books. Usage: Booking date is the expected booking date, unless the status is booked, in which case it is the actual booking date.
    Example: "2017-07-22T00:00:00-0400"

  - `Data.Transaction.CreditDebitIndicator` (string, required)
    Indicates whether the transaction is a credit or a debit entry.
    Enum: "Credit", "Debit"

  - `Data.Transaction.Status` (string, required)
    Status of a transaction entry on the books of the account servicer.
    Enum: "Booked", "Pending", "Rejected"

  - `Data.Transaction.Amount` (object, required)
    Amount of money in the cash transaction entry.

  - `Data.Transaction.OperationCardId` (string)
    A four-digit number used to identify the card that was used for the transaction which corresponds to the last four digits of the card number. This identifier differs from the  identifier when the card that was used for the transaction was an additional card.
    Example: "9999"

  - `Data.Transaction.AddressLine` (string)
    Information that locates and identifies a specific address for a transaction entry, that is presented in free format text.
    Example: "SUCURSAL SANTIAGO CENTRO"

  - `Data.Transaction.Instalment` (object)
    Provides further information of the instalment.

  - `Data.Transaction.Instalment.CurrentInstalmentNumber` (integer, required)
    Number of the current instalment.
    Example: 9

  - `Data.Transaction.Instalment.InstalmentsNumber` (integer, required)
    Total number of instalments.
    Example: 12

  - `Data.Transaction.Instalment.TotalAmount` (object)
    Total amount of the charge which is divided into instalments.

  - `Data.Transaction.Instalment.SupplementaryData` (array)
    Additional information that can not be captured in the structured fields and/or any other specific block.

  - `Data.Transaction.LocalForeignIndicator` (string)
    Indicates whether the transaction is local or foreign.
    Enum: "Local", "Foreign"

  - `Data.Transaction.TransactionInformation` (string)
    Further details of the transaction. This is the transaction narrative, which is unstructured text.
    Example: "PAGO DE CUENTAS"

  - `Data.Transaction.ValueDateTime` (string)
    Date and time at which assets become available to the account owner in case of a credit entry, or cease to be available to the account owner in case of a debit transaction entry. Usage: If transaction entry status is pending and value date is present, then the value date refers to an expected/requested value date. For transaction entries subject to availability/float and for which availability information is provided, the value date must not be used. In this case the availability component identifies the number of availability days.
    Example: "2017-07-21T17:32:28-0400"

  - `AdditionalInformation` (string,null, required)
    This field can be used to display relevant information specific to the response, for instance indicating that the  field is incomplete.

  - `Error` (object,null, required)
    Object with the error details, used when . If  this field will be null. You can read a complete explanation of this object visiting [this link](https://docs.khipu.com/portal/en/errors/)

  - `Error.Code` (string)
    Internal system code that identifies the error.
    Example: "E201"

  - `Error.Type` (string)
    Indicates how to treat this specific error code, based on the type of error.
    Enum: "RETRY_IMMEDIATELY", "DO_NOT_RETRY", "WAIT_4_HOURS_BEFORE_RETRY", "RETRY_AFTER_NOTIFICATION"

  - `Error.Description` (string)
    Description associated with the error code.
    Example: "El servicio destino utilizado para la extracción de datos no se encuentra disponible."

  - `LifeSpan` (string,null, required)
    in sync requests.

## Response 202 fields (application/json):

  - `OperationId` (string, required)
    Unique identifier of the operation.
    Example: "6baf6c19-e485-463b-ae24-a821b025c8a4"

  - `Status` (string, required)
    Operation status. When making async requests it will always return .
    Example: "OK"

  - `Data` (object, required)
    in async requests.

  - `AdditionalInformation` (string, required)
    Operation message, can be used to display additional information.
    Example: "Data will be sent to the callback URL."

  - `Error` (object, required)
    in async requests.

  - `LifeSpan` (string, required)
    Max estimated delivery date for async requests, in ISO 8601 date format, UTC timezone.
    Example: "2017-07-22T00:00:00-0400"