# Statements Este método se conecta a la cuenta especificada por el usuario en y retorna el resumen de los estados de cuenta emitidos por el banco dentro del rango de fechas especificado (también conocido como "Resumen de estado de cuenta"). El uso del campo 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 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/bancochile.cl/statements 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. significa que el servicio se ha ejecutado correctamente aunque no devuelva datos. indica que ha ocurrido algo que ha impedido la finalización con éxito del proceso. Enum: "OK", "ERROR" - `Data` (object,null, required) Contenedor de resumen de estados de cuenta. - `Data.Statement` (array, required) Proporciona más detalles sobre un recurso de declaración. - `Data.Statement.AccountId` (string, required) Identificador único e inmutable utilizado para identificar el recurso de la cuenta. Example: "873458" - `Data.Statement.CreationDateTime` (string, required) Fecha y hora de creación del recurso. Example: "2017-07-21T17:32:28-0400" - `Data.Statement.EndDateTime` (string, required) Fecha y hora a la que finaliza el periodo del extracto. Example: "2017-06-30T23:59:59-0400" - `Data.Statement.StartDateTime` (string, required) Fecha y hora de inicio del periodo de liquidación. Example: "2017-06-01T00:00:00-0400" - `Data.Statement.Type` (string, required) Tipo de declaración, de forma codificada. Enum: "AccountClosure", "AccountOpening", "Annual", "Interim", "RegularPeriodic" - `Data.Statement.StatementDescription` (string) Otras descripciones que pueden estar disponibles para el recurso de enunciado. Example: "ATRIBUTOS ADICIONALES" - `Data.Statement.StatementReference` (string) Referencia única para la declaración. Esta referencia puede rellenarse opcionalmente si está disponible. Example: "a2c557c63450" - `Data.Statement.StatementAmount` (array) Conjunto de elementos utilizados para proporcionar detalles de un importe genérico para el recurso de la declaración. - `Data.Statement.StatementAmount.CreditDebitIndicator` (string, required) Indica si el importe es un abono o un cargo. Utilización: Un importe cero se considera un importe acreedor. Enum: "Credit", "Debit" - `Data.Statement.StatementAmount.Type` (string, required) Tipo de importe, de forma codificada. Example: "ClosingBalance" - `Data.Statement.StatementAmount.Amount` (object, required) Cantidad de dinero asociada al tipo de importe. - `Data.Statement.StatementAmount.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.Statement.StatementAmount.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" - `AdditionalInformation` (string,null, required) Este campo puede utilizarse para mostrar información relevante específica de la respuesta, por ejemplo indicando que el campo está incompleto. - `Error` (object,null, required) Objeto con los detalles del error, utilizado cuando . Si 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) 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á . Example: "OK" - `Data` (object, required) 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) 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"