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

# Синхронизация банковских данных по запросу

> Обновляйте банковские данные подключения по запросу в Didit: один вызов, ожидание результата, дневной лимит банка и ответ 429.

Функция Sync Now от Didit в любой момент запрашивает у банка актуальные данные по подключению одним вызовом.
Живые синхронизации входят в ежемесячную стоимость подключения: дополнительная плата не взимается.
Единственное ограничение накладывает банк.

## Автоматическая синхронизация

* Первая синхронизация запускается, когда пользователь подключается.
* После этого каждое активное постоянное подключение синхронизируется автоматически от одного до четырёх раз в день, в зависимости от банка. `sync.frequency_per_day` в подключении показывает, сколько раз, а `sync.next_sync_at` показывает, когда запланирована следующая.
* Если банк разрешает больше считываний в день без участия пользователя, как минимум два в день всегда остаются для синхронизаций в реальном времени.
* Когда синхронизация сохраняет изменения, приходит `bank.data.updated`, и вы читаете [ленту изменений](https://docs.didit.me/ru/standalone-apis/bank-transactions-sync.md) с помощью своего курсора.
* Синхронизация, которая завершилась ошибкой, повторяется с увеличивающимися интервалами между попытками. Если ошибки продолжаются 24 часа, подключение остаётся `active` со значением `sync.status: failing`, и отправляется `bank.sync.failed`. Когда синхронизация снова работает, следует `bank.sync.recovered`.
* Когда банк просит пользователя войти снова, подключение переходит в статус `renewal_required`.

## Синхронизируйте сейчас одним вызовом

Добавьте `"wait": true`, и один запрос вернёт актуальные данные:

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

Заголовок `Prefer: wait=25` делает то же самое. Вызов ожидает до 25 секунд:

| Ответ | Значение |
| - | - |
| `200` | Синхронизация завершена. В теле ответа находится сама синхронизация с её `outcome`, количество добавленных `added`, изменённых `modified` и удалённых `removed` записей по каждому счёту, а также `balances_changed`. |
| `202` | Банк не ответил за 25 секунд или вы не запросили ожидание. В теле ответа есть `sync_id`: прочитайте синхронизацию через `get_sync_run` или подпишитесь на `bank.sync.completed`. `bank.data.updated` приходит, только если синхронизация сохраняет изменения. |

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

Если синхронизация уже выполняется, вы получите тот же `sync_id`, а не новую задачу.
После ответа `200` или события `bank.data.updated` прочитайте ленту изменений, используя сохранённый курсор.
Чтобы позже посмотреть, что делала синхронизация, воспользуйтесь [`get_sync_run`](https://docs.didit.me/ru/standalone-apis/bank-sync-run-get).

## Цена

Автоматические синхронизации и синхронизации в реальном времени входят в ежемесячную цену подключения, см. [Цены](https://docs.didit.me/ru/getting-started/bank-verification-pricing.md).
Синхронизация в реальном времени никогда не влечёт дополнительной платы.

## Дневной лимит банка

Банк ограничивает, как часто данные можно запрашивать без участия человека.
Правила в Европе позволяют банку ограничить такой доступ без участия человека четырьмя чтениями данных в день на счёт.
Это верхняя граница, а не гарантия: банк может разрешить меньше или согласиться на большее.

* Автоматические синхронизации и синхронизации в реальном времени используют один общий бюджет, и автоматическое расписание никогда не использует последние два чтения за день.
* `sync.live_syncs_left_today` в подключении показывает, сколько синхронизаций в реальном времени осталось на сегодня, а `sync.budgets[]` показывает каждую группу лимита: `scope` (`connection` или `account`), `resource`, `limit`, `remaining` и `resets_at`.
* Пока пользователь находится в Bank Link для продления или повторного подключения, обращения не ограничиваются.
* Когда дневной бюджет исчерпан, вызов возвращает `429 refresh_limit_reached` с заголовком `Retry-After` (количество секунд до сброса бюджета) и объектом `sync` с полями `live_syncs_left_today` и `budgets`. Подождите указанное время, а тем временем полагайтесь на автоматическую синхронизацию.
* Лимиты вашего API независимы: 600 чтений и 300 операций записи в минуту на приложение, с заголовками `X-RateLimit-*`.

## Как узнать, насколько актуальны данные

* `sync.last_synced_at` в подключении и в каждом счёте означает время, когда Didit в последний раз получил данные из банка, а не время, когда вы их в последний раз считывали.
* Оба запроса на чтение транзакций возвращают `X-Bank-Last-Synced-At`.

## Ошибки, которые нужно обрабатывать

| Ошибка | Значение | Действие |
| - | - | - |
| `429 refresh_limit_reached` | Доступный бюджет банка исчерпан. | Дождитесь истечения времени, указанного в `Retry-After`, и положитесь на автоматическую синхронизацию. |
| `409 connection_not_active` | Подключение не в статусе `active`. | Проверьте его статус. |
| `409 consent_expired` | Срок действия согласия истёк. | [Продлите его](https://docs.didit.me/ru/use-cases/renew-bank-consent.md). |

## Связанные материалы

* [Непрерывная передача банковских данных для бухгалтерии](https://docs.didit.me/ru/use-cases/bank-data-for-accounting.md)
* [Банковские webhook](https://docs.didit.me/ru/core-technology/bank-verification/webhooks.md)


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