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

# Sync Now: aggiorna i dati bancari on demand

> Richiedi in qualsiasi momento i dati bancari aggiornati con una chiamata a Didit: scopri il limite giornaliero e la risposta 429.

Il Sync Now di Didit legge in qualsiasi momento dalla banca i dati più recenti relativi a una connessione, con una sola chiamata.
Le sincronizzazioni in tempo reale sono incluse nel prezzo mensile della connessione: non viene addebitato nulla in più.
L'unico limite è quello della banca.

## La sincronizzazione automatica

* La prima sincronizzazione viene eseguita quando la persona si connette.
* Successivamente, ogni connessione continuativa attiva si sincronizza automaticamente da una a quattro volte al giorno, a seconda della banca. `sync.frequency_per_day` sulla connessione indica quante volte, e `sync.next_sync_at` indica quando è pianificata la successiva.
* Dove la banca consente più letture senza intervento dell'utente al giorno, almeno due al giorno restano sempre riservate alle sincronizzazioni in tempo reale.
* Quando una sincronizzazione salva delle modifiche, arriva `bank.data.updated` e tu leggi il [flusso delle modifiche](https://docs.didit.me/it/standalone-apis/bank-transactions-sync.md) con il tuo cursore.
* Una sincronizzazione non riuscita viene ritentata con backoff. Dopo 24 ore di errori la connessione resta `active` con `sync.status: failing`, e viene inviato `bank.sync.failed`. `bank.sync.recovered` arriva quando torna a funzionare.
* Quando la banca chiede alla persona di effettuare di nuovo l'accesso, la connessione passa a `renewal_required`.

## Sincronizza ora, con una sola chiamata

Aggiungi `"wait": true` e una richiesta restituisce dati aggiornati:

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

L'intestazione `Prefer: wait=25` fa lo stesso.
La chiamata attende fino a 25 secondi:

| Risposta | Significato |
| - | - |
| `200` | La sincronizzazione è terminata. Il corpo contiene la sincronizzazione con il suo `outcome`, i conteggi per account di `added`, `modified` e `removed`, e `balances_changed`. |
| `202` | La banca non ha risposto entro 25 secondi, oppure non hai chiesto di attendere. Il corpo contiene il `sync_id`: leggi la sincronizzazione con `get_sync_run`, oppure iscriviti a `bank.sync.completed`. `bank.data.updated` arriva solo se la sincronizzazione salva modifiche. |

```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 una sincronizzazione è già in corso, ottieni lo stesso `sync_id`, non un secondo job.
Dopo un `200` o un `bank.data.updated`, leggi il feed delle modifiche con il cursore memorizzato.
Per leggere in seguito cosa ha fatto una sincronizzazione, usa [`get_sync_run`](https://docs.didit.me/it/standalone-apis/bank-sync-run-get).

## Il prezzo

Le sincronizzazioni automatiche e quelle live sono entrambe incluse nel prezzo mensile della connessione, vedi [prezzi](https://docs.didit.me/it/getting-started/bank-verification-pricing.md).
Una sincronizzazione live non aggiunge mai costi.

## Il limite giornaliero della banca

Una banca limita la frequenza con cui i dati possono essere recuperati senza la presenza della persona.
Le norme europee consentono alla banca di limitare l'accesso non presidiato a quattro letture al giorno per account.
Si tratta di un tetto massimo, non di una garanzia: una banca può consentirne meno o accettarne di più.

* Le sincronizzazioni automatiche e quelle in tempo reale condividono lo stesso budget, e la pianificazione automatica non utilizza mai le ultime due letture della giornata.
* `sync.live_syncs_left_today` sulla connessione indica quante sincronizzazioni in tempo reale restano per oggi, mentre `sync.budgets[]` mostra ciascun contenitore: `scope` (`connection` o `account`), `resource`, `limit`, `remaining` e `resets_at`.
* Mentre la persona è presente in Bank Link, per un rinnovo o una riconnessione, le letture non sono soggette a limiti.
* Quando il budget giornaliero è esaurito, la chiamata risponde con `429 refresh_limit_reached` e con un'intestazione `Retry-After` (i secondi che mancano al ripristino del budget), oltre a un oggetto `sync` con `live_syncs_left_today` e `budgets`. Attendi quel tempo e nel frattempo affidati alla sincronizzazione automatica.
* I limiti delle API sono separati: 600 letture e 300 scritture al minuto per applicazione, con le intestazioni `X-RateLimit-*`.

## Scopri quanto sono aggiornati i dati

* `sync.last_synced_at` sulla connessione e su ogni conto indica quando Didit ha recuperato l'ultima volta i dati dalla banca, non il momento in cui li hai letti tu.
* Entrambe le letture delle transazioni restituiscono `X-Bank-Last-Synced-At`.

## Errori da gestire

| Errore | Significato | Cosa fare |
| - | - | - |
| `429 refresh_limit_reached` | Il budget della banca è esaurito. | Attendi `Retry-After` e affidati alla sincronizzazione automatica. |
| `409 connection_not_active` | La connessione non è `active`. | Verifica il suo stato. |
| `409 consent_expired` | Il consenso è scaduto. | [Rinnovalo](https://docs.didit.me/it/use-cases/renew-bank-consent.md). |

## Correlati

* [Feed bancario continuo per la contabilità](https://docs.didit.me/it/use-cases/bank-data-for-accounting.md)
* [Webhook bancari](https://docs.didit.me/it/core-technology/bank-verification/webhooks.md)


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