> ## 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 pedido

> Peça dados bancários atualizados de uma ligação com um só pedido na Didit. Saiba o limite diário do banco e o que devolve o 429.

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

## A sincronização automática

* A primeira sincronização é executada quando a pessoa estabelece a ligação.
* Depois disso, cada ligação contínua ativa sincroniza automaticamente entre uma e quatro vezes por dia, consoante o banco. `sync.frequency_per_day` na ligação indica quantas, e `sync.next_sync_at` indica quando está prevista a seguinte.
* Quando o banco permite mais leituras automáticas por dia, pelo menos duas por dia ficam sempre reservadas para sincronizações em tempo real.
* Quando uma sincronização grava alterações, é enviado `bank.data.updated` e lê o [feed de alterações](https://docs.didit.me/pt/standalone-apis/bank-transactions-sync.md) com o seu cursor.
* Uma sincronização que falha é tentada novamente com um intervalo progressivo. Após 24 horas de falhas, a ligação mantém-se `active` com `sync.status: failing`, e é enviado `bank.sync.failed`. Quando volta a funcionar, é enviado `bank.sync.recovered`.
* Quando o banco pede à pessoa que volte a iniciar sessão, a ligação passa para `renewal_required`.

## Sincronizar agora, numa só chamada

Adicione `"wait": true` e um pedido devolve 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 até 25 segundos:

| Resposta | Significado |
| - | - |
| `200` | A sincronização terminou. O corpo contém a sincronização, com o respetivo `outcome`, as contagens por conta de `added`, `modified` e `removed`, e `balances_changed`. |
| `202` | O banco não respondeu em 25 segundos, ou não pediu para aguardar. O corpo tem o `sync_id`: leia a sincronização com `get_sync_run`, ou subscreva `bank.sync.completed`. O `bank.data.updated` segue-se apenas se a sincronização guardar 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 curso, 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 guardado.
Consulte mais tarde o que uma sincronização fez com [`get_sync_run`](https://docs.didit.me/pt/standalone-apis/bank-sync-run-get).

## O preço

As sincronizações automáticas e as sincronizações em tempo real estão ambas incluídas no preço mensal da ligação, ver [preços](https://docs.didit.me/pt/getting-started/bank-verification-pricing.md).
Uma sincronização em tempo real nunca acrescenta custos.

## O limite diário do banco

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

* As sincronizações automáticas e em tempo real partilham o mesmo orçamento, e o agendamento automático nunca utiliza as duas últimas leituras do dia.
* `sync.live_syncs_left_today` na ligação indica quantas sincronizações em tempo real restam hoje, e `sync.budgets[]` mostra cada bloco: `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 o orçamento do dia se esgota, a chamada responde com `429 refresh_limit_reached`, com um cabeçalho `Retry-After` (os segundos até ao orçamento ser reposto) e um objeto `sync` com `live_syncs_left_today` e `budgets`. Aguarde esse tempo e, entretanto, conte com a sincronização automática.
* Os limites da sua API são separados: 600 leituras e 300 escritas por minuto, por aplicação, com cabeçalhos `X-RateLimit-*`.

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

* `sync.last_synced_at` na ligação e em cada conta indica quando a Didit foi buscar os dados ao banco pela última vez, e não quando os leu pela última vez.
* Ambas as consultas de transações devolvem `X-Bank-Last-Synced-At`.

## Erros que deve tratar

| Erro | Significado | Ação |
| - | - | - |
| `429 refresh_limit_reached` | O orçamento do banco está esgotado. | Aguarde `Retry-After` e confie na sincronização automática. |
| `409 connection_not_active` | A ligação não está `active`. | Verifique o seu estado. |
| `409 consent_expired` | O consentimento terminou. | [Renove-o](https://docs.didit.me/pt/use-cases/renew-bank-consent.md). |

## Relacionados

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


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