# Recuperar facturas para un enlace

Recuperar facturas de una o más cuentas para un enlace específico dentro de un rango de fechas especificado.

Endpoint: POST /api/bills/
Version: 1.223.0
Security: basicAuth

## Query parameters:

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

## Request fields (application/json):

  - `link` (string, required)
    El link.id para el que deseas recuperar información.
    Example: "c81a1dea-6dd6-4999-8b9f-541ee8197058"

  - `save_data` (boolean)
    Indica si se debe o no persistir los datos en Belvo. Por defecto, esto está configurado en true y devolvemos una respuesta 201 Created.

Cuando se establece en false, los datos no se persistirán y devolvemos una respuesta 200 OK.
    Example: true

## Response 200 fields (application/json):

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

  - `created_at` (string)
    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"

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

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

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

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

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

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

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

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

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

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

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

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

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

  - `account.overdraft` (object,null)

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  - `account.credit_data.limits` (array)

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  - `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 `account.loan_data.interest_rates.type` (2 values)

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  - `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 `account.loan_data.installments_contract_term_frequency` (6 values)

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  - `internal_identification` (string,null)
    El identificador interno de la institución para la factura.
    Example: "92792126019929279212650822221989319252576"

  - `bill_name` (string,null)
    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"

  - `due_date` (string,null)
    La fecha en que se debe pagar la factura, en formato YYYY-MM-DD.
    Example: "2021-09-06"

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

  - `total_amount` (number,null)
    El monto total de la factura.
    Example: 45391.89

  - `minimum_amount` (number,null)
    La cantidad mínima a pagar.
    Example: 391.89

  - `is_installment` (boolean,null)
    Boolean para indicar si esta factura se puede pagar en cuotas.

  - `finance_charges` (array)

  - `finance_charges.type` (string,null)
    El tipo de cargo financiero aplicado a la factura. Devolvemos uno de los siguientes valores:

  - LATE_PAYMENT_INTEREST
  - LATE_FEE
  - ARREARS_INTEREST
  - IOF
  - NO_CHARGE
  - OTHER
  - null
    Enum: "LATE_PAYMENT_INTEREST", "LATE_FEE", "ARREARS_INTEREST", "IOF", "NO_CHARGE", "OTHER", null

  - `finance_charges.additional_info` (string,null)
    Información adicional sobre el cargo financiero.
    Example: "Paid 15 days late, fee applied."

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

  - `finance_charges.amount` (number,null)
    El monto del cargo financiero.
    Example: 91.89

  - `payments` (array)

  - `payments.type` (string,null)
    El tipo de pago. Devolvemos uno de los siguientes valores:

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

  - `payments.payment_date` (string,null)
    La fecha en que se realizó el pago, en formato YYYY-MM-DD.
    Example: "2021-09-04"

  - `payments.payment_mode` (string,null)
    El método en el cual se realizó el pago. Devolvemos uno de los siguientes valores:

  - DIRECT_DEBIT
  - BANK_SLIP
  - SALARY_DEDUCTION
  - PIX
  - null
    Enum: "DIRECT_DEBIT", "BANK_SLIP", "SALARY_DEDUCTION", "PIX", null

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

  - `payments.amount` (number,null)
    El monto del pago.
    Example: 500.15

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