MwSt-Radar pixi App: Dokumentation
Die EU-Datenbank „Taxes in Europe“ (TEDB) ist eine Informationsquelle der Europäischen Kommission und nicht rechtsverbindlich. Die Sätze für Länder außerhalb der EU (z. B. Schweiz, Großbritannien, Norwegen) stammen nicht aus der EU-Datenbank, sondern werden von iungo COMMERCE anhand der amtlichen Quellen gepflegt. Maßgeblich ist das Recht des jeweiligen Landes. Die App ersetzt keine steuerliche Beratung. Für Sonderfälle (z. B. Steuersätze für bestimmte Warengruppen) prüfe die Artikel-Zuordnung in pixi zusätzlich selbst.
1. Einleitung
Was die App macht
In DESCARTES pixi pflegst du die Mehrwertsteuersätze je Land von Hand
(Control Center > Tabellen > Mehrwertsteuersätze). Ist dort ein Satz falsch oder veraltet,
steht er falsch auf jeder Rechnung in dieses Land.
Das MwSt-Radar vergleicht diese Sätze jede Stunde mit der EU-Datenbank „Taxes in Europe“ (TEDB)
der Europäischen Kommission, für die Schweiz, Liechtenstein, Großbritannien und Norwegen mit den
amtlichen Sätzen, die iungo COMMERCE pflegt. Es zeigt dir im Dashboard, wo pixi und die amtlichen Sätze nicht zusammenpassen,
welche Satzänderungen angekündigt sind und ob du sie schon in pixi hinterlegt hast.
Auf Wunsch bekommst du eine E-Mail, sobald sich etwas ändert.
Was die App nicht macht
- Sie ändert nichts in pixi. Die App liest nur. Neue Sätze trägst du selbst ein.
- Sie prüft keine Artikel und keine Bestellungen. Ob ein Artikel in pixi richtig als „hoch“ oder „niedrig“ eingestuft ist, sieht sie nicht.
- Sie ersetzt keine Steuerberatung. Die EU-Datenbank ist eine Informationsquelle, keine Rechtsgrundlage.
Voraussetzungen und Kosten
- Zugang zum iungo Portal mit hinterlegter pixi API
- pixi Version mit dem API-Call
pixiGetVATByCountries (ab LOU Update 46)
- Mindestens ein EU-Land mit Satz in der pixi-Tabelle „Mehrwertsteuersätze“
Die App ist kostenlos. Es gibt keinen Testzeitraum und keine Kündigungsfrist.
2. Einrichtung
In 5 Schritten startklar
- Die App im Portal unter „pixi App's“ kostenlos aktivieren.
- Im Menü des MwSt-Radars „Konfiguration“ öffnen und die pixi API auswählen.
- „Stündliche Prüfung aktivieren“ anhaken, die Vorschau wählen (empfohlen: 90 Tage) und optional eine E-Mail-Adresse eintragen.
- „Verbindung testen und Einstellungen speichern“ klicken. Die App testet die Verbindung zu pixi. Nur wenn der Test klappt, bleibt die Konfiguration aktiv.
- Kurz danach läuft die erste Prüfung. Das Ergebnis siehst du im Dashboard. Hast du eine E-Mail-Adresse eingetragen, bekommst du eine Bestätigung mit dem Ergebnis.
Konfiguration
| Feld | Bedeutung |
| Aktiv |
Schaltet die stündliche Prüfung für diese pixi API ein. Ist sie aus, prüft die App nicht automatisch. „Jetzt prüfen“ im Dashboard funktioniert trotzdem. |
| Vorschau auf Satzänderungen |
30, 90, 180 oder 365 Tage. So weit schaut die App in der EU-Datenbank nach angekündigten Änderungen. Empfohlen sind 90 Tage. Mehr dazu unter Angekündigte Änderungen. |
| Länder ohne Satz |
Ab Werk aus: Die App prüft nur EU-Länder, für die in pixi ein Satz hinterlegt ist, und zeigt die übrigen als Hinweis. Eingeschaltet meldet sie jedes EU-Land ohne Satz als Abweichung. Mehr dazu unter Länder ohne Satz in pixi. |
| Benachrichtigung |
Optionale E-Mail-Adresse für Bestätigung, Warnung und Entwarnung. Mehr dazu unter E-Mails. |
Jede pixi API wird getrennt eingerichtet. Hast du mehrere pixi APIs im Portal, prüft die App jede für sich
und zeigt sie im Dashboard untereinander.
3. So prüft die App
Stündlicher Abgleich
Jede Stunde liest die App die Sätze aus pixi und vergleicht sie mit der EU-Datenbank. So fällt auch eine
versehentliche Änderung in pixi spätestens nach einer Stunde auf.
- Die Sätze aus pixi liest die App bei jeder Prüfung neu, und zwar die Sätze, die heute gelten.
- Die Daten der EU-Datenbank hält sie bis zu 6 Stunden zwischen. Die EU ändert ihre Angaben selten, und die Abfrage dauert einige Sekunden.
- Schlägt eine Prüfung fehl, etwa weil pixi oder die EU-Datenbank nicht erreichbar ist, speichert die App das als fehlgeschlagen und versucht es bei der nächsten Prüfung erneut. Eine E-Mail gibt es dafür nicht.
Normalsatz und ermäßigter Satz
pixi führt je Land einen Normalsatz („MwSt. hoch“) und einen ermäßigten Satz („MwSt. niedrig“). Die App vergleicht so:
- Normalsatz: muss genau dem EU-Normalsatz entsprechen.
- Ermäßigter Satz: muss einem der ermäßigten EU-Sätze entsprechen. Dazu zählen auch stark ermäßigte Sätze und Zwischensätze. Viele Länder haben mehrere ermäßigte Sätze, pixi kennt je Land nur einen.
- Länder ohne ermäßigten EU-Satz (z. B. Dänemark): Der ermäßigte Satz in pixi darf 0 % sein oder dem Normalsatz entsprechen.
- „MwSt. berechnen“ nicht aktiv: Länder, für die pixi keine MwSt. berechnet, zeigt die App an, vergleicht sie aber nicht.
Angekündigte Änderungen
EU-Länder kündigen Satzänderungen oft Monate vorher an. Die App fragt die EU-Datenbank zum 1. jedes Monats
im Vorschau-Zeitraum und zu dessen letztem Tag ab. Weicht ein Satz von heute ab, liest sie die pixi-Sätze
zu diesem Datum und prüft, ob du den neuen Satz schon mit Startdatum hinterlegt hast.
- Hinterlegt: Alles vorbereitet, keine Warnung.
- Fehlt in pixi: Die App meldet eine Abweichung, damit du den Satz rechtzeitig einträgst.
Das angezeigte Datum bedeutet „spätestens ab“. Ändert sich ein Satz in der Monatsmitte, kann der neue Satz
früher gelten als angezeigt. Beispiel: Ein Land erhöht zum 1. Januar seinen Normalsatz von 20 % auf 21 %.
Bei 90 Tagen Vorschau siehst du das ab Anfang Oktober.
Angekündigte Änderungen zeigt die App nur für Länder, für die in pixi ein Satz hinterlegt ist und MwSt. berechnet wird.
Länder außerhalb der EU
Die EU-Datenbank enthält nur die 27 EU-Länder. Für wichtige Lieferländer außerhalb der EU,
derzeit die Schweiz, Liechtenstein, Großbritannien und Norwegen, pflegt iungo COMMERCE die Sätze selbst
anhand der amtlichen Quellen (z. B. ESTV, HMRC, Skatteetaten). Im Dashboard erkennst du diese Länder
am grauen Tag „von iungo COMMERCE gepflegt“ mit der jeweiligen Quelle.
Die App prüft diese Länder wie die EU-Länder, auch angekündigte Änderungen, sobald iungo COMMERCE den neuen Satz
mit seinem Startdatum eingetragen hat. In die meisten dieser Länder lieferst du als deutscher Händler
steuerfrei: Steht in pixi „MwSt. berechnen“ auf nein, zeigt die App das Land nur als Hinweis und vergleicht nicht.
Länder außerhalb der EU ohne Satz in pixi bleiben immer ein Hinweis, auch wenn „Länder ohne Satz“ eingeschaltet ist.
Länder ohne Satz in pixi
Ist für ein EU-Land in pixi kein Satz hinterlegt, berechnet pixi Bestellungen in dieses Land mit dem
Standardsatz ohne Land, meist dem deutschen. Ob das richtig ist, hängt von deinem Geschäft ab:
- Richtig, wenn du in das Land nicht lieferst oder mit deinen EU-Fernverkäufen an Privatkunden unter der OSS-Lieferschwelle von 10.000 € netto im Jahr liegst. Dann berechnest du die deutsche MwSt.
- Falsch, wenn du über der Lieferschwelle liegst und in das Land lieferst. Dann gilt der Satz des Lieferlandes.
Ab Werk zeigt die App Länder ohne Satz deshalb nur als grauen Hinweis unter der Tabelle, ohne Warnung und ohne E-Mail.
Lieferst du in alle EU-Länder und berechnest deren Sätze, schalte in der Konfiguration „Länder ohne Satz“ ein.
Dann meldet die App jedes EU-Land ohne Satz als Abweichung.
4. Dashboard
Aufbau
Für jede eingerichtete pixi API zeigt das Dashboard:
- Letzte Prüfung mit Datum und Uhrzeit sowie dem Ende des Vorschau-Zeitraums.
- Kennzahlen: geprüfte Länder, davon passend, Abweichungen und angekündigte Änderungen.
- Angekündigte Änderungen mit Datum, neuem EU-Satz, Satz in pixi zu diesem Datum und dem Status „hinterlegt“ oder „fehlt in pixi“.
- Sätze je Land mit Normalsatz und ermäßigtem Satz aus pixi und EU sowie dem Status. Abweichende Werte sind rot markiert.
- Hinweise zu Ländern mit mehreren ermäßigten Sätzen und zu Ländern ohne Satz in pixi.
Ist die letzte Prüfung fehlgeschlagen, steht statt der Tabellen die Fehlermeldung.
Statusmeldungen
| Status | Bedeutung |
| Passt |
pixi und EU stimmen überein. |
| Abweichung |
Der Normalsatz in pixi weicht vom amtlichen Normalsatz ab.
Der ermäßigte Satz in pixi entspricht keinem amtlichen ermäßigten Satz.
Eine Änderung ist angekündigt, der neue Satz ist in pixi noch nicht hinterlegt.
Für dieses Land ist in pixi kein Satz hinterlegt. pixi berechnet Bestellungen in dieses Land dann mit dem Standardsatz ohne Land, meist dem deutschen. (nur wenn „Länder ohne Satz“ eingeschaltet ist)
|
| Hinweis |
In pixi ist für dieses Land „MwSt. berechnen“ nicht aktiv. Die App vergleicht hier nicht.
In diesem Land gibt es keinen ermäßigten Satz. |
| Keine Daten |
Die EU-Datenbank hat für dieses Land keinen Satz geliefert. |
| Mehrere ermäßigte Sätze |
In diesem Land gibt es mehrere ermäßigte Sätze. pixi kann je Land nur einen ermäßigten Satz (MwSt. niedrig) führen. Die Markierung ändert den Status nicht. Prüfe selbst, ob der hinterlegte Satz zu deinem Sortiment passt. |
Jetzt prüfen
Mit „Jetzt prüfen“ startest du eine Prüfung sofort, zum Beispiel nachdem du einen Satz in pixi geändert hast.
Sind die EU-Daten nicht zwischengespeichert, dauert das bis zu einer Minute. Der Button steht Nutzern mit
mindestens Manager-Rechten zur Verfügung. Auch hier gilt: Eine E-Mail gibt es nur, wenn sich etwas geändert hat.
5. E-Mails
Wann die App schreibt
| E-Mail | Wann |
| Bestätigung |
Nach der ersten Prüfung an eine neu eingetragene oder geänderte Adresse, mit Ergebnis, auch wenn alles passt. So weißt du, dass die App läuft und die E-Mails ankommen. |
| Warnung |
Wenn mindestens eine Abweichung neu ist. Die E-Mail listet alle aktuellen Abweichungen. Eine Abweichung, die schon gemeldet wurde, löst keine weitere E-Mail aus. Taucht sie nach einer Behebung wieder auf, kommt erneut eine Warnung. |
| Entwarnung |
Wenn es vorher Abweichungen gab und jetzt alle Sätze passen. |
In allen anderen Fällen schreibt die App nicht. Wird nur ein Teil der Abweichungen behoben, kommt ebenfalls keine E-Mail.
Fehlgeschlagene Prüfungen lösen keine E-Mail aus.
6. Steuersätze in pixi
Wie pixi die MwSt. bestimmt
- Das Shopsystem überträgt an pixi nur die Steuerart eines Artikels (hoch, niedrig oder steuerfrei), keinen Prozentsatz.
- Den Prozentsatz nimmt pixi aus der Tabelle „Mehrwertsteuersätze“ für das Land der Bestellung.
- Ist für das Land kein Satz hinterlegt, nimmt pixi den Standardsatz ohne Land.
- Ob für ein Land überhaupt MwSt. berechnet wird, steuert die Ländereinstellung „MwSt. berechnen“.
Deshalb ist die Tabelle „Mehrwertsteuersätze“ entscheidend dafür, dass deine Rechnungen stimmen.
Grenzen von pixi
- Ein ermäßigter Satz je Land: pixi kann je Land und Startdatum nur einen Normalsatz und einen ermäßigten Satz führen. In Ländern mit mehreren ermäßigten Sätzen (z. B. Frankreich, Italien, Portugal) lassen sich Artikel mit einem anderen ermäßigten Satz über die Ländertabelle nicht abbilden.
- Steuerart je Artikel für alle Länder: Die Steuerart eines Artikels lässt sich in pixi nicht je Land einstellen. Ein Artikel mit „niedrig“ wird in jedem Land mit dessen ermäßigtem Satz berechnet, auch dort, wo er eigentlich voll besteuert wird. pixi nennt als Lösungswege, solche Artikel mit dem hohen Satz anzulegen oder Bundles je Land zu nutzen.
Beides kann das MwSt-Radar nicht lösen, aber es zeigt dir, welche Länder betroffen sind.
Satz in pixi anpassen
- Control Center > Tabellen > Mehrwertsteuersätze öffnen.
- Für das Land einen neuen Eintrag mit dem neuen Satz anlegen. Das Startdatum muss mindestens einen Tag in der Zukunft liegen.
- Offene Bestellungen, die vor dem Stichtag importiert wurden und noch nicht versendet sind (Status ANG oder HAL), nach dem Stichtag neu einlesen. Erst dann rechnet pixi sie mit dem neuen Satz.
- Im Dashboard „Jetzt prüfen“ klicken oder die nächste stündliche Prüfung abwarten.
7. Sonstiges
Häufige Fragen
Warum fehlt ein Land in der Tabelle „Sätze je Land“?
Für das Land ist in pixi kein Satz hinterlegt. Es steht im grauen Hinweis unter der Tabelle.
Soll die App es als Abweichung melden, schalte in der Konfiguration „Länder ohne Satz“ ein.
Die App meldet „Passt“, aber mein Artikel ist im Ausland anders besteuert. Wie kann das sein?
Die App prüft die Sätze je Land, nicht die Steuerart deiner Artikel. Siehe Grenzen von pixi.
Ich habe einen Satz geändert, aber das Dashboard zeigt noch den alten.
Klicke „Jetzt prüfen“ oder warte die nächste stündliche Prüfung ab. Beachte: Ein neuer Eintrag in pixi gilt erst ab seinem Startdatum.
Die Prüfung ist fehlgeschlagen. Was tun?
Meist ist pixi oder die EU-Datenbank kurz nicht erreichbar. Die App versucht es bei der nächsten Prüfung erneut.
Bleibt der Fehler, prüfe in der Konfiguration die Verbindung zu pixi oder melde dich bei uns.
Ich bekomme keine E-Mails.
Die App schreibt nur bei der ersten Prüfung, bei neuen Abweichungen und bei der Entwarnung. Prüfe die Adresse in der Konfiguration und deinen Spam-Ordner.
Wie aktuell sind die EU-Daten?
Die App fragt die EU-Datenbank spätestens alle 6 Stunden neu ab. Wie schnell die EU-Kommission eine Änderung dort einträgt, liegt nicht in unserer Hand.
Verwendete API-Calls und Daten
| System | Call | Zweck |
| pixi | pixiGetShops | Verbindungstest beim Speichern der Konfiguration |
| pixi | pixiGetVATByCountries | Sätze je Land zu einem Datum (Parameter Datetime und ChargeVAT, bei Bedarf CntCodeISO2) |
| EU TEDB | retrieveVatRates | Normalsätze und ermäßigte Sätze der EU-Länder zu einem Stichtag |
| iungo COMMERCE | – | Normalsätze und ermäßigte Sätze für Länder außerhalb der EU, von iungo COMMERCE gepflegt |
Die App speichert die Ergebnisse ihrer Prüfungen, einschließlich der von pixi gelieferten Ländersätze.
Kunden-, Bestell- oder Artikeldaten liest und speichert sie nicht.
Rechtlicher Hinweis
Die EU-Datenbank „Taxes in Europe“ (TEDB) ist eine Informationsquelle der Europäischen Kommission und nicht rechtsverbindlich. Die Sätze für Länder außerhalb der EU (z. B. Schweiz, Großbritannien, Norwegen) stammen nicht aus der EU-Datenbank, sondern werden von iungo COMMERCE anhand der amtlichen Quellen gepflegt. Maßgeblich ist das Recht des jeweiligen Landes. Die App ersetzt keine steuerliche Beratung. Für Sonderfälle (z. B. Steuersätze für bestimmte Warengruppen) prüfe die Artikel-Zuordnung in pixi zusätzlich selbst.
Support
Fragen oder Ideen? Schreib uns an [email protected].