English Version

Zurück zur Übersicht

Kleinunternehmer: Fehlerbehebung

Typische Probleme

Die Storefront zeigt weiterhin die normalen MwSt.-Texte

• Prüfung: Steht Kleinunternehmerregelung aktiv auf "Ein"? Nach der Installation steht sie auf "Aus". Ist im betroffenen Verkaufskanal ein eigener Wert gesetzt?
• Lösung: Einstellung einschalten, bei Bedarf pro Verkaufskanal prüfen, Cache leeren. Hat dein Theme die Blöcke der Seite überschrieben, siehe Storefront.

Die Preise sind weiterhin mit Steuer berechnet

• Prüfung: Das Plugin ändert keine Berechnung, sondern nur Anzeigen. Liegen die Produkte noch auf dem alten Steuersatz?
• Lösung: Produkt-Migration ausführen und danach mit einer Testbestellung prüfen. Werden Steuern aus anderen Quellen berechnet, etwa aus der Konfiguration einer Versandart, liegt das außerhalb des Plugins.

Die Migrationskarte meldet "Small business tax rule not found. Please activate the plugin first."

• Prüfung: Der Steuersatz Kleinunternehmer §19 UStG (0%) fehlt, weil er nie angelegt oder gelöscht wurde.
• Lösung: Plugin deaktivieren und erneut aktivieren. Die Aktivierung legt den Steuersatz neu an. Prüfe danach, welcher Standard-Steuersatz im Shop eingestellt ist.

Die Migrationskarte erscheint nicht oder zeigt einen Ladefehler

• Prüfung: Der Benutzer braucht mindestens das Recht product:read. Zeigt die Karte "Fehler beim Laden des Migrationsstatus.", antwortet die Admin-API nicht wie erwartet.
• Lösung: Rechte der Rolle prüfen, Cache leeren und die Administration neu bauen, wie bei jedem Plugin mit Admin-Erweiterung.

Die Migration über den Admin bricht ab

• Prüfung: Bei großen Katalogen (die Karte warnt ab mehr als 1.500 Produkten) kann der Request an Server-Zeitlimits scheitern.
• Lösung: Den CLI-Befehl verwenden, siehe Produkt-Migration. Der Befehl macht dort weiter, wo Produkte noch nicht auf dem 0%-Steuersatz liegen.

Der CLI-Befehl meldet "Tax rate 19% not found in the system."

• Prüfung: Für den Wert von --tax-rate gibt es keinen Steuersatz mit genau diesem Prozentsatz. Der Befehl listet die vorhandenen Steuersätze auf.
• Lösung: Einen vorhandenen Satz angeben oder den Steuersatz im Shop anlegen.

Der Befehl mmd:kleinunternehmer:migrate oder die Optionen --from-small-business, --tax-id, --list-taxes sind unbekannt

• Prüfung: Diese Namen gibt es nicht. Der Befehl heißt mmd:kleinunternehmer:migrate-products.
• Lösung: --to-small-business bzw. --restore --tax-rate=<Satz> verwenden, siehe Produkt-Migration.

Der Hinweis fehlt auf einer Rechnung

• Prüfung: Ist die Regelung für den Verkaufskanal der Bestellung aktiv? Wurde das Dokument vor der Aktivierung erzeugt? Handelt es sich um einen anderen Dokumenttyp als Rechnung, Storno oder Gutschrift? Ersetzt ein Theme oder Plugin die Dokumentvorlage?
• Lösung: Einstellung prüfen, das Dokument neu erzeugen, Vorlagenkette prüfen. Bereits erzeugte Dokumente ändert das Plugin nicht.

In E-Mails fehlt der Hinweis

• Prüfung: Das Plugin ändert keine E-Mail-Vorlagen.
• Lösung: Den Text selbst in der Vorlage ergänzen, siehe Dokumente und E-Mails.

Häufige Fragen

Kann ich die Regelung nur für einen Verkaufskanal anzeigen?

Ja, die Einstellung lässt sich je Verkaufskanal überschreiben. Steuersätze der Produkte und der Standard-Steuersatz sind aber global, siehe Konfiguration.

Was passiert mit bestehenden Bestellungen?

Das Plugin ändert keine Bestellungen. Dokumente, die nach der Aktivierung für eine ältere Bestellung neu erzeugt werden, nutzen die aktuellen Vorlagen und tragen den Hinweis.

Muss ich die Produkte migrieren?

Die Anzeige funktioniert auch ohne Migration, die Steuersätze und Preise der Produkte bleiben dann aber unverändert. Für 0%-Preise führst du die Produkt-Migration aus.

Prüft das Plugin Umsatzgrenzen oder meine Berechtigung zur Kleinunternehmerregelung?

Nein. Das Plugin prüft weder Umsätze noch Voraussetzungen. Ob die Regelung für dich gilt, klärst du mit deiner Steuerberatung.

Kann ich die Hinweistexte ändern?

Ja, alle Texte sind Snippets, siehe Konfiguration.

Funktioniert das Plugin mit meinem Theme?

Das Plugin überschreibt Blöcke der Storefront-Templates. Themes, die auf dem Standard-Theme aufbauen und diese Blöcke nicht selbst ändern, übernehmen die Änderungen. Hat ein Theme dieselben Blöcke überschrieben, entscheidet die Vererbungsreihenfolge.