Synchronize bank account

What is this?

With Sync now you trigger the fetching of new bank transactions immediately instead of waiting for the automatic nightly sync. Useful after an important transfer, a donation or when you want to evaluate as up-to-date as possible at month-end.

In normal operation Chorilo syncs automatically once a day. This function supplements the automation but does not replace it.

How to start a sync

1. Open Administration > Cashbook > Accounts > Bank connections.
2. Click the desired connection.
3. Click Sync now.
4. Wait a moment — usually 5 to 30 seconds, depending on the bank.
5. See the number of newly imported transactions in the confirmation.
6. Switch to Transactions to see the new entries and reconcile them if needed.

What happens during sync

1. Chorilo asks your bank via the PSD2 interface for new transactions.
2. Your bank returns the list of transactions since the last sync.
3. Chorilo checks each entry for duplicates (via a bank reference).
4. New entries are stored as unassigned bank entries.
5. The account balance is recalculated.
6. Reconciliation suggestions are generated — Chorilo automatically proposes when a bank transaction matches an existing manual entry.

When the sync fails

Common reasons and solutions:

• PSD2 connection expired → re-authenticate via Renew connection
• Bank temporarily unreachable → try again in 1 to 2 hours
• TAN method was changed → re-establish the connection
• Bank requires re-login (e.g. after a security incident) → renew connection

Permission

You need cashbook.edit to manually trigger a sync.

Tips

• Sync at month-end shortly before evaluating — that way you have the current state for reports.
• For important donations or transfers you can sync immediately and do the reconciliation right away.
• Do not overdo it — some banks throttle access on too frequent requests. Once an hour is sufficient even for very active accounts.
• Keep an eye on the date of the last sync — if it is more than 24 hours ago, the connection has usually expired.