Mantendo Conexões Sincronizadas#
Quando você cria um Item, você terá uma referência aos dados financeiros do usuário, que inicialmente incluirá todos os dados da Instituição dos últimos 365 dias.
Para manter essas informações atualizadas, é possível Atualizar um Item, que sincronizará os dados da sua conexão armazenados no Pluggy com a Instituição Financeira até aquele momento. Cada Sincronização recuperará as informações transacionais da última data sincronizada (campo lastUpdatedAt do item), com uma janela de retrocesso que varia de acordo com o tipo de conector:
- Conectores diretos: 4 a 5 dias corridos desde a última sincronização. Essa janela mais ampla garante que transações postadas em finais de semana ou feriados bancários - que podem parecer atrasadas - sejam capturadas nos dias úteis seguintes.
- Conectores de Open Finance (regulados): 7 dias corridos incluindo hoje (hoje + os 6 dias anteriores), de acordo com as regras de reconciliação do ecossistema regulado de Open Finance.
Sincronizações Diárias
Para manter essas informações atualizadas, Pluggy sincronizará (Atualizar) seus dados diariamente de forma automática, você não precisará se preocupar em criar um processo em lote ou qualquer rotina para manter os dados atualizados.
Processos em lote são proibidos devido ao uso abusivo da API, o processo de sincronização é de responsabilidade e manutenção do Pluggy. Por favor, nos solicite qualquer personalização que você possa precisar para isso.
Se um usuário precisar de uma Atualização em tempo real, você pode acionar uma Atualização manual que começará naquele exato momento. Essa ação pode ser realizada de duas maneiras:
Atualizar o Item usando o Connect Widget do Pluggy#
Para atualizar um Item existente usando o Pluggy Connect, basta fornecer o ID do item através do campo de configuração itemId. Isso abrirá o widget em "Modo de Atualização", acionando as etapas necessárias para iniciar o processo de atualização.
O Pluggy Connect, como uma solução totalmente funcional, já cobre todas as especificidades e cenários potenciais relacionados aos diferentes fluxos de login de todos os conectores, casos especiais e mais. Isso inclui cenários como:
- Se o item não requer um parâmetro MFA, então o PluggyConnect apenas iniciará o processo de atualização e a coleta de dados prosseguirá.
- Se requer um parâmetro MFA, então o PluggyConnect solicitará ao usuário. Após o usuário resolver, o processo de atualização começará e a coleta de dados prosseguirá.
- Se o Item teve um erro de credenciais inválidas, então o PluggyConnect pedirá as credenciais primeiro.
Você pode testar e validar todos os cenários mencionados, e mais, usando nossas Contas de Teste em nossos Sandbox (Pluggy Bank) conectores.
Atualizar Item via API diretamente#
Se o item não requer um parâmetro MFA, e não tem um erro de credenciais inválidas, então é possível atualizá-lo diretamente via API, uma vez que não são necessárias mais ações do usuário.
Caso contrário, a atualização do Item resultará em um estado de espera (para a ação do usuário). Essa ação deve ser solicitada ao usuário na interface da sua Aplicação, da mesma forma que o PluggyConnect faz, e resolvê-la de acordo com as ações do usuário, e então passá-las de volta para a API do Pluggy.
Leia a documentação!
Confira nosso guia sobre Atualizando um Item, onde fornecemos mais detalhes e insights sobre esse processo.