DE ♦ EN

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

Passwort vergessen?

Kontakt,
Impressum

Neuer Kunde? Neu anmelden

Die Funktion transfer_form

Beispiel:
transfer_form("international", "31.08.2016", "Hugo Meier", "AT022050302101023600", "SPIHAT22XXX", "Hans Müller", "BE68844010370034", "RABOBE22", "123,20", "Verwendungszweck1", "Verwendungszweck2", "username", "password")

Zweck: Validatiert die angegebenen IBANs und generiert ein SEPA-Überweisungsformular im PDF-Format, das, wenn es in Farbe und ohne Größenverändung ausgedruckt wird, von Überweisungsscannern in Bankfilialen eingelesen werden kann (getestet bei der Volksbank in Deutschland). Das Formular wird mit den angegebenen Daten ausgefüllt, in diesem Beispiel: eine Überweisung von 123.20 EUR von Hans Müller mit der IBAN BE68844010370034 an Hugo Meier mit der IBAN AT022050302101023600 und BIC SPIHAT22XXX, mit dem Verwendungszweck (auf zwei Zeilen verteilt) "Verwendungszweck1" und "Verwendungszweck2", und mit einem QR-Code in der oberen rechten Ecke, mit dem die Überweisungsdaten automatisch in eine Banking-App eingelesen werden können.

Zugang: Benutzer-ID und Passwort sind dieselben wie fürs Einloggen auf iban-bic.com.

Eingabe-Parameter:

  • kind: xsd:string
    "international" für ein SEPA-Überweisungsformular oder "qr", wenn nur der QR-Code mit den Überweisungsdaten erzeugt werden soll. Die Möglichkeit, hier "qr" anzugeben, ist vor allem für Benutzer gedacht, die eine ältere Version der SOAP-Schnittstelle nutzen wollen, in der die Funktion qrcode noch nicht existiert.
  • date: xsd:string
    Das Datum, das in das Formular eingegeben werden soll.
  • toname: xsd:string
    Name des Empfängers.
  • toaccount: xsd:string
    IBAN des Empfängers.
  • tobankcode: xsd:string
    BIC des Empfängers.
  • fromname: xsd:string
    Name des Absenders.
  • fromaccount: xsd:string
    IBAN des Absenders.
  • frombankcode: xsd:string
    BIC des Absenders.
  • amount: xsd:string
    Betrag in EUR.
  • memo1: xsd:string
    Der Text fürs Feld "Verwendungszweck 1".
  • memo2: xsd:string
    Der Text fürs Feld "Verwendungszweck 2".
  • user: xsd:string
    Ihr Benutzername, mit dem Sie sich auch auf iban-bic.com einloggen.
  • password: xsd:string
    Das dazugehörige Passwort.

Ausgabe:

tns:TransferResStruct mit folgenden Feldern:

  • url: die URL der erzeugten PDF-Datei. Bitte laden Sie diese Datei innerhalb von einigen Minuten nach ihrer Erzeugung herunter.
  • result: 'passed', wenn beide Bankverbindungen erfolgreich validiert wurden und kein anderer Fehler auftrat. Ansonsten steht in diesem Feld eine Fehlermeldung.
  • validation_to: Ergebnis der Validierung der ersten IBAN, mit derselben Datenstruktur, die auch von der Funktion validate_iban geliefert wird.
  • validation_from: Ergebnis der Validierung der zweiten IBAN, mit derselben Datenstruktur, die auch von der Funktion validate_iban geliefert wird.
  • balance: Kontostand Ihres Benutzerkontos (Anzahl verbleibender Punkte für API-Aufrufe).

 

Die Funktion transfer_form

Bei der Einführung der neuen Funktion qrcode wollten wir unsere Kunden nicht dazu zwingen, sofort ihre eigene Software an eine neue WSDL-Datei anzupassen. Stattdessen widmeten wir eine existierende Funktion in der stabilen Version der SOAP-Schnittstelle um, so dass wir die neue Funktionalität anbieten konnten, ohne die stabile SOAP-Schnittstelle um eine neue Funktion zu erweitern.

Die Dokumentation der neuen Funktion qrcode erklärt, wozu Sie Überweisungs-QR-Codes erzeugen können und wie Sie die QR-Codes, die unser System liefert, in Webseiten und in PDF-Dateien einbauen können.

Wenn Sie die stabile Version der SOAP-Schnittstelle benutzen wollen (und nur dann), d.h. wenn die nicht ganz so stabile Version, REST oder der http-Wrapper nicht in Frage kommen (die alle bereits die neue Funktion enthalten), dann nutzen Sie bitte die Funktion transfer_form wie folgt.

Um den QR-Code zu erhalten, den Sie mit dem folgenden Aufruf erzeugen würden,

qrcode(Empfänger, iban, bic, Betrag, Verwendungszweck, Fußzeile, Benutzername, Passwort)

rufen Sie stattdessen auf:

transfer_form("qr", Datum, Empfänger, iban, bic, Absender, Absender_iban, Absender_bic, Betrag, Verwendungszweck, Fußzeile, Benutzername, Passwort).

Die fettgedruckten Parameter sind dieselben wie für die neue Funktion qrcode. Die anderen Parameter haben keinen Einfluss auf den QR-Code, aber auch die irrelevante Absender-IBAN sollte eine valide IBAN sein.