MitteilungsService Service

Dieser Service beinhaltet die Funktionalität, Mengenmitteilungen elektronisch abzusetzen. Für die fristgerechten Abrufe und Mengenmitteilungen ü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.

Namespace
http://www.ear-system.de/ear-soap/v2
WSDL
/MitteilungsService?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.0
Rückgabewert
Typ Beschreibung
StandardResponse Text Service verfügbar, wenn verfügbar.
Exception
Name Typ Bedingung
ServiceException ServiceException Service ist nicht verfügbar oder interner Serverfehler

checkRegistrierungsnummer Operation

Prüfen der eigenen Registrierungsdaten auf Richtigkeit. Der Service prüft, ob der aufrufende Benutzer die Berechtigung zur Verwendung der Schnittstelle für den angegebenen Hersteller besitzt.

Verfügbar ab
2.0
Eingabeparameter
Name Typ Beschreibung
registrierungsnummer int WEEE-Reg.-Nr. DE
Rückgabewert
Typ Beschreibung
StandardResponse Prüfung erfolgreich, wenn die Registrierungsnummer zum angemeldeten Benutzer passt.
Exception
Name Typ Bedingung
ServiceException ServiceException Ungültiges Format des übergebenen Parameters, Registrierungsnummer existiert nicht oder es liegt ein interner Serverfehler vor

getGeraetearten Operation

Mit dieser Funktion können die im System konfigurierten Gruppen, Kategorien und Gerätearten abgerufen werden. In anderen Serviceaufrufen, wie z.B. submitIstInput, wird die Nummer der Geräteart zur Identifikation der Geräteart als Parameter mit der Bezeichnung geraeteartnummer verwendet.

Verfügbar ab
2.0
Rückgabewert
Typ Beschreibung
list of Geraeteart Liste der im System konfigurierten Gerätearten inklusive der zugeordneten Gruppen und Kategorien
Exception
Name Typ Bedingung
ServiceException ServiceException Es liegt ein interner Serverfehler vor

submitIstInput Operation

Es werden die tatsächlich in Verkehr gebrachten Mengen je Geräteart in Bezug auf den Vormonat mitgeteilt, um die geplanten Mengen (Registrierungsgrundmenge) zu aktualisieren. Die Ist-Inputmitteilung ist spätestens bis zum 15. des Folgemonats, bzw. den darauffolgenden Werktag im Falle eines Samstags, Sonntags oder Feiertags einzureichen.

Erforderliche Berechtigungen:

  • Ist-Inputmitteilungen einsehen, abgeben und Korrekturen durchführen

Verfügbar ab
2.0
Eingabeparameter
Name Typ Beschreibung
menge decimal Zu meldende Menge bzw. Gewicht in Bezug auf die angegebene Einheit. Die Anzahl erlaubter Nachkommastellen ist abhängig von der übermittelten Einheit.
einheit Masseinheit Maßeinheit der übergebenen Menge. Erlaubte Werte: 1 = Kilogramm, 3 = Tonnen
jahr int Jahr für das die Mitteilung gilt. Format YYYY
monat int Monat für den die Mitteilung gilt. Format MM
geraeteartnummer int Nummer der Geräteart (siehe getGeraetearten)
registrierungsnummer int WEEE-Reg.-Nr. DE
wahrheitserklaerung boolean Mit Setzen dieses Parameters auf "true" bzw. "1" erklären Sie, dass die gemachten Angaben richtig sind und genaue Informationen über Art und Menge der von dem genannten Hersteller in der Bundesrepublik Deutschland in Verkehr gebrachten Elektro- und Elektronikgeräte vermitteln. Das Setzen des Parameters ist verpflichtend. Mitteilungen mit Werten ungleich "true" bzw. "1" werden nicht akzeptiert.
Rückgabewert
Typ Beschreibung
StandardResponse Mitteilung wurde erfolgreich übermittelt, wenn die IST-Inputmitteilung erfolgreich an das System übergeben wurde.
Exception
Name Typ Bedingung
ServiceException ServiceException Ungültiges Format der übergebenen Parameter, Registrierungsnummer existiert nicht oder es liegt ein interner Serverfehler vor

submitEigenruecknahme Operation

Mit dieser Funktion können Eigenrücknahmen mitgeteilt werden. Die Mitteilung kann monatlich erfolgen und es gelten die gleichen Fristen wie bei der IST-Inputmitteilung (siehe submitIstInput).

Erforderliche Berechtigungen:

  • Eigenrücknahmemitteilungen einsehen, abgeben und Korrekturen durchführen

Verfügbar ab
2.0
Eingabeparameter
Name Typ Beschreibung
menge decimal Zu meldende Menge bzw. Gewicht in Bezug auf die angegebene Einheit. Die Anzahl erlaubter Nachkommastellen ist abhängig von der übermittelten Einheit.
einheit Masseinheit Maßeinheit der übergebenen Menge. Erlaubte Werte: 1 = Kilogramm, 3 = Tonnen
jahr int Jahr für das die Mitteilung gilt. Format YYYY
monat int Monat für den die Mitteilung gilt. Format MM
geraeteartnummer int Nummer der Geräteart (siehe getGeraetearten)
registrierungsnummer int WEEE-Reg.-Nr. DE
Rückgabewert
Typ Beschreibung
StandardResponse Mitteilung wurde erfolgreich übermittelt, wenn die Eigenrücknahmemitteilung erfolgreich an das System übergeben wurde.
Exception
Name Typ Bedingung
ServiceException ServiceException Ungültiges Format der übergebenen Parameter, Registrierungsnummer existiert nicht oder es liegt ein interner Serverfehler vor

submitMittelbarerExport Operation

Mit dieser Funktion können Mittelbare Exportmitteilungen übermittelt werden. Die Mitteilung kann monatlich erfolgen und es gelten die gleichen Fristen wie bei der IST-Inputmitteilung (siehe submitIstInput). Es besteht eine Korrelation zwischen der mittelbaren Exportmitteilung und der jeweiligen Ist-Inputmitteilung: Das Meldegewicht der mittelbaren Exportmitteilung muss stets kleiner oder gleich des Meldegewichts der Ist-Inputmitteilung des Meldemonats sein. Die Angabe des Anteils an Gebrauchtgeräten ist verpflichtend.

Erforderliche Berechtigungen:

  • Mittelbare Exportmitteilungen einsehen, abgeben und Korrekturen durchführen

Verfügbar ab
2.0
Eingabeparameter
Name Typ Beschreibung
menge decimal Zu meldende Menge bzw. Gewicht in Bezug auf die angegebene Einheit. Die Anzahl erlaubter Nachkommastellen ist abhängig von der übermittelten Einheit.
anteilGebrauchtgeraete decimal Der Anteil an Gebrauchtgeräten innerhalb der zu meldenden Menge in Bezug auf die angegebene Einheit (Diese Angabe ist verpflichtend.)
einheit Masseinheit Maßeinheit der übergebenen Menge. Erlaubte Werte: 1 = Kilogramm, 3 = Tonnen
jahr int Jahr für das die Mitteilung gilt. Format YYYY
monat int Monat für den die Mitteilung gilt. Format MM
geraeteartnummer int Nummer der Geräteart (siehe getGeraetearten)
registrierungsnummer int WEEE-Reg.-Nr. DE
Rückgabewert
Typ Beschreibung
StandardResponse Mitteilung wurde erfolgreich übermittelt, wenn die mittelbare Exportmitteilung erfolgreich an das System übergeben wurde.
Exception
Name Typ Bedingung
ServiceException ServiceException Ungültiges Format der übergebenen Parameter, Registrierungsnummer existiert nicht oder es liegt ein interner Serverfehler vor

submitIstOutput Operation

Dieser Funktionsaufruf dient der Erfassung von Ist-Outputmitteilungen. Er steht für die vom Entsorger gewogene Nettomenge an Elektroaltgeräten, der dem Kunden zugewiesenen und abgeholten Transporteinheit. Diese Mitteilung korrigiert die Entlastung des Herstellers, die durch die Vorab-Gutschrift mit dem durchschnittlichen Soll-Outputgewicht der abgeholten Transporteinheit entstanden ist. Sie fließt in die Verpflichtungsrechnung für die AHK ein.

Erforderliche Berechtigungen:

  • Ist-Outputmitteilungen einsehen, abgeben und Korrekturen durchführen

Verfügbar ab
2.0
Eingabeparameter
Name Typ Beschreibung
menge decimal Zu meldende Menge bzw. Gewicht in Bezug auf die angegebene Einheit. Die Anzahl erlaubter Nachkommastellen ist abhängig von der übermittelten Einheit.
einheit Masseinheit Maßeinheit der übergebenen Menge. Erlaubte Werte: 1 = Kilogramm, 3 = Tonnen
codeId string 4 stelliger Abhol- bzw. Aufstellungscode
wgKfz string KFZ Kennzeichen des LKWs
wgNumber string Wiegescheinnummer
registrierungsnummer int WEEE-Reg.-Nr. DE
Rückgabewert
Typ Beschreibung
StandardResponse Mitteilung wurde erfolgreich übermittelt, wenn die IST-Outmitteilung erfolgreich an das System übergeben wurde.
Exception
Name Typ Bedingung
ServiceException ServiceException Ungültiges Format der übergebenen Parameter, Registrierungsnummer existiert nicht oder es liegt ein interner Serverfehler vor

Impressum | Disclaimer | Datenschutzerklärung
© ear ist eine eingetragene Marke
Schnittstellen-Version 2.5