Installation

Voraussetzungen

• Craft CMS 5.3 oder neuer
• Craft Commerce 5.0 oder neuer
• PHP 8.2 oder neuer

Installation

composer require justinholtweb/craft-datevz
php craft plugin/install datevz

Vor dem ersten Export

Öffnen Sie Einstellungen → Plugins → Datevz. Fünf Dinge müssen stimmen; alles Übrige hat eine brauchbare Voreinstellung.

1. Die Angaben der Kanzlei

Beraternummer und Mandantennummer erhalten Sie von Ihrem Steuerberater — sie identifizieren die Kanzlei und diesen Mandanten innerhalb von DATEV. Ohne sie liest DATEV die Datei gar nicht erst ein, und Datevz weigert sich, eine zu schreiben.

Beide Felder akzeptieren eine Umgebungsvariable, sodass die Nummern in der .env stehen können statt in der Projektkonfiguration:

DATEV_BERATER=1234567
DATEV_MANDANT=54321

2. Sachkontenlänge

Wie viele Stellen die Sachkonten haben — üblicherweise 4. Ist das falsch gesetzt, lehnt DATEV den Import mit einer Meldung zur Kontenstammdatei ab, denn Debitorenkonten haben immer eine Stelle mehr als die Sachkonten. Bei vierstelligen Sachkonten sind Debitorennummern fünfstellig.

3. Kontenrahmen

Wählen Sie SKR03 oder SKR04 und klicken Sie auf die passende Schaltfläche Aus SKR… befüllen. Sie schreibt die Kontonummern nur dort hinein, wo Sie sie leer gelassen haben — eine Nummer, die Ihre Kanzlei vorgegeben hat, wird nie überschrieben.

Die Vorgaben sind ein Ausgangspunkt, keine Beratung. Zwei Shops auf demselben Kontenrahmen können berechtigterweise auf unterschiedliche Konten buchen, und welche für Sie richtig sind, weiß nur Ihr Steuerberater.

4. Das Debitorenkonto

Im Modus Sammelkonto werden alle Forderungen auf ein Konto gebucht — 1400 im SKR03, 1200 im SKR04. Das ist richtig für einen Shop mit vielen einmaligen Käufern.

Stellen Sie auf ein Personenkonto je Kunde um, wenn Ihre Kanzlei einzelne Forderungen verfolgt. Datevz vergibt dann eine Nummer aus dem von Ihnen gesetzten Nummernkreis, gebunden an den Kunden und ersatzweise an dessen E-Mail-Adresse — wer als Gast bestellt und sich später registriert, behält so eine Nummer.

5. Wirtschaftsjahr

Entspricht das Wirtschaftsjahr des Mandanten nicht dem Kalenderjahr, tragen Sie Monat und Tag des Beginns ein. Die Spalte Belegdatum enthält nur Tag und Monat — das Jahr kommt aus dem Header —, und genau hier wird entschieden, in welchem Jahr die Buchungen landen.

Der erste Export

Datevz → Export, wählen Sie den Vormonat und klicken Sie Vorschau, bevor Sie sonst etwas anklicken. Sie sehen jede Buchung, die der Stapel enthalten würde, und jedes gefundene Problem — ohne dass eine Datei entsteht.

Ist die Vorschau sauber, erzeugen Sie mit Stapel erzeugen die Datei und geben sie Ihrem Steuerberater. Bitten Sie ihn um einen Testimport, bevor Sie sich auf den monatlichen Rhythmus verlassen — ein Kontenrahmen ist mandantenspezifisch, und eine Runde genügt, um das zu klären.