An open API service indexing awesome lists of open source software.

https://github.com/feelautom/french-invoice-community

FrenchInvoice Community — Outil de comptabilité et facturation pour auto-entrepreneurs français. Gestion du CA, cotisations URSSAF, déclarations, factures Factur-X, devis, import bancaire CSV. Self-hosted via Docker.
https://github.com/feelautom/french-invoice-community

auto-entrepreneur blazor comptabilite docker dotnet factur-x facturation facturation-electronique french invoice micro-entreprise self-hosted-open-source urssaf

Last synced: 9 days ago
JSON representation

FrenchInvoice Community — Outil de comptabilité et facturation pour auto-entrepreneurs français. Gestion du CA, cotisations URSSAF, déclarations, factures Factur-X, devis, import bancaire CSV. Self-hosted via Docker.

Awesome Lists containing this project

README

          

# FrenchInvoice Community Edition

[![Build & Tests](https://github.com/feelautom/french-invoice-community/actions/workflows/build.yml/badge.svg)](https://github.com/feelautom/french-invoice-community/actions/workflows/build.yml)
[![CodeFactor](https://www.codefactor.io/repository/github/feelautom/french-invoice-community/badge)](https://www.codefactor.io/repository/github/feelautom/french-invoice-community)
[![License: ELv2](https://img.shields.io/badge/License-ELv2-blue.svg)](LICENSE)
[![.NET 9](https://img.shields.io/badge/.NET-9.0-512BD4?logo=dotnet)](https://dotnet.microsoft.com/)
[![Docker](https://img.shields.io/badge/Docker-ready-2496ED?logo=docker&logoColor=white)](https://hub.docker.com/)
[![Blazor](https://img.shields.io/badge/Blazor-Server-512BD4?logo=blazor)](https://dotnet.microsoft.com/apps/aspnet/web-apps/blazor)
[![Docker Pulls](https://img.shields.io/docker/pulls/feelautom/frenchinvoice-community)](https://hub.docker.com/r/feelautom/frenchinvoice-community)
[![Factur-X](https://img.shields.io/badge/Factur--X-EN%2016931-green)](https://fnfe-mpe.org/factur-x/)

![FrenchInvoice](screenshot.png)

Outil de gestion comptable complet pour **indépendants** et **entreprises** en France : micro-entreprise, EI classique, EURL, SASU.

Factures Factur-X, devis, comptabilité, déclarations URSSAF, bilans annuels — tout-en-un, auto-hébergé, gratuit.

## Fonctionnalités

### Comptabilité & Fiscalité
- **Multi-statut juridique** — Micro-entreprise, EI classique (réel), EURL (IR), SASU (IS)
- **Simulateur de statut** — compare les 4 statuts côte à côte avec recommandation et projections
- **Impôt sur le revenu** — simulation IR (barème 2025), IS pour SASU, versement libératoire
- **Bilans annuels** — compte de résultat, bilan simplifié, génération PDF
- **Déclarations URSSAF** — génération mensuelle ou trimestrielle, gestion multi-statut
- **Dashboard** — trésorerie, CA, cotisations+CFP, bénéfice net, adapté au statut juridique
- **Clôture d'exercice** — snapshot fiscal avec chaîne de hachage inaltérable
- **ACRE** — calcul automatique des cotisations réduites la première année

### Facturation
- **Factures Factur-X** — PDF conformes avec XML embarqué (ZUGFeRD v2.3, profil Comfort)
- **Devis** — création, envoi, expiration automatique, conversion en facture
- **Mentions légales dynamiques** — adaptées automatiquement au statut juridique
- **Export FEC** — Fichier des Écritures Comptables

### Gestion
- **Import bancaire** — CSV multi-banques (Boursobank, BNP, Crédit Mutuel, générique)
- **Clients** — gestion complète avec recherche SIRET automatique
- **Notes inline** — sur recettes et dépenses, édition au clic
- **Export/Import** — sauvegarde ZIP avec intégrité SHA-256
- **Livre des recettes** et **Registre des achats** en PDF
- **Mode sombre** — persistant entre les sessions

## Installation

Trois méthodes au choix :

### Docker Hub — Le plus simple

```bash
docker run -d --name frenchinvoice -p 5555:8080 -v frenchinvoice-data:/app/Data feelautom/frenchinvoice-community:latest
```

### Depuis les sources — Docker Compose

```bash
git clone https://github.com/feelautom/french-invoice-community.git
cd french-invoice-community
docker-compose up -d
```

### Sans Docker — .NET 9 SDK

```bash
# Prérequis : .NET 9 SDK — https://dotnet.microsoft.com/download/dotnet/9.0
dotnet run --project src/FrenchInvoice.Community
```

> L'application démarre sur `http://localhost:5000` en mode .NET direct.

---

### Ouvrir l'application

Rendez-vous sur [http://localhost:5555](http://localhost:5555) (Docker) ou [http://localhost:5000](http://localhost:5000) (.NET).

Au premier lancement, un assistant de configuration vous guidera :

1. Entrez votre **numéro SIRET** — les informations de votre entreprise sont remplies automatiquement depuis l'API gouvernementale
2. Complétez les champs manquants (téléphone, TVA, type d'activité)
3. Validez — vous êtes prêt à facturer

### Changer le port

Par défaut, l'application écoute sur le port **5555**. Pour changer, modifiez `docker-compose.yml` :

```yaml
ports:
- "8080:8080" # remplacez 5555 par le port souhaité
```

### Mise à jour

```bash
git pull
docker-compose up --build -d
```

Les migrations de base de données s'appliquent automatiquement. Vos données sont préservées dans le volume Docker `community-data`.

### Sauvegarde

Vos données (base SQLite + PDFs) sont dans le volume Docker `community-data`. Pour sauvegarder :

```bash
# Exporter depuis l'interface
# Menu latéral > Export/Import > Exporter (ZIP avec intégrité SHA-256)

# Ou copier le volume directement
docker cp frenchinvoice-community:/app/Data ./backup
```

## Stack technique

| Composant | Technologie |
|-----------|-------------|
| Framework | [.NET 9](https://dotnet.microsoft.com/) — Blazor Server |
| Base de données | [SQLite](https://www.sqlite.org/) + Entity Framework Core |
| Interface | [MudBlazor](https://mudblazor.com/) — Material Design |
| Génération PDF | [QuestPDF](https://www.questpdf.com/) |
| Factur-X | [ZUGFeRD-csharp](https://github.com/stephanstapel/ZUGFeRD-csharp) — XML EN 16931 |

## Conformité

FrenchInvoice génère des factures conformes à la législation française :

- **Numérotation séquentielle** sans trou (Art. L441-9 Code de Commerce)
- **Factur-X** EN 16931 (profil Comfort, ZUGFeRD v2.3)
- **Mentions légales obligatoires** : TVA art. 293B, pénalités de retard, indemnité 40 €
- **Cadre de facturation** BT-23 pour la réforme e-invoicing (sept. 2026)

## Statuts juridiques supportés

| Statut | Cotisations | Fiscalité |
|--------|-------------|-----------|
| Micro-entreprise | Sur CA (taux configurable, défaut 25.6%) | IR + versement libératoire optionnel |
| EI classique | Sur bénéfice (CA - dépenses) | IR |
| EURL | Sur rémunération/bénéfice | IR |
| SASU | Charges sociales sur salaire | IS + IR sur rémunération |

## FrenchInvoice SaaS

Cette édition Community est gratuite et auto-hébergée.

Une version **SaaS** hébergée est également disponible sur [frenchinvoice.fr](https://frenchinvoice.fr) avec des fonctionnalités supplémentaires :

- API REST pour intégrer vos outils
- Import automatique des clients depuis votre site web
- Synchronisation Stancer/Stripe
- Hébergement et sauvegardes gérées pour vous

## Tests

```bash
dotnet test
```

## Licence

[Elastic License 2.0 (ELv2)](LICENSE)

En résumé, vous pouvez librement :

- **Utiliser** FrenchInvoice pour votre activité personnelle ou professionnelle
- **Modifier** le code source pour l'adapter à vos besoins
- **Héberger** l'application pour vous-même ou votre entreprise

Ce que vous **ne pouvez pas** faire :

- Proposer FrenchInvoice comme un service hébergé à des tiers (SaaS)
- Revendre ou redistribuer le logiciel comme votre propre produit
- Retirer ou contourner les fonctionnalités de licence