> ## 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 ahora: actualizar datos bancarios bajo demanda

> Solicita los datos bancarios más recientes de una conexión con una sola llamada, espera el resultado y conoce el límite diario del banco en Didit.

Sync Now de Didit consulta al banco los datos más recientes de una conexión en cualquier momento, con una sola llamada.
Las sincronizaciones en vivo están incluidas en el precio mensual de la conexión: no se cobra nada adicional.
El único límite es el del banco.

## Sincronización automática

* La primera sincronización se ejecuta cuando la persona se conecta.
* Después, cada conexión activa continua se sincroniza automáticamente entre una y cuatro veces al día, según el banco. `sync.frequency_per_day` en la conexión indica cuántas, y `sync.next_sync_at` indica cuándo está prevista la siguiente.
* Cuando el banco permite más lecturas automáticas al día, siempre quedan al menos dos disponibles para las sincronizaciones en vivo.
* Cuando una sincronización almacena cambios, llega `bank.data.updated` y puedes leer el [feed de cambios](https://docs.didit.me/es/standalone-apis/bank-transactions-sync.md) con tu cursor.
* Una sincronización fallida se reintenta con espera progresiva. Tras 24 horas de fallos, la conexión sigue `active` con `sync.status: failing` y se envía `bank.sync.failed`. Cuando vuelve a funcionar, se envía `bank.sync.recovered`.
* Cuando el banco pide a la persona que vuelva a iniciar sesión, la conexión pasa a `renewal_required`.

## Sincroniza ahora, en una sola llamada

Añade `"wait": true` y una solicitud devuelve datos actualizados:

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

El encabezado `Prefer: wait=25` hace lo mismo. La llamada espera hasta 25 segundos:

| Respuesta | Significado |
| - | - |
| `200` | La sincronización terminó. El cuerpo es la sincronización con su `outcome`, los recuentos por cuenta de `added`, `modified` y `removed`, y `balances_changed`. |
| `202` | El banco no ha respondido en 25 segundos, o no pediste esperar. El cuerpo incluye el `sync_id`: consulta la sincronización con `get_sync_run` o suscríbete a `bank.sync.completed`. `bank.data.updated` llega solo si la sincronización guarda cambios. |

```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 ya hay una sincronización en curso, recibes ese mismo `sync_id`, no un segundo trabajo.
Tras un `200` o un `bank.data.updated`, lee el feed de cambios con tu cursor guardado.
Consulta después lo que hizo una sincronización con [`get_sync_run`](https://docs.didit.me/es/standalone-apis/bank-sync-run-get).

## El precio

Las sincronizaciones automáticas y las sincronizaciones en vivo están incluidas en el precio mensual de la conexión, consulta [precios](https://docs.didit.me/es/getting-started/bank-verification-pricing.md).
Una sincronización en vivo nunca añade ningún cargo.

## El límite diario del banco

Un banco limita con qué frecuencia se pueden obtener datos sin la presencia de la persona. Las normas europeas permiten a un banco limitar a cuatro lecturas al día por cuenta el acceso sin que la persona esté presente. Es un techo, no una garantía: un banco puede permitir menos o aceptar más.

* Las sincronizaciones automáticas y en tiempo real comparten un mismo presupuesto, y la programación automática nunca usa las dos últimas lecturas del día.
* `sync.live_syncs_left_today` en la conexión indica cuántas sincronizaciones en tiempo real quedan hoy, y `sync.budgets[]` muestra cada bloque: `scope` (`connection` o `account`), `resource`, `limit`, `remaining` y `resets_at`.
* Mientras la persona está presente en Bank Link, para una renovación o una reconexión, las lecturas no tienen límite.
* Cuando se agota el presupuesto del día, la llamada responde `429 refresh_limit_reached` con un encabezado `Retry-After` (los segundos que faltan hasta que el presupuesto se restablezca) y un objeto `sync` con `live_syncs_left_today` y `budgets`. Espera ese tiempo y confía en la sincronización automática mientras tanto.
* Tus límites de API son independientes: 600 lecturas y 300 escrituras por minuto por aplicación, con encabezados `X-RateLimit-*`.

## Qué tan actualizados están los datos

* `sync.last_synced_at` en la conexión y en cada cuenta indica cuándo Didit consultó por última vez al banco, no cuándo leíste los datos por última vez.
* Ambas lecturas de transacciones devuelven `X-Bank-Last-Synced-At`.

## Errores que debes manejar

| Error | Significado | Qué hacer |
| - | - | - |
| `429 refresh_limit_reached` | Se agotó el presupuesto del banco. | Espera el tiempo indicado en `Retry-After` y confía en la sincronización automática. |
| `409 connection_not_active` | La conexión no está `active`. | Revisa su estado. |
| `409 consent_expired` | El consentimiento ha vencido. | [Renuévalo](https://docs.didit.me/es/use-cases/renew-bank-consent.md). |

## Relacionados

* [Feed bancario continuo para contabilidad](https://docs.didit.me/es/use-cases/bank-data-for-accounting.md)
* [Webhooks bancarios](https://docs.didit.me/es/core-technology/bank-verification/webhooks.md)


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