# Booked Month Statements (LCY)

This method connects to the user's specified account in  and returns the desired month's booked statements (also known as "Resumen de movimientos cuenta corriente").

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/business/itau.cl/booked/month/LCY/statements
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.AccountNumber` (string, required)
    Bank account number.
    Example: "000011887755"

  - `RequestData.BookingDate` (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 Statements. Can be an empty array.

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

  - `Data.Statement.AccountId` (string, required)
    A unique and immutable identifier used to identify the account resource. This identifier has no meaning to the account owner.
    Example: "873458"

  - `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.StartDateTime` (string, required)
    Date and time at which the statement period starts.
    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.StatementDescription` (array)
    Other descriptions that may be available for the statement resource.
    Example: ["ATRIBUTOS ADICIONALES"]

  - `Data.Statement.StatementId` (string)
    Unique identifier for the statement resource within an servicing institution. This identifier is both unique and immutable.
    Example: "4525f6656f4248a99d289fe8d213557d"

  - `Data.Statement.StatementReference` (string)
    Unique reference for the statement. This reference may be optionally populated if available.
    Example: "a2c557c63450"

  - `Data.Statement.StatementAmount` (array)
    Set of elements used to provide details of a generic amount for the statement resource.

  - `Data.Statement.StatementAmount.CreditDebitIndicator` (string, required)
    Indicates whether the amount is a credit or a debit. Usage: A zero amount is considered to be a credit amount.
    Enum: "Credit", "Debit"

  - `Data.Statement.StatementAmount.Type` (string, required)
    Amount type, in a coded form.
    Example: "ClosingBalance"

  - `Data.Statement.StatementAmount.Amount` (object, required)
    Amount of money associated with the amount type.

  - `Data.Statement.StatementAmount.Amount.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.StatementAmount.Amount.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.StatementBenefit` (array)
    Set of elements used to provide details of a benefit or reward amount for the statement resource.

  - `Data.Statement.StatementBenefit.Type` (string, required)
    Benefit type, in a coded form.
    Example: "Cashback"

  - `Data.Statement.StatementBenefit.Amount` (object, required)
    Amount of money associated with the statement benefit type.

  - `Data.Statement.StatementDateTime` (array)
    Set of elements used to provide details of a generic date time for the statement resource.

  - `Data.Statement.StatementDateTime.DateTime` (string, required)
    Date and time associated with the date time type.
    Example: "2017-07-21T17:32:28-0400"

  - `Data.Statement.StatementDateTime.Type` (string, required)
    Date time type, in a coded form.
    Example: "LastStatement"

  - `Data.Statement.StatementFee` (array)
    Set of elements used to provide details of a fee for the statement resource.

  - `Data.Statement.StatementFee.Type` (string, required)
    Fee type, in a coded form.
    Example: "Monthly"

  - `Data.Statement.StatementFee.Amount` (object, required)
    Amount of money associated with the statement fee type.

  - `Data.Statement.StatementFee.Description` (string)
    Description that may be available for the statement fee.
    Example: "DETALLE DE COMISIONES"

  - `Data.Statement.StatementFee.Frequency` (string)
    How frequently the fee is applied to the Account.
    Enum: "ChargingPeriod", "PerTransactionAmount", "PerTransactionPercentage", "Quarterly", "StatementMonthly", "Weekly"

  - `Data.Statement.StatementFee.Rate` (string)
    Rate charged for Statement Fee (where it is charged in terms of a rate rather than an amount)
    Example: "OTRAS TARIFAS"

  - `Data.Statement.StatementFee.RateType` (string)
    Description that may be available for the statement fee rate type.
    Enum: "AER", "EAR"

  - `Data.Statement.StatementInterest` (array)
    Set of elements used to provide details of a generic interest amount related to the statement resource.

  - `Data.Statement.StatementInterest.Type` (string, required)
    Interest amount type, in a coded form.
    Example: "Total"

  - `Data.Statement.StatementInterest.Amount` (object, required)
    Amount of money associated with the statement interest amount type.

  - `Data.Statement.StatementInterest.Description` (string)
    Description that may be available for the statement interest.
    Example: "DETALLE DE INTERESES"

  - `Data.Statement.StatementInterest.Frequency` (string)
    How frequently the Interest Rate is applied to the Account.
    Enum: "Daily", "HalfYearly", "Monthly", "PerStatementDate", "Quarterly", "Weekly", "Yearly"

  - `Data.Statement.StatementInterest.Rate` (string)
    Rate for Statement Interest (where it is applicable in terms of a rate rather than an amount)
    Example: "OTRAS TARIFAS"

  - `Data.Statement.StatementInterest.RateType` (string)
    Description that may be available for the statement Interest rate type.
    Enum: "BOEBaseRate", "FixedRate", "Gross", "LoanProviderBaseRate", "Net"

  - `Data.Statement.StatementRate` (array)
    Set of elements used to provide details of a generic rate related to the statement resource.

  - `Data.Statement.StatementRate.Rate` (string, required)
    Rate associated with the statement rate type.
    Example: "1000"

  - `Data.Statement.StatementRate.Type` (string, required)
    Statement rate type, in a coded form.
    Example: "MonthlyPurchase"

  - `Data.Statement.StatementValue` (array)
    Set of elements used to provide details of a generic number value related to the statement resource.

  - `Data.Statement.StatementValue.Type` (string, required)
    Statement value type, in a coded form.
    Example: "Credits"

  - `Data.Statement.StatementValue.Value` (string, required)
    Value associated with the statement value type.
    Example: "100"

  - `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"