Egal, ob Sie ein neuer Benutzer sind, der sich mit den Nutzungshinweisen vertraut machen möchte, oder ein erfahrener Entwickler, der mehr über die Schnittstellen des ear-Portals erfahren möchte: Hier finden Sie wertvolle Informationen, um Ihre Erfahrungen zu verbessern und Ihre technischen Anforderungen zu erfüllen.
Technische Rahmenbedingungen
Nutzungshinweise zum ear-Portal und dessen Schnittstellen
Technische Voraussetzungen
Für sichere Übertragungen im ear-Portal und den verbundenen Webservices (SOAP und REST) wird das Verschlüsselungsprotokoll Transport Layer Security (TLS) verwendet. TLS gewährleistet, dass Informationen während der Übertragung kryptographisch abgesichert sind.
Die Nutzung des ear-Portals und der Webservices ist nur möglich, wenn TLS 1.2 oder eine höhere Version verwendet wird. Stellen Sie sicher, dass die von Ihnen verwendeten Anwendungen und Tools (wie Browser) die Mindestanforderungen erfüllen.
Elektronische Datenschnittstelle (SOAP)
Die SOAP-Schnittstelle ermöglicht es, im Zusammenhang mit dem ElektroG u.a. Mengenmeldungen abzugeben und Informationen zur Abholkoordination zu erhalten. Außerdem bietet sie Funktionen zur Abfrage öffentlicher Verzeichnisse und Dienste für Eigenrücknahmesysteme (BattG).
Die Dokumentation der SOAP-Schnittstelle (Version 2.0) ist unter https://www.ear-system.de/ear-soap/v2 im HTML-Format verfügbar.
Testumgebung zum ear-Portal und dessen Schnittstellen
Sie können in der Testumgebung des ear-Portals einen Testaccount erstellen und dort viele Funktionen des ear-Portals ausprobieren.
Wichtige Hinweise für die Nutzung der Testumgebung
Bitte beachten Sie, dass alle Daten, Prüfentscheidungen und Dokumente, die Sie in der Testumgebung eingeben oder erhalten, keine rechtliche Bedeutung haben. Diese Testumgebung ist ausschließlich für Tests gedacht und hat keine Auswirkungen auf das reale ear-Portal. Alle Prüfentscheidungen und Verfahren sind bereits festgelegt, unabhängig von den Testdaten, die Sie eingeben. Daher können Sie nicht auf die Ergebnisse und Verfahrensdauer im echten ear-Portal schließen.
Wichtig: Alle Daten in der Testumgebung werden alle 3 Monate gelöscht, immer am ersten Tag des Quartals.
Test-SOAP-Schnittstelle
Für den Test der SOAP-Schnittstelle steht ein separates Testsystem zur Verfügung. Sie können die WSDL für das Testsystem unter den folgenden URLs abrufen:
Anleitung zur Verwendung der SOAP-Schnittstelle auf dem Testsystem
- Authentifizierung
Um die SOAP-Schnittstelle zu nutzen, müssen Sie sich mit einem Testaccount anmelden. Verwenden Sie dafür die Benutzer-ID "test" und das Kennwort "test". Beachten Sie, dass keine Änderungen an den Daten vorgenommen werden, wenn Sie sich mit diesem Benutzer anmelden. - Virtuelle Registrierungsnummer
Für den Testbenutzer des Elektrogeräteherstellers und ElektroG-Bevollmächtigten wird eine "virtuelle" Registrierungsnummer (12345678) bereitgestellt. Diese muss bei bestimmten Aufrufen des MitteilungsServices verwendet werden. - Virtuelle Abholkoordinations-Codes
Für die Funktionen des AbholkoordinationsService getCodes und getDetails kann mit der codeId V001 (für Vollmeldung), A001 (für Abzug) und B001 (für Erstgestellung) eine feste Beispielantwort generiert werden, die immer, sowohl für die Abholung als auch für die Aufstellung, den Status 5 („Abholung bestätigt nach Zuweisung" bzw. „Aufstellung bestätigt nach Zuweisung") zurück liefert. - Test mit Elektrogerätehersteller-Account
Alternativ können Sie die SOAP-Schnittstelle auch mit einem im Test-Portal angelegten Elektrogerätehersteller-Account verwenden. In diesem Fall stehen Ihnen alle Funktionen zur Verfügung, die auch einem Benutzer im Produktivsystem zur Verfügung stehen. Beachten Sie jedoch, dass im Testsystem keine validen Daten zur Abholkoordination geliefert werden.
Test-REST-Webservice-Schnittstelle für Herstellergarantiesysteme
Um die Schnittstelle nutzen zu können, bedarf es einer Benutzerauthentifizierung. Verwenden Sie dazu die vorgegebenen Anmeldedaten:
- Benutzername: test
- Passwort: test
Nach erfolgreicher Anmeldung können Sie die verschiedenen Funktionen der Schnittstelle ausprobieren. Beachten Sie, dass in der Testumgebung keine Datenänderungen möglich sind. Alle Eingaben werden nur formal geprüft und mit entsprechenden Fehler- oder Erfolgsmeldungen zurückgegeben.
Wichtige Hinweise für die Nutzung der Testumgebung
Bitte berücksichtigen Sie, dass die IDs der Gerätearten in der Testumgebung von denen des Produktivsystems abweichen können, obwohl die abgerufenen Gerätearten identisch sind.