# Listar transacciones

## ▶️ Uso

Con el método List Transactions, puedes:

1. [Requerido] Listar transacciones relacionadas con un link.id específico (usando el parámetro de consulta link).
2. Filtrar las transacciones devueltas usando parámetros de consulta (ver la sección de Filtrado de respuestas a continuación).
3. Obtener los detalles de un transaction.id específico (usando el parámetro de consulta id junto con el parámetro de consulta link).

## 📖 Paginación

Este método devuelve una respuesta paginada (por defecto: 100 elementos por página). Puedes usar el parámetro de consulta page_size para aumentar el número de elementos devueltos hasta un máximo de 1000 elementos. Puedes usar el parámetro de consulta page para navegar a través de los resultados. Para más detalles sobre cómo navegar por las respuestas paginadas de Belvo, consulta nuestro artículo Consejos de Paginación.

## 🔦 Filtrado de Respuestas

Consulta la lista de campos a continuación para ver por cuáles puedes filtrar tus respuestas. Para más información sobre cómo usar filtros, consulta nuestro artículo Filtrado de respuestas.

Endpoint: GET /api/transactions/
Version: 1.223.0
Security: basicAuth

## Query parameters:

  - `link` (string, required)
    El link.id por el que deseas filtrar.
    Example: "8848bd0c-9c7e-4f53-a732-ec896b11d4c4"

  - `page_size` (integer)
    Indica cuántos resultados devolver por página. Por defecto, devolvemos 100 resultados por página.

ℹ️ El número mínimo de resultados devueltos por página es 1 y el máximo es 1000. Si introduces un valor mayor que 1000, nuestra API usará por defecto el valor máximo (1000).
    Example: 100

  - `page` (integer)
    Un número de página dentro del conjunto de resultados paginados.
    Example: 1

  - `omit` (string)
    Omite ciertos campos para que no se devuelvan en la respuesta. Para más información, consulta nuestro artículo del DevPortal Filtrando respuestas.

  - `fields` (string)
    Devuelve solo los campos especificados en la respuesta. Para obtener más información, consulta nuestro artículo del DevPortal Filtrando respuestas.

  - `link__in` (array)
    Devuelve resultados solo para estos link.ids.
    Example: ["5722d0ba-69d7-42dc-8ff5-33767b83c5d6"]

  - `account` (string)
    El account.id por el que deseas filtrar.

ℹ️ Recomendamos encarecidamente agregar filtros de link.id o account.id para mejorar tu rendimiento.
    Example: "8848bd0c-9c7e-4f53-a732-ec896b11d4c4"

  - `account__in` (array)
    Devuelve resultados solo para estos account.ids.
    Example: ["85b77707-90ef-46fd-9059-5a757f24247a"]

  - `account__balance__available` (number)
    Devuelve transacciones que tengan un account.balance.available que coincida exactamente con este valor.
    Example: 4000.02

  - `account__balance__available__lt` (number)
    Devuelve las transacciones que tienen un account.balance.available menor que este valor.
    Example: 6000.02

  - `account__balance__available__lte` (number)
    Devuelve las transacciones que tienen un account.balance.available menor o igual a este valor.
    Example: 5999.02

  - `account__balance__available__gt` (number)
    Devolver transacciones que tengan un account.balance.available mayor que este valor.
    Example: 6000.02

  - `account__balance__available__gte` (number)
    Devuelve las transacciones que tienen un account.balance.available mayor o igual a este valor.
    Example: 5999.02

  - `account__balance__available__range` (array)
    Devuelve transacciones que tienen un account.balance.available dentro de un rango de dos valores. El primer valor indica el inicio del rango y el segundo valor indica el final del rango.
    Example: [100,5000]

  - `account__balance__current` (number)
    Devuelve transacciones que tengan un account.balance.current que coincida exactamente con este valor.
    Example: 4000.02

  - `account__balance__current__gt` (number)
    Devuelve las transacciones que tienen un account.balance.current mayor que este valor.
    Example: 4020.02

  - `account__balance__current__gte` (number)
    Devuelve transacciones que tengan un account.balance.current mayor o igual a este valor.
    Example: 4019.02

  - `account__balance__current__lt` (number)
    Devuelve las transacciones que tienen un account.balance.current menor que este valor.
    Example: 3000.02

  - `account__balance__current__lte` (number)
    Devuelve transacciones que tengan un account.balance.current menor o igual a este valor.
    Example: 2999.02

  - `account__balance__current__range` (array)
    Devuelve transacciones que tienen un account.balance.current dentro de un rango. El primer valor indica el inicio del rango y el segundo valor indica el final del rango.
    Example: [100,5000]

  - `account_type` (string)
    Devuelve información solo para las transacciones que coincidan con este tipo de cuenta, según lo designado por la institución.
    Example: "Cuentas de efectivo"

  - `account_type__in` (array)
    Devuelve información solo para transacciones que coincidan con estos tipos de cuenta, según lo designado por la institución.
    Example: ["Depositos Ahorro"]

  - `accounting_date` (string)
    Devolver transacciones que fueron procesadas por la institución exactamente en esta fecha (YYYY-MM-DD).
    Example: "2022-05-05"

  - `accounting_date__gt` (string)
    Devolver transacciones que fueron procesadas por la institución después de esta fecha (YYYY-MM-DD).
    Example: "2022-05-06"

  - `accounting_date__gte` (string)
    Devuelve las transacciones que fueron procesadas por la institución en esta fecha (YYYY-MM-DD) o posteriormente.
    Example: "2022-05-04"

  - `accounting_date__lt` (string)
    Devolver transacciones que fueron procesadas por la institución antes de esta fecha (YYYY-MM-DD).
    Example: "2022-03-02"

  - `accounting_date__lte` (string)
    Devuelve las transacciones que fueron procesadas por la institución en esta fecha (YYYY-MM-DD) o antes.
    Example: "2022-03-01"

  - `accounting_date__range` (array)
    Devuelve las transacciones que fueron procesadas por la institución en esta fecha. El primer valor indica el inicio del rango y el segundo valor indica el final del rango. rango (YYYY-MM-DD).
    Example: ["2022-01-01","2022-12-31"]

  - `amount` (number)
    Devuelve resultados solo para este valor.
    Example: 1000.02

  - `amount__gt` (number)
    Devolver resultados solo para más de esta cantidad.
    Example: 1000.02

  - `amount__gte` (number)
    Devuelve resultados solo para y más de esta cantidad.
    Example: 1000.02

  - `amount__lt` (number)
    Devolver resultados solo por menos de esta cantidad.
    Example: 1000.02

  - `amount__lte` (number)
    Devuelve resultados solo para esta cantidad o menos.
    Example: 1000.02

  - `amount__range` (array)
    Devuelve resultados entre este rango de cantidades. El primer valor indica el inicio del rango y el segundo valor indica el final del rango.
    Example: [100,5000]

  - `collected_at` (string)
    Devuelve los elementos que fueron recuperados de la institución en esta fecha (YYYY-MM-DD o marca de tiempo completa ISO-8601).
    Example: "2022-05-01"

  - `collected_at__gt` (string)
    Devuelve los elementos que fueron recuperados de la institución después de esta fecha (YYYY-MM-DD o marca de tiempo completa en formato ISO-8601).
    Example: "2022-05-05"

  - `collected_at__gte` (string)
    Devolver los elementos que fueron recuperados de la institución en o después de esta fecha (YYYY-MM-DD o marca de tiempo completa ISO-8601).
    Example: "2022-05-04"

  - `collected_at__lt` (string)
    Devolver los elementos que fueron recuperados de la institución antes de esta fecha (YYYY-MM-DD o marca de tiempo completa ISO-8601).
    Example: "2022-04-01"

  - `collected_at__lte` (string)
    Devuelve los elementos que fueron recuperados de la institución en o antes de esta fecha (YYYY-MM-DD o marca de tiempo completa ISO-8601).
    Example: "2022-03-30"

  - `collected_at__range` (array)
    Devolver elementos que fueron recuperados de la institución entre dos fechas (YYYY-MM-DD o marca de tiempo completa ISO-8601). El primer valor indica el inicio del rango y el segundo valor indica el final del rango.
    Example: ["2022-01-01","2022-12-31"]

  - `created_at` (string)
    Devuelve los elementos que se actualizaron por última vez en la base de datos de Belvo en esta fecha (en formato YYYY-MM-DD).
    Example: "2022-05-05"

  - `created_at__gt` (string)
    Devuelve los elementos que se actualizaron por última vez en la base de datos de Belvo después de esta fecha (en formato YYYY-MM-DD).
    Example: "2022-05-05"

  - `created_at__gte` (string)
    Devuelve los elementos que se actualizaron por última vez en la base de datos de Belvo después o en esta fecha (en formato YYYY-MM-DD).
    Example: "2022-05-04"

  - `created_at__lt` (string)
    Devuelve los elementos que se actualizaron por última vez en la base de datos de Belvo antes de esta fecha (en formato YYYY-MM-DD).
    Example: "2022-04-01"

  - `created_at__lte` (string)
    Devuelve los elementos que se actualizaron por última vez en la base de datos de Belvo antes o en esta fecha (en formato YYYY-MM-DD).
    Example: "2022-03-30"

  - `created_at__range` (array)
    Devolver cuentas que fueron actualizadas por última vez en la base de datos de Belvo entre dos fechas (en formato YYYY-MM-DD). El primer valor indica el inicio del rango y el segundo valor indica el final del rango.
    Example: ["2022-01-01","2022-12-31"]

  - `currency` (string)
    Devuelve resultados que contengan finanzas o saldos solo en este código de moneda de tres letras.
    Example: "BRA"

  - `currency__in` (array)
    Devuelve resultados que tengan fondos o saldos en uno de estos códigos de moneda de tres letras.
    Example: ["BRA"]

  - `credit_card_data__bill_name__in` (array)
    Devolver transacciones para uno de estos nombres de factura.
    Example: ["feb-2022"]

  - `reference` (string)
    Devuelve transacciones con este número de referencia asignado por la institución.
    Example: 85904452810319230

  - `reference__in` (array)
    Devuelve transacciones con estos números de referencia asignados por la institución.
    Example: [85904452810319230]

  - `status` (string)
    Devolver transacciones con este estado. Puede ser PENDING, PROCESSED o UNCATEGORIZED.
    Example: "PENDING"

  - `status__in` (array)
    Devuelve transacciones con estos estados. Puede ser PENDING, PROCESSED o UNCATEGORIZED.
    Example: ["PROCESSED"]

  - `type` (string)
    Devolver transacciones con este tipo. Puede ser INFLOW o OUTFLOW.
    Enum: "OUTFLOW", "INFLOW"

  - `type__in` (array)
    Devolver transacciones con estos tipos. Puede ser INFLOW o OUTFLOW.
    Enum: same as `type` (2 values)

  - `value_date` (string)
    Devolver resultados exactamente para esta fecha (YYYY-MM-DD).
    Example: "2022-05-05"

  - `value_date__gt` (string)
    Devolver resultados que ocurrieron después de esta fecha (YYYY-MM-DD).
    Example: "2022-05-06"

  - `value_date__gte` (string)
    Devolver resultados para esta fecha (YYYY-MM-DD) o posterior.
    Example: "2022-05-04"

  - `value_date__lt` (string)
    Devolver resultados para antes de esta fecha (YYYY-MM-DD).
    Example: "2022-03-02"

  - `value_date__lte` (string)
    Devolver resultados para esta fecha (YYYY-MM-DD) o anterior.
    Example: "2022-03-01"

  - `value_date__range` (array)
    Devuelve resultados para este rango de fechas (YYYY-MM-DD). El primer valor indica el inicio del rango y el segundo valor indica el final del rango.
    Example: ["2022-01-01","2022-12-31"]

## Response 200 fields (application/json):

  - `count` (integer)
    El número total de resultados en tu cuenta de Belvo.
    Example: 130

  - `next` (string,null)
    La URL a la siguiente página de resultados. Cada página consta de hasta 100 elementos. Si no hay suficientes resultados para una página adicional, el valor es null.

En nuestro ejemplo de documentación, usamos {endpoint} como un valor de marcador de posición. En producción, este valor será reemplazado por el endpoint real que estás utilizando actualmente (por ejemplo, accounts o owners).
    Example: "https://sandbox.belvo.com/api/{endpoint}/?link=1bd948f7-245d-4313-b604-34d1044cb908page=2"

  - `previous` (string,null)
    La URL a la página anterior de resultados. Si no hay una página anterior, el valor es null.

  - `results` (array)
    Matriz de objetos de transacción (OFDA Brasil).

  - `results.id` (string, required)
    Identificador único de Belvo para el elemento actual.
    Example: "0d3ffb69-f83b-456e-ad8e-208d0998d71d"

  - `results.internal_identification` (string, required)
    La identificación interna de la institución para la transacción.

> No anulable: La red de finanzas abiertas de Brasil debe devolver un valor.
    Example: "TXpRMU9UQTROMWhZV2xSU1FUazJSMDl"

  - `results.account` (object,null, required)
    Detalles sobre la cuenta.

  - `results.account.id` (string, required)
    Identificador único de Belvo para el elemento actual.
    Example: "0d3ffb69-f83b-456e-ad8e-208d0998d71d"

  - `results.account.link` (string,null, required)
    El link.id al que pertenecen los datos.
    Example: "30cb4806-6e00-48a4-91c9-ca55968576c8"

  - `results.account.institution` (object, required)
    Detalles sobre la institución.

  - `results.account.institution.name` (string)
    El nombre de la institución, según lo designado por Belvo.
    Example: "erebor_mx_retail"

  - `results.account.institution.type` (string)
    El tipo de institución. Devolvemos uno de los siguientes valores:

  - bank
  - fiscal
  - employment
    Enum: "bank", "fiscal", "employment"

  - `results.account.collected_at` (string, required)
    La marca de tiempo ISO-8601 cuando se recopiló el punto de datos.
    Example: "2022-02-09T08:45:50.406032Z"

  - `results.account.created_at` (string, required)
    La marca de tiempo ISO-8601 de cuando se creó el punto de datos en la base de datos de Belvo.
    Example: "2022-02-09T08:45:50.406032Z"

  - `results.account.last_accessed_at` (string,null, required)
    La marca de tiempo ISO-8601 del acceso más reciente y exitoso de Belvo a la institución para el enlace dado.
    Example: "2021-03-09T10:28:40.000Z"

  - `results.account.category` (string,null, required)
    El tipo de cuenta.  
Devolvemos uno de los siguientes valores de enum:  
  - ADVANCE_DEPOSIT_ACCOUNT
  - CHECKING_ACCOUNT
  - CREDIT_CARD
  - FINANCING_ACCOUNT
  - INVESTMENT_ACCOUNT
  - INVOICE_FINANCING_ACCOUNT
  - LOAN_ACCOUNT
  - PENSION_FUND_ACCOUNT
  - SAVINGS_ACCOUNT
  - UNCATEGORIZED
    Enum: "ADVANCE_DEPOSIT_ACCOUNT", "CHECKING_ACCOUNT", "CREDIT_CARD", "FINANCING_ACCOUNT", "INVESTMENT_ACCOUNT", "INVOICE_FINANCING_ACCOUNT", "LOAN_ACCOUNT", "PENSION_FUND_ACCOUNT", "SAVINGS_ACCOUNT", "UNCATEGORIZED"

  - `results.account.balance_type` (string,null, required)
    Indica si esta cuenta es un ASSET o un LIABILITY. Puedes considerar el saldo de un ASSET como positivo, mientras que el saldo de un LIABILITY como negativo.
    Example: "ASSET"

  - `results.account.overdraft` (object,null)

  - `results.account.overdraft.arranged` (number, required)
    El límite de sobregiro acordado entre el titular de la cuenta y la institución.

> No anulable: Se debe devolver un valor por la red de finanzas abiertas de Brasil si el campo overdraft está disponible.
    Example: 5000.5

  - `results.account.overdraft.used` (number, required)
    El valor del sobregiro utilizado.

> No anulable: La red de finanzas abiertas de Brasil debe devolver un valor si el campo overdraft está disponible.
    Example: 1000.5

  - `results.account.overdraft.unarranged` (number, required)
    El sobregiro utilizado que no fue acordado entre el titular de la cuenta y la institución.

> No anulable: Se debe devolver un valor por la red de finanzas abiertas de Brasil si el campo overdraft está disponible.
    Example: 300.1

  - `results.account.type` (string, required)
    El tipo de cuenta, según lo designado por la institución.

> No anulable: La red de finanzas abiertas de Brasil debe devolver un valor.
    Example: "STANDARD_NACIONAL"

  - `results.account.subtype` (string, required)
    El subtipo de cuenta, según lo designado por la institución.

> No anulable: La red de finanzas abiertas de Brasil debe devolver un valor.
    Example: "FINANCIAMENTO_HABITACIONAL_SFH"

  - `results.account.name` (string,null, required)
    El nombre de la cuenta, tal como lo proporciona la institución.
    Example: "Cuenta Perfiles- M.N. - MXN-666"

  - `results.account.number` (string,null, required)
    El número de cuenta, tal como lo designa la institución.
    Example: "4057068115181"

  - `results.account.agency` (string,null, required)
    El código de sucursal donde se abrió el producto.
    Example: "6272"

  - `results.account.check_digit` (string,null, required)
    El dígito de control del número del producto, si corresponde.
    Example: "7"

  - `results.account.balance` (object, required)
    Detalles sobre los saldos actual y disponible de la cuenta.

  - `results.account.balance.current` (number,null, required)
    El saldo actual se calcula de manera diferente según el tipo de cuenta.

- 💰 Cuentas corrientes y de ahorro:

El saldo de la cuenta del usuario en el momento del timestamp collected_at.

- 💳 Tarjetas de crédito:

La cantidad que el usuario ha gastado en el período de facturación actual de la tarjeta (consulte credit_data.cutting_date para obtener información sobre cuándo finaliza el período de facturación actual).

- 🏡 Cuentas de préstamo:

La cantidad restante por pagar en el préstamo del usuario.
    Example: 5874.13

  - `results.account.balance.available` (number,null)
    El saldo que el titular de la cuenta puede utilizar.

- 💰 Cuentas corrientes y de ahorro:

El saldo disponible puede ser diferente al saldo current debido a transacciones pendientes.

- 💳 Tarjetas de crédito:

El monto de crédito que el usuario aún tiene disponible para el período actual. El monto se calcula como credit_data.credit_limit menos balance.current.

- 🏡 Cuentas de préstamo:

El valor presente requerido para liquidar el préstamo, según lo proporcionado por la institución.

Nota: Si la institución no proporciona este valor, devolvemos null.
    Example: 5621.12

  - `results.account.balance.blocked` (number)
    La cantidad que está actualmente bloqueada debido a transacciones pendientes.

> No anulable: Se debe devolver un valor por la red de finanzas abiertas de Brasil si el campo balances está disponible.
    Example: 60.32

  - `results.account.balance.automatically_invested` (number)
    La cantidad que se invierte automáticamente (según lo acordado con la institución).

> No anulable: Se debe devolver un valor por la red de finanzas abiertas de Brasil si el campo balances está disponible.
    Example: 131.5

  - `results.account.currency` (string, required)
    El código de moneda de tres letras (ISO-4217).

> No anulable: Se debe devolver un valor por la red de finanzas abiertas de Brasil si el campo balances está disponible.
    Example: "BRL"

  - `results.account.public_identification_name` (string,null, required)
    El nombre público para el tipo de identificación. Para cuentas de ahorro y corrientes en 🇧🇷 Brasil, este campo será AGENCY/ACCOUNT.
    Example: "AGENCY/ACCOUNT"

  - `results.account.public_identification_value` (string,null, required)
    El valor para el public_identification_name.

Para cuentas de ahorro y corriente OFDA brasileñas 🇧🇷, este campo será el número de agencia y cuenta bancaria, separados por una barra. Por ejemplo: 0444/45722-0.

Para cuentas de tarjeta de crédito OFDA brasileñas 🇧🇷, devolveremos una cadena de números de tarjeta de crédito concatenados asociados con la cuenta. Por ejemplo: "8763,9076,5522"
    Example: "0444/45722-0"

  - `results.account.internal_identification` (string, required)
    La identificación interna de la institución para la cuenta.

> No anulable: Se debe devolver un valor por la red de finanzas abiertas de Brasil si el campo balances está disponible.
    Example: "92792126019929279212650822221989319252576"

  - `results.account.credit_data` (object,null, required)
    Detalles sobre las tarjetas de crédito asociadas con esta cuenta.

  - `results.account.credit_data.collected_at` (string, required)
    La marca de tiempo ISO-8601 cuando se recopiló el punto de datos.
    Example: "2022-02-09T08:45:50.406032Z"

  - `results.account.credit_data.credit_limit` (number,null, required)
    El límite de crédito superior de la tarjeta.

> No anulable: La red de finanzas abiertas de Brasil debe devolver un valor.
    Example: 192000.9

  - `results.account.credit_data.limits` (array)

  - `results.account.credit_data.limits.identification_number` (string,null, required)
    El número de la tarjeta de crédito.

Nota: A menudo, esto es solo los últimos cuatro dígitos de la tarjeta de crédito.

> No anulable: La red de finanzas abiertas de Brasil debe devolver un valor.
    Example: "4453"

  - `results.account.credit_data.limits.credit_limit` (number,null, required)
    El límite de la tarjeta de crédito.
    Example: 1000.04

  - `results.account.credit_data.limits.used_amount` (number,null, required)
    La cantidad utilizada.
    Example: 400.04

  - `results.account.credit_data.limits.available_amount` (number, required)
    El monto aún disponible.

> No anulable: La red de finanzas abiertas de Brasil debe devolver un valor.
    Example: 600

  - `results.account.credit_data.limits.is_limit_flexible` (boolean, required)
    Boolean para indicar si el credit_limit es flexible.

> No anulable: La red de finanzas abiertas de Brasil debe devolver un valor.

  - `results.account.credit_data.limits.type` (string, required)
    El tipo de límite. Devolvemos uno de los siguientes valores:

  - TOTAL_LIMIT
  - MODAL_LIMIT

  > No anulable: La red de finanzas abiertas de Brasil debe devolver un valor.
    Enum: "TOTAL_LIMIT", "MODAL_LIMIT"

  - `results.account.credit_data.limits.consolidation_type` (string, required)
    Indica si el límite de crédito es consolidado o individual.

> No anulable: La red de finanzas abiertas de Brasil debe devolver un valor.
    Example: "INDIVIDUAL"

  - `results.account.credit_data.limits.line_name` (string,null, required)
    El nombre de la línea de límite de crédito.
    Example: "CREDITO_A_VISTA"

  - `results.account.credit_data.limits.line_name_additional_info` (string,null, required)
    Información adicional sobre el nombre de la línea.
    Example: "Informações adicionais e complementares"

  - `results.account.credit_data.cutting_date` (string,null)
    La fecha de vencimiento de la factura de la tarjeta de crédito.
    Example: "2019-12-11"

  - `results.account.credit_data.minimum_payment` (number,null)
    La cantidad mínima que el titular de la cuenta necesita pagar en el período de crédito actual.
    Example: 2400.3

  - `results.account.credit_data.network` (string)
    La red de crédito con la que está asociada la tarjeta. Devolvemos uno de los siguientes valores:

  - VISA
  - MASTERCARD
  - AMERICAN_EXPRESS
  - DINERS_CLUB
  - HIPERCARD
  - BANDEIRA_PROPRIA
  - CHEQUE_ELETRONICO
  - ELO
  - OTHER

  > No anulable: La red de finanzas abiertas de Brasil debe devolver un valor.
    Enum: "VISA", "MASTERCARD", "AMERICAN_EXPRESS", "DINERS_CLUB", "HIPERCARD", "BANDEIRA_PROPRIA", "CHEQUE_ELETRONICO", "ELO", "OTHER"

  - `results.account.credit_data.network_additional_info` (string,null)
    Información adicional sobre la red de tarjetas de crédito.
    Example: "It's an orange card."

  - `results.account.credit_data.cards` (array)
    Detalles sobre las tarjetas asociadas con la cuenta.

  - `results.account.credit_data.cards.is_multiple` (boolean, required)
    Boolean para indicar si esta cuenta tiene múltiples tarjetas de crédito.

> No anulable: La red de finanzas abiertas de Brasil debe devolver un valor.

  - `results.account.credit_data.cards.identification_number` (string, required)
    El número de la tarjeta de crédito.

Nota: A menudo, esto es solo los últimos cuatro dígitos de la tarjeta de crédito.

> No anulable: La red de finanzas abiertas de Brasil debe devolver un valor.
    Example: "4453"

  - `results.account.credit_data.next_payment_date` (string,null)
    Nota: Este campo no es aplicable para OF Brazil y devolverá null.

  - `results.account.credit_data.no_interest_payment` (number,null)
    Nota: Este campo no es aplicable para OF Brazil y devolverá null.

  - `results.account.credit_data.interest_rate` (number,null)
    Nota: Este campo no es aplicable para OF Brazil y devolverá null.

  - `results.account.credit_data.monthly_payment` (number,null)
    Nota: Este campo no es aplicable para OF Brazil y devolverá null.

  - `results.account.credit_data.last_payment_date` (string,null)
    Nota: Este campo no es aplicable para OF Brazil y devolverá null.

  - `results.account.loan_data` (object,null, required)
    Las opciones de préstamo asociadas con esta cuenta.

  - `results.account.loan_data.collected_at` (string, required)
    La marca de tiempo ISO-8601 cuando se recopiló el punto de datos.
    Example: "2022-02-09T08:45:50.406032Z"

  - `results.account.loan_data.loan_code` (string, required)
    El número de contrato estandarizado específico del país.

> No anulable: La red de finanzas abiertas de Brasil debe devolver un valor.
    Example: "92792126019929279212650822221989319252576"

  - `results.account.loan_data.contract_amount` (number,null, required)
    El monto total inicial del préstamo cuando se firmó el contrato, calculado por la institución. Este monto incluye el principal + intereses + impuestos + tarifas.
    Example: 202000

  - `results.account.loan_data.total_effective_cost` (number,null)
    El costo total efectivo inicial del préstamo.
    Example: 209000

  - `results.account.loan_data.loan_type` (string, required)
    El tipo de préstamo, según la institución.

> No anulable: La red de finanzas abiertas de Brasil debe devolver un valor.
    Example: "HOME_EQUITY"

  - `results.account.loan_data.outstanding_balance` (number,null, required)
    El monto restante a pagar en total, incluidos los intereses.
    Example: 182000

  - `results.account.loan_data.interest_rates` (array, required)
    Desglose del interés aplicado al préstamo. Con OF Brasil, recomendamos encarecidamente utilizar la información en interest_rate_data para obtener información detallada.

> No anulable: La red de finanzas abiertas de Brasil debe devolver un valor.

  - `results.account.loan_data.interest_rates.name` (string,null, required)
    El nombre del tipo de tasa de interés aplicada al préstamo.

Nota: Para OFDA Brasil, recomendamos usar el parámetro interest_rate_data.tax_type.
    Example: "NOMINAL"

  - `results.account.loan_data.interest_rates.type` (string, required)
    El período durante el cual se aplica el interés al préstamo.

> No anulable: La red de finanzas abiertas de Brasil debe devolver un valor.
    Enum: "MONTHLY", "YEARLY"

  - `results.account.loan_data.interest_rates.value` (number,null, required)
    La tasa de interés (en porcentaje o valor monetario).

Nota: Para OFDA Brasil, recomendamos que utilice el parámetro interest_rate_data.pre_fixed_rate y interest_rate_data.post_fixed_rate.
    Example: 7.85

  - `results.account.loan_data.interest_rates.interest_rate_data` (object,null, required)
    Información detallada sobre la tasa de interés.

  - `results.account.loan_data.interest_rates.interest_rate_data.tax_type` (string, required)
    El tipo de impuesto sobre la tasa de interés. Devolvemos uno de los siguientes valores:

  - NOMINAL
  - EFFECTIVE
  
  > No anulable: La red de finanzas abiertas de Brasil debe devolver un valor.
    Enum: "NOMINAL", "EFFECTIVE"

  - `results.account.loan_data.interest_rates.interest_rate_data.rate_type` (string, required)
    El tipo de tasa de interés. Devolvemos uno de los siguientes valores:

  - SIMPLE
  - COMPOUND

  > No anulable: La red de finanzas abiertas de Brasil debe devolver un valor.
    Enum: "SIMPLE", "COMPOUND"

  - `results.account.loan_data.interest_rates.interest_rate_data.type` (string)
    El período durante el cual se aplica el interés al préstamo.

> No anulable: La red de finanzas abiertas de Brasil debe devolver un valor.
    Enum: same as `results.account.loan_data.interest_rates.type` (2 values)

  - `results.account.loan_data.interest_rates.interest_rate_data.calculation_base` (string, required)
    El cálculo base para la tasa de interés.

> No anulable: La red de finanzas abiertas de Brasil debe devolver un valor.
    Example: "30/360"

  - `results.account.loan_data.interest_rates.interest_rate_data.reference_index_type` (string, required)
    La tasa de índice de referencia. Devolvemos uno de los siguientes valores:

  - WITHOUT_INDEX_TYPE
  - PRE_FIXED
  - POST_FIXED
  - FLOATING
  - INDEXED_PRICE
  - RURAL_CREDIT
  - OTHER_INDEX

  > No anulable: La red de finanzas abiertas de Brasil debe devolver un valor.
    Enum: "WITHOUT_INDEX_TYPE", "PRE_FIXED", "POST_FIXED", "FLOATING", "INDEXED_PRICE", "RURAL_CREDIT", "OTHER_INDEX"

  - `results.account.loan_data.interest_rates.interest_rate_data.reference_index_subtype` (string,null, required)
    El subtipo de la tasa de índice de referencia.
    Example: "TR_TBF"

  - `results.account.loan_data.interest_rates.interest_rate_data.reference_index_info` (string,null, required)
    Información adicional sobre la tasa del índice de referencia.
    Example: "Additional information"

  - `results.account.loan_data.interest_rates.interest_rate_data.pre_fixed_rate` (number, required)
    La tasa de interés con porcentaje prefijado.

> No anulable: La red de finanzas abiertas de Brasil debe devolver un valor.
    Example: 0.062

  - `results.account.loan_data.interest_rates.interest_rate_data.post_fixed_rate` (number, required)
    La tasa de porcentaje post-fijada de la tasa de interés.

> No anulable: La red de finanzas abiertas de Brasil debe devolver un valor.
    Example: 0.062

  - `results.account.loan_data.interest_rates.interest_rate_data.additional_info` (string,null, required)
    Información adicional sobre la tasa de interés.
    Example: "Additional information"

  - `results.account.loan_data.fees` (array,null, required)
    Desglose de las tarifas aplicadas al préstamo.

  - `results.account.loan_data.fees.type` (string,null, required)
    Nota: Este campo no es aplicable para OF Brazil y devolverá null.
    Enum: "OPERATION_FEE", "INSURANCE_FEE", "OTHERS", null

  - `results.account.loan_data.fees.value` (number,null, required)
    El valor total de la tarifa. Misma moneda que el préstamo.
    Example: 5.6

  - `results.account.loan_data.fees.name` (string, required)
    El nombre de la tarifa.

 > No anulable: Se debe devolver un valor por la red de finanzas abiertas de Brasil si el campo fees está disponible.
    Example: "Renovação de cadastro"

  - `results.account.loan_data.fees.code` (string, required)
    El código de tarifa.

 > No anulable: Se debe devolver un valor por la red de finanzas abiertas de Brasil si el campo fees está disponible.
    Example: "CADASTRO"

  - `results.account.loan_data.fees.fee_charge_type` (string, required)
    Indica el tipo de cargo. Devolvemos uno de los siguientes valores:

  - SINGLE
  - PER_INSTALLMENT

   > No anulable: Se debe devolver un valor por la red de finanzas abiertas de Brasil si el campo fees está disponible.
    Enum: "SINGLE", "PER_INSTALLMENT"

  - `results.account.loan_data.fees.fee_charge` (string, required)
    Método de facturación, según lo acordado con la institución. Devolvemos uno de los siguientes valores:

  - MINIMUM
  - MAXIMUM
  - FIXED
  - PERCENTAGE

   > No anulable: Se debe devolver un valor por la red de finanzas abiertas de Brasil si el campo fees está disponible.
    Enum: "MINIMUM", "MAXIMUM", "FIXED", "PERCENTAGE"

  - `results.account.loan_data.fees.rate` (number,null, required)
    La tasa porcentual de la tarifa. Requerido cuando fee_charge está configurado en PERCENTAGE.
    Example: 0.062

  - `results.account.loan_data.contracted_charges` (array,null)
    Lo siento, no hay texto proporcionado para traducir. Por favor, proporciona el texto que necesitas que traduzca.

  - `results.account.loan_data.contracted_charges.type` (string)
    El tipo de cargo contratado. Devolvemos uno de los siguientes valores:

  - LATE_PAYMENT_INTEREST_FEE
  - LATE_PAYMENT_PENALTY_FEE
  - DEFAULT_INTEREST_FEE
  - LOAN_CONTRACT_TAX
  - LATE_PAYMENT_TAX
  - NO_CHARGE
  - OTHER

  > No anulable: Se debe devolver un valor por la red de finanzas abiertas de Brasil si el campo contracted_charges está disponible.
    Enum: "LATE_PAYMENT_INTEREST_FEE", "LATE_PAYMENT_PENALTY_FEE", "DEFAULT_INTEREST_FEE", "LOAN_CONTRACT_TAX", "LATE_PAYMENT_TAX", "NO_CHARGE", "OTHER"

  - `results.account.loan_data.contracted_charges.info` (string,null)
    Información adicional sobre el cargo contratado.
    Example: "Late fee"

  - `results.account.loan_data.contracted_charges.rate` (number,null)
    La tasa porcentual del cargo, calculada en función del monto del préstamo.
    Example: 0.062

  - `results.account.loan_data.collaterals` (array,null, required)
    Detalles sobre cualquier garantía de préstamo que el individuo o negocio haya proporcionado.

  - `results.account.loan_data.collaterals.type` (string, required)
    El tipo de garantía, según lo definido por la institución.

> No anulable: Se debe devolver un valor por la red de finanzas abiertas de Brasil si el campo collaterals está disponible.
    Example: "OPERACOES_GARANTIDAS_PELO_GOVERNO"

  - `results.account.loan_data.collaterals.subtype` (string, required)
    El subtipo de la garantía, según lo definido por la institución.

> No anulable: Se debe devolver un valor por la red de finanzas abiertas de Brasil si el campo collaterals está disponible.
    Example: "CCR_CONVENIO_CREDITOS_RECIPROCOS"

  - `results.account.loan_data.collaterals.currency` (string, required)
    El código de moneda de tres letras (ISO-4217).

> No anulable: Se debe devolver un valor por la red de finanzas abiertas de Brasil si el campo collaterals está disponible.
    Example: "BRL"

  - `results.account.loan_data.collaterals.amount` (number, required)
    El monto total de la factura.

> No anulable: Se debe devolver un valor por la red de finanzas abiertas de Brasil si el campo collaterals está disponible.
    Example: 45391.89

  - `results.account.loan_data.balloon_payments` (array,null, required)
    Información detallada sobre cualquier pago global del préstamo, si corresponde.

  - `results.account.loan_data.balloon_payments.due_date` (string,null, required)
    La fecha en que se debe pagar el balloon payment, en formato YYYY-MM-DD.
    Example: "2021-09-06"

  - `results.account.loan_data.balloon_payments.currency` (string,null, required)
    El código de moneda de tres letras (ISO-4217).
    Example: "BRL"

  - `results.account.loan_data.balloon_payments.amount` (number,null, required)
    El monto total del pago global.
    Example: 45391.89

  - `results.account.loan_data.installments_contract_term_frequency` (string,null, required)
    La frecuencia de los pagos a plazos contratados, tal como se definió cuando se firmó el contrato por primera vez. Devolvemos uno de los siguientes:

  - DAY
  - WEEK
  - MONTH
  - YEAR
  - NO_DEADLINE_REMAINING
  - null
    Enum: "DAY", "WEEK", "MONTH", "YEAR", "NO_DEADLINE_REMAINING", null

  - `results.account.loan_data.installment_frequency` (string, required)
    La frecuencia con la que se pagan las cuotas. Devolvemos uno de los siguientes valores:

  - IRREGULAR
  - WEEKLY
  - FORTNIGHTLY
  - MONTHLY
  - BIMONTHLY
  - QUARTERLY
  - BIANNUALLY
  - ANNUALLY
  - OTHER

  > No anulable: La red de finanzas abiertas de Brasil debe devolver un valor.
    Enum: "IRREGULAR", "WEEKLY", "FORTNIGHTLY", "MONTHLY", "BIMONTHLY", "QUARTERLY", "BIANNUALLY", "ANNUALLY", "OTHER"

  - `results.account.loan_data.installment_frequency_info` (string,null, required)
    Información adicional sobre el installment_frequency.
    Example: "Both the term and requency are the same."

  - `results.account.loan_data.first_installment_due_date` (string,null, required)
    La fecha en la que debe pagarse la primera cuota del préstamo, en formato YYYY-MM-DD.
    Example: "2020-03-01"

  - `results.account.loan_data.number_of_installments_total` (integer,null, required)
    El número total de cuotas necesarias para pagar el préstamo.
    Example: 60

  - `results.account.loan_data.number_of_installments_outstanding` (integer,null, required)
    El número de cuotas restantes por pagar.
    Example: 48

  - `results.account.loan_data.number_of_installments_paid` (integer,null, required)
    El número de cuotas ya pagadas.
    Example: 32

  - `results.account.loan_data.number_of_installments_past_due` (integer,null, required)
    El número de cuotas que están vencidas.
    Example: 2

  - `results.account.loan_data.disbursement_dates` (array,null, required)
    Un array de fechas cuando se desembolsó el préstamo.
    Example: ["2021-09-23"]

  - `results.account.loan_data.settlement_date` (string,null, required)
    La fecha en que se liquidó el préstamo, en formato YYYY-MM-DD.
    Example: "2021-09-23"

  - `results.account.loan_data.contract_start_date` (string, required)
    La fecha en que se firmó el contrato de préstamo, en formato YYYY-MM-DD.

> No anulable: Se debe devolver un valor por la red de finanzas abiertas de Brasil.
    Example: "2020-03-01"

  - `results.account.loan_data.contract_end_date` (string,null, required)
    La fecha en la que se espera que el préstamo se complete, en formato YYYY-MM-DD.
    Example: "2027-10-01"

  - `results.account.loan_data.contract_remaining_frequency` (string,null, required)
    La frecuencia de los pagos de las cuotas restantes contratadas, tal como se definió cuando se firmó el contrato por primera vez. Devolvemos uno de los siguientes valores:
- DAY
- WEEK
- MONTH
- YEAR
- NO_DEADLINE_REMAINING
- null
    Enum: same as `results.account.loan_data.installments_contract_term_frequency` (6 values)

  - `results.account.loan_data.contract_remaining_total` (integer,null, required)
    El número total de cuotas restantes del préstamo.
    Example: 20

  - `results.account.loan_data.amortization_schedule` (string, required)
    El calendario de amortización del préstamo.

> No anulable: La red de finanzas abiertas de Brasil debe devolver un valor.
    Example: "SEM_SISTEMA_AMORTIZACAO"

  - `results.account.loan_data.amortization_schedule_info` (string,null, required)
    Información adicional sobre el amortization_schedule.
    Example: "No need for a schedule."

  - `results.account.loan_data.consignee_id` (string,null, required)
    El ID del consignatario del préstamo.
    Example: "60500998000135"

  - `results.account.loan_data.contract_number` (string,null, required)
    El número de contrato del préstamo, tal como lo proporciona la institución.
    Example: "1324926521496"

  - `results.account.loan_data.monthly_payment` (number,null, required)
    Nota: Este campo no es aplicable para OF Brazil y devolverá null.

  - `results.account.loan_data.principal` (number,null, required)
    Nota: Este campo no es aplicable para OF Brazil y devolverá null.

  - `results.account.loan_data.payment_day` (string,null, required)
    Nota: Este campo no es aplicable para OF Brazil y devolverá null.

  - `results.account.loan_data.outstanding_principal` (number,null, required)
    Nota: Este campo no es aplicable para OF Brazil y devolverá null.

  - `results.account.loan_data.credit_limit` (number,null, required)
    Nota: Este campo no es aplicable para OF Brazil y devolverá null.

  - `results.account.loan_data.last_period_balance` (number,null, required)
    Nota: Este campo no es aplicable para OF Brazil y devolverá null.

  - `results.account.loan_data.interest_rate` (number,null, required)
    Nota: Este campo no es aplicable para OF Brazil y devolverá null.

  - `results.account.loan_data.limit_day` (string,null, required)
    Nota: Este campo no es aplicable para OF Brazil y devolverá null.

  - `results.account.loan_data.cutting_day` (string,null, required)
    Nota: Este campo no es aplicable para OF Brazil y devolverá null.

  - `results.account.loan_data.cutting_date` (string,null, required)
    Nota: Este campo no es aplicable para OF Brazil y devolverá null.

  - `results.account.loan_data.last_payment_date` (string,null, required)
    Nota: Este campo no es aplicable para OF Brazil y devolverá null.

  - `results.account.loan_data.no_interest_payment` (number,null, required)
    Nota: Este campo no es aplicable para OF Brazil y devolverá null.

  - `results.account.funds_data` (string,null, required)
    Nota: Este campo no es aplicable para OF Brazil y devolverá null.

  - `results.collected_at` (string, required)
    La marca de tiempo ISO-8601 cuando se recopiló el punto de datos.
    Example: "2022-02-09T08:45:50.406032Z"

  - `results.created_at` (string, required)
    La marca de tiempo ISO-8601 de cuando se creó el punto de datos en la base de datos de Belvo.
    Example: "2022-02-09T08:45:50.406032Z"

  - `results.value_date` (string, required)
    La fecha en que ocurrió la transacción, en formato YYYY-MM-DD.

> No anulable: La red de finanzas abiertas de Brasil debe devolver un valor.
    Example: "2019-10-23"

  - `results.transacted_at` (string)
    La marca de tiempo ISO-8601 de cuando ocurrió la transacción (en la zona horaria UTC).

> Nota: Para transacciones que ocurrieron antes del 31.01.2024, la marca de tiempo puede indicar solo el día (por ejemplo, 2016-01-29T00:00:00.000Z). Sin embargo, las transacciones que ocurrieron después de esta fecha deben incluir la fecha y la hora (2024-02-20T12:29:03.374Z).

> Instituciones que no cumplen con este formato:
> Algunas instituciones pueden no proporcionar la hora exacta de la transacción. En este caso, la marca de tiempo se establecerá en 00:00:00.000Z.
> Belvo ha identificado las siguientes instituciones como no cumpliendo con la regulación y ha planteado el problema a los reguladores: Bradesco, Itau y Sicoob.

> No anulable: La red de finanzas abiertas de Brasil debe devolver un valor para transacciones de tarjeta de crédito y cuenta corriente.
    Example: "2024-02-20T12:29:03.374Z"

  - `results.accounting_date` (string,null, required)
    La fecha en que la transacción fue procesada y contabilizada por la institución, en formato YYYY-MM-DD.  
> No anulable: La red de finanzas abiertas de Brasil debe devolver un valor para transacciones con tarjeta de crédito.
    Example: "2019-10-23"

  - `results.inferred_accounting_date` (string)
    En el caso de que la transacción ocurra en un fin de semana o día festivo, Belvo inferirá la fecha en que la transacción es contabilizada por la institución. Normalmente, este es el siguiente día hábil.
    Example: "2019-10-23"

  - `results.amount` (number, required)
    El monto de la transacción.  
ℹ️ El monto mostrado siempre es positivo, ya que indicamos la dirección de la transacción en el parámetro type.  
> No anulable: La red de finanzas abiertas de Brasil debe devolver un valor.
    Example: 2145.45

  - `results.local_currency_amount` (number,null, required)
    El valor de la transacción en la moneda local.

> No anulable: La red de finanzas abiertas de Brasil debe devolver un valor para las transacciones con tarjeta de crédito.
    Example: 7623.64

  - `results.balance` (number,null, required)
    Nota: Este campo no es aplicable para OF Brazil y devolverá null.

  - `results.currency` (string,null, required)
    El código de moneda de tres letras (ISO-4217).
    Example: "BRL"

  - `results.description` (string,null, required)
    La descripción de la transacción proporcionada por la institución. Generalmente, este es el texto que el usuario final ve en la plataforma en línea.

> No anulable: La red de finanzas abiertas de Brasil debe devolver un valor.
    Example: "SEVEN BUDDHAS RFC:XXXXXXXXXX"

  - `results.observations` (string,null, required)
    Nota: Este campo no es aplicable para OF Brazil y devolverá null.

  - `results.merchant` (object,null, required)
    Datos adicionales sobre el comerciante involucrado en la transacción.
Solo devolvemos información del comerciante para nuevas transacciones realizadas desde cuentas de cheques o tarjeta de crédito.
> Obtener información del comerciante
 Recuperamos la información del comerciante para una transacción como parte de nuestro producto de Categorización de transacciones, convirtiendo datos en bruto en información procesable. Para habilitar este producto, simplemente contáctanos, y nos pondremos manos a la obra.

  - `results.merchant.logo` (string,null)
    La URL del logotipo del comerciante.
    Example: "https://logo.clearbit.com/asesor-contable.es"

  - `results.merchant.website` (string,null)
    La URL al sitio web del comerciante.
    Example: "https://merchants-r-us.com"

  - `results.merchant.merchant_name` (string)
    El nombre del comerciante.
    Example: "Merchants R Us Global"

  - `results.category` (string,null, required)
    El nombre de la categoría de transacción.

> Obtener categorización de transacciones
Con la categorización de transacciones, limpiamos y categorizamos las transacciones por ti, convirtiendo datos en bruto en información procesable. Para habilitar esta función, simplemente contáctanos y nos pondremos manos a la obra.

Devolvemos uno de los siguientes valores de 'enum':

  - Bills & Utilities
  - Credits & Loans
  - Deposits
  - Fees & Charges
  - Food & Groceries
  - Home & Life
  - Income & Payments
  - Insurance
  - Investments & Savings
  - Online Platforms & Leisure
  - Personal Shopping
  - Taxes
  - Transfers
  - Transport & Travel
  - Unknown*
  - Withdrawal & ATM
  - null


  \* Para los clientes que no utilizan nuestro producto de Categorización de Transacciones, devolvemos null en su lugar.
    Enum: "Bills & Utilities", "Credits & Loans", "Deposits", "Fees & Charges", "Food & Groceries", "Home & Life", "Income & Payments", "Insurance", "Investments & Savings", "Online Platforms & Leisure", "Personal Shopping", "Taxes", "Transfers", "Transport & Travel", "Unknown", "Withdrawal & ATM", null

  - `results.subcategory` (string,null, required)
    La subcategoría de la transacción.

  > Obtener categorización de transacciones
  Para los clientes que no utilizan nuestra categorización de transacciones, devolvemos null en su lugar. Para habilitar esta función, simplemente contáctanos, y lo activaremos de inmediato.

Devolvemos uno de los siguientes valores de enum:

  - Electricity & Energy
  - Rent
  - Telecommunications
  - Water
  - Auto
  - Credit Card
  - Instalment
  - Interest & Charges
  - Mortgage
  - Pay Advance
  - Personal
  - Adjustments
  - Bank Fees
  - Chargeback
  - Refund
  - Blocked Balances
  - Alimony
  - Alcohol & Tobacco
  - Bakery & Coffee
  - Bars & Nightclubs
  - Convenience Store
  - Delivery
  - Groceries
  - Restaurants
  - Education
  - Gyms & Fitness
  - Hair & Beauty
  - Health
  - Home Decor & Appliances
  - Laundry & Dry Cleaning
  - Pharmacies
  - Professional Services
  - Veterinary Services
  - Freelance
  - Interest
  - Retirement
  - Salary
  - Government
  - Home Insurance
  - Auto Insurance
  - Health & Life Insurance
  - Savings
  - Fixed income
  - Equity
  - Investment Funds
  - Derivatives
  - Cryptocurrencies
  - Apps, Software and Cloud Services
  - Events, Parks and Museums
  - Gambling
  - Gaming
  - Lottery
  - Movie & Audio
  - Books & News
  - Clothing & Accessories
  - Department Store
  - Electronics
  - E-commerce
  - Gifts
  - Office Supplies
  - Pet Supplies
  - Auto Tax & Fees
  - Donation
  - Government Fees
  - Income Tax
  - Real Estate Tax & Fees
  - Tax Return
  - Accommodation
  - Auto Expenses
  - Auto Rental
  - Flights
  - Gas
  - Mileage Programs
  - Parking & Tolls
  - Public Transit
  - Taxis & Rideshares
  - Other
  - null
    Enum: "Electricity & Energy", "Rent", "Telecommunications", "Water", "Auto", "Credit Card", "Instalment", "Interest & Charges", "Mortgage", "Pay Advance", "Personal", "Adjustments", "Bank Fees", "Chargeback", "Refund", "Blocked Balances", "Alimony", "Alcohol & Tobacco", "Bakery & Coffee", "Bars & Nightclubs", "Convenience Store", "Delivery", "Groceries", "Restaurants", "Education", "Gyms & Fitness", "Hair & Beauty", "Health", "Home Decor & Appliances", "Laundry & Dry Cleaning", "Pharmacies", "Professional Services", "Veterinary Services", "Freelance", "Interest", "Retirement", "Salary", "Government", "Home Insurance", "Auto Insurance", "Health & Life Insurance", "Savings", "Fixed income", "Equity", "Investment Funds", "Derivatives", "Cryptocurrencies", "Apps, Software and Cloud Services", "Events, Parks and Museums", "Gambling", "Gaming", "Lottery", "Movie & Audio", "Books & News", "Clothing & Accessories", "Department Store", "Electronics", "E-commerce", "Gifts", "Office Supplies", "Pet Supplies", "Auto Tax & Fees", "Donation", "Government Fees", "Income Tax", "Real Estate Tax & Fees", "Tax Return", "Accommodation", "Auto Expenses", "Auto Rental", "Flights", "Gas", "Mileage Programs", "Parking & Tolls", "Public Transit", "Taxis & Rideshares", "Other", null

  - `results.reference` (string,null, required)
    Nota: Este campo no es aplicable para OF Brazil y devolverá null.

  - `results.type` (string,null, required)
    La dirección de la transacción:
- INFLOW indica dinero que entra en la cuenta.
- OUTFLOW indica dinero que sale de la cuenta.
- null cuando no hay información presente sobre la dirección de la transacción.
    Enum: "OUTFLOW", "INFLOW", null

  - `results.status` (string,null, required)
    El estado de la transacción. Devolvemos uno de los siguientes valores:

  - PROCESSED (La transacción ha sido procesada por la institución.)
  - PENDING (La institución indica claramente que la transacción aún no ha sido procesada.)
  - UNCATEGORIZED (obsoleto)
  - null (obsoleto)
    Enum: "PENDING", "PROCESSED", "UNCATEGORIZED", null

  - `results.credit_card_data` (object,null, required)
    Datos adicionales proporcionados por la institución para transacciones con tarjeta de crédito.

  - `results.credit_card_data.collected_at` (string, required)
    La marca de tiempo ISO-8601 cuando se recopiló el punto de datos.
    Example: "2022-02-09T08:45:50.406032Z"

  - `results.credit_card_data.bill_name` (string,null, required)
    El título de la factura mensual de la tarjeta de crédito a la que pertenece la transacción. El formato del valor devuelto es específico de la institución; sin embargo, algunos ejemplos comunes son:

- diciembre-2021
- dec-2021
- dec-21

> Nota: Este campo solo se devuelve para facturas 'cerradas' (lo que significa que el período de facturación ha terminado y la factura ha sido emitida). Si el período de facturación aún está en curso, devolvemos null.
    Example: "apr-2020"

  - `results.credit_card_data.bill_due_date` (string,null)
    La fecha en que se debe pagar la factura, en formato YYYY-MM-DD.

> Nota: Este campo solo se devuelve para facturas 'cerradas' (lo que significa que el período de facturación ha terminado y la factura ha sido emitida). Si el período de facturación aún está en curso, devolvemos null.
    Example: "2023-06-17"

  - `results.credit_card_data.bill_internal_identification` (string,null)
    El identificador interno de la institución para la factura.

> Nota: Este campo solo se devuelve para facturas 'cerradas' (lo que significa que el período de facturación ha terminado y la factura ha sido emitida). Si el período de facturación aún está en curso, devolvemos null.
    Example: "927921260199292792126508222219893192525A6"

  - `results.credit_card_data.bill_status` (string,null, required)
    Nota: Este campo no es aplicable para OFDA Brasil y devolverá null.

  - `results.credit_card_data.previous_bill_total` (string,null, required)
    Nota: Este campo no es aplicable para OFDA Brasil y devolverá null.

  - `results.credit_card_data.bill_amount` (number,null, required)
    El monto de la factura, a partir de collected_at. Para más información, consulta credit_card_bill.
    Example: 300

  - `results.credit_card_data.card_number` (string, required)
    El número de la tarjeta de crédito.

Nota: A menudo, esto es solo los últimos cuatro dígitos de la tarjeta de crédito.

> No anulable: La red de finanzas abiertas de Brasil debe devolver un valor.
    Example: "4453"

  - `results.credit_card_data.fee_type` (string,null, required)
    La tarifa que se puede cobrar por una transacción con tarjeta. Devolvemos uno de los siguientes valores:

  - ANNUAL_FEE
  - NATIONAL_WITHDRAWAL
  - INTERNATIONAL_WITHDRAWAL
  - EMERGENCY_CREDIT_EVALUATION_FEE
  - DUPLICATE_ISSUANCE_FEE
  - PAYMENT_FEE
  - SMS_FEE
  - OTHERS
  - null
    Enum: "ANNUAL_FEE", "NATIONAL_WITHDRAWAL", "INTERNATIONAL_WITHDRAWAL", "EMERGENCY_CREDIT_EVALUATION_FEE", "DUPLICATE_ISSUANCE_FEE", "PAYMENT_FEE", "SMS_FEE", "OTHERS", null

  - `results.credit_card_data.fee_type_additional_info` (string,null, required)
    Información adicional sobre la tarifa.
    Example: "ATM withdrawal in Curitiba."

  - `results.credit_card_data.credits_type` (string,null, required)
    Otros tipos de crédito que se han contratado en la tarjeta. Devolvemos uno de los siguientes valores:

  - REVOLVING_CREDIT
  - BILL_INSTALLMENT_PAYMENT
  - LOAN
  - OTHERS
  - null
    Enum: "REVOLVING_CREDIT", "BILL_INSTALLMENT_PAYMENT", "LOAN", "OTHERS", null

  - `results.credit_card_data.credits_type_additional_info` (string,null, required)
    Información adicional sobre el tipo de crédito.
    Example: "Some additional information."

  - `results.credit_card_data.installment_identifier` (string, required)
    Un identificador para la cuota, según la institución.

> No anulable: La red de finanzas abiertas de Brasil debe devolver un valor.
    Example: "PARCELA_896"

  - `results.credit_card_data.number_of_installments` (integer,null, required)
    El número total de cuotas para la transacción con tarjeta, si corresponde.
    Example: 4

  - `results.credit_card_data.credit_card_bill` (object,null)
    Información sobre la factura en la que aparece esta transacción.

  - `results.credit_card_data.credit_card_bill.id` (string)
    El identificador único creado por Belvo utilizado para referenciar la factura actual de la tarjeta de crédito.

> Nota: Este campo solo se devuelve para facturas 'closed' (lo que significa que el período de facturación ha terminado y la factura ha sido emitida). Si el período de facturación aún está en curso, devolvemos null.
    Example: "8e9d13c2-af41-4a49-b43e-2da012bd1d11"

  - `results.credit_card_data.credit_card_bill.internal_identification` (string,null)
    El identificador interno de la institución para la factura.

> Nota: Este campo solo se devuelve para facturas 'cerradas' (lo que significa que el período de facturación ha terminado y la factura ha sido emitida). Si el período de facturación aún está en curso, devolvemos null.
    Example: "92792126019929279212650822221989319252576"

  - `results.counterparty` (object,null, required)
    Información sobre la otra parte de esta transacción, si está disponible.

  - `results.counterparty.type` (string,null, required)
    El tipo de contraparte de la transacción. Devolvemos uno de los siguientes valores:

  - INDIVIDUAL
  - COMPANY
  - null
    Enum: "INDIVIDUAL", "COMPANY", null

  - `results.counterparty.document_number` (string,null, required)
    El número de documento del representante.

Nota:

Para Brasil:
  - Cuando el type es INDIVIDUAL, este es el número de CPF.
  - Cuando el type es COMPANY, este es el número de CNPJ.
    Example: "73677831148"

  - `results.counterparty.clearing_code` (string,null, required)
    El código de compensación bancaria.
    Example: "001"

  - `results.counterparty.agency` (string,null, required)
    El código de sucursal donde se abrió la cuenta.
    Example: "6272"

  - `results.counterparty.check_digit` (string,null, required)
    El dígito de control del número de cuenta, si corresponde.
    Example: "7"

  - `results.counterparty.number` (string,null, required)
    El número de cuenta del producto.
    Example: "24550245"

  - `results.loan_data` (object,null, required)
    Información sobre los datos transaccionales del préstamo, si corresponde.

  - `results.loan_data.is_detached` (boolean, required)
    Boolean para indicar si este pago de préstamo fue parte del calendario de pagos original.

> No anulable: La red de finanzas abiertas de Brasil debe devolver un valor.
    Example: true

  - `results.loan_data.installment_id` (string,null, required)
    El ID único de la institución para esta cuota de pago.
    Example: "WGx0aExYcEJMVm93TFRsZFcyRXRla0V0V2pBdE9Wd3RYWH"

  - `results.loan_data.fees` (array, required)
    Detalles relacionados con las tarifas asociadas con este pago. Solo aplicable cuando is_detached = true.

  - `results.loan_data.fees.name` (string, required)
    El nombre de la tarifa.

> No anulable: Se debe devolver un valor por la red de finanzas abiertas de Brasil cuando el campo fees está presente.
    Example: "Reavaliação periódica do bem"

  - `results.loan_data.fees.code` (string, required)
    El código de la institución para la tarifa.

> No anulable: Se debe devolver un valor por la red de finanzas abiertas de Brasil cuando el campo fees está presente.
    Example: "aval_bem"

  - `results.loan_data.fees.amount` (number,null, required)
    El monto de la tarifa.

> No anulable: Se debe devolver un valor por la red de finanzas abiertas de Brasil cuando el campo fees está presente.
    Example: 8903.77

  - `results.loan_data.charges` (array, required)
    Detalles relacionados con los cargos asociados con este pago. Solo aplicable cuando is_detached = true.

  - `results.loan_data.charges.type` (string, required)
    El tipo de cargo.

> No anulable: Se debe devolver un valor por la red de finanzas abiertas de Brasil cuando el campo charges está presente.
    Example: "MULTA_ATRASO_PAGAMENTO"

  - `results.loan_data.charges.info` (string, required)
    Información adicional sobre el type de cargo.
    Example: "Late payment charge."

  - `results.loan_data.charges.amount` (number, required)
    El monto del cargo.

> No anulable: La red de finanzas abiertas de Brasil debe devolver un valor cuando el campo charges está presente.
    Example: 8903.77

  - `results.payment_type` (string,null, required)
    El tipo de pago de la transacción. Devolvemos uno de los siguientes valores:

  - FULL
  - INSTALLMENT
  - null
    Enum: "FULL", "INSTALLMENT", null

  - `results.operation_type` (string, required)
    El tipo de transacción. Por ejemplo, un pago PIX o un depósito.

> No anulable: La red de finanzas abiertas de Brasil debe devolver un valor para transacciones de cuentas que no sean de préstamo.
    Example: "TRANSFERENCIA_MESMA_INSTITUICAO"

  - `results.operation_type_additional_info` (string,null, required)
    Información adicional sobre el operation_type, si corresponde.
    Example: "Internal transfer."

  - `results.mcc` (integer,null, required)
    El código de categoría de comerciante (MCC) de cuatro dígitos (compatible con ISO-18245) para la transacción. Este campo solo es aplicable para transacciones con tarjeta de crédito.
    Example: 5137

## Response 403 fields (application/json):

  - `code` (string)
    Un código de error único (access_to_resource_denied) que te permite clasificar y manejar el error de manera programática.

ℹ️ Consulta nuestro DevPortal para obtener más información sobre cómo manejar 403 access_to_resource_denied.
    Example: "access_to_resource_denied"

  - `message` (string)
    Una breve descripción del error.

Para los errores access_to_resource_denied, la descripción es:

  - You don't have access to this resource..
    Example: "You don't have access to this resource."

  - `request_id` (string)
    Un ID único de 32 caracteres de la solicitud (que coincide con un patrón regex de: [a-f0-9]{32}). Proporcione este ID al contactar al equipo de soporte de Belvo para acelerar las investigaciones.
    Example: "9e7b283c6efa449c9c028a16b5c249fb"

## Response 404 fields (application/json):

  - `code` (string)
    Un código de error único (not_found) que te permite clasificar y manejar el error de manera programática.
    Example: "not_found"

  - `message` (string)
    Una breve descripción del error.

Para errores not_found, la descripción es:

  - Not found
    Example: "Not found"

  - `request_id` (string)
    Un ID único de 32 caracteres de la solicitud (que coincide con un patrón regex de: [a-f0-9]{32}). Proporcione este ID al contactar al equipo de soporte de Belvo para acelerar las investigaciones.
    Example: "9e7b283c6efa449c9c028a16b5c249fb"

## Response 408 fields (application/json):

  - `code` (string)
    Un código de error único (request_timeout) que te permite clasificar y manejar el error de manera programática.

ℹ️ Consulta nuestro DevPortal para obtener más información sobre cómo manejar errores 408 request_timeout.
    Example: "request_timeout"

  - `message` (string)
    Una breve descripción del error.

Para los errores de request_timeout, la descripción es:

  - The request timed out, you can retry asking for less data by changing your query parameters.
    Example: "The request timed out, you can retry asking for less data by changing your query parameters"

  - `request_id` (string)
    Un ID único de 32 caracteres de la solicitud (que coincide con un patrón regex de: [a-f0-9]{32}). Proporcione este ID al contactar al equipo de soporte de Belvo para acelerar las investigaciones.
    Example: "9e7b283c6efa449c9c028a16b5c249fb"

## Response 428 fields (application/json):

  - `code` (string)
    Un código de error único (token_required) que te permite clasificar y manejar el error de forma programática. ℹ️ Consulta nuestro DevPortal para obtener más información sobre cómo manejar errores 428 token_required.
    Example: "token_required"

  - `message` (string)
    Una breve descripción del error. 
Para los errores token_required, la descripción es:

  - A MFA token is required by the institution to login.
    Example: "A MFA token is required by the institution to login"

  - `request_id` (string)
    Un ID único de 32 caracteres de la solicitud (que coincide con un patrón regex de: [a-f0-9]{32}). Proporcione este ID al contactar al equipo de soporte de Belvo para acelerar las investigaciones.
    Example: "9e7b283c6efa449c9c028a16b5c249fb"

  - `session` (string)
    Un ID único de 32 caracteres de la sesión de inicio de sesión (que coincide con un patrón de regex de: [a-f0-9]{32}).
    Example: "2675b703b9d4451f8d4861a3eee54449"

  - `expiry` (integer)
    Tiempo de duración de la sesión en segundos.
    Example: 9600

  - `link` (string)
    Identificador único creado por Belvo, utilizado para referenciar el Link actual.
    Example: "30cb4806-6e00-48a4-91c9-ca55968576c8"

  - `token_generation_data` (object)
    Detalles sobre cómo generar el token.

  - `token_generation_data.instructions` (string)
    Instrucciones para la generación de tokens.
    Example: "Use this code to generate the token"

  - `token_generation_data.type` (string)
    Tipo de datos para generar el token (código QR, desafío numérico).
    Example: "numeric"

  - `token_generation_data.value` (string)
    Valor a utilizar para generar el token.
    Example: "12345"

  - `token_generation_data.expects_user_input` (boolean)
    Indica si el usuario necesita proporcionar información para completar la autenticación. Cuando se establece en false, es posible que su usuario necesite:
- confirmar el inicio de sesión en otro dispositivo
- escanear un código QR
Aún necesitará realizar una llamada PATCH para completar la solicitud.
    Example: true

## Response 500 fields (application/json):

  - `code` (string)
    Un código de error único (unexpected_error) que te permite clasificar y manejar el error de manera programática.

ℹ️ Consulta nuestro DevPortal para obtener más información sobre cómo manejar errores 500 unexpected_error.
    Example: "unexpected_error"

  - `message` (string)
    Una breve descripción del error.

Para los errores unexpected_error, la descripción es:

- Belvo no puede procesar la solicitud debido a un problema interno del sistema o a una respuesta no soportada de una institución.
    Example: "Belvo is unable to process the request due to an internal system issue or to an unsupported response from an institution"

  - `request_id` (string)
    Un ID único de 32 caracteres de la solicitud (que coincide con un patrón regex de: [a-f0-9]{32}). Proporcione este ID al contactar al equipo de soporte de Belvo para acelerar las investigaciones.
    Example: "9e7b283c6efa449c9c028a16b5c249fb"