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

# Sincronitza ara: actualitza les dades bancàries sota demanda

> Demana les dades bancàries més recents d'una connexió amb una sola crida a Didit, espera el resultat i consulta el límit diari i la resposta 429.

La funció Sync Now de Didit llegeix les dades més recents d'una connexió al banc en qualsevol moment, amb una sola crida.
Les sincronitzacions en directe estan incloses en el preu mensual de la connexió: no es cobra res addicional.
L'única limitació és la del banc.

## La sincronització automàtica

* La primera sincronització s'executa quan la persona es connecta.
* Després, cada connexió contínua activa se sincronitza automàticament entre una i quatre vegades al dia, segons el banc. `sync.frequency_per_day` a la connexió indica quantes són, i `sync.next_sync_at`, quan està prevista la següent.
* Quan el banc permet més lectures al dia sense intervenció de la persona, sempre en queden almenys dues al dia reservades per a sincronitzacions en directe.
* Quan una sincronització emmagatzema canvis, arriba `bank.data.updated` i tu llegeixes el [feed de canvis](https://docs.didit.me/ca/standalone-apis/bank-transactions-sync.md) amb el teu cursor.
* Una sincronització que falla es reintenta amb retard progressiu. Després de 24 hores de fallades, la connexió es manté `active` amb `sync.status: failing`, i s'envia `bank.sync.failed`. Quan torna a funcionar, arriba `bank.sync.recovered`.
* Quan el banc demana a la persona que torni a iniciar sessió, la connexió passa a `renewal_required`.

## Sincronitza ara, en una sola crida

Afegeix `"wait": true` i una sola petició retorna dades actualitzades:

```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 }'
```

La capçalera `Prefer: wait=25` fa el mateix.
La crida espera fins a 25 segons:

| Resposta | Significat |
| - | - |
| `200` | La sincronització ha acabat. El cos és la sincronització amb el seu `outcome`, els recomptes per compte de `added`, `modified` i `removed`, i `balances_changed`. |
| `202` | El banc no ha respost en 25 segons, o no has demanat esperar. El cos conté el `sync_id`: llegeix la sincronització amb `get_sync_run`, o subscriu-te a `bank.sync.completed`. `bank.data.updated` arriba només quan la sincronització desa canvis. |

```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 }]
}
```

Si ja hi ha una sincronització en curs, obtens aquest mateix `sync_id`, no una segona tasca.
Després d'un `200` o d'un `bank.data.updated`, llegeix el canal de canvis amb el cursor que has desat.
Per llegir més tard què ha fet una sincronització, usa [`get_sync_run`](https://docs.didit.me/ca/standalone-apis/bank-sync-run-get).

## El preu

Les sincronitzacions automàtiques i les sincronitzacions en directe estan incloses en el preu mensual de la connexió. Consulta [preus](https://docs.didit.me/ca/getting-started/bank-verification-pricing.md).
Una sincronització en directe mai no suposa cap càrrec addicional.

## El límit diari del banc

Un banc limita amb quina freqüència es poden obtenir dades sense la presència de la persona.
Les normes europees permeten que un banc limiti l'accés desatès a quatre lectures al dia per compte.
Es tracta d'un sostre, no d'una promesa: un banc pot permetre-n'hi menys o acordar-ne més.

* Les sincronitzacions automàtiques i les en directe comparteixen un mateix pressupost, i la programació automàtica mai no utilitza les dues últimes lectures del dia.
* `sync.live_syncs_left_today` a la connexió indica quantes sincronitzacions en directe queden avui, i `sync.budgets[]` mostra cada grup: `scope` (`connection` o `account`), `resource`, `limit`, `remaining` i `resets_at`.
* Mentre la persona és present a Bank Link, per a una renovació o una reconnexió, les lectures no tenen límit.
* Quan s'ha esgotat el pressupost del dia, la crida respon amb `429 refresh_limit_reached`, amb una capçalera `Retry-After` (els segons que falten fins que el pressupost es reinicia) i un objecte `sync` amb `live_syncs_left_today` i `budgets`. Espera aquest temps i confia en la sincronització automàtica mentrestant.
* Els límits de la teva API són independents: 600 lectures i 300 escriptures per minut per aplicació, amb capçaleres `X-RateLimit-*`.

## Saber com d'actualitzades són les dades

* `sync.last_synced_at` a la connexió i a cada compte és el moment en què Didit va obtenir les dades del banc per última vegada, i no el moment en què tu les vas llegir per última vegada.
* Les dues lectures de transaccions retornen `X-Bank-Last-Synced-At`.

## Errors que has de gestionar

| Error | Significat | Què fer |
| - | - | - |
| `429 refresh_limit_reached` | El pressupost del banc s'ha esgotat. | Espera `Retry-After` i confia en la sincronització automàtica. |
| `409 connection_not_active` | La connexió no està `active`. | Comprova'n l'estat. |
| `409 consent_expired` | El consentiment ha caducat. | [Renova'l](https://docs.didit.me/ca/use-cases/renew-bank-consent.md). |

## Relacionats

* [Flux bancari continu per a la comptabilitat](https://docs.didit.me/ca/use-cases/bank-data-for-accounting.md)
* [Webhooks bancaris](https://docs.didit.me/ca/core-technology/bank-verification/webhooks.md)


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