Skip to content
Última actualización

Límites de Recuperación de Datos de OFDA Brasil

Introducción

La Red de Open Finance de Brasil establece límites mensuales sobre la frecuencia con la que puedes recuperar datos para una persona o empresa específica. Estos límites operativos están vinculados a una combinación de:

  • el CPF o CNPJ del usuario
  • los datos de la API que deseas obtener (Owner, Account, Transaction, o Bill)
  • el certificado de la red de Open Finance

Una vez que se alcanza el límite operativo mensual de llamadas a la API, no se puede recuperar más información para el CPF/CNPJ hasta el inicio del siguiente mes calendario. Sin embargo, Belvo ha implementado optimizaciones para maximizar la cantidad de datos que puedes recuperar para tus usuarios de acuerdo con tus necesidades de datos.

Los límites se describen en la tabla a continuación:

Recurso de la API de Belvo (llamadas POST)Límite de Operación de Open Finance
Owners4 recuperaciones por CPF/CNPJ
Accounts4 llamadas de recuperación por CPF/CNPJ
  • Nota: La información de saldo y límite de sobregiro se puede actualizar hasta 240 veces por CPF/CNPJ
TransactionsDependiendo del período de tiempo solicitado:
  • Hasta 365 días desde el momento de la solicitud: 4 recuperaciones por CPF/CNPJ
  • Menos de 6 días desde el momento de la solicitud: 240 recuperaciones por CPF/CNPJ

Flujo de trabajo asincrónico (enlaces únicos)

Necesidades de frecuencia de datos: Baja

Solo necesitas recuperar información histórica una vez (o una vez a la semana). Por ejemplo, prestamistas de crédito o verificación de identidad.

Cuando creas un enlace único utilizando nuestro flujo de trabajo asincrónico (que utiliza nuestro parámetro fetch_resources), Belvo recuperará asincrónicamente la información histórica para tu usuario (hasta 365 días). Después de recibir la notificación del webhook de que los datos históricos están disponibles, puedes recuperarlos utilizando llamadas GET.

Para cualquier llamada POST subsiguiente que realices después de la creación del enlace, la información que recuperes dependerá del recurso de la API (ver la tabla a continuación).

Recurso de la API de BelvoInformación actualizada en cada llamada POSTFrecuencia recomendada
AccountsSaldos, límites de sobregiro y límites de tarjetas de créditoDiario o semanal
OwnersDetalles personales del usuarioMensual
TransactionsTransacciones dentro de los últimos seis días.Semanal
Evita enlaces duplicados

Para cada enlace que crees, se genera un nuevo consentimiento en la red de Open Finance de Brasil y Belvo recupera datos históricos para ese CPF/CNPJ, consumiendo los límites operativos.

Flujo de trabajo asincrónico (enlaces recurrentes)

Necesidades de frecuencia de datos: Alta

Necesitas información de saldo, sobregiro y transacciones diariamente. Por ejemplo, PFMs o ERPs.

Cuando creas un enlace recurrente, Belvo recuperará de manera asincrónica la información histórica para tu usuario (hasta 365 días). Después de recibir la notificación del webhook de que los datos históricos están disponibles, puedes recuperarlos usando llamadas GET como de costumbre. Dependiendo de tu tasa de actualización, recibirás webhooks indicando si se ha recuperado una nueva cuenta, propietario o transacción de la institución, los cuales también puedes recuperar usando llamadas GET.

Cualquier llamada POST individual que realices recuperará la siguiente información:

Recurso de la API de BelvoInformación actualizada en cada llamada POSTFrecuencia recomendada
CuentasSaldos, límites de sobregiro y límites de tarjetas de créditoDiario o semanal
PropietariosDetalles personales del usuarioMensual
TransaccionesTransacciones dentro de los últimos seis días.Semanal

Enlaces únicos

Necesidades de frecuencia de datos: Muy baja

Solo necesitas recuperar información histórica una vez. Por ejemplo, un análisis de crédito único.

Cuando creas un enlace único sin datos históricos, necesitarás hacer llamadas POST individuales para recuperar datos para tu usuario.

Recurso de la API de BelvoInformación actualizada en la primera llamada POST
AccountsInformación histórica de la cuenta
OwnersDetalles históricos del propietario
TransactionsHasta 365 días de datos transaccionales

Cualquier llamada POST individual posterior que realices recuperará la siguiente información:

Recurso de la API de BelvoInformación actualizada en cada llamada POSTFrecuencia recomendada
AccountsSaldos, límites de sobregiro y límites de tarjetas de créditoDiario o semanal
OwnersDetalles personales del usuarioMensual
TransactionsTransacciones de los últimos seis días.Semanal

Dado los límites, ¿es posible que los datos de cuenta y propietario para un enlace recurrente no se actualicen durante todo un mes?

Sí, en la situación en la que se ha alcanzado el límite operativo para un CPF/CNPJ, el enlace recurrente no se actualizará (y no se identificarán nuevas cuentas o propietarios). Esto puede ocurrir por tres razones:

  1. El usuario ha creado un enlace cuatro veces dentro del mes.
  2. Los clientes que no utilizan flujos de trabajo asincrónicos han agotado los límites operativos para el CPF/CNPJ utilizando llamadas POST.

La información sobre el saldo de la cuenta y los límites de sobregiro tienen un límite más alto (mínimo de 240 llamadas API). Por lo tanto, esta información se actualizará para las cuentas existentes hasta que se haya alcanzado el límite para esos recursos.

¿Sigo recibiendo webhooks de transacciones para actualizaciones diarias o semanales?

Sí, como los límites para la información transaccional dentro de los últimos seis días son mayores (240 solicitudes), aún recibirás webhooks para nuevas transacciones que ocurran.

¿Qué error de API recibiré cuando se alcance el límite?

Cuando se alcance el límite, recibirás un error HTTP 400 (operational_limits_reached), indicando que Belvo no pudo recuperar información para el link debido a que se alcanzaron los límites.

[
  {
    "code": "operational_limits_reached",
    "message": "The institution has reached its operational limits",
    "request_id": "3e7b283c6efa449c9c028a16b5c249fd"
  }
]

¿Estará mi usuario al tanto de que ha alcanzado el límite al crear su enlace?

Como las llamadas a la API ocurren después de que el usuario ha creado su enlace, no recibirán ningún error que indique que la aplicación a la que están otorgando consentimiento no podrá recuperar datos.