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
TarifPreisFür wen
Verpackungs-Radar399 € / Jahr zzgl. MwSt.Händler, die ihre eigenen Mengen melden
Verpackungs-Radar Fulfillment799 € / 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

  1. Die App im Portal unter „pixi App's“ buchen.
  2. 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.
  3. Konfiguration > Verpackung: eintragen, was in ein Paket geht (Karton, Füllmaterial, Klebeband, Etikett) und wie viel es wiegt.
  4. 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

FeldBedeutung
AktivSchaltet das Laden aus pixi ein. Ausschalten pausiert nur; beim Wiedereinschalten macht die App dort weiter, wo sie aufgehört hat.
LUCID-NummerDeine Registrierungsnummer, z. B. DE1234567890123. Steht im Nachweis; für die XML-Datei wird sie nicht gebraucht.
Duales SystemDer Systembetreiber, mit dem du einen Vertrag hast. Seine ID kommt in die XML-Datei.
MeldeintervallJährlich, vierteljährlich oder monatlich, wie in deinem Vertrag mit dem dualen System. Danach richten sich die Erinnerungen.
E-Mail für ErinnerungenAn diese Adresse gehen Erinnerungen an anstehende Meldungen.
Monatsbericht anEine 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

  1. Unter „Meldung“ die Meldeart wählen: Jahresabschlussmeldung, Unterjährige Meldung oder Planmengenmeldung, dazu Jahr und Monate.
  2. Die Vorschau prüfen: Mengen je MaterialCode, Grundlage, Hinweise.
  3. „Meldung erstellen“ hält den Stand fest. Spätere Änderungen an Daten oder Verpackung ändern eine erstellte Meldung nicht.
  4. 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:

MeldungWas du tun kannst
Kein duales SystemUnter Konfiguration > Allgemein auswählen (sperrt die Meldung).
Daten unvollständigDas Laden ist noch nicht bis zum Ende des Zeitraums gekommen; später erneut versuchen (sperrt die Meldung).
Zeitraum vor Kurzem beendetRechnungen, die in pixi erst nachträglich als versendet markiert werden, fehlen noch. Besser ein paar Tage warten.
Rechnungen ohne Shoppixi ordnet sie keinem aktiven Shop zu; sie zählen beim Hauptmandanten mit.
Pakete über 31,5 kgPaletten 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 GewichtSie 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

  1. Konfiguration > Hersteller: Kunden anlegen mit Name, LUCID-Nummer, dualem System, Meldeintervall und E-Mail-Adressen.
  2. Konfiguration > Shops: die Shops des Kunden ab einem Datum „zählt für …“ diesem Hersteller zuordnen. Sie zählen dann nicht mehr bei dir.
  3. 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-CallWofür
pixiGetInvoiceShippingReportVersendete Rechnungen je Tag, Shop und Land
pixiGetInvoicePackagePakete je Rechnung mit Gewicht
pixiGetCountriesLändertabelle für die Zuordnung zu ISO-Codes
pixiGetShopsShops 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].