Funktion supported_countries

Beispiel:
supported_countries("IBAN AND some_BICs AND (account_validated OR bankcode_validated)", "DE", "benutzername", "passwort") liefert - in deutscher Sprache - eine Liste aller Länder, für die IBAN-Berechnungen angeboten werden, für die es zumindest für manche Banken auch BIC-Daten gibt, und für die wenigstens eins der beiden Felder Inlands-Kontonummer und Bankleitzahl validiert werden.

Zweck: teilt Ihnen mit, welche Länder eine von Ihnen festgelegte Bedingung für "ausreichende Unterstützung" erfüllen, und wie diese Länder in einer von Ihnen gewählten Sprache heißen. So können Sie automatisch für Ihre Anwendung immer alle unterstützten Länder verwenden, auch solche, die von uns erst kürzlich hinzugefügt wurden. Die Liste der Ländernamen können Sie z. B. benutzen, um Ihrem Benutzer eine Drop-Down-Liste anzuzeigen.

Eingabe-Parameter:

supported_condition: xsd:string
Eine Bedingung, die die von Ihnen gewünschten Länder erfüllen müssen, um aufgelistet zu werden. Sie können folgende Schlüsselwörter verwenden und mit runden Klammern, AND (logisches Und) und OR (logisches Oder) verknüpfen:
- IBAN: für dieses Land kann eine IBAN berechnet werden.
- unique_BIC: falls es für eine Bankleitzahl einen BIC-Code gibt, wird dieser auch zurückgeliefert. Außerdem wird ein eindeutiger BIC-Code geliefert.
- some_BICs: für eine Bankleitzahl könnte keiner, einer, oder auch mehrere BIC-Codes geliefert werden (im letzteren Fall müssten Sie selbst herausfinden, welcher der BIC-Kandidaten richtig ist). Länder, die die Bedingung 'unique_BIC' erfüllen, werden ebenfalls geliefert, wenn Sie die Bedingung 'some_BICs' angeben.
- name_based_BICs: wie für "some_BICs" könnte keiner, einer, oder mehrere BIC-Codes geliefert werden. Im Gegensatz zur Bedingung "some_BICs" stammen diese BIC-Codes aber nicht aus einem Verzeichnis, sondern aus zweien, die aufgrund des Bank-Namens verknüpft wurden. Solche BICs sind also etwas weniger zuverlässig. Länder, die die Bedingung "some_BICs" erfüllen, werden ebenfalls geliefert, wenn Sie "name_based_BICs" verlangen.
- account_validated: wenn eine Kontonummer eine Püfsumme enthält, wird diese auch geprüft.
- bankcode_validated: die Bankleitzahl wird auf das Vorhandensein in einem Bankleitzahlverzeichnis geprüft.
Wenn Sie den Parameter "supported_condition" leer lassen, wird die Voreinstellung "IBAN AND some_BICs AND (account_validated OR bankcode_validated)" verwendet.
language: xsd:string
Die zwei Buchstaben umfassende Länderkennung für die gewünschte Sprache, oder auch die Sprach-Nummer laut folgender Liste.
- Englisch = 0 oder EN
- Deutsch = 1 oder DE
- Niederländisch = 3 oder NL
- Polnisch = 4 oder PL
- Französisch = 5 oder FR
- Spanisch = 6 oder ES
- Italienisch = 7 oder IT
- Türkisch = 8 oder TR
- Kroatisch = 9 oder HR
- Serbisch = 10 oder RS
user: xsd:string
Ihr Benutzername, mit dem Sie sich auch auf iban-bic.com einloggen.
password: xsd:string
Das dazugehörige Passwort.

Ausgabe:

tns:CountryResStruct mit folgenden Feldern:

result: 'OK' oder eine Fehlermeldung.
supported_countries: Liste von 2-Buchstaben-Ländercodes aller unterstützten Länder.
country_names: Liste der Namen der unterstützten Länder (in der verlangten Sprache).
balance: Ihr Kontostand (Anzahl verbleibender Transaktionen).

Diese Funktion in Aktion

Die folgende Tabelle wird von unserem CMS mit Hilfe mehrerer Aufrufe der Funktion "supported_countries" zusammengestellt. Die Tabelle passt sich daher immer automatisch an, sobald die SOAP-Schnittstelle ein neues Land unterstützt:

Land	Inlands-Kontonummern-Validierung?	Bankleitzahl-Validierung?	BICs verfügbar?
	nein	nein	ja³
Ägypten	nein	nein	ja³
Albanien	nein	nein	ja³
Andorra	nein	nein	ja³
Belgien	nein	nein	ja³
Bosnien und Herzegowina	nein	nein	ja³
Bulgarien	nein	nein	ja³
Dänemark	nein	nein	ja³
Deutschland	nein	nein	ja³
Estland	nein	nein	ja³
Finnland	nein	nein	ja³
Frankreich	nein	nein	ja³
Georgien	nein	nein	ja³
Großbritannien	nein	nein	ja³
Irland	nein	nein	ja³
Island	nein	nein	ja³
Israel	nein	nein	ja³
Italien	nein	nein	ja³
Jordanien	nein	nein	ja³
Kasachstan	nein	nein	ja³
Kosovo	nein	nein	ja³
Kroatien	nein	nein	ja³
Lettland	nein	nein	ja³
Libanon	nein	nein	ja³
Liechtenstein	nein	nein	ja³
Litauen	nein	nein	ja³
Luxemburg	nein	nein	ja³
Malta	nein	nein	ja³
Moldawien	nein	nein	ja³
Monaco	nein	nein	ja³
Niederlande	nein	nein	ja³
Norwegen	nein	nein	ja³
Österreich	nein	nein	ja³
Polen	nein	nein	ja³
Portugal	nein	nein	ja³
Rumänien	nein	nein	ja³
San Marino	nein	nein	ja³
Schweden	nein	nein	ja³
Schweiz	nein	nein	ja³
Serbien	nein	nein	ja³
Slowakei	nein	nein	ja³
Slowenien	nein	nein	ja³
Spanien	nein	nein	ja³
Tschechien	nein	nein	ja³
Türkei	nein	nein	ja³
Ungarn	nein	nein	ja³
Vereinigte Arabische Emirate	nein	nein	ja³
Weißrussland	nein	nein	ja³
Zypern	nein	nein	ja³

¹ Diese BICs werden regelmäßig aus einem offiziellen Verzeichnis kopiert (für die meisten Länder von der Nationalbank). Wenn für eine Bankleitzahl ein BIC-Code definiert ist, liefern wir genau diesen einen BIC-Code.

² Auch diese BICs werden regelmäßig aus einem offiziellen Verzeichnis kopiert. Im Gegensatz zu 1. kann es hier aber vorkommen, dass für dieselbe Bankleitzahl mehrere BICs in Frage kommen. Wir liefern dann alle in Frage kommenden Kandidaten, und Sie müssen ggf. selbst herausfinden, welcher BIC-Code der richtige ist.

³ Diese BICs werden regelmäßig durch das Kombinieren zweier offizieller Verzeichnisse bestimmt. Das eine Verzeichnis enthält BICs und Banknamen, das andere Banknamen und Bankleitzahlen. Wir verknüpfen diese Daten anhand des Banknamens. Daher kann es gelegentlich zu Fehlern kommen, falls die Banken in den beiden Verzeichnissen nicht konsistent benannt wurden. Auch hier kann es vorkommen, dass mehrere BICs in Frage kommen und Sie ggf. selbst herausfinden müssen, welcher BIC-Code der richtige ist.

Immer wenn wir mehrere BIC-Kandidaten liefern, liefern wir zu Beginn der Liste kürzere BICs (mit 8 statt 11 signifikanten Stellen). Meist ist es eine gute Idee, solche kurzen BICs zu verwenden.

		Passwort vergessen?	Kontakt, Impressum
angemeldet bleiben		Neuer Kunde? Neu anmelden	Kontakt, Impressum