# Listar facturas ## ▶️ Uso Con el método List Bills, puedes: 1. Listar facturas relacionadas con un link.id específico (usando el parámetro de consulta ). 2. Filtrar las facturas devueltas usando parámetros de consulta (ver la sección de Filtrado de respuestas a continuación). 3. Obtener los detalles de una factura específica usando el parámetro de consulta . ## 📖 Paginación Este método devuelve una respuesta paginada (por defecto: 100 elementos por página). Puedes usar el parámetro de consulta para aumentar el número de elementos devueltos hasta un máximo de 1000 elementos. Puedes usar el parámetro de consulta 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 los campos por los que puedes filtrar tus respuestas. Para más información sobre cómo usar filtros, consulta nuestro artículo Filtrado de respuestas. Endpoint: GET /api/bills/ Version: 1.223.0 Security: basicAuth ## Query parameters: - `link` (string, required) El 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. - `id` (string) Devuelve información solo para este recurso . Example: "24ccab1d-3a86-4136-a6eb-e04bf52b356f" - `id__in` (array) Devuelve información para estos s de recursos. Example: ["6b3dea0f-be29-49d1-aabe-1a6d588642e6"] - `account` (string) El por el que deseas filtrar. ℹ️ Recomendamos encarecidamente agregar filtros de o para mejorar tu rendimiento. Example: "8848bd0c-9c7e-4f53-a732-ec896b11d4c4" - `account__in` (array) Devuelve resultados solo para estos s. Example: ["85b77707-90ef-46fd-9059-5a757f24247a"] - `due_date` (string) Devolver elementos que tienen una en esta fecha (). Example: "2022-05-01" - `due_date__gt` (string) Devolver elementos que tengan una posterior a esta fecha (). Example: "2022-05-05" - `due_date__gte` (string) Devolver elementos que tengan una en o después de esta fecha (). Example: "2022-05-05" - `due_date__lt` (string) Devolver elementos que tengan una anterior a esta fecha (). Example: "2022-05-05" - `due_date__lte` (string) Devolver elementos que tengan una anterior o en esta fecha (). Example: "2022-05-05" - `due_date__range` (array) Devolver elementos que tienen una entre dos fechas (). Example: ["2022-05-04"] - `collected_at__gt` (string) Devuelve los elementos que fueron recuperados de la institución después de esta fecha ( o marca de tiempo completa en formato ). 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 ( o marca de tiempo completa ). Example: "2022-05-04" - `collected_at__lt` (string) Devolver los elementos que fueron recuperados de la institución antes de esta fecha ( o marca de tiempo completa ). Example: "2022-04-01" - `collected_at__lte` (string) Devuelve los elementos que fueron recuperados de la institución en o antes de esta fecha ( o marca de tiempo completa ). Example: "2022-03-30" - `collected_at__range` (array) Devolver los elementos que fueron recuperados de la institución entre dos fechas ( o una marca de tiempo completa en formato ). Example: ["2022-05-04"] - `created_at` (string) Devuelve los elementos que se actualizaron por última vez en la base de datos de Belvo en esta fecha (en formato ). 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 ). 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 ). 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 ). 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 ). 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 ). Example: ["2022-03-03"] ## 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 . En nuestro ejemplo de documentación, usamos 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, o ). 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 . - `results` (array) Un array de objetos Bill. - `results.id` (string) Identificador único de Belvo para el elemento actual. Example: "0d3ffb69-f83b-456e-ad8e-208d0998d71d" - `results.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" - `results.collected_at` (string) La marca de tiempo ISO-8601 cuando se recopiló el punto de datos. Example: "2022-02-09T08:45:50.406032Z" - `results.account` (object,null) Detalles sobre la cuenta. - `results.account.link` (string,null, required) El 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: - - - Enum: "bank", "fiscal", "employment" - `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: - - - - - - - - - - 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 o un . Puedes considerar el saldo de un como positivo, mientras que el saldo de un 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. > Se debe devolver un valor por la red de finanzas abiertas de Brasil si el campo está disponible. Example: 5000.5 - `results.account.overdraft.used` (number, required) El valor del sobregiro utilizado. > La red de finanzas abiertas de Brasil debe devolver un valor si el campo 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. > Se debe devolver un valor por la red de finanzas abiertas de Brasil si el campo está disponible. Example: 300.1 - `results.account.type` (string, required) El tipo de cuenta, según lo designado por la institución. > 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. > 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. - : El saldo de la cuenta del usuario en el momento del timestamp . - : La cantidad que el usuario ha gastado en el período de facturación actual de la tarjeta (consulte para obtener información sobre cuándo finaliza el período de facturación actual). - : 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. - : El saldo disponible puede ser diferente al saldo debido a transacciones pendientes. - : El monto de crédito que el usuario aún tiene disponible para el período actual. El monto se calcula como menos . - : El valor presente requerido para liquidar el préstamo, según lo proporcionado por la institución. Si la institución no proporciona este valor, devolvemos . Example: 5621.12 - `results.account.balance.blocked` (number) La cantidad que está actualmente bloqueada debido a transacciones pendientes. > Se debe devolver un valor por la red de finanzas abiertas de Brasil si el campo 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). > Se debe devolver un valor por la red de finanzas abiertas de Brasil si el campo está disponible. Example: 131.5 - `results.account.currency` (string, required) El código de moneda de tres letras (ISO-4217). > Se debe devolver un valor por la red de finanzas abiertas de Brasil si el campo 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á . Example: "AGENCY/ACCOUNT" - `results.account.public_identification_value` (string,null, required) El valor para el . 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: . 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. > Se debe devolver un valor por la red de finanzas abiertas de Brasil si el campo 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.credit_limit` (number,null, required) El límite de crédito superior de la tarjeta. > 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. A menudo, esto es solo los últimos cuatro dígitos de la tarjeta de crédito. > 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. > 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 es flexible. > 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: - - > 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. > 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: - - - - - - - - - > 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. > La red de finanzas abiertas de Brasil debe devolver un valor. - `results.account.credit_data.next_payment_date` (string,null) Este campo no es aplicable para OF Brazil y devolverá null. - `results.account.credit_data.no_interest_payment` (number,null) Este campo no es aplicable para OF Brazil y devolverá null. - `results.account.credit_data.interest_rate` (number,null) Este campo no es aplicable para OF Brazil y devolverá null. - `results.account.credit_data.monthly_payment` (number,null) Este campo no es aplicable para OF Brazil y devolverá null. - `results.account.credit_data.last_payment_date` (string,null) 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.loan_code` (string, required) El número de contrato estandarizado específico del país. > 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. > 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 para obtener información detallada. > 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. Para OFDA Brasil, recomendamos usar el parámetro . 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. > 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). Para OFDA Brasil, recomendamos usar el parámetro y . 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: - - > 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: - - > La red de finanzas abiertas de Brasil debe devolver un valor. Enum: "SIMPLE", "COMPOUND" - `results.account.loan_data.interest_rates.interest_rate_data.calculation_base` (string, required) El cálculo base para la tasa de interés. > 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: - - - - - - - > 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. > 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. > 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) 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. > Se debe devolver un valor por la red de finanzas abiertas de Brasil si el campo está disponible. Example: "Renovação de cadastro" - `results.account.loan_data.fees.code` (string, required) El código de tarifa. > Se debe devolver un valor por la red de finanzas abiertas de Brasil si el campo 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: - - > Se debe devolver un valor por la red de finanzas abiertas de Brasil si el campo 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: - - - - > Se debe devolver un valor por la red de finanzas abiertas de Brasil si el campo está disponible. Enum: "MINIMUM", "MAXIMUM", "FIXED", "PERCENTAGE" - `results.account.loan_data.fees.rate` (number,null, required) La tasa porcentual de la tarifa. Requerido cuando está configurado en . 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: - - - - - - - > Se debe devolver un valor por la red de finanzas abiertas de Brasil si el campo 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. > Se debe devolver un valor por la red de finanzas abiertas de Brasil si el campo 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. > Se debe devolver un valor por la red de finanzas abiertas de Brasil si el campo está disponible. Example: "CCR_CONVENIO_CREDITOS_RECIPROCOS" - `results.account.loan_data.collaterals.amount` (number, required) El monto total de la factura. > Se debe devolver un valor por la red de finanzas abiertas de Brasil si el campo 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 . 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: - - - - - - 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: - - - - - - - - - > 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 . 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 . 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 . 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 . > 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 . 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: - - - - - - Enum: "DAY", "WEEK", "MONTH", "YEAR", "NO_DEADLINE_REMAINING", null - `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. > 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 . 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.principal` (number,null, required) Este campo no es aplicable para OF Brazil y devolverá null. - `results.account.loan_data.payment_day` (string,null, required) Este campo no es aplicable para OF Brazil y devolverá null. - `results.account.loan_data.outstanding_principal` (number,null, required) Este campo no es aplicable para OF Brazil y devolverá null. - `results.account.loan_data.credit_limit` (number,null, required) Este campo no es aplicable para OF Brazil y devolverá null. - `results.account.loan_data.last_period_balance` (number,null, required) Este campo no es aplicable para OF Brazil y devolverá null. - `results.account.loan_data.limit_day` (string,null, required) Este campo no es aplicable para OF Brazil y devolverá null. - `results.account.loan_data.cutting_day` (string,null, required) Este campo no es aplicable para OF Brazil y devolverá null. - `results.account.loan_data.cutting_date` (string,null, required) Este campo no es aplicable para OF Brazil y devolverá null. - `results.account.funds_data` (string,null, required) Este campo no es aplicable para OF Brazil y devolverá null. - `results.internal_identification` (string,null) El identificador interno de la institución para la factura. Example: "92792126019929279212650822221989319252576" - `results.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 > : 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 . Example: "apr-2020" - `results.due_date` (string,null) La fecha en que se debe pagar la factura, en formato . Example: "2021-09-06" - `results.total_amount` (number,null) El monto total de la factura. Example: 45391.89 - `results.minimum_amount` (number,null) La cantidad mínima a pagar. Example: 391.89 - `results.is_installment` (boolean,null) Boolean para indicar si esta factura se puede pagar en cuotas. - `results.finance_charges` (array) - `results.finance_charges.type` (string,null) El tipo de cargo financiero aplicado a la factura. Devolvemos uno de los siguientes valores: - - - - - - - Enum: "LATE_PAYMENT_INTEREST", "LATE_FEE", "ARREARS_INTEREST", "IOF", "NO_CHARGE", "OTHER", null - `results.finance_charges.additional_info` (string,null) Información adicional sobre el cargo financiero. Example: "Paid 15 days late, fee applied." - `results.finance_charges.amount` (number,null) El monto del cargo financiero. Example: 91.89 - `results.payments` (array) - `results.payments.type` (string,null) El tipo de pago. Devolvemos uno de los siguientes valores: - - - - Enum: "INSTALLMENT", "FULL", "OTHER", null - `results.payments.payment_date` (string,null) La fecha en que se realizó el pago, en formato . Example: "2021-09-04" - `results.payments.payment_mode` (string,null) El método en el cual se realizó el pago. Devolvemos uno de los siguientes valores: - - - - - Enum: "DIRECT_DEBIT", "BANK_SLIP", "SALARY_DEDUCTION", "PIX", null - `results.payments.amount` (number,null) El monto del pago. Example: 500.15 ## Response 403 fields (application/json): - `code` (string) Un código de error único () 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 , la descripción es: - . 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: ). 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 () 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 , la descripción es: - Example: "Not found" - `request_id` (string) Un ID único de 32 caracteres de la solicitud (que coincide con un patrón regex de: ). 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 () 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 , la descripción es: - . 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: ). Proporcione este ID al contactar al equipo de soporte de Belvo para acelerar las investigaciones. Example: "9e7b283c6efa449c9c028a16b5c249fb" ## Response 500 fields (application/json): - `code` (string) Un código de error único () 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 , la descripción es: - . 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: ). Proporcione este ID al contactar al equipo de soporte de Belvo para acelerar las investigaciones. Example: "9e7b283c6efa449c9c028a16b5c249fb"