English Version

Zurück zur Übersicht

Kleinunternehmer: Fehlerbehebung und FAQ

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

Fehlerbehebung

Symptom: In der Admin-Sidebar fehlt unter „MMKreativ Plugins“ der Eintrag „Kleinunternehmer §19 UStG“, oder das Admin bricht mit einem Routing-Fehler ab.
Prüfen: Ist das Bundle in config/bundles.php registriert? Ist der Routen-Import aus der Installation vorhanden?
Lösung: Fehlenden Eintrag ergänzen und bin/console cache:clear ausführen. Der Menüpunkt zeigt auf die Route mmd_sylius_kleinunternehmer_admin_settings. Ist das Bundle registriert, aber der Routen-Import fehlt, kann das Rendern des Menüs mit einem Routing-Fehler scheitern. bin/console mmd:kleinunternehmer:setup prüft den Import und gibt einen Snippet aus.

Symptom: Beim Speichern erscheint „Die Regelung konnte nicht aktiviert werden: Es existiert keine Zone mit dem Code „DE“. Lege zuerst eine Zone für Deutschland an.“
Prüfen: Gibt es unter Admin → Konfiguration → Zonen eine Zone mit genau dem Code DE?
Lösung: Lege die Zone an und speichere erneut. Das Plugin erstellt keine Zone selbst und leitet die Zone auch nicht aus vorhandenen Steuersätzen ab.

Symptom: mmd:kleinunternehmer:setup bricht ab und meldet, die Migrationen seien nicht bei Doctrine registriert.
Prüfen: Ist das Bundle registriert, und wurde der Cache seitdem geleert? Steht sylius_core.prepend_doctrine_migrations nicht auf false?
Lösung: Bundle-Eintrag und Einstellung prüfen, Cache leeren und den Befehl erneut ausführen.

Symptom: mmd:kleinunternehmer:setup bricht ab und verlangt doctrine:migrations:migrate.
Prüfen: Sind Migrationen von Sylius selbst noch offen?
Lösung: Einmal bin/console doctrine:migrations:migrate ausführen, danach den Setup-Befehl wiederholen.

Symptom: Auf Produktseite oder Produktkarte erscheint kein Hinweis.
Prüfen: Ist die Regelung aktiv? Liegen bei einem Produkt wirklich alle aktiven Varianten auf der Steuerkategorie kleinunternehmer_zero? Eine einzelne nicht migrierte Variante genügt, damit das Produkt keinen Hinweis bekommt.
Lösung: Auf der Einstellungsseite die Zähler der Karte „Preise migrieren“ ansehen und die offenen Varianten migrieren, siehe Preis-Migration.

Symptom: Im Warenkorb oder Checkout fehlt der Hinweis, obwohl die Regelung aktiv ist.
Prüfen: Steht bei „Steuern gesamt“ ein Betrag größer 0? Der Hinweis erscheint nur, wenn beide Steuersummen 0 sind.
Lösung: Ein Artikel ist noch nicht migriert. Migriere ihn, danach erscheint der Hinweis.

Symptom: Der Hinweis fehlt, obwohl eine Seite im Theme ihn zeigen sollte.
Prüfen: Ersetzt dein Theme das Template mit dem Hook-Punkt? Welcher Hook wo liegt, steht unter Storefront.
Lösung: Hook im Theme-Template wieder rendern oder die Twig-Funktionen kleinunternehmer_notice_applies() und kleinunternehmer_notice_text() direkt nutzen.

Symptom: Migration meldet, dass Varianten übersprungen wurden.
Prüfen: Hat die Variante einen Code und für die Zone DE einen Steuersatz auf ihrer bisherigen Steuerkategorie?
Lösung: Fehlendes ergänzen und die Migration erneut starten. Solche Varianten zählen bis dahin weiter als „noch nicht migriert“. Varianten, die gar keine Steuerkategorie haben, werden nie ausgewählt und tauchen weder in den Zählern noch in einer Warnung auf. Weise ihnen eine Kategorie zu, wenn sie mitmigriert werden sollen.

Symptom: Nach --restore weicht ein Bruttopreis um einen oder zwei Cent vom ursprünglichen ab.
Prüfen: Der Nettopreis wurde beim Migrieren auf den Cent gerundet.
Lösung: Es gibt keine. Korrigiere die betroffenen Preise von Hand, falls sie auf den Cent stimmen müssen.

Symptom: Das Gutschrift-PDF zeigt keinen Hinweis.
Prüfen: Ist sylius/refund-plugin installiert? Ist die Regelung aktiv? Enthält die Gutschrift Steuern? Hat eine andere Erweiterung das Template des Gutschrift-PDFs ersetzt?
Lösung: Der Hinweis erscheint nur bei aktiver Regelung und einer Gutschrift ohne Steuer. Ist das Template von anderer Stelle ersetzt, übernimm den Hinweis dort mit den Twig-Funktionen aus der Storefront-Seite.

Symptom: Das Feld kleinunternehmerNoticeApplies fehlt in der Shop-API-Antwort.
Prüfen: Ist es eine Shop-API-Antwort (nicht Admin API)? Gehört die Antwort zu einer der Serialisierungsgruppen auf der Seite Shop API? Ist der Cache geleert?
Lösung: Cache leeren. Eigene Serialisierungsgruppen werden nicht erfasst.

Bekannte Einschränkungen

• Nur Gutschriften, keine Rechnungen. Der Hinweis wird auf Gutschrift-PDFs des Refund-Plugins ergänzt. Für Rechnungen und Stornobelege gibt es keine Integration.
• Zone DE ist Pflicht. Aktivierung und Migration brauchen eine Zone mit dem Code DE.
• Zurücksetzen nicht cent-genau. Siehe Preis-Migration.
• Zurücksetzen nur per Konsole. Im Admin gibt es nur die Migration zur Kleinunternehmerregelung.
• Varianten ohne Steuerkategorie, Code oder DE-Steuersatz werden nicht migriert. Ohne Steuerkategorie werden sie nicht einmal gezählt.
• Nur der Verkaufspreis wird umgerechnet, nicht Original- und Mindestpreis, und die Formel nimmt Brutto-Preise an (siehe Preis-Migration).
• Nur Deutsch und Englisch im Admin editierbar. Weitere Sprachen brauchen eine Übersetzungsdatei.
• Shopweite Einstellung. Sie gilt für alle Channels gleich.
• Keine eigenen Erweiterungspunkte. Das Plugin löst keine Events aus und definiert keine Service-Tags (siehe Technische Details).

FAQ

Allgemein

Ändert das Aktivieren meine Preise? Nein. Aktivieren legt nur die 0-%-Steuerkategorie an. Preise ändern sich erst, wenn du sie migrierst.

Bekomme ich Rechtssicherheit? Das Plugin setzt die Steuerkategorie und den Hinweis technisch um. Ob §19 UStG für dein Unternehmen gilt und welcher Wortlaut passt, klärst du mit deiner Steuerberatung.

Konfiguration

Kann ich die Regelung für einen einzelnen Channel ausschalten? Nein. Die Einstellung gilt shopweit.

Wo ändere ich den Hinweistext? Auf der Einstellungsseite, siehe Konfiguration.

Kompatibilität

Funktioniert das Plugin ohne Refund-Plugin? Ja. Das Refund-Plugin ist nur für den Hinweis auf Gutschrift-PDFs nötig.

Funktioniert es mit einer eigenen Variantenklasse? Ja. Die Migration nutzt die in deiner Installation gemappte Variantenklasse.