Kleinunternehmer §19 UStG

Sylius-Plugin für die Kleinunternehmerregelung nach §19 UStG: 0-%-Steuerkategorie, Preis-Migration per Admin oder Konsole, Hinweis in Storefront, Shop API und Gutschrift-PDF.

English Version

Zurück zu Sylius Plugins

Kleinunternehmer §19 UStG

Diese Dokumentation bezieht sich immer auf die aktuellste veröffentlichte Version.

Live Demo: Teste dieses und weitere Plugins live — ohne Installation, ohne Risiko: demo.markus-michalski.net

Überblick

Als Kleinunternehmer nach §19 UStG weist du keine Umsatzsteuer aus. In Sylius heißt das: Alle Produkte brauchen eine Steuerkategorie mit 0 % Steuersatz, und Kunden müssen an den Stellen, wo sonst Steuern stehen, einen Hinweis lesen. Dieses Plugin erledigt beides. Mit einem Schalter im Admin legt es die 0-%-Steuerkategorie an, stellt deine bestehenden Produktpreise per Knopfdruck oder Konsolenbefehl um und blendet den Hinweis in Produktseiten, Warenkorb, Checkout, Bestellübersichten und Gutschrift-PDFs ein.

Der Hinweis erscheint nur dort, wo er stimmt: neben einem Artikel, der noch Steuern berechnet, oder einer Summe mit Steuern bleibt er weg. So steht nie ein Hinweis neben einem Preis, der ihm widerspricht.

graph LR
    A["Admin: Regelung aktivieren"] --> B["0-Prozent-Steuerkategorie anlegen"]
    B --> C["Produktpreise migrieren (Admin-Button oder CLI)"]
    C --> D{"Hinweis gültig?"}
    D -->|Ja| E["Twig-Storefront: Hinweis"]
    D -->|Ja| F["Shop API: kleinunternehmerNoticeApplies"]
    D -->|Ja| G["Gutschrift-PDF mit sylius/refund-plugin"]
    D -->|Nein| H["Kein Hinweis"]

Dokumentation

Seite	Inhalt
Installation	Composer, Bundle, Routen, Setup-Befehl, Update, Deinstallation
Konfiguration	Einstellungsseite im Admin, Hinweistexte, weitere Sprachen, Praxis-Beispiele
Preis-Migration	Produktpreise auf 0 % umstellen und zurücksetzen, Admin-Button und Konsolenbefehl
Storefront	Wo der Hinweis erscheint, wann er erscheint, Gutschrift-PDF, Twig-Funktionen
Shop API	Das Feld `kleinunternehmerNoticeApplies` für Headless-Frontends
Fehlerbehebung und FAQ	Typische Probleme, bekannte Einschränkungen, häufige Fragen
Technische Details	Architektur, Plugin-Struktur, Tabellen, Migrationen, Erweiterbarkeit

Features

Feature	Beschreibung
Ein Schalter	Aktivieren unter Admin → MMKreativ Plugins → Kleinunternehmer §19 UStG legt die 0-%-Steuerkategorie `kleinunternehmer_zero` samt Steuersatz an
Preis-Migration	Produktvarianten per Admin-Button oder `mmd:kleinunternehmer:migrate-prices` auf 0 % umstellen, mit Vorschau (`--dry-run`) und Rückweg (`--restore`)
Hinweis in der Storefront	Produktseite, Produktkarte, Warenkorb, Checkout-Seitenleiste und Bestellübersichten
Eigene Hinweistexte	Deutscher und englischer Text im Admin überschreibbar, leer lassen für den Standardtext
Shop API	Boolesches Feld `kleinunternehmerNoticeApplies` an Warenkorb/Bestellung, Produkt und Produktvariante
Gutschrift-PDF	Mit `sylius/refund-plugin` steht der Hinweis auch auf Gutschriften ohne Steuer, in der Sprache der Gutschrift
Setup-Befehl	`mmd:kleinunternehmer:setup` führt nur die Migrationen dieses Plugins aus und lässt sich nach jedem `composer update` erneut ausführen

Anforderungen

Anforderung	Version	Hinweise
Sylius	^2.2	Getestet gegen Sylius 2.2 und 2.3
PHP	^8.3
Symfony	^7.4
Zone `DE`	-	Eine Zone mit dem Code `DE` muss existieren, sonst lässt sich die Regelung nicht aktivieren
`sylius/refund-plugin`	optional	Nur nötig, wenn der Hinweis auf Gutschrift-PDFs stehen soll

Lizenz

Kommerzielle Lizenz: Eine Lizenz gilt für eine Sylius-Installation (alle Channels sowie deren Entwicklungs- und Staging-Umgebungen). Eine Weitergabe ist nicht erlaubt, Updates sind 12 Monate ab Kauf enthalten.

Support

Bei Fragen zur Lizenz, technischen Fragen oder Fehlern erreichst du mich unter support@markus-michalski.net.