Hier wird die SOAP-Funktion beschrieben. Wenn Sie ein neuer Nutzer unserer API sind, empfehlen wir stattdessen den moderneren, handlicheren REST-Endpunkt.

Die Funktion qrcode

Diese Funktion ist noch nicht Teil des SOAP-Interfaces in der Produktionsversion. Sie können diese Funktionalität aber bereits jetzt nutzen:
• über SOAP mit der Version ssl.ibanrechner.de/soap-ce/ oder durch Verwendung der Funktion "transfer_form",
• via REST
• oder mit dem http-Wrapper.

Beispiel:
qrcode("Theano GmbH", "DE12500105170648489890", "COBADEHD001", 355.81, "Re. TI135225", "TI135225/355.81 EUR", "username", "password")

Zweck: Erzeugt einen QR-Code, der, wenn er eingescannt wird, automatisch ein Überweisungsformular z. B. in einer Banking-App ausfüllt.

Der QR-Code, der oben links im Bild sichtbar ist, wurde mit dieser Funktion erzeugt. Wenn Ihre Banking-App QR-Codes versteht, können Sie (bzw. Ihr Kunde) so ein komplettes Überweisungsformular auf Knopfdruck füllen.

Mit der Subsembly-Banking-App geht das beispielsweise so:
1. in die App einloggen,
2. das Konto, von dem überwiesen werden soll, antippen,
3. das Menü öffnen (auf die drei Streifen unten links klicken),
4. "QR-Code einlesen" antippen,
5. mit dem Smartphone auf den QR-Code zeigen,
und ein paar Sekunden später ist das Formular automatisch ausgefüllt.

Die Funktion liefert eine PNG-Datei mit dem QR-Code (optional mit einer für Menschen lesbaren Fußzeile), die Sie z. B. online anzeigen oder in Ihre Rechnungsdokumente einbinden können.

Um den QR-Code auf einer Webseite anzuzeigen, müssen Sie keine PNG-Datei im Dateisystem Ihres Servers anlegen, sondern können stattdessen direkt die von uns gelieferte base64-codierte Zeichenkette (z. B. "data:image/png;base64,iVBORw0KGgoAAAAN...") wie folgt in eine HTML-Seite einbauen: <img width=""300" src="data:image/png;base64,iVBORw...kSuQmCC"/>.

Für die Einbindung einer QR-Code-PNG-Datei in PDF-Rechnungen empfehlen wir folgende kostenlose Open Source-Software:
• convert (imagemagick) fürs Umwandeln von PNG nach PDF,
• pdfjam fürs Skalieren und Positionieren des QR-Codes auf einer Seite, und
• pdftk fürs Überlagern der PDF-Rechnung, wie sie aus Ihrem Buchhaltungsprogramm kommt, mit der PDF-Datei, die den skalierten und positionierten QR-Code enthält.

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

Eingabe-Parameter:

• recipient: xsd:string
  Der Kontoinhaber (Empfänger).
• iban: xsd:string
  Die IBAN des Empfänger-Kontos.
• bic: xsd:string
  Der zugehörige BIC-Code. Wenn Sie dieses Feld leer lassen, versucht der Server es anhand der IBAN zu füllen. Wenn Sie einen BIC-Code angeben, wird aber der von Ihnen angegebene genutzt.
• amount: xsd:string
  Betrag (in EUR).
• memo: xsd:string
  Verwendungszweck.
• label: xsd:string
  Hier können Sie Text angeben, der menschenlesbar unter den QR-Code gedruckt wird (damit Sie z. B. sehen können, zu welcher Rechnung dieser Code gehört). Wenn Sie dieses Feld leer lassen, wird eine quadratische Bitmap erzeugt, andernfalls werden unten ein paar Pixel für den Text angehängt.
• user: xsd:string
  Ihr Benutzername, mit dem Sie sich auch auf iban-bic.com einloggen.
• password: xsd:string
  Das dazugehörige Passwort.

Ausgabe:

• image: die QR-Code-Bitmap als Zeichenkette in base64-encoding. Sie können diese Zeichenkette direkt wie angegeben im HTML-"img"-Tag nutzen (z.B.: <img src="data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAisAAAJ...">), oder Sie können den Teil nach "data:image/png;base64," base64-decodieren und in eine PNG-Datei schreiben.
• md5sum: das Ergebnis des Linux-Kommandos "md5sum", wenn man es auf die PNG-Datei anwendet.
• result: 'passed', wenn die IBAN erfolgreich validiert wird und kein anderer Fehler auftritt. Andernfalls enthält dieses Feld eine Fehlermeldung.
• balance: die Anzahl auf Ihrem Benutzerkonto verbleibender Berechnungen. Falls Sie Ihre Berechnungen im Nachhinein bezahlen, sind Berechnungen auch beim Erreichen von 0 weiter möglich.