DE ♦ EN

IBAN-BIC.com (Theano GmbH)  » Webservice  » Dokumentation  » Dokumentation: find_bank

Passwort vergessen?

Kontakt,
Impressum

Neuer Kunde? Neu anmelden

Funktion find_bank

Beispiel:
find_bank("Deutsche", "DE", "100", "23", "benutzername", "passwort")
findet Banken im Land "DE" (Deutschland), in deren Namen "Deutsche" vorkommt, deren Bankleitzahl irgendwo die Ziffernfolge "100" enthält, und liefert höchstens 23 Einträge zurück.

Zweck: Volltextsuche für Banken aus allen unterstützten Ländern. Die Einschränkung auf ein bestimmtes Land ist optional - wenn Sie als zweiten Parameter einen leeren String übergeben, durchsuchen Sie alle Länder auf einmal. Auch die Einschränkung der Bankleitzahl ist optional, ebenso wie die Angabe von Suchbegriffen.

Eingabe-Parameter:

  • searchterms: xsd:string
    Suchbegriffe. Wenn Sie ein ganzes Wort oder mehrere ganze Wörter eingeben, geht die Suche besonders schnell und umfasst Bankname und -adresse. Geben Sie dagegen nur einen Teil eines Wortes ein, dauert die Suche ein wenig länger und umfasst nur Banknamen. Sie können diesen Parameter auch leer lassen ("" übergeben). In diesem Fall sollten Sie die Suche anderweitig eingrenzen, z. B. mit der Bankleitzahl (siehe unten). Außerdem können Sie diesen Parameter auch dazu nutzen, Banken aufgrund ihrer PAN-Nummer zu finden. Wenn eine 5-stellige Nummer und sonst nichts für diesen Parameter angegeben wird, wird die Suche auf diejenigen deutschen Banken eingeschränkt, deren PAN der angegebenen Nummer entspricht.
  • country: xsd:string
    Die zwei Buchstaben umfassende Länderkennung. Kann leer gelassen werden. Wird ein Land angegeben, wird die Suche auf dieses Land begrenzt; andernfalls werden alle unterstützten Länder durchsucht.
  • bankcode: xsd:string
    Optional. Wenn Sie hier eine nichtleere Zeichenfolge angeben, wird die Suche auf solche Banken begrenzt, deren Bankleitzahl die angegebene Zeichenfolge enthält.
  • maxitems:xsd:int
    Anzahl maximal zurückzuliefernder Suchergebnisse.
  • user: xsd:string
    Ihr Benutzername, mit dem Sie sich auch auf iban-bic.com einloggen.
  • password: xsd:string
    Das dazugehörige Passwort.

Ausgabe:

tns:BankResStruct mit folgenden Feldern:

  • result: leer, falls kein Fehler aufgetreten ist. Andernfalls eine Fehlermeldung.
  • banks: Liste von Banken. Jede Bank wird in einer Datenstruktur mit folgenden Attributen geliefert:

    • name: Bankname.
    • bic: BIC.
    • bankcode: nationale Bankleitzahl.
    • address: Adresse der Bank, soweit bekannt.

  • balance: Ihr Kontostand (Anzahl verbleibender Transaktionen).