Funktion validate_creditor_identifier

Beispiel:
validate_creditor_identifier("DE47ZZZ00000023373", "benutzername", "passwort")
validiert die Gläubigeridentifikationsnummer "DE47ZZZ00000023373" (Länge, Prüfsumme etc.).

Zweck: Plausibilitätsprüfung für Gläubigeridentifikationsnummern sowie Zerlegung in Ländercode, Creditor Business Code und National ID. Mögliche Tests: die enthaltene Prüfsumme, die Länderkennung (SEPA-Land) und die Länge.

Eingabe-Parameter:

• creditor_identifier: xsd:string
  Die zu prüfende Gläubigeridentifikationsnummer.
• user: xsd:string
  Ihr Benutzername, mit dem Sie sich auch auf iban-bic.com einloggen.
• password: xsd:string
  Das dazugehörige Passwort.

Ausgabe:

tns:CreditorIDValResStruct mit folgenden Feldern:

• id: die validierte Gläubiger-Identifikationsnummer.
• result: 'passed' oder 'failed' - für eine formal gültige oder ungültige Gläubiger-Identifikationsnummer.
• return_code: die Ergebnisse der durchgeführten Prüfungen, ausgedrückt als eine einzige Zahl. Nicht alle denkbaren Prüfungen wurden notwendigerweise durchgeführt (siehe die anderen Felder). Der "return_code" ist eine Zahl, die 0 ist, wenn alle für das betreffende Land implementierten Tests durchgeführt und bestanden wurden. Andernfalls ist es die Summe einer oder mehrerer der folgenden Zahlen: 512=falsche Länge für den "Creditor Identifier"; 1024=ungültiger Ländercode (kein SEPA-Land); 2048=ID-Prüfsummenfehler (Stellen 3 und 4).

  Wenn der "return_code" 65536 ist, bedeutet das, dass er undefiniert ist. Das sollte nicht vorkommen, und wir wären für einen Hinweis dankbar, wenn es doch passiert.

• checks: ein Array mit Bezeichnungen der durchgeführten Prüfungen (kann Elemente wie 'length' und 'checksum' enthalten).
• country: der ISO-Ländercode (die ersten 2 Stellen der Identifikationsnummer).
• creditor_business_code: die durch den Gläubiger festgelegten 3 Stellen, beispielsweise eine Zweigstellennummer.
• national_id: die nationale ID-Nummer, die den Gläubiger identifiziert.
• length_check: 'passed' oder 'failed' - je nachdem, ob die Länge für das jeweilige Land passt.
• checksum_check: 'passed' oder 'failed' (Korrektheit der zweistelligen Prüfsumme unmittelbar nach dem Ländercode im Creditor Identifier)
• balance: Ihr Kontostand (Anzahl verbleibender Transaktionen).