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

# Journaux

> Les journaux comptables de l'entreprise : catégories, formats de numérotation, défauts.

Un journal est le registre dans lequel un document est comptabilisé et
**numéroté**. Sa `category` dit quels documents il reçoit (`sales_invoice`,
`sales_credit`, `purchases_invoice`, `purchases_credit`, `incoming_sales`,
`incoming_purchases`) ; quelques journaux entrants historiques sortent en
`incoming`, en lecture seule.

## Numérotation

Chaque document du journal reçoit un numéro tiré d'un compteur, rendu selon
`numbering_format` : `{code}<sep><période><sep>{seq:N}`, où `<sep>` vaut `-` ou
`/`, et `N` (2–8) est la largeur du compteur — la facture 119 rend `0119` avec
`{seq:4}`. Défaut : `{code}-{year4}-{seq:5}`.

`<période>` combine un ou plusieurs de ces tokens, calculés sur la date d'émission :

| Token               | Représente                                          | Exemple *(15/01/2026, exercice débutant en juillet)* |
| ------------------- | --------------------------------------------------- | ---------------------------------------------------- |
| `{year4}`           | Année                                               | `2026`                                               |
| `{year2}`           | Année, sur 2 chiffres                               | `26`                                                 |
| `{month}`           | Mois, sur 2 chiffres                                | `01`                                                 |
| `{fys4}` / `{fye4}` | Début / fin de l'**exercice fiscal** en cours       | `2025` / `2026`                                      |
| `{fys2}` / `{fye2}` | Idem, sur 2 chiffres                                | `25` / `26`                                          |
| `{fy4}`             | Les deux années de l'exercice, jointes par un tiret | `2025-2026`                                          |
| `{fy2}`             | Idem, sur 2 chiffres, collées                       | `2526`                                               |

Les tokens `fy*` ne diffèrent de `{year4}`/`{year2}` que si `sequence_scope` vaut
`fiscal-year` et que l'exercice ne débute pas en janvier ; sinon ils rendent la
même valeur.

`sequence_scope` (`never`, `monthly`, `calendar-year`, `fiscal-year`) dit quand le
compteur redémarre.

Le `code` préfixe ce numéro : il est unique dans l'entreprise, sans tenir compte de
la casse (`409 duplicate_journal_code`).

`code`, `category` et `sequence_scope` sont **figés à la création**
(`422 field_not_editable` ensuite) : les changer romprait la continuité des numéros
déjà attribués. Pour un autre code ou une autre catégorie, créez un journal.

## Journal par défaut

Chaque catégorie a un journal par défaut, celui dans lequel `POST /documents`
réserve un document quand il ne nomme pas de journal. Il doit rester utilisable :

* `is_default: true` promeut un journal et rétrograde l'ancien défaut de la même
  catégorie ;
* un journal ne peut être créé ni mis à jour comme étant à la fois par défaut et
  inactif, et le dernier défaut d'une catégorie ne se rétrograde pas par `is_default: false`
  (`422 default_journal_required`) — promouvoir un autre journal à la place. La
  règle regarde l'état final : promouvoir un journal inactif passe si la même
  requête le réactive.

## Sur les documents

`documents.journal_id` est le journal où le document est comptabilisé, `null` quand
il n'en a pas (beaucoup de documents reçus). Un document importé en
`purchase`/`sale` est réservé dès sa création dans le journal entrant par défaut.