Dokumentation — TVA CERFA 3310-CA3

Installation

Voraussetzungen

Dolibarr 19.0 → 23.x oder höher
PHP 7.4 → 8.5
MySQL 5.7+ oder MariaDB 10.3+
Schreibrechte auf dem Ordner htdocs/custom/

Methode 1 — Installation über DoliStore (empfohlen)

Modul kaufen
Gehen Sie auf DoliStore und kaufen Sie das Modul TVA CERFA 3310-CA3.
ZIP-Archiv herunterladen
Laden Sie die ZIP-Datei des Moduls aus Ihrem DoliStore-Kundenkonto herunter.
In Dolibarr bereitstellen
In Dolibarr: Startseite → Konfiguration → Module → Externes Modul bereitstellen/installieren, dann die ZIP-Datei auswählen.
Modul aktivieren
Nach der Bereitstellung aktivieren Sie „MwSt-Erklärungen (CERFA 3310-CA3)" im Bereich Finanzen / Buchhaltung.

Methode 2 — Manuelle Installation

# Wechseln Sie in den custom-Ordner von Dolibarr cd /var/www/dolibarr/htdocs/custom/ # Archiv entpacken unzip module_tva_cerfa_3310-4.1.1.zip # Berechtigungen anpassen chmod -R 755 tva_cerfa_3310/ chown -R www-data:www-data tva_cerfa_3310/

Wichtig: Falls die Datenbanktabellen bei der Aktivierung nicht automatisch angelegt werden, rufen Sie die Hauptseite des Moduls auf und klicken Sie auf „Tabellen installieren".

Konfiguration

Nach der Modulaktivierung öffnen Sie die Konfigurationsseite über Konfiguration → Module → TVA CERFA 3310-CA3 → Konfiguration.

1. Erklärungsmodus

Das Modul verarbeitet den Hauptteil des Formulars CA3 (CERFA 3310-CA3), reguläres Normalbesteuerungsverfahren. Das vereinfachte Verfahren CA12 wird nicht unterstützt.

Aktueller Umfang: Nur der Hauptteil der CA3 (Seite 1) wird automatisch berechnet. Folgende Elemente werden in dieser Version noch nicht unterstützt: Anhänge 3310-TER, 3310-A und 3310-TIC, Importzeilen (I1–I6, in Konsolidierung), MwSt auf Erdölerzeugnisse sowie die drei Kopfzeilen-Sonderfelder der CA3 (Steuervertreter des einzigen Steuerpflichtigen Art. 256 C, DGE-Konsolidierungsverfahren Art. 1693 ter, Erklärung „Null").

2. Aufbewahrung der Geschäftsjahre

Legen Sie fest, wie viele Geschäftsjahre aufbewahrt werden sollen (empfohlen: mindestens 3 Jahre zur Einhaltung der gesetzlichen Aufbewahrungspflichten).

3. Anlagevermögenskonten

Die Anlagevermögenskonten dienen zur Berechnung der abziehbaren MwSt auf Anlagevermögen (Zeile 19). Verwenden Sie den automatischen Erkennungsassistenten, um diese Konten automatisch zu identifizieren (in der Regel Konten beginnend mit 2).

4. Innergemeinschaftliche Konten

Konfigurieren Sie die Konten für innergemeinschaftliche Vorgänge (Erwerb von EU-Waren, ausländische EU- und Nicht-EU-Dienstleistungen).

5. MwSt-Satz für europäische Rechnungen

Wählen Sie den anzuwendenden französischen MwSt-Satz bei der Steuerschuldnerschaft (Reverse-Charge) für EU-Lieferantenrechnungen. Wenn nicht konfiguriert, verwendet das Modul die auf der Rechnung ausgewiesene MwSt.

6. OSS-Option

Wenn Sie grenzüberschreitende B2C-Fernverkäufe innerhalb der EU tätigen, die die Schwelle von 10 000 € überschreiten, können Sie über den OSS-Schalter erklären. Aktivieren Sie die entsprechende Option in der Konfiguration, damit das Modul diese Vorgänge korrekt aus der nationalen CA3-Berechnung ausschließt.

Nutzung

Eine MwSt-Erklärung erstellen

Modul aufrufen
Gehen Sie zu Buchhaltung/Finanzen → Steuern → TVA CERFA 3310-CA3.
Neue Erklärung anlegen
Klicken Sie auf „Neue Erklärung" und wählen Sie den Zeitraum (Monat oder Quartal je nach Ihrem Verfahren).
Beträge berechnen
Klicken Sie auf „MwSt berechnen", um die Daten automatisch aus Ihren validierten Rechnungen und Ihrem Hauptbuch zu extrahieren.
Prüfen und anpassen
Kontrollieren Sie die berechneten Beträge. Die 10 Schutzregeln (R1–R10) werden automatisch geprüft: jeder blockierende Punkt wird angezeigt, bevor Sie fortfahren können.
Erklärung validieren
Sobald alle Schutzregeln erfüllt sind, validieren Sie die Erklärung, um sie einzufrieren.
PDF generieren
Klicken Sie auf „PDF generieren", um den vollständigen Nachweis der Erklärung zu erhalten.

Lebenszyklus einer Erklärung

Status	Beschreibung	Mögliche Aktionen
Entwurf	Erklärung in Vorbereitung	Bearbeiten, Berechnen, Löschen
Validiert	Erklärung validiert, Schutzregeln erfüllt	Sperren, PDF generieren, Stornieren
Gesperrt	Erklärung abgeschlossen und eingereicht	Nur PDF generieren

Irreversibler Workflow: Der Übergang zum Status Gesperrt ist endgültig. Eine gesperrte Erklärung kann nicht mehr bearbeitet werden. Nur eine explizite Stornierung (Status Storniert) ist möglich, falls ein Fehler nachträglich festgestellt wird.

MwSt-Berechnungsregeln

Geschuldete MwSt — Hauptzeilen

Berechnet aus den validierten Kundenrechnungen des Zeitraums (Kundengutschriften werden abgezogen).

CERFA-Zeile	Beschreibung	Satz
08	MwSt zum Normalsatz	20 %
9B	MwSt zum Zwischensatz	10 %
09	MwSt zum ermäßigten Satz	5,5 %
11	MwSt zum besonderen Satz	2,1 %
10	MwSt DOM (Überseedepartements)	8,5 %
17	Davon Reverse-Charge — innergemeinschaftlicher Erwerb von Waren (B2) und ausländische EU-/Nicht-EU-Dienstleistungen (A3, Art. 283-2)	20 %

Zeile 16 (Gesamte geschuldete MwSt) = Σ(Zeilen 08 + 9B + 09 + 11 + 10 + …)

Abziehbare MwSt — Hauptzeilen

Berechnet aus den validierten Lieferantenrechnungen des Zeitraums (Lieferantengutschriften werden berücksichtigt).

CERFA-Zeile	Beschreibung
19	MwSt auf Anlagevermögen (Konten der Klasse 2)
20	MwSt auf sonstige Güter und Dienstleistungen (Aufwendungen, Gemeinkosten)
22	Vorgetragenes MwSt-Guthaben aus Zeile 27 des Vorperiode

Zeile 23 (Gesamte abziehbare MwSt) = Zeile 19 + Zeile 20 + Zeile 22 + …

Periodenergebnis

CERFA-Zeile	Beschreibung
32	Zu zahlende MwSt = Zeile 16 − Zeile 23 (wenn positiv)
25	MwSt-Gutschrift = Zeile 23 − Zeile 16 (wenn negativ)
26	Beantragter Erstattungsbetrag (manuell einzutragen)
27	Vorzutragender Gutschriftsbetrag = Zeile 25 − Zeile 26 → speist Zeile 22 der nächsten Periode

Gutschriftskette: Zeile 22 jeder Erklärung wird automatisch aus Zeile 27 der Vorperiode gespeist. Diese Kette darf niemals unterbrochen werden — sie ist ein blockierender Invariant des Moduls.

Steuerliche Schutzregeln (R1–R10)

Zehn Konsistenzregeln werden automatisch vor jeder Validierung geprüft. Sie sind blockierend: es ist unmöglich, eine inkonsistente Erklärung zu validieren. Beispiele geprüfter Regeln: Konsistenz Bemessungsgrundlage × Satz = MwSt, Neutralität des Reverse-Charge (Zeile 17 ↔ entsprechende abziehbare MwSt), Konsistenz von Zeile 22 mit der Vorperiode.

Gesetzliche Rundung: Alle Beträge werden auf den nächsten ganzzahligen Wert gerundet, gemäß den Anforderungen der französischen Steuerverwaltung (DGFiP).

MwSt auf europäische Umsätze und Reverse-Charge

Innergemeinschaftlicher Erwerb von Waren (B2)

Beim Kauf von Waren von einem in der EU ansässigen Lieferanten wird die MwSt per Reverse-Charge übertragen: Sie erklären sowohl die geschuldete MwSt (Zeile 17) als auch die entsprechende abziehbare MwSt (Zeile 20), was bei vollständigem Vorsteuerabzugsrecht zu einer vollständigen Neutralität führt.

Ausländische EU- und Nicht-EU-Dienstleistungen — Reverse-Charge Art. 283-2 (A3)

Dienstleistungen von nicht in Frankreich ansässigen Dienstleistern (EU oder Drittländer) unterliegen dem Reverse-Charge-Verfahren gemäß Artikel 283-2 des CGI. Sie erscheinen in Zeile A3 (Bemessungsgrundlage) und Zeile 17 (MwSt).

Konfiguration des Satzes für europäische Rechnungen

Öffnen Sie die Modulkonfiguration.
Wählen Sie unter „MwSt-Satz für europäische Rechnungen" den anzuwendenden französischen Satz (in der Regel 20 %).
Wenn Sie „MwSt der Rechnung verwenden" belassen, verwendet das Modul die auf der importierten Rechnung ausgewiesene MwSt.

Beispiel — Rechnung eines deutschen Lieferanten

Nettobetrag: 1 000 €
MwSt auf der Rechnung: 19 % (190 €) — deutscher Satz, in Frankreich nicht abziehbar
Konfigurierter Reverse-Charge-Satz: 20 %
Berechnete Reverse-Charge-MwSt: 1 000 € × 20 % = 200 €
→ 200 € in Zeile 17 erklärt (geschuldet) + 200 € in Zeile 20 (abziehbar bei vollem Vorsteuerabzugsrecht)

OSS-Verfahren — B2C-Fernverkäufe (Schwelle 10 000 €)

Wenn Ihre innergemeinschaftlichen B2C-Fernverkäufe 10 000 € im Kalenderjahr überschreiten, fallen Sie unter den OSS-Schalter (One Stop Shop). Diese Verkäufe werden zum Satz des Verbraucherlandes besteuert und über OSS erklärt — sie erscheinen nicht in Ihrer nationalen CA3. Das Modul verwaltet diesen Umfang über die OSS-Option in der Konfiguration.

Unterhalb der Schwelle von 10 000 €: Sie können zum MwSt-Satz des Verbraucherlandes fakturieren, die Bemessungsgrundlagen jedoch in Zeile A1 zum normalen französischen Satz (20 %) erklären. Das Modul wendet diese Regel an: eine Bemessungsgrundlage A1 mit 20 % darf nicht als Fehler interpretiert werden, wenn die ursprüngliche Fakturierung zu einem niedrigeren ausländischen Satz erfolgte.

Verwaltung des Anlagevermögens

Die MwSt auf Anlagevermögen wird gesondert behandelt (Zeile 19), um die französischen steuerlichen Vorschriften zu erfüllen. Sie wird automatisch aus Zeile 20 ausgeschlossen, um jede Doppelzählung zu vermeiden.

Automatische Kontoerkennung

Das Modul identifiziert Anlagevermögen anhand der Hauptbucheinträge, die auf folgende Konten gebucht wurden:

Konten der Klasse 2 (Sach- und immaterielle Anlagen);
alle weiteren im Assistenten manuell konfigurierten Konten.

Verwenden Sie den Kontenzuordnungsassistenten (Konfigurationsseite), um die Liste der Anlagevermögenskonten automatisch aus Ihrem Dolibarr-Kontenplan vorzubefüllen.

Berechnung der abziehbaren MwSt auf Anlagevermögen

Das Modul extrahiert die MwSt aus Lieferantenrechnungen, bei denen mindestens eine Zeile auf ein Anlagevermögenskonto gebucht wurde. Diese MwSt fließt ausschließlich in Zeile 19; der Anteil „sonstige Güter und Dienstleistungen" derselben Rechnung fließt in Zeile 20.

Strenge Kontenzuordnungsprüfung: Verfügt eine Rechnung über keine Kontenzuordnung (kein im Hauptbuch bewegtes Konto), wird sie von der Berechnung ausgeschlossen — auch wenn ihre MwSt null ist. Dieses Verhalten ist beabsichtigt und nicht konfigurierbar.

Modulaktualisierung

Daten sichern
Erstellen Sie vor jeder Operation eine vollständige Sicherung Ihrer Dolibarr-Datenbank und der Moduldateien.
Neue Version herunterladen
Laden Sie die neueste Version von DoliStore herunter. Der Versionsverlauf ist auf der Versionshinweise-Seite verfügbar.
Modul deaktivieren
Deaktivieren Sie das Modul TVA CERFA 3310-CA3 in Dolibarr vorübergehend.
Dateien ersetzen
Überschreiben Sie die alten Dateien mit denen der neuen Version (manuelle Methode) oder nutzen Sie die Funktion „Externes Modul bereitstellen" von Dolibarr.
Modul reaktivieren
Aktivieren Sie das Modul erneut, um das automatische Datenbankupdate auszulösen.
Funktionsfähigkeit prüfen
Berechnen Sie eine bestehende Erklärung neu und vergleichen Sie die Summen, um sicherzustellen, dass keine Regression eingeführt wurde.

Hinweis: Lesen Sie die Versionshinweise, um Neuerungen, Korrekturen und bei jedem Update gegebenenfalls erforderliche manuelle Aktionen zu erfahren.

Fehlerbehebung

Die Datenbanktabellen wurden nicht erstellt
Rufen Sie die Hauptseite des Moduls auf und klicken Sie auf „Tabellen installieren". Falls der Fehler bestehen bleibt, überprüfen Sie, ob der MySQL-Benutzer über CREATE TABLE-Rechte auf der Dolibarr-Datenbank verfügt.

Die MwSt-Beträge sind falsch
Prüfen Sie:

die Konfiguration des MwSt-Satzes für europäische Rechnungen;
die konfigurierten Anlagevermögenskonten (ein falsch klassifiziertes Konto kann zwischen Zeile 20 und Zeile 19 wechseln);
die gewählten Zeitraumdaten (Rechnungsdatum vs. Buchungsdatum);
den Status der Rechnungen — es werden nur validierte Rechnungen berücksichtigt;
die Kontenzuordnung im Hauptbuch (Zeilen ohne Zuordnung werden ausgeschlossen).

Das PDF wird nicht generiert
Prüfen Sie:

ob das PDF-Modul (TCPDF) in Dolibarr aktiviert ist;
die Schreibrechte auf dem Ordner documents/ von Dolibarr;
die PHP-Konfiguration: memory_limit ≥ 128 MB, max_execution_time ≥ 60 s.

Eine Schutzregel blockiert die Validierung
Lesen Sie die angezeigte Fehlermeldung sorgfältig — jede Regel R1–R10 gibt genau die inkonsistente Zeile und den erwarteten Wert an. Korrigieren Sie die Kontenzuordnung oder die Konfigurationsparameter, die die Abweichung verursachen.

Häufig gestellte Fragen

Welche Dolibarr-Versionen werden unterstützt?

Das Modul ist kompatibel mit Dolibarr 19.0 → 23.x.

Welche französischen MwSt-Sätze werden verwaltet?

Das Modul unterstützt die fünf in Frankreich gültigen Sätze (Festland und DOM): 20 %, 10 %, 5,5 %, 2,1 % und den DOM-Satz 8,5 %.

Verwaltet das Modul Gutschriften?

Ja. Kundengutschriften werden von der geschuldeten MwSt abgezogen; Lieferantengutschriften werden von der abziehbaren MwSt abgezogen.

Kann ich eine validierte Erklärung ändern?

Eine validierte Erklärung (Status Validiert) kann geändert werden, solange sie nicht gesperrt ist. Einmal Gesperrt, kann sie nicht mehr bearbeitet werden — nur eine explizite Stornierung ist möglich.

Deckt das Modul den vollständigen Umfang der CA3 ab?

Nein — und das ist dokumentiert. Die aktuelle Version berechnet automatisch den Hauptteil der CA3 (Seite 1). Folgende Elemente werden noch nicht abgedeckt: Anhänge 3310-TER, 3310-A und 3310-TIC; Importzeilen I1–I6 (in Konsolidierung); MwSt auf Erdölerzeugnisse; Sonder-Kopfzeilenfelder (Steuervertreter des einzigen Steuerpflichtigen, DGE-Verfahren, Null-Erklärung). Verfolgen Sie die Weiterentwicklung in den Versionshinweisen.

Unterstützt das Modul das vereinfachte Verfahren (CA12)?

Nein. Das Modul verarbeitet ausschließlich das reguläre Normalbesteuerungsverfahren (Formular CA3). Das vereinfachte Verfahren CA12 wird nicht unterstützt.

Wie funktioniert der MwSt-Gutschriftsvortrag?

Zeile 22 (vorgetragene Gutschrift) wird automatisch aus Zeile 27 der Vorperiode gespeist, die dem verbleibenden Gutschriftsbetrag nach einem eventuell beantragten Erstattungsbetrag (Zeile 26) entspricht. Diese Kette ist ein blockierender Invariant: jede Unterbrechung wird von der entsprechenden Schutzregel R erkannt.

Wie erhalte ich Unterstützung?

Lesen Sie diese Dokumentation und wenden Sie sich dann an den Support: tvacerfa3310@ptitetete.org — Antwort innerhalb von 24–48 Werktunden.

Nützliche Links

Zur Startseite Versionshinweise Im DoliStore kaufen Support kontaktieren