Synchronisations bancaires
Les exécutions qui vont chercher les données bancaires d'une entreprise. On en démarre une, puis on l'interroge. Un 202 signifie que l'exécution existe, jamais que le travail est terminé, et un échec terminal est rapporté sur l'exécution elle-même plutôt que seulement dans un journal. Une exécution qui finit en partial s'est achevée avec un jeu de résultats qu'elle sait incomplet - ce n'est pas un arrondi de completed, et plus d'une cause peut l'y conduire.
Start a bank sync
Starts a run that pulls the company's bank data and returns it so you can poll it. **A 202 never means the work finished** - it means the run exists. Poll `GET /api/v1/bank_syncs/{id}` until `state` is terminal, and read terminal failure off the run rather than assuming success from the 202. The run covers every connection the company has, and takes no request body; only one may be in flight per company at a time.
Retrieve a bank sync
Returns one sync run. This is the endpoint to poll after a 202: `state` tells you whether the work is still in flight, and a terminal `failed` or `partial` is reported here rather than only in a log.