Comptabilité analytique

Périmètre : plan comptable / natures de prestation, ventilation analytique des charges fournisseur (par exercice, trimestre, contrat, affaire, site, client), immobilisations, clôture annuelle (FNP / CCA / CAP / AAR / provisions) et pivots de contrôle. Ce domaine couvre la couche analytique qui se superpose à la comptabilité opérationnelle (journaux, TVA, exports légaux FEC) décrite dans docs/10-domain-sales-billing.md §3.15.

Vocabulaire & entités

Le modèle complet est dans docs/04-data-model.md §16. La facture fournisseur enrichie est décrite en §8 (SupplierInvoice).

Écrans

Modèle de données (points clés)

• Le plan comptable est paramétrable par organisation : codes activables/désactivables, ajout de comptes custom. Un seed initial couvre 23 codes issus de l'existant (de 215410000 à 622100001).
• Les comptes 215* (immobilisations) ne peuvent pas être affectés en charge directe : toute facture sur ce compte alimente obligatoirement un FixedAsset.
• La somme des SupplierInvoiceAllocation d'une facture ventilée doit égaler son totalHt (contrôlé côté service).
• Un exercice CLOSED est immuable : aucune affectation ni provision ne peut être modifiée ; les corrections passent par l'exercice ouvert suivant.
• Une AccountingProvision référence son reversedInYear (exercice d'apurement) ; l'apurement est tracé et déclenché automatiquement à l'ouverture de l'exercice suivant.
• L'exercice de rattachement peut différer de l'exercice de comptabilisation (charges sur exercice antérieur).

API

Les routes exigent une permission accounting.* (plan comptable, immobilisations, clôture / exports), purchasing.* (affectation analytique des charges, portée par le domaine facture fournisseur) ou finance.* (provisions). Permission vérifiée côté API et UI.

Plan comptable (/api/workspace/accounting-codes) :

Affectation analytique des charges (portée par la facture fournisseur — une affectation = une ligne SupplierInvoiceAllocation) :

Immobilisations (/api/workspace/fixed-assets) :

Clôture, amortissement mensuel, provisions & exports :

Le domaine couvre aussi le rapprochement bancaire (bank-accounts, bank-operations, bank-sync), la TVA EDI (vat-returns, edi-submissions), la paie (payroll-imports, payroll-mappings), les loyers (rent-reconciliations) et les rapprochements intragroupe (intragroup-reconciliations) sous /api/workspace/accounting/* — hors périmètre de cette page analytique.

Exemple de référence d'endpoint :

curl -s -X POST "$API/api/workspace/supplier-invoices/$INVOICE_ID/allocations" \
  -H "Content-Type: application/json" -H "Cookie: $SESSION" \
  -d '{"amountHt":1200,"accountingCodeId":"code_xxx","fiscalYear":2025,"leaseContractId":"lease_xxx"}'

{
  "items": [
    { "id": "alloc_…", "supplierInvoiceId": "inv_…", "amountHt": 1200, "accountingCodeId": "code_xxx", "fiscalYear": 2025, "leaseContractId": "lease_xxx" }
  ],
  "invoiceTotalHt": 1200,
  "allocatedHt": 1200,
  "remainingHt": 0,
  "fullyAllocated": true
}

Workflows

Affectation d'une facture fournisseur

À la validation comptable d'une SupplierInvoice :

1. Saisie de la nature de prestation (accountingCodeId) — obligatoire.
2. Indicateur Affaires / Hors affaires.
3. Exercice d'affectation (fiscalYear) — obligatoire.
4. Trimestre (quarterTag) pour l'analytique trimestriel.
5. Rattachement à un contrat ou une affaire, un client, un site.
6. Indicateur d'inclusion dans l'enveloppe de financement.
7. Si charge réseau : ventilation en plusieurs SupplierInvoiceAllocation (une ligne par POST .../allocations, somme contrôlée ≤ total HT).

Une facture non affectée bloque la clôture de son exercice.

Gestion des immobilisations

• Facture sur compte 215* → génère ou alimente un FixedAsset.
• Mise en service d'un bien IN_PROGRESS → POST /fixed-assets/[id]/commission (transition vers ACTIVE, démarre l'amortissement).
• Dotation aux amortissements pour un exercice → POST /fixed-assets/[id]/amortization → FixedAssetEvent de type AMORTIZATION (méthode linéaire par défaut). L'amortissement mensuel global du parc se déclenche via POST /accounting/run-monthly-depreciation.
• Cession / mise au rebut → FixedAssetEvent de type DISPOSAL, sortie de l'actif.

Clôture annuelle

OPEN
  │  (lancement de la clôture)
  ▼
IN_PROGRESS
  │  (contrôles : factures affectées, écarts résolus)
  │  (saisie/génération provisions : FNP / CCA / CAP / AAR / risques / stock)
  ▼
REVIEW
  │  (validation direction financière)
  ▼
CLOSED   (exercice verrouillé — provisions immuables)

À l'ouverture de l'exercice suivant : apurement automatique des provisions (reprise). Les écritures de régularisation alimentent l'export comptable vers l'outil externe (FEC / Sage / Cegid / Pennylane).

Contrôle inter-exercices

À chaque clôture : comparaison des montants par compte avec le fichier de clôture N-1. Les écarts sont listés avec une zone d'analyse à renseigner (reclassements, corrections).

Règles métier

• Une SupplierInvoice validée doit porter une nature de prestation et un exercice d'affectation.
• La somme des SupplierInvoiceAllocation d'une facture ventilée doit égaler son totalHt.
• Exercice CLOSED → aucune modification possible (affectation ni provision) ; les corrections passent par l'exercice suivant.
• Comptes 215* → alimentent uniquement un FixedAsset, jamais une charge directe.
• Toute affectation et toute écriture de clôture → audit log systématique.
• Apurement de provision → tracé via reversedInYear.

Notifications

KPIs

Taux de factures affectées · charges par compte/exercice/contrat · montant des provisions par type (FNP / CCA / CAP / AAR) · valeur nette comptable du parc d'immobilisations · écarts inter-exercices non résolus · marge consolidée par contrat réseau.