| Sehen Sie sich auch mein anderes Produkt an: myebilanz – die Freeware-eBilanz aus MySQL und CSV! |
 |
KONTOPRUEF-Navigation:
Online-Schnittstelle (Bankverbindungen) zu KONTOPRUEF
Hier finden Sie die nötigen Informationen, um die Online-Kontonummernprüfung in eigene Systeme zu integrieren. Dies hat den Vorteil, daß Sie sich nie mehr um Updates und deren Installation kümmern müssen - die Bankdaten sind ohne Ihr Zutun stets aktuell! Als Schnittstelle wird WDDX oder WebServices/SOAP verwendet. Mit WDDX erfolgt der Aufruf direkt über eine URL mittels GET in einem der folgenden Formate:
Nationale Bankverbindungsprüfung mit Bankleitzahl und Kontonummer
http(s)://wddx.hanft.de/ktopruef?un={Ihr Benutzername}&pw={Ihr Kennwort}&blz={Bankleitzahl}&kto={Kontonummer}&c={Land}
(Bitte die Parameter jeweils
ohne geschweifte Klammern angeben! Eine gültige URL könnte
z.B. wie folgt aussehen:
http://wddx.hanft.de/ktopruef?un=demo&pw=demo&blz=89999999&kto=1234 (unverschlüsselt)
https://wddx.hanft.de/ktopruef?un=demo&pw=demo&blz=89999999&kto=1234 (verschlüsselt)
Falls Sie auf einen dieser Links klicken, öffnet sich ein neues, auf den
ersten Blick vermutlich
leeres Fenster, dessen Quellcode Sie ansehen können - z.B. unter Netscape
mit Strg-U. Dort ist dann die Antwort auf Ihre Anfrage enthalten.)
Die Parameter im einzelnen:
| un | Ihr Benutzername |
| pw | Ihr Passwort |
| blz | Zu prüfende Bankleitzahl (maximal 8 Ziffern ohne Zwischenräume) |
| kto | Zu prüfende Kontonummer (maximal 11 Ziffern ohne Zwischenräume) |
| Die folgenden Parameter müssen nur beim WebService-Zugang angegeben werden; beim WDDX-Zugang können sie weggelassen werden: | |
| c | Land (immer "de" für Deutschland) |
| id | für zukünftige Erweiterungen reserviert; derzeit bitte immer 0 (Integer) senden |
| name | für zukünftige Erweiterungen reserviert; derzeit bitte immer ein leeres Feld senden |
Die obige URL liefert als Ergebnis folgende Variablen in WDDX gepackt zurück:
| result | Numerisches Ergebnis der Prüfung
(als String) lt. folgender Tabelle:
|
| resulttext | Ergebnis der Prüfung im Klartext Bitte verwenden Sie diesen Text nur für eine "menschen-lesbare" Erläuterung, jedoch nicht für die Gut-/Schlecht-Aussage in Ihrer Software, da er sich immer wieder einmal ändern kann. Für die Gut-/Schlecht-Aussage dürfen Sie nur den numerischen result-Wert benutzen! |
| bankname | Name der geprüften Bank (leer, falls Bank nicht existiert) |
| newblz |
|
| iban | Die aus den Prüfdaten konstruierte internationale Kontonummer (nur bei 0<=result<=10), wenn sie eindeutig ermittelt werden kann, ansonsten leeres Feld |
| bic | Der aus der geprüften Bankleitzahl ermittelte Bank Identifier Code (Swift-Code) (nur bei 0<=result<=10, ansonsten leeres Feld) |
IBAN-Prüfung
Hinweis: Zunächst wird die IBAN-eigene Prüfziffer getestet. Diese Funktion steht für alle Kunden und alle Länder zur Verfügung, unabhängig davon, ob für das jeweilige "IBAN-Land" ein Vertrag besteht oder nicht. Eine weitergehende (nationale) Prüfung wird (bei korrekter IBAN-Prüfziffer) jedoch nur dann durchgeführt, wenn für das jeweilige Land ein nationaler Prüfvertrag besteht.
http(s)://wddx.hanft.de/ktopruef?un={Ihr Benutzername}&pw={Ihr Kennwort}&iban={IBAN}
(Bitte die Parameter jeweils
ohne geschweifte Klammern angeben! Eine gültige URL könnte
z.B. wie folgt aussehen:
http://wddx.hanft.de/ktopruef?un=demo&pw=demo&iban=xx1234567890 (unverschlüsselt)
https://wddx.hanft.de/ktopruef?un=demo&pw=demo&iban=xx1234567890 (verschlüsselt)
Falls Sie auf einen dieser Links klicken, öffnet sich ein neues, auf den
ersten Blick vermutlich
leeres Fenster, dessen Quellcode Sie ansehen können - z.B. unter Netscape
mit Strg-U. Dort ist dann die Antwort auf Ihre Anfrage enthalten.)
Die Parameter im einzelnen:
| un | Ihr Benutzername |
| pw | Ihr Passwort |
| iban | Zu prüfende IBAN (bitte ohne Zwischenräume übermitteln!) |
| id | für zukünftige Erweiterungen reserviert; derzeit bitte immer 0 (Integer) senden |
| name | für zukünftige Erweiterungen reserviert; derzeit bitte immer ein leeres Feld senden |
Die obige URL liefert als Ergebnis folgende Variablen in WDDX gepackt zurück:
| result | Numerisches Ergebnis der Prüfung (als String) lt. obiger Tabelle |
| resulttext | Ergebnis der Prüfung im Klartext Bitte verwenden Sie diesen Text nur für eine "menschen-lesbare" Erläuterung, jedoch nicht für die Gut-/Schlecht-Aussage in Ihrer Software, da er sich immer wieder einmal ändern kann. Für die Gut-/Schlecht-Aussage dürfen Sie nur den numerischen result-Wert benutzen! |
| bankname | Name der geprüften Bank (leer, falls Bank nicht existiert oder nicht aus einem "prüfbaren" Land stammt) |
| newblz |
Nur bei national prüfbaren Banken gefüllt:
|
| iban | Die aus den Prüfdaten rekonstruierte IBAN (nur bei 0<=result<=10 und in "prüfbaren" Ländern; sollte theoretisch mit der geprüften IBAN übereinstimmen) |
| bic | Der aus der geprüften Bankleitzahl ermittelte Bank Identifier Code (Swift-Code) (nur bei 0<=result<=10 und nur in "prüfbaren" Ländern) |
BIC-Prüfung
Hinweis: Für die Prüfung wird das SCL-Directory der Deutschen Bundesbank herangezogen, d.h. es sind diejenigen Banken enthalten, die "SEPA-connected" sind. I.d.R. sind das auch die "interessanten" Banken, da u.a. die Information darin enthalten ist, ob die jeweilige Bank SEPA-Lastschriften akzeptiert (was z.B. in der Schweiz nicht für alle Banken gilt).
http(s)://wddx.hanft.de/ktopruef?un={Ihr Benutzername}&pw={Ihr Kennwort}&bic={BIC}
(Bitte die Parameter jeweils
ohne geschweifte Klammern angeben! Eine gültige URL könnte
z.B. wie folgt aussehen:
http://wddx.hanft.de/ktopruef?un=demo&pw=demo&bic=abcdefgh123 (unverschlüsselt)
https://wddx.hanft.de/ktopruef?un=demo&pw=demo&bic=abcdefgh123 (verschlüsselt)
Falls Sie auf einen dieser Links klicken, öffnet sich ein neues, auf den
ersten Blick vermutlich
leeres Fenster, dessen Quellcode Sie ansehen können - z.B. unter Netscape
mit Strg-U. Dort ist dann die Antwort auf Ihre Anfrage enthalten.)
Die Parameter im einzelnen:
| un | Ihr Benutzername |
| pw | Ihr Passwort |
| bic | Zu prüfender BIC (8 oder 11 Stellen lang) |
Die obige URL liefert als Ergebnis folgende Variablen in WDDX gepackt zurück:
| bicname | Name der geprüften Bank
(leer, falls BIC nicht existiert oder nicht "SEPA-connected" ist) Achtung: Beginnt dieses Antwortfeld mit einem Stern "*", ist die Abfrage fehlgeschlagen, und der Rest dieses Feldes enthält die Fehlermeldung! |
| bicsct | wenn 1: Diese Bank akzeptiert SEPA-Überweisungen (Credit Transfer). |
| bicsdd | wenn 1: Diese Bank akzeptiert SEPA-Basislastschriften (Core Direct Debit). |
| bicb2b | wenn 1: Diese Bank akzeptiert SEPA-Firmenlastschriften (Business To Business). |
IBAN- und BIC-Prüfung
Diese Püfung ist eine Kombination aus IBAN-Prüfung und BIC-Prüfung. Geben Sie einfach alle Eingabeparameter für beide Funktionen an, und Sie erhalten die Ausgabeparameter von beiden Funktionen. Beispiel:
http(s)://wddx.hanft.de/ktopruef?un={Ihr Benutzername}&pw={Ihr Kennwort}&iban={IBAN}&bic={BIC}
(Bitte die Parameter jeweils
ohne geschweifte Klammern angeben! Eine gültige URL könnte
z.B. wie folgt aussehen:
http://wddx.hanft.de/ktopruef?un=demo&pw=demo&iban=xx1234567890&bic=abcdefgh123 (unverschlüsselt)
https://wddx.hanft.de/ktopruef?un=demo&pw=demo&iban=xx1234567890&bic=abcdefgh123 (verschlüsselt)
Falls Sie auf einen dieser Links klicken, öffnet sich ein neues, auf den
ersten Blick vermutlich
leeres Fenster, dessen Quellcode Sie ansehen können - z.B. unter Netscape
mit Strg-U. Dort ist dann die Antwort auf Ihre Anfrage enthalten.)
Selbstverständlich wird Ihnen bei dieser "Kombi-Abfrage" nur eine einzige Prüfung berechnet!
Kreditkartenprüfung
http(s)://wddx.hanft.de/ktopruef?un={Ihr Benutzername}&pw={Ihr Kennwort}&cc={Kreditkartennummer}
(Bitte die Parameter jeweils
ohne geschweifte Klammern angeben! Eine gültige URL könnte
z.B. wie folgt aussehen:
http://wddx.hanft.de/ktopruef?un=demo&pw=demo&cc=1234567890123456 (unverschlüsselt)
https://wddx.hanft.de/ktopruef?un=demo&pw=demo&cc=1234567890123456 (verschlüsselt)
Falls Sie auf einen dieser Links klicken, öffnet sich ein neues, auf den
ersten Blick vermutlich
leeres Fenster, dessen Quellcode Sie ansehen können - z.B. unter Netscape
mit Strg-U. Dort ist dann die Antwort auf Ihre Anfrage enthalten.)
Die obige URL liefert als Ergebnis folgende Variablen in WDDX gepackt zurück:
| result | Numerisches Ergebnis der Prüfung (als String) lt. obiger Tabelle |
| resulttext | Ergebnis der Prüfung im Klartext Bitte verwenden Sie diesen Text nur für eine "menschen-lesbare" Erläuterung, jedoch nicht für die Gut-/Schlecht-Aussage in Ihrer Software, da er sich immer wieder einmal ändern kann. Für die Gut-/Schlecht-Aussage dürfen Sie nur den numerischen result-Wert benutzen! |
Bankensuche
http(s)://wddx.hanft.de/ktopruef?un={Ihr Benutzername}&pw={Ihr Kennwort}&search={Bankname/-ort oder Teile davon}{&fragments=1 wenn auch nach Wortteilen gesucht werden soll}
(Bitte die Parameter jeweils
ohne geschweifte Klammern angeben! Eine gültige URL könnte
z.B. wie folgt aussehen:
http://wddx.hanft.de/ktopruef?un=demo&pw=demo&search=Demobank Demostadt (unverschlüsselt)
https://wddx.hanft.de/ktopruef?un=demo&pw=demo&search=Demobank Demostadt (verschlüsselt)
Falls Sie auf einen dieser Links klicken, öffnet sich ein neues, auf den
ersten Blick vermutlich
leeres Fenster, dessen Quellcode Sie ansehen können - z.B. unter Netscape
mit Strg-U. Dort ist dann die Antwort auf Ihre Anfrage enthalten.)
Die obige URL liefert als Ergebnis folgende Variablen in WDDX gepackt zurück:
| banken | Liste der gefundenenen Banken im Format "Bankleitzahl|Bankname" |
WebService
Alternativ zur WDDX-Schnittstelle wird die Bankverbindungsprüfung auch als WebService (SOAP) angeboten.
Demo
Sie können sowohl die WDDX-Schnittstelle als auch die WebServices gleich ausprobieren: Sehen Sie bitte auf der Demo-Seite nach.
Software für Handeingabe
Wenn Sie den WDDX-Server einfach per Handeingabe nutzen wollen, können Sie sich hier ein ausführbares Programm für Windows herunterladen Hinweis: Vorherige Versionen von HanftWddx, die per Installshield installiert wurden, sind vor dem Aufruf des aktuellen HanftWddx über "Systemsteuerung/Software" erst restlos zu entfernen!.
Falls Sie das Programm zur Handeingabe für Linux benötigen, lassen Sie es mich bitte wissen.
Einbindung in Anwendungen
In Programmiersprachen wie z. B. PHP oder Perl sind WDDX-Funktionen bereits integriert. Dokumentierte Beispielskripte für PHP finden Sie hier. Falls Sie Unterstützung bei der Implementierung in Ihre eigenen PHP-Skripte benötigen, können Sie sich von unserem Partner Sauerer Software ein Angebot erstellen lassen.
Wenn Sie die Online-Prüfung unter Windows ohne viel Aufwand einbinden wollen, können Sie sich ein COM-Objekt herunterladen. Dabei ist auch gleich ein Beispielprogramm, um den Verbindungsaufbau manuell zu testen. Hinweis: Vorherige Versionen von HanftWddx, die per Installshield installiert wurden, sind vor dem Aufruf des aktuellen HanftWddx über "Systemsteuerung/Software" erst restlos zu entfernen! Eine Einbindung in ASP, MS-Access oder Visual Basic etc. funktioniert dann ungefähr wie folgt:
Dim KtoPruef as Variant
Set KtoPruef = CreateObject("HanftWddx.KtoPruef")
KtoPruef.SetProxy("mein.proxy.de", 3128) ' nur falls benötigt
KtoPruef.SSLMode = 1 ' nur falls gewünscht
KtoPruef.TestBlzKto("Benutzername","Passwort","Bankleitzahl","Kontonummer","DE",0,"")
ErgebnisAlsZahl = KtoPruef.Result
ErgebnisAlsText = KtoPruef.Resulttext
ErgebnisBankName = KtoPruef.BankNameInformationen für weitere Entwicklungsumgebungen finden Sie im Inhaltsverzeichnis unter „Software-Integration”
Falls Sie eine libHanftWddx.so für Linux benötigen, lassen Sie es mich bitte wissen.
Organisatorisches
Für diesen Dienst ist eine Anmeldung erforderlich (siehe unten). Sie können die Schnittstellenimplementierung jedoch auch ohne Anmeldung jederzeit mit der Demo-Version ausprobieren, um die grundsätzliche Funktionalität zu testen.
Es besteht die Möglichkeit, eine kostenlose, zeitlich limitierte Benutzerkennung zu erhalten, um reale Tests durchzuführen. Setzen Sie sich bei Interesse bitte mit mir in Verbindung.
Die genauen Preise finden Sie auf der PDF-Anmeldung unten. Bedenken Sie, dass für eine einzige Rücklastschrift schon über 10 EUR Bank-Entgelte anfallen können; für netto 10 EUR können Sie hier – bei Zahlung per Lastschrift – schon 76 Bankverbindungen prüfen! Und durch die Mengenstaffel wird der durchschnittliche Preis immer günstiger, je öfter Sie diesen Service in Anspruch nehmen. Vermeiden Sie also unnötigen Ärger und unnötige Kosten und nutzen Sie diesen vorteilhaften Service für wenig Geld!
Wenn Sie sich für die Bankverbindungs- und Adreßprüfung gleichzeitig anmelden, fällt das Anmeldeentgelt insgesamt nur einmal an!
Wie bei Verträgen üblich benötige ich leider immer noch Ihre Unterschrift (die digitale Unterschrift ist ja leider momentan noch nicht so weit gediehen...). Ich habe daher ein PDF-Dokument vorbereitet, das Sie direkt am Bildschirm ausfüllen und dann ausdrucken können. Bitte senden Sie mir das ausgefüllte und unterschriebene Formular an die darauf angegebene Anschrift. Sie erhalten dann Ihren Benutzernamen und Ihr Kennwort per E-Mail zugesandt.
| Download des Anmeldeformulars: | Download des Adobe Readers: |
|---|---|
 |
 |
| Sehen Sie sich auch mein anderes Produkt an: myebilanz – die Freeware-eBilanz aus MySQL und CSV! |
|