Limites Operacionais de Taxa

Limites de Taxa do Open Finance#

Existem dois tipos de limites de taxa que o Pluggy utiliza para recuperar os dados, e o limite operacional de Open Finance das instituições financeiras.

A Rede Brasileira de Open Finance impõe limites de taxa sobre o número de vezes por mês que qualquer pessoa usando Open Finance pode buscar cada produto. Essa limitação não é do Pluggy; é a limitação para sincronizar os dados do Pluggy. Esses limites se aplicam por combinação de CPF/CNPJ, instituição e produto (ou seja, cartão, conta, investimento ou empréstimo).

O Pluggy gerencia os limites de taxa, para que você não precise se preocupar com isso.

Sob o uso normal dos Conectores de Open Finance (um CPF e instituição em apenas um item), você não precisará se preocupar com Limites de Taxa, já que você nunca os alcançaria, mesmo que tivesse atualizações automáticas habilitadas em todos os seus itens, atualizando até 4 vezes por dia.

Criando múltiplos itens para o mesmo CPF/CNPJ + Instituição

No entanto, tenha em mente que se você conectar o mesmo CPF/CNPJ à mesma instituição criando múltiplos itens, você atingirá a limitação de Open Finance mais rapidamente, o que significa que alguns produtos não estarão atualizando/retornando seus dados até que o limite seja renovado no próximo mês. Ao não usar um item, inicie a exclusão dele para evitar a sincronização automática.

Contas (Corrente e Poupança)#

* Cada Atualização significa que cada execução que o item faz.

Considerações

• Após 240 solicitações, novas transações não aparecerão até o próximo mês.
• Após 420 solicitações, o saldo da conta não será atualizado até o próximo mês.
• Em cada atualização, ambas as solicitações são consumidas, e atualmente, não é suportado apenas recuperar o saldo. Se necessário, crie uma conexão que recuperaria apenas o produto CONTAS, enviando no array products o produto desejado.

Cartões de Crédito#

* Cada Atualização significa que cada execução que o item faz.

Considerações

• Se um novo cartão de crédito aparecer como autorizado, pode levar até 7 dias para aparecer nas respostas.
• As transações de fatura do cartão de crédito (faturas fechadas e passadas) serão atualizadas diariamente.
• Os limites do cartão de crédito e novas transações serão sincronizados em cada atualização.
  • Após 240 atualizações, isso tem uma média de 8 atualizações por dia. Ele atingirá os limites de taxa e não atualizará transações até o próximo mês.

Investimentos#

* Cada Atualização significa que cada execução que o item faz.

Considerações

• Se um item for atualizado 120 vezes antes do final do mês, novas transações ou saldos não serão sincronizados até o dia 1 do próximo mês.
• Os detalhes recuperam a taxa do ativo, rateType, fixedAnnualRate, etc. Essa informação não deve mudar e é recuperada na criação. Se houver uma mudança por algum motivo, ela será refletida após 7 dias daquela atualização.
• Se um novo investimento foi adquirido, mas o limite de taxa já foi atingido, ele não aparecerá até o próximo mês.

Outros produtos#

• Empréstimos serão atualizados diariamente, se um item for atualizado mais de uma vez por dia, não sincronizará os dados do empréstimo.
• As informações de identidade são recuperadas na criação do item e sincronizarão atualizações a cada 7 dias. Se houver algum dado pessoal atualizado, não refletirá mudanças até que execute uma sincronização após 7 dias da sincronização inicial.

Entendendo um item que atingiu o limite de taxa#

Como o limite de taxa é retornado como um aviso?#

Quando um limite de taxa é atingido, você verá o Item no status PARTIAL_SUCCESS e dentro do detalhe do status, um aviso sobre o produto que falhou:

{
  "id": "44534b0e-717e-497d-890f-08c2faa468c1",
  "status": "PARTIAL_SUCCESS",
  "statusDetail": {
    "accounts": {
      "warnings": [
        {
          "code": "423",
          "message": "Limite de taxa mensal de Open Finance atingido no produto 'accounts' para este CPF/CNPJ e instituição. O produto não pôde ser atualizado."
        }
      ],
      "isUpdated": false,
      "lastUpdatedAt": "2023-10-19T19:19:58.188Z"
    }
  }
}