Glossar
Kompaktes Begriffsverzeichnis für das Developer-Portal. Jeder Eintrag gibt die knappe Definition; die ausführliche Erklärung steht in der zuständigen Anleitung und ist verlinkt.
Begriffe rund um die drei ZEDAL-Speicherbereiche (Inbox, Nachweis-Bereich, Versandpapier-Bereich) sind im eigenen Kapitel Speicherbereiche zusammengeführt.
| Begriff |
Bedeutung |
| Provider |
Eine ZEDAL-Instanz, identifiziert über eine numerische ProviderId. Auf dem REST-Pfad ist sie als Header provider_id bei jedem Aufruf Pflicht. Die IDs sind umgebungsspezifisch — eine ID aus der Produktion gilt nicht auf Test. Verzeichnis: DiscoveryApi/ListProvider. |
| Subscriber |
Vertrags-Mandant innerhalb eines Providers. Bündelt Accounts und Berechtigungen einer Organisation; wird beim Login als subscriberId mitgegeben. Berechtigungs-Scopes hängen an der Subscriber-Zuordnung. |
| Account |
Benutzerkonto innerhalb eines Subscribers, Login-Identität für CreateSession. Die drei Ebenen zusammen ergeben das User-Id-Muster account-subscriber@provider. |
| App-Token |
JWT, das die integrierende Anwendung identifiziert — nicht den Benutzer. Wird von den API-Betreibern pro Client-Anwendung ausgegeben und trägt deren Berechtigungsprofil. Beim Login zusätzlich zu den Credentials erforderlich. |
| Refresh-Token |
Langlebiges Token aus AuthApi/IssueRefreshToken; berechtigt ausschließlich dazu, Access-Tokens zu holen. Rotiert: Jeder RequestAccess gibt ein neues zurück und macht das bisherige ungültig — das neue muss persistiert sein, bevor der nächste Fachaufruf läuft. |
| Access-Token |
Kurzlebiges JWT aus AuthApi/RequestAccess; autorisiert Fachaufrufe als Authorization: Bearer. Die Gültigkeitsdauer steht im Token (exp-Claim, im SDK Jwt.ValidTo) — lies sie dort, statt eine Dauer im Client anzunehmen. Scopes wie usermgt stecken als Claim darin. |
| API-Key (folgt) |
Zugang eines Accounts für Prozesse ohne Benutzer. Wird zusammen mit dem App-Token in AuthApi/RequestAccess (apiKeyCredentials) direkt gegen ein Access-Token getauscht, ohne Refresh-Token. Kein JWT, sondern zedal_ak_<provider_id>_<key_id>_<geheimnis>. Gewährt nur ausdrücklich vergebene Scopes; angelegt und widerrufen im ZEDAL-Portal. |
| Discovery |
Verfahren, mit dem die zuständige ZEDAL-Instanz gefunden wird. DiscoveryApi/ListProvider ist die einzige Operation ohne Token und ohne provider_id und damit Schritt 0 jeder Integration. |
| ZeWaSS |
XML-Format, in dem ZEDAL DiWaSS-Dokumente persistiert. Der Begriff erscheint im SDK an einigen Stellen — gearbeitet wird auf den abgeleiteten typisierten Objekten. |
Speicherbereiche
| Begriff |
Bedeutung |
| Inbox |
Posteingang eines Accounts; flache Liste eingehender Dokument-Einträge mit read- und removed-Flag. Der Import aus der Inbox ist der Zustellweg für eingehende Dokumentversionen, kein Aufräumschritt. Siehe Speicherbereiche → Inbox und Aufrufe und Synchronisation. |
| Nachweis-Bereich |
Aktenbasierter Bereich (File Area): Akten (File) mit jeweils mehreren Dokumenten und eigenem Submission-Lebenszyklus. Siehe Nachweis-Bereich. |
| Versandpapier-Bereich |
Verteil- und Quittierungs-Schiene (Transport Paper Area) für Einzel-Dokumente entlang einer Beförderungskette; flache Liste mit Peek-and-Acknowledge-Modell. Siehe Versandpapier-Bereich. |
| Akte |
File im Nachweis-Bereich. Logischer Ordner mit eindeutiger FileId, enthält ein oder mehrere Dokumente. |
| Distribution |
Automatische Zustellung eines Versandpapier-Dokuments an die im Dokument identifizierten Beteiligten. Wird beim Import über das Feld distribute ausgelöst. |
DiWaSS-Dokumente
| Begriff |
Bedeutung |
| Submission |
Initiales DiWaSS-Dokument einer Verbringung — die vom Notifizierenden eingereichte Anmeldung mit allen Parteien, Abfallart, Mengen und Routen. |
| Notification |
Lebenszyklus-Hülle um die Submission. Durchläuft Acknowledgement, Nachforderungen und Entscheidungen der Behörden, endet mit Consent oder Storno. Siehe Lebenszyklus. |
| Movement |
Operatives DiWaSS-Dokument einer einzelnen Beförderung unter einer konsentierten Notification. Über die API sofort im Zustand Announced — es gibt keinen Entwurfsstatus. |
| Annex VII |
Dokumentenformat für Verbringungen der Grünlisten-Stoffe nach Anhang VII der VO (EU) 2024/1157; kein vollwertiges Notifizierungsverfahren. Im SDK Annex7DocumentHandler; in der Ereignis-Codeliste am Präfix GLW_ erkennbar. |
| Notifizierungsnummer |
NotificationId im Format <CA-Code><JJ><Laufnummer>i, Beispiel DE0126999901i. Der Präfix ist der Behörden-Code; ein abweichender Präfix wird mit INVALID-NOTIFICATION-CA-CODE-PREFIX abgelehnt. |
| MovementId |
Fachliche DiWaSS-Kennung eines Movements: <NotificationId>.<Sequenz>MOV, Beispiel DE0126999901i.000001MOV. Von DiWaSS beim Anlegen des Movement-Templates vergeben. |
| Transportpapiernummer |
ZEDAL-seitige Nummer desselben Movements: <NotificationId>.<Sequenz> mit fünfstelliger Sequenz und ohne MOV, Beispiel DE0126999901i.00002. Die beiden Formate nicht verwechseln — ein Abruf mit dem falschen findet nichts. Gegenüberstellung: Feldregeln. |
| SequenceNumber |
Laufende Nummer eines Movements innerhalb einer Notifizierung, beginnt pro Notifizierung wieder bei 1. Wird nicht serverseitig reserviert; die nächste freie liefert GetNextMovementSequenceNumber(notificationId). Lege Movements einer Notifizierung nacheinander an. |
| Stage |
Abgeschlossener Schritt im Lebenszyklus eines DiWaSS-Dokuments; im SDK eine Methode auf dem Document-Handler (SetCarrierTransport, SetFacilityReception, …). |
| DiwassIntents |
Protobuf-Enum, das die wire-seitig zulässigen Folge-Aktionen pro DiWaSS-Dokument aufzählt (CREATE_SUBMISSION, SUBMIT_DECISION, …). |
| Followup-Intent |
Ein Eintrag aus DiwassIntents, den der Server nach einem Stage-Aufruf als nächstzulässige Aktion zurückmeldet. Im SDK die Property handler.FollowupIntents — keine Methode. Der vorgesehene Weg, den Zustand zu bestimmen; das Dokument selbst trägt im Mutations-Datenmodell keinen Status. Siehe Zustand bestimmen. |
| Ereignisliste |
Liste der Änderungen in DiWaSS über ein Zeitfenster (RetrievalApi.LookupEventList). Erster Schritt jedes Abgleichs: erst die Ereignisse holen, dann gezielt die betroffenen Dokumente — nie ein Vollabzug. Siehe Änderungen abholen. |
Fachbegriffe der Verbringung
| Begriff |
Bedeutung |
| Anlagenkette |
Die Folge von Anlagen, die eine Notifizierung führt: die erste Anlage plus alle nachgelagerten bei vorläufigem Verfahren (Art. 15 Abs. 1 VO (EU) 2024/1157), also 1 + n. Daraus folgen mehrere Empfangs- und Abschlusszertifikate pro Movement und ein Movement-Status, der eine Aggregation über die Kette ist. Siehe Anlagenkette. |
| Vorläufiges Verfahren |
Verwertung oder Beseitigung, nach der der Abfall an eine weitere Anlage geht (InterimFacility in FacilityType.OperationalIndicators). Zwei Fortsetzungen mit sehr unterschiedlichen Folgen: im Bestimmungsstaat (Art. 15(5)) genügt eine Artikel-15-Bescheinigung; ins Ausland (Art. 15(7)/(8)) ist eine neue Notifizierung mit eigenen Movements erforderlich. |
| Artikel-15-Bescheinigung |
Nachweis der Folgeanlage über den Abschluss nach vorläufigem Verfahren. Hängt an der Notifizierung, nicht am Movement, und nennt über movementIdentifier mehrere Verbringungen. Im SDK SetFacilityCompletionUnderArticle15 auf dem NotificationDocumentHandler. |
| Kontingent |
Die in Feld 4 der Notifizierung angegebene Gesamtzahl vorgesehener Verbringungen. Die Zahl der Begleitformulare darf sie nicht überschreiten; ein ordnungsgemäß annulliertes Formular zählt nicht mit, ein liegengelassenes schon. Ausgeschöpft schlägt es als MOVEMENT_TEMPLATE_INVALID_TOTAL_NUMBER durch. Siehe Kontingent. |
| API-Client (DiWaSS) |
Technische Konfiguration der Europäischen Kommission, unter der mehrere Nutzer gebündelt auf DiWaSS zugreifen; der Identifier ist neutral (Beispiele WSR01, WSR85). Die Kommission kann Nutzer zwischen API-Clients umhängen — deshalb muss das Attribut Client ID in deiner Integration konfigurierbar sein. Siehe API-Client und Client-ID. |
DiWaSS-Rollen
| Rolle |
Wire-Bezeichnung |
Bedeutung |
| Notifizierender |
Notifier |
Zentraler Akteur: meldet die Verbringung an, authentifiziert sie und initiiert das Movement. |
| Erzeuger |
WasteProducer |
Slot in der Submission für die Partei, an der der Abfall physisch entsteht. |
| Beförderer |
Carrier |
Transporteur des Abfalls; erfasst im Movement die Transport-Daten. |
| Empfänger |
Consignee |
Partei, an die der Abfall geliefert wird; bestätigt den Wareneingang. Ist der Empfänger zugleich die Anlage, entfällt diese Stage. |
| Anlage |
RecoveryDisposalFacility |
Verwertungs- oder Entsorgungsanlage (FacilityTypeCode R oder D); bestätigt die Annahme und schließt die Behandlung mit R-/D-Code ab. In der Notifizierung mehrfach vorhanden, siehe Anlagenkette. |
| Behörde |
Authority (CA) |
Versand-, Bestimmungs- oder Durchfuhrbehörde; nimmt über Acknowledgements, Entscheidungen und Signale am Lebenszyklus teil. Jede beteiligte Behörde entscheidet einzeln; konsentiert ist erst, wenn alle zugestimmt haben. |
| Operator |
— |
Wirtschaftlicher Akteur, der eine oder mehrere Rollen einnimmt. Identifiziert über OperatorInternalId, EORI-Nummer, W-ID oder § 28-Nummer. Siehe Rollen. |
| OperatorInternalId |
— |
Eindeutiger numerischer (long) Identifier eines Operators im DiWaSS-Operator-Register; wird in allen DiWaSS-Aufrufen geführt. Die eigenen IDs des angemeldeten Nutzers liefert client.MyAccount.GetOwnDiwassOperatorIds(). |
eANV und Signatur
| Begriff |
Bedeutung |
| Begleitschein (BGS) |
Beleg des eANV, der einen Transport nachweispflichtiger Abfälle vom Erzeuger zum Entsorger begleitet; Nummer „1“ und 13 Ziffern. Siehe Verfahren und Rollen. |
| Übernahmeschein (UNS) |
Beleg für die Übernahme beim einzelnen Erzeuger in der Sammelentsorgung und bei Kleinmengen; Nummer „2“ und 13 Ziffern. |
| Entsorgungsnachweis (EN), Sammelentsorgungsnachweis (SN) |
Vorab bestätigte Zulässigkeit der Entsorgung; der Begleitschein verweist über nachweis_nr darauf. |
| Layer |
Abschnitt eines elektronischen Begleitscheins, den genau ein Beteiligter anlegt und signiert; jeder Layer enthält alle vorherigen. Typen: Vorlage, Erzeuger, Beförderer, Zwischenlager, Entsorger, Ergänzung, Behörde. Siehe Layer. |
| Abfalltransportbeteiligter (ATB) |
Erzeuger, Beförderer, Zwischenlager und Entsorger eines Begleitscheins. Die Rolle (im Schema ATBRolle) sagt, für wen ein Vorlage- oder Ergänzungslayer angelegt wird. |
| Behördliche Nummer |
Erzeuger-, Beförderer- oder Entsorgernummer, die die zuständige Behörde vergibt (§ 28 NachwV). Über sie ermittelt ZEDAL, wem ein Begleitschein zugestellt wird. |
| Einsammler |
Beförderer, der in der Sammelentsorgung bei vielen Erzeugern abholt; trägt sich im Begleitschein der Tour als Beförderer ein. |
| Vermittlung |
Zustellung eines gespeicherten Transportdokuments an die übrigen Beteiligten; ausgelöst durch distribute. Siehe Distribution. |
| Dekadenmeldung |
Übermittlung eines abgeschlossenen Begleitscheins an die Behörden über die ZKS-Abfall, ausgelöst durch dekadenmeldung beim Speichern des Entsorger-Layers. Siehe Begleitschein je Rolle. |
| ZKS-Abfall |
Gemeinsame Einrichtung der Länder für die elektronische Nachweisführung (§ 20 NachwV); über sie laufen Belege an Behörden und an Beteiligte bei anderen eANV-Anbietern. |
| Signaturvorgang |
SigningProcess im WebSigner: Dokumente, die ein Mensch über einen Link qualifiziert signiert. Siehe Signieren mit dem WebSigner. |
| signing_url |
Link zum Signaturvorgang für den Menschen, der signiert. Trägt ein befristetes, vorgangsgebundenes Token und ist vertraulich zu behandeln. |
Abkürzungen
| Kürzel |
Auflösung |
| ATB |
Abfalltransportbeteiligter |
| AVV |
Abfallverzeichnis-Verordnung — deutsches Abfallverzeichnis; Quelle der sechsstelligen Abfallschlüssel im eANV |
| BGS |
Begleitschein |
| CA |
Competent Authority — zuständige Behörde im Sinne der VO (EU) 2024/1157 |
| DiWaSS |
EU-Zentralsystem zur Abwicklung der grenzüberschreitenden Abfallverbringung nach VO (EU) 2024/1157 |
| DVO |
Durchführungsverordnung — hier: DVO (EU) 2025/1290 |
| eANV |
elektronisches Abfallnachweisverfahren nach der Nachweisverordnung |
| EN |
Entsorgungsnachweis |
| EORI |
Economic Operators Registration and Identification — EU-weiter zollbehördlicher Identifier für Wirtschaftsteilnehmer |
| GLW |
Green Listed Waste — Verbringung nach Anhang VII |
| gRPC |
gRPC Remote Procedure Calls |
| JWT |
JSON Web Token |
| KrWG |
Kreislaufwirtschaftsgesetz |
| LoW |
List of Waste — europäisches Abfallverzeichnis; auch die listID des Abfallschlüssels |
| NachwV |
Nachweisverordnung — deutscher Rechtsrahmen für die innerstaatliche Abfallnachweisführung |
| QES |
qualifizierte elektronische Signatur nach der eIDAS-Verordnung (EU) 910/2014 |
| REST |
Representational State Transfer |
| SDK |
Software Development Kit |
| SN |
Sammelentsorgungsnachweis |
| UNS |
Übernahmeschein |
| VO |
Verordnung — hier: VO (EU) 2024/1157 |
| W-ID |
Wirtschaftsidentifikationsnummer — bundeseinheitliche Identifikation deutscher wirtschaftlich Tätiger |
| WSDL |
Web Services Description Language |
| XSD |
XML Schema Definition |
| ZKS |
ZKS-Abfall, gemeinsame Einrichtung der Länder für die elektronische Nachweisführung |