> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# Sincronizar agora: atualizar dados bancários sob demanda

> Solicite os dados bancários mais recentes de uma conexão com uma chamada no Didit, aguarde o resultado e veja o limite diário e o retorno do 429.

O Sync Now lê os dados mais recentes de uma conexão no banco a qualquer momento, com uma única chamada.
As sincronizações em tempo real estão incluídas no preço mensal da conexão: nenhum valor extra é cobrado.
O único limite é o do banco.

## A sincronização automática

* A primeira sincronização é executada quando a pessoa se conecta.
* Depois disso, cada conexão ativa e contínua é sincronizada automaticamente entre uma e quatro vezes por dia, dependendo do banco. `sync.frequency_per_day` na conexão indica quantas, e `sync.next_sync_at` indica quando a próxima está prevista.
* Quando o banco permite mais leituras sem intervenção por dia, sempre restam pelo menos duas por dia para sincronizações ao vivo.
* Quando uma sincronização armazena alterações, `bank.data.updated` é enviado e você lê o [feed de alterações](https://docs.didit.me/pt-br/standalone-apis/bank-transactions-sync.md) usando seu cursor.
* Uma sincronização que falha é tentada novamente com backoff. Após 24 horas de falhas, a conexão permanece `active` com `sync.status: failing`, e `bank.sync.failed` é enviado. `bank.sync.recovered` é enviado quando ela volta a funcionar.
* Quando o banco pede que a pessoa entre novamente, a conexão passa para `renewal_required`.

## Sincronizar agora, em uma chamada

Adicione `"wait": true` e uma única requisição retorna dados atualizados:

```bash theme={null}
curl -X POST https://verification.didit.me/v3/bank/connections/$CONNECTION_ID/refresh/ \
  -H "x-api-key: $DIDIT_API_KEY" -H "content-type: application/json" \
  -d '{ "wait": true }'
```

O cabeçalho `Prefer: wait=25` faz o mesmo.
A chamada aguarda por até 25 segundos:

| Resposta | Significado |
| - | - |
| `200` | A sincronização terminou. O corpo traz a sincronização com seu `outcome`, as contagens de `added`, `modified` e `removed` por conta, e `balances_changed`. |
| `202` | O banco não respondeu em 25 segundos, ou você não pediu para aguardar. O corpo traz o `sync_id`: consulte a sincronização com `get_sync_run` ou assine o `bank.sync.completed`. O `bank.data.updated` só é enviado quando a sincronização armazena alterações. |

```json theme={null}
{
  "id": "d4a9e7b2-1c58-4f03-96ab-5e2d8c7f0b14",
  "trigger": "requested",
  "status": "succeeded",
  "outcome": "succeeded",
  "balances_changed": true,
  "results": [{ "resource": "transactions", "outcome": "succeeded", "added": 3, "modified": 0, "removed": 1 }]
}
```

Se uma sincronização já estiver em andamento, você recebe o mesmo `sync_id`, e não uma segunda tarefa.
Depois de um `200` ou de um `bank.data.updated`, leia o feed de alterações com o cursor que você armazenou.
Leia depois o que uma sincronização fez com [`get_sync_run`](https://docs.didit.me/pt-br/standalone-apis/bank-sync-run-get).

## Preço

As sincronizações automáticas e as sincronizações ao vivo estão incluídas no preço mensal da conexão. Veja [preços](https://docs.didit.me/pt-br/getting-started/bank-verification-pricing.md).
Uma sincronização ao vivo nunca gera cobrança extra.

## O limite diário do banco

Um banco limita a frequência com que os dados podem ser buscados sem a presença da pessoa.
As regras europeias permitem que um banco limite o acesso sem supervisão a quatro leituras por dia por conta.
Esse é um teto, não uma promessa: um banco pode permitir menos ou aceitar mais.

* As sincronizações automáticas e ao vivo compartilham a mesma cota, e a programação automática nunca usa as últimas duas leituras do dia.
* `sync.live_syncs_left_today` na conexão indica quantas sincronizações ao vivo restam hoje, e `sync.budgets[]` mostra cada cota: `scope` (`connection` ou `account`), `resource`, `limit`, `remaining` e `resets_at`.
* Enquanto a pessoa estiver presente no Bank Link, para uma renovação ou uma reconexão, as leituras não são limitadas.
* Quando a cota do dia se esgota, a chamada responde `429 refresh_limit_reached` com um cabeçalho `Retry-After` (os segundos até a cota ser reiniciada) e um objeto `sync` com `live_syncs_left_today` e `budgets`. Aguarde esse tempo e, nesse meio-tempo, conte com a sincronização automática.
* Os limites da sua API são separados: 600 leituras e 300 gravações por minuto por aplicação, com cabeçalhos `X-RateLimit-*`.

## Saiba o quão atualizados estão os dados

* `sync.last_synced_at` na conexão e em cada conta indica quando a Didit buscou dados pela última vez no banco, e não quando você os leu pela última vez.
* As duas leituras de transações retornam `X-Bank-Last-Synced-At`.

## Erros que você deve tratar

| Erro | Significado | O que fazer |
| - | - | - |
| `429 refresh_limit_reached` | A cota de atualizações do banco foi esgotada. | Aguarde o tempo indicado em `Retry-After` e conte com a sincronização automática. |
| `409 connection_not_active` | A conexão não está `active`. | Verifique o status da conexão. |
| `409 consent_expired` | O consentimento expirou. | [Renove-o](https://docs.didit.me/pt-br/use-cases/renew-bank-consent.md). |

## Relacionados

* [Feed bancário contínuo para contabilidade](https://docs.didit.me/pt-br/use-cases/bank-data-for-accounting.md)
* [Webhooks bancários](https://docs.didit.me/pt-br/core-technology/bank-verification/webhooks.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.