Limites de Recuperação de Dados da OFDA Brasil

Introdução

A Rede de Open Finance do Brasil estabelece limites mensais sobre a frequência com que você pode recuperar dados para uma pessoa ou empresa específica. Esses limites operacionais estão vinculados a uma combinação de:

o CPF ou CNPJ do usuário
os dados da API que você deseja obter (Owner, Account, Transaction ou Bill)
o certificado da rede Open Finance

Uma vez atingido o limite operacional mensal de chamadas de API, nenhuma informação adicional pode ser recuperada para o CPF/CNPJ até o início do próximo mês calendário. No entanto, a Belvo implementou otimizações para maximizar a quantidade de dados que você pode recuperar para seus usuários de acordo com suas necessidades de dados.

Os limites estão descritos na tabela abaixo:

Recurso da API da Belvo (chamadas POST)	Limite de Operação do Open Finance
Owners	4 recuperações por CPF/CNPJ
Accounts	4 chamadas de recuperação por CPF/CNPJ Nota: As informações de saldo e limite de cheque especial podem ser atualizadas até 240 vezes por CPF/CNPJ
Transactions	Dependendo do período solicitado: Até 365 dias a partir do momento da solicitação: 4 recuperações por CPF/CNPJ Menos de 6 dias a partir do momento da solicitação: 240 recuperações por CPF/CNPJ

Fluxo de trabalho assíncrono (links únicos)

Necessidade de frequência de dados: Baixa
Você só precisa recuperar informações históricas uma vez (ou uma vez por semana). Por exemplo, credores de crédito ou verificação de ID.

Quando você cria um link único usando nosso fluxo de trabalho assíncrono (que usa nosso parâmetro fetch_resources), a Belvo recuperará de forma assíncrona as informações históricas para o seu usuário (até 365 dias). Após receber a notificação do webhook de que os dados históricos estão disponíveis, você pode recuperá-los usando chamadas GET.

Para quaisquer chamadas POST subsequentes que você fizer após a criação do link, as informações que você recupera dependerão do recurso da API (veja a tabela abaixo).

Recurso da API Belvo	Informação atualizada em cada chamada POST	Frequência recomendada
Accounts	Saldos, limites de cheque especial e limites de cartão de crédito	Diária ou semanal
Owners	Detalhes pessoais do usuário	Mensal
Transactions	Transações nos últimos seis dias.	Semanal

Evite links duplicados

Para cada link que você cria, um novo consentimento é gerado na rede Open Finance do Brasil e a Belvo recupera dados históricos para aquele CPF/CNPJ, consumindo os limites operacionais.

Fluxo de trabalho assíncrono (links recorrentes)

Necessidade de frequência de dados: Alta
Você precisa de informações de saldo, cheque especial e transações diariamente. Por exemplo, PFMs ou ERPs.

Quando você cria um link recorrente, a Belvo recuperará assincronamente as informações históricas para o seu usuário (até 365 dias). Após receber a notificação do webhook de que os dados históricos estão disponíveis, você pode recuperá-los usando chamadas GET como de costume. Dependendo da sua taxa de atualização, você receberá webhooks indicando se uma nova conta, proprietário ou transação foi recuperada da instituição, que você também pode recuperar usando chamadas GET.

Qualquer chamada POST individual que você fizer recuperará as seguintes informações:

Recurso da API Belvo	Informação atualizada em cada chamada POST	Frequência recomendada
Contas	Saldos, limites de cheque especial e limites de cartão de crédito	Diária ou semanal
Proprietários	Detalhes pessoais do usuário	Mensal
Transações	Transações nos últimos seis dias.	Semanal

Links únicos

Necessidade de frequência de dados: Muito baixa
Você só precisa recuperar informações históricas uma vez. Por exemplo, análise de crédito pontual.

Quando você cria um link único sem dados históricos, será necessário fazer chamadas POST individuais para recuperar dados para seu usuário.

Recurso da API Belvo	Informação atualizada na primeira chamada POST
Accounts	Informação histórica da conta
Owners	Detalhes históricos do proprietário
Transactions	Até 365 dias de dados transacionais

Qualquer chamada POST individual subsequente que você fizer irá recuperar as seguintes informações:

Recurso da API Belvo	Informação atualizada em cada chamada POST	Frequência recomendada
Accounts	Saldos, limites de cheque especial e limites de cartão de crédito	Diária ou semanal
Owners	Detalhes pessoais do usuário	Mensal
Transactions	Transações nos últimos seis dias.	Semanal

Dadas as limitações, é possível que os dados de conta e proprietário de um link recorrente não sejam atualizados durante um mês inteiro?

Sim, na situação em que o limite operacional foi atingido para um CPF/CNPJ, o link recorrente não será atualizado (e novas contas ou proprietários não serão identificados). Isso pode ocorrer por três razões:

O usuário criou um link quatro vezes dentro do mês.
Clientes que não utilizam fluxos de trabalho assíncronos esgotaram os limites operacionais para o CPF/CNPJ usando chamadas POST.

Informações sobre saldo de conta e limites de cheque especial têm um limite mais alto (mínimo de 240 chamadas de API). Assim, essas informações serão atualizadas para contas existentes até que o limite para esses recursos seja atingido.

Ainda recebo webhooks de transações para atualizações diárias ou semanais?

Sim, como os limites para informações transacionais nos últimos seis dias são maiores (240 solicitações), você ainda receberá webhooks para novas transações que ocorrerem.

Que erro de API receberei quando o limite for atingido?

Quando o limite for atingido, você receberá um erro HTTP 400 (operational_limits_reached), indicando que o Belvo não pôde recuperar informações para o link devido aos limites terem sido atingidos.

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

Meu usuário saberá que atingiu o limite ao criar seu link?

Como as chamadas da API ocorrem após o usuário ter criado seu link, ele não receberá nenhum erro que indique que o aplicativo ao qual está concedendo consentimento não poderá recuperar dados.