Skip to main content
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 : 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.