Actif platform functional Revu le 2026-09-03 platform/compta-invoice-import.md

Import des factures dans l'espace comptable

Doc fonctionnelle : décrit le quoi et le pourquoi (point de vue utilisateur / chef de projet).

À quoi ça sert

L'espace comptable (/compta) alimente les factures ISI depuis deux sources : les factures Stripe (import automatique, mois par mois) et l'export « Factures » de l'outil comptable, déposé sous forme de fichier CSV. L'import CSV sert notamment aux factures Isi-DSI et aux avoirs, qui ne passent pas par Stripe.

Depuis la refonte, le CSV n'est plus écrit à l'aveugle : un écran de validation montre, ligne à ligne, ce que l'import va faire et ce qui cloche. Le service comptable décide alors ce qu'il importe.

Comment ça marche (côté utilisateur)

Onglet Outils (`/compta/tools`)

Deux cartes :

Importer depuis Stripe — choix du mois et de l'année, puis confirmation. Une barre de progression suit la synchronisation et un email part vers les services comptables.
Importer depuis un fichier — renvoie vers l'écran d'import CSV.

Import CSV (`/compta/import`), en trois étapes

Fichier — choix du type de facturation (Isi-DSI, Isi-APP, Autre) et dépôt du CSV (glisser-déposer ou parcourir, 5 Mo maximum). La colonne de droite rappelle le format attendu : 10 colonnes, séparateur virgule, états acceptés. La ligne d'en-tête du fichier est ignorée automatiquement.
Validation — le fichier est analysé sans rien enregistrer. L'écran affiche :
- le nombre de lignes lues, à créer, à mettre à jour, et le nombre d'anomalies ;
- les totaux HT et TTC de ce qui sera importé (avoirs déduits) ;
- le détail par ligne : pièce, date, état, client, montants, action prévue et contrôles. Les lignes importables sont cochées par défaut. On peut tout décocher, ne garder que certaines lignes, ou n'afficher que les lignes porteuses d'une anomalie.
Import — après confirmation, seules les lignes cochées sont écrites. Un récapitulatif donne le nombre de créations, de mises à jour, de lignes ignorées et, le cas échéant, celles en échec.

Anomalies signalées

Bloquantes — la ligne est grisée, décochée, et ne peut pas être importée :

Anomalie	Cause
Colonnes manquantes	Moins de 10 colonnes sur la ligne
Code client invalide	La 1ʳᵉ colonne n'est pas au format `CLTxxxx`
Client introuvable	Aucun client CRM avec ce code, ou client sans compte de rattachement
Statut inconnu	État hors référentiel (Réglée, Validée, Annulée, Brouillon)
Date illisible	Date absente ou hors format `JJ/MM/AAAA`
Numéro de pièce absent	Colonne « Numéro » vide
Montant illisible	HT ou TTC non numérique
Doublon dans le fichier	Le même numéro apparaît deux fois dans le CSV

Avertissements — la ligne reste importable, à vous de juger :

Anomalie	Ce qu'elle veut dire
Réglé + reste dû ≠ TTC	Les colonnes de règlement ne retombent pas sur le montant TTC
TTC à 0 €	Un HT est renseigné mais pas le TTC
Signe incohérent	Avoir au montant positif, ou facture au montant négatif
Taux de TVA inhabituel	Le taux calculé (TTC − HT) ne correspond à aucun taux usuel
Montant modifié	La pièce existe déjà avec un TTC différent : l'écran donne l'avant / après
Statut modifié	La pièce existe déjà avec un autre statut
Pièce supprimée en base	La pièce a été supprimée dans ISI ; la mise à jour ne la restaure pas
Aucune affaire rattachée	Facture Isi-APP dont le client n'a pas d'affaire d'abonnement ouverte

Règles d'accès

Tout l'espace comptable est réservé aux membres ISI-DSI du service comptabilité (profil 40, ou administrateur ISI). Sans cette habilitation, /compta/* renvoie une erreur d'autorisation et la carte d'import CSV de l'onglet Outils affiche un message de restriction au lieu du bouton.

Points d'attention

Le TTC vient de la colonne « Montant TTC », jamais du reste dû. Une facture réglée a un reste dû à 0 : la lire comme montant TTC importait des factures et des avoirs à 0 €, avec un chiffre d'affaires faussé (voire négatif) sur le tableau de bord.
Mise à jour d'une pièce existante : la recherche se fait sur le numéro de pièce et le type de facturation. Seuls la date, le statut et les montants sont réécrits ; le client, l'entité émettrice et l'affaire rattachée restent ceux de la pièce d'origine.
Réimporter est sans risque : le même fichier passé deux fois met à jour au lieu de dupliquer. C'est la façon normale de corriger un import précédent.
Les factures Stripe passent par l'import automatique ; le type « Stripe » n'est pas proposé au dépôt de fichier.
Les montants au format français (1 600,00) sont acceptés, y compris avec espaces insécables.

Voir aussi

Doc technique : ../../.claude/technical-docs/platform/compta-invoice-import.md