DE ♦ EN

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

Passwort vergessen?

Kontakt,
Impressum

Neuer Kunde? Neu anmelden

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