VerzeichnisService Service
Der VerzeichnisService beinhaltet Funktionen zum Abrufen von Statusinformationen zu einem Abhol- und/oder Aufstellungscode. Der Anwender der Schnittstelle kann mit Hilfe der Methode getAhkstatus unter Angabe des Abhol- und Aufstellungscode die entsprechende Statusinformation sowie den Typ des Codes abfragen.
Weiterhin sind Funktionen zum Abrufen für das Verzeichnis der registrierten Hersteller und registrierten Bevollmächtigten nach dem ElektroG, das Verzeichnis der Sammel- und Rücknahmestellen und das Verzeichnis der Betreiber von Erstbehandlungsanlagen vorhanden.
Bildmarken werden bei dem Aufruf
getMarken mittels
SOAP Message Transmission Optimization Mechanism
(MTOM) übertragen. Dabei wird XOP für die
Übermittlung der binären Daten verwendet. Bei der Implementierung eines Clients ist darauf zu
achten, dass die Codierung der SOAP-Nachrichten entsprechend konfiguriert ist und dass die
Puffergröße für den Nachrichtenempfang und die maximal erlaubte Größe einer Nachricht
entsprechend groß gewählt wird (z.B für .NET
binding.MessageEncoding = WSMessageEncoding.Mtom,
binding.MaxBufferSize = 10_000_000 und
binding.MaxReceivedMessageSize = 10_000_000).
- Namespace
- http://www.ear-system.de/ear-soap/v2
- WSDL
- /VerzeichnisService?wsdl
isAlive Operation
Diese Funktion beinhaltet eine Abfrage, welche prüft, ob der SOAP Service aktiv ist. Dies ist vergleichbar mit einem Ping.
- Verfügbar ab
- 2.1
| Typ | Beschreibung |
|---|---|
| StandardResponse | Text Service verfügbar, wenn verfügbar. |
| Name | Typ | Bedingung |
|---|---|---|
| ServiceException | ServiceException | Service ist nicht verfügbar oder interner Serverfehler |
getAlleGeraetearten Operation
Mit dieser Funktion können die im System hinterlegten Gerätearten abgerufen werden. In
anderen Serviceaufrufen, wie z.B. getHersteller, wird die
Nummer der Geräteart/Kategorie zur Identifikation der Geräteart/Kategorie als Parameter mit
der Bezeichnung geraeteartnummer bzw. kategorienummer verwendet.
Im Gegensatz zu der Methode getGeraetearten aus dem MitteilungsService liefert diese Methode alle im System verfügbaren Gerätearten.
- Verfügbar ab
- 2.3
| Typ | Beschreibung |
|---|---|
| list of Geraeteart | Liste aller im System konfigurierten Gerätearten inklusive der zugeordneten Gruppen und Kategorien |
| Name | Typ | Bedingung |
|---|---|---|
| ServiceException | ServiceException | Es liegt ein interner Serverfehler vor |
getAhkstatus Operation
Die Funktion getAhkstatus() liefert Statusinformation sowie den Typ
(Abholanordnung / Aufstellungsanordnung) zu einem bestimmten Code.
- Verfügbar ab
- 2.1
| Name | Typ | Beschreibung |
|---|---|---|
| codeId | string | 4 stelliger Abhol- bzw. Aufstellungscode |
| Typ | Beschreibung |
|---|---|
| list of Ahkstatus | Statusinformation zu einer Abholung bzw. Aufstellung zu einem bestimmten Code |
| Name | Typ | Bedingung |
|---|---|---|
| ServiceException | ServiceException | Service ist nicht verfügbar oder interner Serverfehler |
getHersteller Operation
Verzeichnis der registrierten Hersteller und registrierten Bevollmächtigten.
Die übergebenen Parameter dienen der Filterung der Ergebnismenge. Es werden nur die Treffer angezeigt, die exakt dem von Ihnen eingegebenen Suchbegriff entsprechen, d.h. eine Suche z.B. nach der Marke "abc" liefert auch nur Treffer mit der Marke "abc", nicht aber solche mit der Marke "abcd" zurück. Bei Unsicherheiten verwenden Sie bitte vor und/oder nach dem Suchbegriff (z.B. "abc") einen *. So werden alle Treffer gefunden, die den Suchbegriff beinhalten, also bei einer Suche nach z.B. "abc*" auch "abcdef". Auf Groß -und Kleinschreibung müssen Sie nicht achten. Marktaustrittsdatum ist das Beendigungsdatum der letzten Registrierung. Bei dem 26.10.2018 als Marktaustrittsdatum kann es sich ferner um das Datum einer Registrierungsüberführung (Rechtsänderung zum 15.08.2018) handeln.
- Verfügbar ab
- 2.3
| Name | Typ | Beschreibung |
|---|---|---|
| herstellername | string | Filter nach Hersteller-/Bevollmächtigtenname |
| plz | string | Filter nach Postleitzahl |
| bundesland | Bundesland | Filter nach Bundesland. Als Wert ist die Abkürzung des jeweiligen Bundeslandes zu
verwenden, wie z.B. BY für das Bundesland Bayern. |
| registrierungsnummer | int | Filter nach WEEE-Reg.-Nr. DE |
| marke | string | Filter nach Markenname der Registrierung
Achtung! Ein Filtern nach Marken filtert nur auf Textmarken, also Marken die bei der Registrierung ohne hochgeladenes Bild als Marke angelegt wurden. Bildmarken (auch mit Text im Bild) werden damit nicht gefunden! |
| kategorienummer | int | Nummer der Kategorie, nach der gefiltert werden soll. Die Kategorienummer ist über den Service getAlleGeraetearten ermittelbar. |
| geraeteartnummer | int | Nummer der Geräteart, nach der gefiltert werden soll. Die Geräteartnummer ist über den Service getAlleGeraetearten ermittelbar. |
| page | int |
| Typ | Beschreibung |
|---|---|
| Registrierungen | Liste von Registrierungen, die den eingegebenen Kriterien entsprechen |
| Name | Typ | Bedingung |
|---|---|---|
| ServiceException | ServiceException | Service ist nicht verfügbar oder interner Serverfehler |
getMarken Operation
Verzeichnis der registrierten Hersteller und registrierten Bevollmächtigten nach Marken.
Die übergebenen Parameter dienen der Filterung der Ergebnismenge. Es werden nur die Treffer angezeigt, die exakt dem von Ihnen eingegebenen Suchbegriff entsprechen, d.h. eine Suche z.B. nach der Marke "abc" liefert auch nur Treffer mit der Marke "abc", nicht aber solche mit der Marke "abcd" zurück. Bei Unsicherheiten verwenden Sie bitte vor und/oder nach dem Suchbegriff (z.B. "abc") einen *. So werden alle Treffer gefunden, die den Suchbegriff beinhalten, also bei einer Suche nach z.B. "abc*" auch "abcdef". Auf Groß -und Kleinschreibung müssen Sie nicht achten. Bei Einschränkung auf Marken werden keine Bildmarken gefunden. Bildmarken werden - je nach Sortierreihenfolge der Markenspalte - zu Beginn oder am Ende der Trefferliste gesammelt angezeigt. Marktaustrittsdatum ist das Beendigungsdatum einer konkreten Registrierung. Bei dem 26.10.2018 als Marktaustrittsdatum kann es sich ferner um das Datum einer Registrierungsüberführung (Rechtsänderung zum 15.08.2018) handeln.
- Verfügbar ab
- 2.3
| Name | Typ | Beschreibung |
|---|---|---|
| herstellername | string | Hersteller-/Bevollmächtigtenname) |
| registrierungsnummer | int | WEEE-Reg.-Nr. DE |
| marke | string | Markenname der Registrierung
Achtung! Ein Filtern nach Marken filtert nur auf Textmarken, also Marken die bei der Registrierung ohne hochgeladenes Bild angelegt wurden. Bei Filterung auf Markennamen (auch mit *) werden keine Bildmarken ausgeliefert! Bitte lassen Sie den Filter für Marke leer, um auch Bildmarken zu erhalten! |
| kategorienummer | int | Nummer der Kategorie, nach der gefiltert werden soll. Die Kategorienummer ist über den Service getAlleGeraetearten ermittelbar. |
| geraeteartnummer | int | Nummer der Geräteart, nach der gefiltert werden soll. Die Geräteartnummer ist über den Service getAlleGeraetearten ermittelbar. |
| page | int | Nummer der angefragten Seite (Paging), je Seite werden max. 5.000 Einträge geliefert. Der Seitenzähler beginnt bei 1. |
| Typ | Beschreibung |
|---|---|
| Marken | Liste von registrierten Marken, die den eingegebenen Kriterien entsprechen |
| Name | Typ | Bedingung |
|---|---|---|
| ServiceException | ServiceException | Service ist nicht verfügbar oder interner Serverfehler |
getErstbehandlungsanlagen Operation
Verzeichnis der Betreiber von Erstbehandlungsanlagen.
Das Verzeichnis der Betreiber von Erstbehandlungsanlagen enthält die veröffentlichten Angaben exakt so, wie sie ursprünglich vom Betreiber der jeweiligen Erstbehandlungsanlage eingetragen wurden.
Die Anschrift bezieht sich auf die Daten des Anlagenstandorts einer Erstbehandlungsanlage.
Der Name des Anlagenstandorts wird ebenfalls in einem eigenen Feld standortname
ausgeliefert. Das Feld taetigkeit enthält dann die Angaben zu behandelten
Kategorien und Tätigkeiten.
Die übergebenen Parameter dienen der Filterung der Ergebnismenge. Bei Unsicherheiten bitte vor und nach der Ihnen vorliegenden Teilinformation des Ortes bzw. der Postleitzahl einen * setzen. Auf diese Weise werden alle Betreiber von Erstbehandlungsanlagen im eingegrenzten Suchbereich angezeigt.
- Verfügbar ab
- 2.3
| Name | Typ | Beschreibung |
|---|---|---|
| plz | string | Filter nach Postleitzahl |
| ort | string | Filter nach Ort |
| bundesland | Bundesland | Filter nach Bundesland. Als Wert ist die Abkürzung des jeweiligen Bundeslandes zu
verwenden, wie z.B. BY für das Bundesland Bayern. |
| page | int | Nummer der angefragten Seite (Paging), je Seite werden max. 5.000 Einträge geliefert. Der Seitenzähler beginnt bei 1. |
| Typ | Beschreibung |
|---|---|
| Erstbehandlungsanlagen |
| Name | Typ | Bedingung |
|---|---|---|
| ServiceException | ServiceException |
Impressum
| Disclaimer
| Datenschutzerklärung
© ear ist eine eingetragene Marke
Schnittstellen-Version 2.5