BattGVerzeichnisService Service

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).

Namespace
http://www.ear-system.de/ear-soap/v2
WSDL
/BattGVerzeichnisService?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
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

getAllebatteriearten Operation

Mit dieser Funktion können die im System hinterlegten Batteriearten abgerufen werden. In anderen Serviceaufrufen, wie z.B. getHersteller, wird die die Batterieart als Parameter mit der Bezeichnung batterieartverwendet.

Verfügbar ab
2.3
Rückgabewert
Typ Beschreibung
list of Batterieart Liste aller im System konfigurierten Batteriearten
Exception
Name Typ Bedingung
ServiceException ServiceException Es liegt ein interner Serverfehler vor

getHersteller Operation

Verzeichnis der registrierten Hersteller (BattG) und registrierten Bevollmächtigten.

Die übergebenen Parameter dienen der Filterung der Ergebnismenge. Es werden nur die Treffer geliefert, 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.

Verfügbar ab
2.3
Eingabeparameter
Name Typ Beschreibung
herstellername string Hersteller-/Bevollmächtigtenname)
registrierungsnummer int BattG-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 als Marke angelegt wurden. Bildmarken (auch mit Text im Bild) werden damit nicht gefunden!

batterieart string Batterieart, nach der gefiltert werden soll. Die Batterieart ist über den Service getAlleBatteriearten ermittelbar.
page int  
Rückgabewert
Typ Beschreibung
BattGRegistrierungen Liste von Registrierungen, die den eingegebenen Kriterien entsprechen
Exception
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 zurückgeliefert, 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.

Verfügbar ab
2.3
Eingabeparameter
Name Typ Beschreibung
herstellername string Hersteller-/Bevollmächtigtenname)
registrierungsnummer int Battg-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!

batterieart string Batterieart, nach der gefiltert werden soll. Die Batterieart ist über den Service getAlleBatteriearten ermittelbar.
page int Nummer der angefragten Seite (Paging), je Seite werden max. 5.000 Einträge geliefert. Der Seitenzähler beginnt bei 1.
Rückgabewert
Typ Beschreibung
BattGMarken Liste von registrierten Marken, die den eingegebenen Kriterien entsprechen
Exception
Name Typ Bedingung
ServiceException ServiceException Service ist nicht verfügbar oder interner Serverfehler

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