> ## Documentation Index
> Fetch the complete documentation index at: https://api-doc.fidly.be/llms.txt
> Use this file to discover all available pages before exploring further.

# Comptes bancaires

> Les comptes bancaires de l'entreprise : les lire, créer des comptes manuels, gérer le défaut.

Les comptes bancaires de l'entreprise. `origin` dit d'où vient chaque compte :
`ponto` (connexion bancaire), `coda` (extraits CODA) ou `manual`. Les soldes ne
sont connus que des comptes que Fidly synchronise ; sur les autres, ils valent
`null`.

## Comptes manuels

L'API ne crée que des comptes `manual` : les comptes `ponto` et `coda` naissent de
leurs propres flux, `origin` n'est donc pas un champ d'entrée. Pour la même raison,
`bic` et `reference` ne se modifient que sur un compte `manual` — sur un compte
synchronisé, ils appartiennent à la banque et sont refusés dès qu'ils sont présents
dans le corps, même avec leur valeur actuelle (`422 field_not_editable`). N'envoyez
donc que les champs à modifier, jamais le document relu en entier.

Un compte `manual` peut aussi cesser de l'être malgré vous : si une connexion Ponto
ou un import CODA détecte un compte existant portant le même IBAN, ce compte est
réutilisé plutôt que dupliqué, et son `origin` bascule vers `ponto`/`coda`. `bic` et
`reference` y deviennent alors en lecture seule.

`reference` est l'IBAN : il doit être valide, il est normalisé (majuscules, sans
espaces) et il est unique dans l'entreprise (`409 duplicate_bank_account`).

## Compte par défaut

Une entreprise a toujours **exactement un** compte par défaut, celui qui figure sur
ses documents. Les règles en découlent :

* s'il n'y en a aucun, le premier compte créé le devient, quoi que dise le corps ;
* `default: true` promeut un compte et rétrograde l'ancien défaut ;
* `default: false` sur le défaut actuel est refusé (`422 default_account_required`)
  — promouvoir un autre compte à la place.