Kleinunternehmer: Konfiguration
Einstellungsseite des Sylius-Plugins Kleinunternehmer §19 UStG: Regelung aktivieren, eigene Hinweistexte in Deutsch und Englisch, weitere Sprachen per Übersetzungsdatei, Praxis-Beispiele.
Kleinunternehmer: Konfiguration
Live Demo: Teste dieses und weitere Plugins live — ohne Installation, ohne Risiko: demo.markus-michalski.net
Admin-Oberfläche
Die Einstellungsseite findest du unter Admin-Sidebar → MMKreativ Plugins → Kleinunternehmer §19 UStG (Pfad /admin/kleinunternehmer/settings, wobei admin dem Admin-Pfad deiner Installation entspricht). Unter dem Seitentitel steht die installierte Plugin-Version.
Die Einstellungen gelten für den ganzen Shop, nicht pro Channel. Es gibt genau einen Datensatz, und das Plugin hat weder eine
config/packages/*.yaml-Datei noch Umgebungsvariablen. Alles stellst du auf dieser Seite ein.
Einstellungen
| Einstellung | Standard | Beschreibung |
|---|---|---|
| Kleinunternehmerregelung aktiv | aus | Schaltet die Regelung ein. Beim Aktivieren legt das Plugin die 0-%-Steuerkategorie kleinunternehmer_zero samt Steuersatz kleinunternehmer_zero_rate sofort an, sodass du sie neuen Produkten schon vor der Migration zuweisen kannst |
| Storefront-Hinweistext (Deutsch) | leer | Überschreibt den deutschen Hinweis, maximal 1000 Zeichen. Leer lassen für „Gemäß §19 UStG wird keine Umsatzsteuer berechnet.“ |
| Storefront-Hinweistext (Englisch) | leer | Überschreibt den englischen Hinweis, maximal 1000 Zeichen. Leer lassen für „No VAT charged according to §19 UStG (German small business regulation).“ |
Das erstmalige Anlegen der 0-%-Steuerkategorie braucht eine Zone mit dem Code
DE. Fehlt sie, bricht das Speichern mit einer Fehlermeldung ab, und die Regelung bleibt ausgeschaltet. Existiert die Kategoriekleinunternehmer_zeroschon, wird sie wiederverwendet.
Bestehende Produkte behalten ihre Steuerkategorie, bis du sie migrierst. Unter dem Formular zeigt eine zweite Karte, wie viele Varianten noch migriert werden müssen, und bietet den Migrationsknopf an, siehe Preis-Migration.
Hinweistexte
Der Text gilt für die gesamte Storefront und für Gutschrift-PDFs. Welche Sprache verwendet wird, richtet sich nach der Sprache des Besuchers, bei Gutschriften nach der Sprache, in der die Gutschrift ausgestellt wurde.
- Deutsch und Englisch: Ein ausgefüllter Text im Admin gewinnt, ein leeres Feld fällt auf den mitgelieferten Standardtext zurück.
- Andere Sprachen: Sylius hat keine Oberfläche zum Bearbeiten von Übersetzungen, deshalb sind weitere Sprachen im Admin nicht editierbar. Lege stattdessen in deinem Projekt eine Datei
translations/messages.<locale>.yamlan, zum Beispieltranslations/messages.fr.yaml:
mmd_sylius_kleinunternehmer:
notice:
storefront: 'Pas de TVA applicable selon l’article 19 UStG (régime allemand des petites entreprises).'
Danach bin/console cache:clear ausführen. Eine Sprache ohne eigene Datei zeigt den Text, den der Übersetzer über die Fallback-Sprachen deiner Installation (framework.translator.fallbacks) findet. Die Admin-Felder gelten für alle Sprachvarianten von Deutsch und Englisch, zum Beispiel auch für de_AT.
Admin-Grids
Das Plugin registriert kein Sylius-Grid. Die Einstellungen sind ein einzelnes Formular, keine Liste.
Praxis-Beispiele
Ersteinrichtung für einen neuen Shop. Zone DE prüfen, Regelung aktivieren, Speichern. Neue Produkte weist du direkt die Steuerkategorie kleinunternehmer_zero zu. Es gibt nichts zu migrieren, die Karte zeigt „0 Variante(n) noch nicht migriert“.
Bestehender Shop mit 19 % und 7 %. Regelung aktivieren, danach auf der Karte „Preise migrieren“ den Hinweis lesen und mit Jetzt migrieren bestätigen. Zuvor kannst du per bin/console mmd:kleinunternehmer:migrate-prices --to-small-business --dry-run zählen lassen, wie viele Varianten betroffen sind. Details stehen unter Preis-Migration.
Eigener Hinweistext. Trage im Feld „Storefront-Hinweistext (Deutsch)“ zum Beispiel „Als Kleinunternehmer im Sinne von §19 UStG berechnen wir keine Umsatzsteuer.“ ein. Der Text erscheint ab dem nächsten Seitenaufruf überall, wo der Standardhinweis stand.
Regelung ausschalten. Haken entfernen und speichern. Der Hinweis verschwindet sofort. Migrierte Varianten behalten ihren 0-%-Preis, die Karte warnt dann „Die Regelung ist inaktiv, aber … bereits migrierte Variante(n) berechnen weiterhin keine Umsatzsteuer“. Willst du die ursprünglichen Steuerkategorien zurück, setze die Preise mit --restore zurück.