Online-Schnittstelle (Adressen) zu KONTOPRUEF

Mit dem folgenden Web-Interface können Sie die Adreßprüfung online in eigene Systeme integrieren. Als Schnittstelle wird WDDX oder WebServices/SOAP verwendet. Der Aufruf per WDDX erfolgt direkt über eine URL mittels GET im einem der folgenden Formate.

Derzeit mögliche Prüfungen:

Alle Prüfungen, bei denen ein Ort mit übergeben wird, können einen optionalen Parameter "rewrite" verwenden. Der Unterschied ist wie folgt:

• rewrite=0 (oder weggelassen):
  Die Ortsprüfung erfolgt mit genauer Schreibweise (also mit Umlauten und Groß- und Kleinschreibung), d.h. z.B. eine Anfrage nach "90425" in Verbindung mit "nuernberg" würde zurückliefern, daß es zur Postleitzahl 90425 nur "andere" Orte gibt (nämlich "Nürnberg").
• rewrite=1:
  Die Ortsprüfung erfolgt mit ungenauer Schreibweise, so daß z.B. die Postleitzahl "90425" für "Nürnberg", "nürnberg", "Nuernberg", "nuernberg" oder sogar "nuern-berg" gilt. In diesem Fall können Sie nach der Abfrage dem Feld "rewritten" die postalisch korrekte Schreibweise entnehmen.
• rewrite=2 (empfohlen):
  Wie 1, aber zusätzlich wird nun auch der "lange" Ortsname (ebenfalls in "unschöner" Schreibweise) akzeptiert (also z.B. "ROTHEN/burg,ob'der'TauBER"); das Feld "Rewritten" liefert stets den "kurzen" Ortsnamen zurück ("Rothenburg"), egal, ob der Kunde den kurzen oder langen Namen eingegeben hat.
• rewrite=3
  Wie 2, es wird aber immer der "lange" Ortsname im Feld "Rewritten" zurückgegeben ("Rothenburg ob der Tauber"), egal, ob der Kunde den kurzen oder langen Namen eingegeben hat.

Wer also die Möglichkeit Rewrite=2 oder Rewrite=3 nutzt, hat in jedem Fall die Gewißheit, daß "kurze" und "lange" Ortsnamen gleichermaßen akzeptiert werden. Mit der Unterscheidung 2 oder 3 kann man sich dann noch aussuchen, ob man z.B. seine Kundendatenbank einheitlich mit den "kurzen" oder "langen" Namen aufbauen will. Für die Post-Beförderung genügt der kurze Name!

Prüfung von Postleitzahl und Ort

http(s)://wddx.hanft.de/address?un={Ihr Benutzername}&pw={Ihr Kennwort}&func=check&plz={Postleitzahl}&ort={Ortsname}

(Bitte die Parameter jeweils ohne geschweifte Klammern angeben! Eine gültige URL könnte z.B. wie folgt aussehen:
http://wddx.hanft.de/address?un=demo&pw=demo&func=check&plz=99999&ort=Demostadt (unverschlüsselt)
https://wddx.hanft.de/address?un=demo&pw=demo&func=check&plz=99999&ort=Demostadt (verschlüsselt)
Falls Sie auf diesen Link 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.)

Prüfung von Postleitzahl, Ort und Straße

Funktioniert wie oben, nur daß noch ein Feld "str" mit übergeben wird:

http(s)://wddx.hanft.de/address?un={Ihr Benutzername}&pw={Ihr Kennwort}&func=check&plz={Postleitzahl}&ort={Ortsname}&str={Straßenname}

(Bitte die Parameter jeweils ohne geschweifte Klammern angeben! Eine gültige URL könnte z.B. wie folgt aussehen:
http://wddx.hanft.de/address?un=demo&pw=demo&func=check&plz=99999&ort=Demostadt&str=Marienstraße (unverschlüsselt)
https://wddx.hanft.de/address?un=demo&pw=demo&func=check&plz=99999&ort=Demostadt&str=Marienstraße (verschlüsselt)
Falls Sie auf diesen Link 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.)

Prüfung von Postleitzahl, Ort, Straße und Hausnummer

Funktioniert wie oben, nur daß noch ein Feld "hnr" mit übergeben wird (nur in Verbindung mit dem Feld "str"; evtl. Zusätze zur Hausnummer wie "a" oder "1/2" lassen Sie bitte weg, da momentan nur der numerische Teil geprüft werden kann):

http(s)://wddx.hanft.de/address?un={Ihr Benutzername}&pw={Ihr Kennwort}&func=check&plz={Postleitzahl}&ort={Ortsname}&str={Straßenname}&hnr={Hausnummer}

(Bitte die Parameter jeweils ohne geschweifte Klammern angeben! Eine gültige URL könnte z.B. wie folgt aussehen:
http://wddx.hanft.de/address?un=demo&pw=demo&func=check&plz=99999&ort=Demostadt&str=Marienstraße&hnr=1 (unverschlüsselt)
https://wddx.hanft.de/address?un=demo&pw=demo&func=check&plz=99999&ort=Demostadt&str=Marienstraße&hnr=1 (verschlüsselt)
Falls Sie auf diesen Link 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.)

Prüfung von Postleitzahl, Ort und Postfach

Funktioniert wie oben, nur daß noch ein Feld "pof" mit übergeben wird:

http(s)://wddx.hanft.de/address?un={Ihr Benutzername}&pw={Ihr Kennwort}&func=check&plz={Postleitzahl}&ort={Ortsname}&pof={Postfachnummer}

(Bitte die Parameter jeweils ohne geschweifte Klammern angeben! Eine gültige URL könnte z.B. wie folgt aussehen:
http://wddx.hanft.de/address?un=demo&pw=demo&func=check&plz=99999&ort=Demostadt&pof=120344 (unverschlüsselt)
https://wddx.hanft.de/address?un=demo&pw=demo&func=check&plz=99999&ort=Demostadt&pof=120344 (verschlüsselt)
Falls Sie auf diesen Link 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.)

Herausfinden des Typs einer Postleitzahl

http(s)://wddx.hanft.de/address?un={Ihr Benutzername}&pw={Ihr Kennwort}&func=type&plz={Postleitzahl}

(Bitte die Parameter jeweils ohne geschweifte Klammern angeben! Eine gültige URL könnte z.B. wie folgt aussehen:
http://wddx.hanft.de/address?un=demo&pw=demo&func=type&plz=99999 (unverschlüsselt)
https://wddx.hanft.de/address?un=demo&pw=demo&func=type&plz=99999 (verschlüsselt)
Falls Sie auf diesen Link 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.)

Weitere Prüfungen

Brauchen Sie weitere Prüfungen oder Auskünfte? Wollen Sie wissen, in welchem Monat ein bestimmter Ortsteil eingemeindet wurde? Brauchen Sie die Anschrift einer bestimmten Postfachanlage? Möchten Sie zu einer bestimmten Postleitzahl und/oder Straße den Ortsteil wissen? Wir können Ihnen helfen! Sprechen Sie mit uns, und wir werden die gewünschten Funktionen - soweit technisch möglich - gerne für Sie einbauen.

Ergebnisse

Die obigen URLs liefern als Ergebnis folgende Variablen in WDDX gepackt zurück:

Alternativ zur WDDX-Schnittstelle wird die Adreßprüfung auch als WebService (SOAP) angeboten.

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 myAddress as Variant
Set myAddress = CreateObject("HanftWddx.Address")
myAddress.SetProxy("mein.proxy.de", 3128) ' nur falls benötigt
myAddress.SSLMode = 1 ' nur falls gewünscht
myAddress.Check("Ihr Benutzername","Ihr Passwort","Postleitzahl","Ortsname")
ErgebnisAlsZahl = myAddress.Result
ErgebnisAlsText = myAddress.Resulttext
if ErgebnisAlsZahl = 4 then ' Ortsliste übernehmen (Anzahl in .Orte[0])
  i = 1
  while myAddress.Orte[i] <> "" ' noch ein Ort
    ErgebnisOrte[i] = myAddress.Orte[i]
    i = i + 1 
  wend
endif

Informationen 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. Durch die Mengenstaffel wird der durchschnittliche Preis immer günstiger, je öfter Sie diesen Service in Anspruch nehmen. Vermeiden Sie also unnötigen Ärger mit falschen und/oder Phantasieadressen, veralteten Postleitzahlen, falschen Orts-Schreibweisen usw. usf. 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: