Verpackungs-Radar pixi App: Dokumentation
1. Einleitung
Was die App macht
Wer Ware an Endkunden verschickt, meldet die Masse seiner Versandverpackungen beim dualen System und gleichlautend
im Verpackungsregister LUCID der Zentralen Stelle Verpackungsregister (ZSVR). Der Verpackungs-Radar zählt in
DESCARTES pixi, wie viele Pakete du in welches Land verschickt hast, und rechnet sie mit deinen Angaben zur
Verpackung in Kilogramm je Material um.
- Pakete je Tag, Land und Shop aus pixi, mit Paketgewicht
- Mengen getrennt nach Deutschland, anderen EU-Ländern und Ländern außerhalb der EU
- Meldung (Jahresabschluss, unterjährig, Planmenge) als XML-Datei für LUCID, dazu CSV und PDF
- Erinnerung an anstehende Meldungen und Monatsbericht per E-Mail
Was die App nicht macht
- Sie ändert nichts in pixi. Die App liest nur.
- Sie meldet nicht für dich. Die Meldung beim dualen System und den Upload in LUCID machst du selbst.
- Sie kennt deine Verpackung nicht von allein. Karton, Füllmaterial und Klebeband trägst du einmal ein.
- Sie ersetzt keine Rechtsberatung. Ob du Hersteller bist, hängt davon ab, wie du verpackst.
Voraussetzungen, Tarife und Test
- Zugang zum iungo Portal mit hinterlegter pixi API
- Versand über pixi mit Rechnungen (siehe Grenzen)
- Registrierung in LUCID und Vertrag mit einem dualen System
| Tarif | Preis | Für wen |
| Verpackungs-Radar | 399 € / Jahr zzgl. MwSt. | Händler, die ihre eigenen Mengen melden |
| Verpackungs-Radar Fulfillment | 799 € / Jahr zzgl. MwSt. | Fulfiller, die zusätzlich für Kunden melden (siehe Fulfillment) |
Beide Tarife werden jährlich abgerechnet. Die ersten 14 Tage nach der Buchung
sind ein Testzeitraum: Du siehst alle Mengen und die Vorschau deiner Meldung. Die Meldung selbst mit XML, CSV und PDF
sowie den Monatsbericht gibt es nach dem Testzeitraum.
2. Einrichtung
In 4 Schritten startklar
- Die App im Portal unter „pixi App's“ buchen.
- Konfiguration > Allgemein: pixi API wählen, „Aktiv“ anhaken, LUCID-Nummer und duales System eintragen, speichern. Die App testet die Verbindung und beginnt mit dem Laden.
- Konfiguration > Verpackung: eintragen, was in ein Paket geht (Karton, Füllmaterial, Klebeband, Etikett) und wie viel es wiegt.
- Konfiguration > Shops (optional): Shops ausnehmen, für die du nicht Hersteller bist, z. B. Versand durch Amazon.
Die Checkliste oben in der Konfiguration und im Dashboard zeigt, was noch fehlt.
Allgemein
| Feld | Bedeutung |
| Aktiv | Schaltet das Laden aus pixi ein. Ausschalten pausiert nur; beim Wiedereinschalten macht die App dort weiter, wo sie aufgehört hat. |
| LUCID-Nummer | Deine Registrierungsnummer, z. B. DE1234567890123. Steht im Nachweis; für die XML-Datei wird sie nicht gebraucht. |
| Duales System | Der Systembetreiber, mit dem du einen Vertrag hast. Seine ID kommt in die XML-Datei. |
| Meldeintervall | Jährlich, vierteljährlich oder monatlich, wie in deinem Vertrag mit dem dualen System. Danach richten sich die Erinnerungen. |
| E-Mail für Erinnerungen | An diese Adresse gehen Erinnerungen an anstehende Meldungen. |
| Monatsbericht an | Eine oder mehrere Adressen (mit Komma getrennt) für den Monatsbericht. Leer = kein Bericht. |
Verpackung
Je Verpackung wählst du, wie die App rechnet:
- Pauschal je Paket: ein Satz Bestandteile, gilt für jedes Paket.
- Nach Paketgewicht in Staffeln: eigene Grenzen in Gramm (z. B. bis 500 g, bis 2.000 g) mit eigenen Bestandteilen, dazu ein Standard für Pakete ohne Gewicht in pixi oder außerhalb der Staffeln. Grundlage ist das Paketgewicht aus pixi. Jeder Staffel kannst du einen Arbeitstitel geben (z. B. „Luftpolstertasche A4“); er erscheint in der Übersicht und im PDF, nicht in der Meldung an LUCID.
Brauchen einzelne Shops eine andere Verpackung, z. B. Marktplätze, legst du eine weitere Verpackung an und wählst
ihre Shops aus. Alle übrigen Shops nutzen die Verpackung „Standard“.
Jede Änderung gilt ab einem Datum. Frühere Stände bleiben erhalten, damit Meldungen für vergangene Zeiträume mit der
damals gültigen Verpackung rechnen. Außerdem gibst du an, wie deine Versandverpackung entsteht (selbst zusammengesetzt,
mit eigenem Logo, fertig vom Lieferanten). Davon hängt ab, wer in Deutschland Hersteller ist.
Shops
Ab einem Datum kannst du festlegen, dass ein pixi-Shop nicht mitzählt, mit Grund: Marktplatz übernimmt die
Herstellerpflichten (z. B. Versand durch Amazon), Kunde (Fulfillment) oder Sonstiges. Rechnungen ohne Shop-Zuordnung in
pixi zählen beim Hauptmandanten mit der Standard-Verpackung mit.
3. Daten aus pixi
Was und wann die App lädt
- Je Tag die versendeten Rechnungen je Land und Shop und je Rechnung die Pakete mit Gewicht.
- Gespeichert werden nur Anzahlen und Gewichte, keine Namen, Adressen oder E-Mails deiner Kunden.
- Beim Start: zuerst die letzten 30 Tage, danach rückwärts bis zum 1. Januar. Wer bis Ende Mai bucht, bekommt zusätzlich das Vorjahr ab 1. Januar, für den Jahresabschluss.
- Jede Nacht die letzten 7 Tage neu, weil Rechnungen in pixi auch nachträglich als versendet markiert werden.
- Die App fragt pixi nur nachts ab (22:00–00:45 und 03:00–06:00 Uhr). Je nach Menge dauert das erste Laden des ganzen Jahres einige Nächte. Den Fortschritt siehst du im Dashboard.
Daten neu laden
Unter Konfiguration > Allgemein kannst du die Daten ab einem Datum neu laden, frühestens ab 1. Januar des Vorjahres,
auf Wunsch mit „Pakete je Rechnung neu abfragen“. Das ist sinnvoll, wenn in pixi nachträglich etwas korrigiert wurde.
Das Neuladen läuft nachts; abbrechen geht jederzeit.
So rechnet die App
Pakete je Land × Verpackung je Paket = Masse je Material.
- Eine Rechnung ohne Paket in pixi zählt als ein Paket.
- Bei Staffeln entscheidet das Gewicht jedes einzelnen Pakets, welche Staffel greift.
- Die App rechnet intern in Hundertstelgramm und rundet erst am Ende auf Kilogramm mit drei Nachkommastellen, wie LUCID es verlangt.
- Die MaterialCodes richten sich nach dem Meldejahr (bis 2026 nach dem VerpackG, ab 2027 nach dem VerpackDG).
4. Dashboard und Meldung
Dashboard
Wähle einen Zeitraum. Das Dashboard zeigt Pakete und Rechnungen, die Mengen je Material für Deutschland, EU-Ausland und
Länder außerhalb der EU, die Länder mit den meisten Paketen, die Shops und den Ladestand aus pixi. Darüber stehen die
nächste anstehende Meldung und die Checkliste der Einrichtung.
Meldung erstellen
- Unter „Meldung“ die Meldeart wählen: Jahresabschlussmeldung, Unterjährige Meldung oder Planmengenmeldung, dazu Jahr und Monate.
- Die Vorschau prüfen: Mengen je MaterialCode, Grundlage, Hinweise.
- „Meldung erstellen“ hält den Stand fest. Spätere Änderungen an Daten oder Verpackung ändern eine erstellte Meldung nicht.
- Unter „Erstellte Meldungen“ XML, CSV, Druckansicht oder PDF herunterladen.
Gemeldet werden nur die Mengen für Deutschland, für die du selbst Hersteller bist. Die Planmenge rechnet die App aus den
letzten bis zu 12 vollständigen Monaten hoch. Von und Bis liegen immer im selben Kalenderjahr.
Upload in LUCID
Die XML-Datei entspricht der Schnittstelle der ZSVR (Version 1.0, UTF-8 mit BOM, Masse mit Dezimalkomma) und ist gegen das
offizielle Schema geprüft. In LUCID lädst du sie unter Datenmeldung per XML hoch. Melde dieselben Mengen auch deinem
dualen System; beide Meldungen müssen übereinstimmen.
Hinweise
Die App sperrt eine Meldung, wenn etwas fehlt, und gibt Hinweise, wenn etwas auffällt. Die wichtigsten:
| Meldung | Was du tun kannst |
| Kein duales System | Unter Konfiguration > Allgemein auswählen (sperrt die Meldung). |
| Daten unvollständig | Das Laden ist noch nicht bis zum Ende des Zeitraums gekommen; später erneut versuchen (sperrt die Meldung). |
| Zeitraum vor Kurzem beendet | Rechnungen, die in pixi erst nachträglich als versendet markiert werden, fehlen noch. Besser ein paar Tage warten. |
| Rechnungen ohne Shop | pixi ordnet sie keinem aktiven Shop zu; sie zählen beim Hauptmandanten mit. |
| Pakete über 31,5 kg | Paletten oder Sperrgut zählen sonst wie ein normales Paket. Lege dafür eine eigene Staffel an; die App schlägt eine Grenze vor. |
| Pakete ohne Gewicht | Sie zählen mit dem Standard. In pixi das Paketgewicht pflegen. |
5. E-Mails
Erinnerung an Meldungen
Nach deinem Meldeintervall erinnert die App an die unterjährige Meldung für den Vormonat oder das Vorquartal, an den
Jahresabschluss und ab 1. Dezember an die Planmenge für das Folgejahr. Die Erinnerung kommt etwa eine Woche nach Ende
des Zeitraums und entfällt, wenn du die Meldung schon erstellt hast. Die Frist steht in deinem Vertrag mit dem dualen System.
Monatsbericht
Am 1. bis 7. eines Monats schickt die App den Bericht für den Vormonat an die Adressen unter „Monatsbericht an“, sobald der
Monat vollständig geladen ist: PDF mit Mengen, Ländern und Verpackung, dazu die CSV-Datei mit allen Ländern. Der Bericht ist
keine Meldung. Mit „Testbericht senden“ schickst du den letzten vollständigen Monat sofort.
6. Fulfillment
Kunden als Hersteller
Verpackst du für Kunden, die selbst Hersteller sind, legst du sie im Tarif Verpackungs-Radar Fulfillment
als eigene Hersteller an. Jeder Hersteller hat eigene LUCID-Nummer, eigenes duales System, eigenes Meldeintervall,
eigene Verpackung, eigene Meldungen sowie eigene Erinnerungen und Monatsberichte. Du selbst bist der Hauptmandant.
Einrichten
- Konfiguration > Hersteller: Kunden anlegen mit Name, LUCID-Nummer, dualem System, Meldeintervall und E-Mail-Adressen.
- Konfiguration > Shops: die Shops des Kunden ab einem Datum „zählt für …“ diesem Hersteller zuordnen. Sie zählen dann nicht mehr bei dir.
- Konfiguration > Verpackung: oben den Hersteller wählen und seine Verpackung eintragen.
In Dashboard, Meldung und Verpackung wechselst du über die Reiter oben zwischen den Herstellern.
Tarif wechseln
Vom Verpackungs-Radar zum Fulfillment-Tarif wechselst du jederzeit, alle Daten bleiben erhalten. Wechselst du zurück,
werden die weiteren Hersteller nur ausgeblendet; ihre Shops zählen weiter nicht bei dir, damit deine Mengen stimmen.
7. Sonstiges
Grenzen
- Nur Rechnungen: Die App zählt versendete Rechnungen aus pixi. Versand ohne Rechnungsdatensatz in pixi sieht sie nicht.
- Rechnung = Sendung: Eine Rechnung ohne Paket zählt als ein Paket.
- Verpackung je Paket: Die App kennt den tatsächlich verwendeten Karton nicht; sie rechnet mit deinen Angaben.
- Länder: Die Zuordnung kommt aus der Ländertabelle in pixi. Länder ohne ISO-Code erscheinen als „unbekannt“.
Verwendete API-Calls und Daten
| API-Call | Wofür |
pixiGetInvoiceShippingReport | Versendete Rechnungen je Tag, Shop und Land |
pixiGetInvoicePackage | Pakete je Rechnung mit Gewicht |
pixiGetCountries | Ländertabelle für die Zuordnung zu ISO-Codes |
pixiGetShops | Shops für Auswahl und Zuordnung |
Die App liest nur. Endkundendaten aus dem Versandbericht werden nicht gespeichert, nur Anzahlen je Tag, Land und Shop.
Rechtlicher Hinweis
Der Verpackungs-Radar bereitet deine Mengenmeldung vor. Die Meldung beim dualen System und in LUCID gibst du selbst ab, die Verantwortung für die Angaben bleibt bei dir. Die App ersetzt keine Rechtsberatung. Ob du für deine Versandverpackungen Hersteller im Sinne der PPWR bist, hängt davon ab, wie du verpackst; Hinweise dazu gibt die Zentrale Stelle Verpackungsregister.
Support
Fragen zur App beantworten wir unter [email protected].