FEC

Outil open source de validation de Fichiers des Écritures Comptables (FEC), conforme à l'article A47 A-1 du Livre des procédures fiscales.

L'ensemble du traitement est effectué localement dans le navigateur : aucune donnée n'est transmise à un serveur.

Fonctionnalités

• Validation de fichiers FEC au format texte tabulé (.txt) et XML (.xml)
• 19 contrôles de conformité : structure, colonnes, formats, cohérence comptable
• Distinction erreurs / avertissements avec localisation (ligne, champ)
• Traitement 100% local, gratuit et sans inscription

Contrôles effectués

#	Contrôle	Sévérité
1	Nom de fichier ({SIREN}FEC{AAAAMMJJ})	Erreur
2	Présence de l'en-tête	Erreur
3	Ordre des 18 colonnes obligatoires	Erreur
4	Nombre minimum de colonnes (18)	Erreur
5	Séparateur tabulation ou pipe	Erreur
6	Format des dates (AAAAMMJJ)	Erreur
7	Format numérique (virgule décimale)	Erreur
8	CompteNum (3 premiers caractères numériques)	Erreur
9	Champs obligatoires non vides	Erreur
10	Présence Débit/Crédit ou Montant/Sens	Erreur
11	Valeurs du champ Sens (D, C, +1, -1)	Erreur
12	Validité calendaire des dates	Erreur
13	Fichier non vide	Erreur
14	Encodage (ASCII, ISO-8859-15, UTF-8)	Avertissement
15	Ordre chronologique (ValidDate)	Avertissement
16	Séquence continue des EcritureNum	Avertissement
17	Écritures d'ouverture (à-nouveaux)	Avertissement
18	Équilibre débit/crédit par écriture	Avertissement
19	Cohérence PieceDate / EcritureDate	Avertissement

Architecture

Monorepo pnpm avec deux packages :

packages/
  engine/       Moteur de validation FEC (TypeScript pur, aucune dépendance navigateur)
  website/      Interface web (React 19, Vite 7, PandaCSS, TanStack Router)

@arrhes/fec-engine

Librairie TypeScript exportant les parseurs, validateurs et types FEC. Peut être utilisée indépendamment du site web.

import { validateFecFile } from "@arrhes/fec-engine"

const result = validateFecFile(fileContent, "123456789FEC20240101.txt")
// result.summary  -> { errors: 0, warnings: 2, total: 19, lines: 1042 }
// result.checks   -> FecCheckResult[]

@arrhes/fec-website

Application React avec validation côté client. Le fichier est lu via File.text() et passé au moteur de validation directement dans le navigateur.

Prérequis

• Node.js >= 22
• pnpm >= 10
• Docker et Docker Compose (pour le développement conteneurisé et le build de production)
• just (optionnel, raccourcis de commandes)

Démarrage rapide

# Cloner le dépôt
git clone https://github.com/arrhes/fec.git
cd fec

# Installer les dépendances
pnpm install

# Lancer le serveur de développement (Vite)
pnpm dev

Le site est accessible sur http://localhost:5173.

Développement avec Docker

# Démarrer l'environnement de développement conteneurisé
just dev up
# ou directement :
./scripts/dev-up.sh

# Arrêter
just dev down

Le site est alors accessible sur http://localhost:19004.

Scripts

Commande	Description
pnpm dev	Démarre les serveurs de développement (tous les packages)
pnpm build	Compile tous les packages
pnpm test	Exécute les tests (vitest)
pnpm check	Lint et format avec Biome
pnpm check:fix	Corrige automatiquement les problèmes de lint/format
just build	Build Docker de production
just dev up	Environnement de développement Docker
just dev down	Arrêt de l'environnement Docker

Build de production

Le build de production crée une image Docker avec Nginx pour servir le site statique :

# Via just
just build

# Ou directement
docker compose -f workflows/build/compose.yml --env-file workflows/build/.env.example build

Variables d'environnement requises (voir workflows/build/.env.example) :

Variable	Description
VITE_WEBSITE_BASE_URL	URL publique du site

Stack technique

Composant	Technologie
Langage	TypeScript 5.9
Runtime	Node.js 22
Frontend	React 19
Bundler	Vite 7
Routeur	TanStack Router
CSS	PandaCSS
Tests	Vitest
Lint / Format	Biome
Validation	Valibot
Gestionnaire de paquets	pnpm
CI/CD	GitHub Actions
Production	Docker, Nginx

Licence

AGPL-3.0