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 |
|---|---|
| Owners | 4 recuperaciones por CPF/CNPJ |
| Accounts | 4 llamadas de recuperación por CPF/CNPJ
|
| Transactions | Dependiendo del período de tiempo solicitado:
|
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 Belvo | Información actualizada en cada llamada POST | Frecuencia recomendada |
|---|---|---|
| Accounts | Saldos, límites de sobregiro y límites de tarjetas de crédito | Diario o semanal |
| Owners | Detalles personales del usuario | Mensual |
| Transactions | Transacciones dentro de los últimos seis días. | Semanal |
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 Belvo | Información actualizada en cada llamada POST | Frecuencia recomendada |
|---|---|---|
| Cuentas | Saldos, límites de sobregiro y límites de tarjetas de crédito | Diario o semanal |
| Propietarios | Detalles personales del usuario | Mensual |
| Transacciones | Transacciones 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 Belvo | Información actualizada en la primera llamada POST |
|---|---|
| Accounts | Información histórica de la cuenta |
| Owners | Detalles históricos del propietario |
| Transactions | Hasta 365 días de datos transaccionales |
Cualquier llamada POST individual posterior que realices recuperará la siguiente información:
| Recurso de la API de Belvo | Información actualizada en cada llamada POST | Frecuencia recomendada |
|---|---|---|
| Accounts | Saldos, límites de sobregiro y límites de tarjetas de crédito | Diario o semanal |
| Owners | Detalles personales del usuario | Mensual |
| Transactions | Transacciones 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:
- El usuario ha creado un enlace cuatro veces dentro del mes.
- 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.