ear SOAP Schnittstelle: Services

Namespace `http://www.ear-system.de/ear-soap/v2`
name	Beschreibung
AbholkoordinationsService	Der AbholkoordinationsService beinhaltet Funktionen zum Abruf von Informationen zur Abholkoordination. Hersteller können sich hier u.a. generierte PDF-Dokumente herunterladen. Bitte beachten Sie, dass Sie nur noch für Anordnungen (Codes) welche bis einschließlich 27.12.2023 ergangen sind die entsprechenden Gebührenbescheide über die Schnittstelle abrufen können. Der Anwender der Schnittstelle ruft zunächst die Methode getCodes auf. Diese ermittelt die Schlüsseldaten (Abholungs-/Aufstellungscode, Status, Art) nach den übergebenen Kriterien. Die Daten werden als XML zur Verfügung gestellt und bestehen aus einer Liste, die den Kriterien entsprechenden Abholungs-/Aufstellungscodes (Code) inklusive des Status sowie der Art entspricht. Des Weiteren bietet die Schnittstelle dem Anwender die Möglichkeit, im ear-System an den eigenen Abholungen bzw. Aufstellungen einen herstellereigenen Status zu pflegen. Dies geschieht über die Methode setStatusHst. Dieser durch den Anwender frei zu belegende Status kann bei der Methode getCodes als `statusHstVon` - `statusHstBis` Kriterium mit übergeben werden und versetzt den Anwender in die Lage, sich eine vom ear-System unabhängige Logik der Abholung bzw. Nachverfolgung von Codes aus dem ear-System aufzubauen. Der herstellereigene Status findet außerhalb der in diesem Dokument beschriebenen Schnittstellenfunktionalität keine Verwendung. Die Dokumente werden bei den Aufrufen getDetails bzw. getGebuehrenbescheid mittels SOAP Message Transmission Optimization Mechanism (MTOM) übertragen. Dabei wird XOP für die Übermittlung der binären Daten verwendet. Bei den übertragenen Dokumenten handelt es sich ausschließlich um PDF-Dokumente. Bei der Implementierung eines Clients ist darauf zu achten, dass die Codierung der SOAP-Nachrichten entsprechend konfiguriert ist (z.B für .NET `binding.MessageEncoding = WSMessageEncoding.Mtom`).
BattGRSVerzeichnisService	Der BattGRSVerzeichnisService beinhaltet Funktionen zum Abrufen für das Verzeichnis der genehmigten Eigenrücknahmesysteme.
BattGVerzeichnisService	Der BattGVerzeichnisService beinhaltet Funktionen zum Abrufen für das Verzeichnis der registrierten Hersteller und registrierten Bevollmächtigten nach dem BattG. 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`).
EigenruecknahmesystemHerstellerlisteService	Der EigenruecknahmesystemHerstellerlisteService stellt verschiedene Funktionen zum Umgang mit der Herstellerliste eines Eigenrücknahmesystems zur Verfügung. Es ist möglich den aktuellen Stand der Herstellerliste abzufragen. Diese stellt den zuletzt bearbeiteten Zustand dar, wie er auch im Portal sichtbar ist. Daraus kann nicht abgeleitet werden, welche Hersteller aktuell für das BattG-Eigenrücknahmesystem genehmigt wurden. Der Liste können neue Einträge hinzugefügt oder bestehende geändert werden. Insbesondere ist es möglich, Einträge zu bestätigen, die durch eine Zuordnung des Eigenrücknahmesystems durch einen Hersteller entstanden sind.
MitteilungsService	Dieser Service beinhaltet die Funktionalität, Mengenmitteilungen elektronisch abzusetzen. Für die fristgerechten Abrufe und Mengenmitteilungen über die SOAP Schnittstelle sind die Kunden selbst verantwortlich. Sollten die erforderlichen Voraussetzungen für die Abgabe einer Mengenmitteilung nicht erfüllt sein, so wird dies durch eine entsprechende Fehlermeldung quittiert.
VerzeichnisService	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`).