Adressvalidierung

Häufig gestellte Fragen zur API

Plugins

Welche Plugins sind verfügbar?

Eine Liste von Plugins für Shopware, Magento, WooCommerce und andere finden Sie auf der API-Implementierungsseite.

Warum muss ich für einige Plugins extra bezahlen?

Kostenlose Plugins werden "wie besehen" ohne Support bereitgestellt. Da es viele verschiedene Plugins für verschiedene Plattformen gibt kann die Der Quellcode einiger kostenloser Plugins ist daher frei zugänglich, um den Partnern, die sich der Implementierung widmen, so weit wie möglich zu helfen, die Website nach ihren Wünschen zu entwickeln.

Kostenpflichtige Versionen werden von Drittanbietern angeboten, die Support für ihre Plugins anbieten. Es wird dann ein Vertrag zwischen zwei verschiedenen Parteien geschlossen. Bei Postcode.nl für die API und bei einer dritten Partei für das Plugin. Diese Verträge sind unabhängig voneinander.

Ist Ihr Plugin nicht aufgeführt?

Kein Sorge, die API kann auch mithilfe der technischen Dokumentation integriert werden.

API testen

Wie kann ich die API testen?

Wenn Sie ein Konto anlegen, ist dies immer der erste Testzugang, Sie gehen also noch kein Abonnement ein. Sie haben sechs Monate Zeit, die API zu testen, und die Anzahl der Validierungen, die Sie im Testzugang durchführen können, ist begrenzt.

Nach dem Test ist es notwendig, dass Sie uns mitteilen, dass Sie fertig sind und das Abonnement beginnen kann. Sie wählen dann das Abonnement, das Sie abschließen möchten.

Mehr Validierungen als Webshop Bestellungen

Warum sehe ich in meinem API-Konto mehr Treffer als Bestellungen?

In der Praxis kann es vorkommen, dass die Anzahl der Adressanfragen nicht genau der Anzahl der Bestellungen in einem Webshop entspricht. Dies kann verschiedene Gründe haben, abhängig vom verwendeten Plugin oder der eigenen Implementierung.

Die häufigsten Gründe sind:

• Dieselben Adressen werden oft mehrfach abgefragt, z. B. weil ein Nutzer dieselbe Adresse mehrfach eingibt oder weil die Software des Online-Shops die Adresse an mehreren Stellen überprüft. Daher kann ein einziger Befehl zu vielen Abfragen führen. Durch die Zwischenspeicherung einer geprüften Adresse (z. B. bis zu einer Woche) verhindern Sie, dass dieselbe Adresse unnötigerweise von unserem Dienst abgefragt wird.
• Anfragen mit falschen Postleitzahlen oder Hausnummern: Diese Anfragen führen nie zu einer Adresse. Vergewissern Sie sich, bevor Sie eine Abfrage starten, dass die Postleitzahl vollständig und im richtigen Format ist und dass die Hausnummer mit Ziffern beginnt. Achten Sie auch darauf, dass eine Adresse erst überprüft werden kann, wenn der Benutzer die Eingabe beendet hat.

Überschreiten des Limits von Validierenden

Was passiert, wenn ich mein aktuelles Tier-Limit überschreite?

Machen Sie sich zunächst keine Sorgen, die API wird nicht deaktiviert, wenn Sie Ihr Limit überschreiten. Uns ist es wichtig, dass die API immer funktioniert, damit Ihre Kunden weiterhin bestellen können und Sie nicht in Ihren Prozessen unterbrochen werden.

Benachrichtigungen zum Stand Ihres Abonnements werden per E-Mail gesendet, um Sie über Ihre Nutzung auf dem Laufenden zu halten. Dies geschieht bei 50%, 80% und 100% Ihres Limits.

Bei 100% wird das Abonnement automatisch auf eine korrekte und übereinstimmende Stufe aktualisiert. Das System betrachtet den Verbrauch in der vergangenen Periode in der aktuellen Abonnementperiode und es wird eine Prognose über die erwartete Anzahl von Abfragen für den Rest der Abonnementperiode erstellt.

Um eine gute Schätzung für die Prognose zu erhalten, wird das Upgrade der Stufe nicht im ersten Monat Ihres Abonnementzeitraums durchgeführt.

Werden Sie Stufe 5 überschreiten?

Auf der Grundlage der Prognose wird der erwartete Verbrauch in Blöcken von 10 % der Stufe 5 (d. h. 100 Euro pro Stufe) abgerechnet, und es gelten auch die Einheitspreise pro Validierung dieser Stufe.

Mein API-Konto und Abonnement

Wie verwalte ich mein API-Konto und das zugehörige Abonnement?

Request for credentials

Wenn Sie sich mit Ihrem Administratorkonto in der Verwaltungsumgebung anmelden, wird im Menü links Folgendes angezeigt: Anmeldeinformationen.

Wenn Sie darauf klicken, sehen Sie den Schlüssel. Das Geheimnis wurde zu diesem Zeitpunkt nur per E-Mail gesendet und kann nicht angefordert werden. Auf derselben Seite befindet sich oben rechts eine Schaltfläche zum Erstellen eines neuen Schlüssels und Geheimnisses. Diese werden dann automatisch per E-Mail verschickt.

Rechnungs- und / oder Kontoinformationen ändern

Leider ist dies noch nicht über die Verwaltungsumgebung möglich. Bitte kontaktieren Sie uns direkt per E-Mail, um Änderungen vorzunehmen.

Wiederaufnahme des Vertragsverhältnisses

Für die Wiederaufnahme und Aktivierung eines alten Vertrages, kontaktieren Sie uns bitte ebenfalls per E-Mail.

Abonnement kündigen

Stornierungen für die API können durch Anmelden in der Verwaltungsumgebung erfolgen. Dies muss vom Administrator des Kontos erfolgen.

Im Menü "Manage" gibt es einen Abschnitt "Subscription". Hier ist es möglich, das Abonnement bei nächster Gelegenheit zu kündigen.

Address Autocomplete API vs. Niederländische Postcode API

Was ist der Unterschied zwischen Address Autocomplete API und Dutch Postcode API?

Mit der Adress-Autocomplete-API können Sie Adressen für alle verfügbaren Länder abrufen. Diese API ist in Bezug auf die Funktionalität umfangreicher als die niederländische Postleitzahl-API. Beispielsweise können Sie niederländische Adressen nicht nur anhand einer Postleitzahl und einer Hausnummer vervollständigen, sondern auch mit der vollständigen Funktionalität des Fahrzeugs. Nützlich, wenn Adressen eingegeben werden, für die die Postleitzahl nicht bekannt ist. Die niederländische Postleitzahl-API funktioniert nur mit einer Postleitzahl und einer Hausnummer, um eine vollständige Adresse zurückzugewinnen.

Kann ich nur ein API verwenden?

Sie können die APIs natürlich nebeneinander verwenden. Zum Beispiel können Adressen für alle Ihre Kunden über die Address Autocomplete API und speziell für niederländische Kunden über die Niederländische Postleitzahl API abgerufen werden. Bei einigen Plugins erfolgt dies bereits automatisch, wodurch die richtige API für die Anforderung einer Adresse ausgewählt wird.

Warum ist die Address Autocomplete API teurer als die Niederländische Postleitzahl API?

Adressen, die über die Address Autocomplete API abgerufen werden, haben einen höheren Stückpreis, da diese API mehr Funktionen bietet. Dieser Preis gilt auch, wenn eine niederländische Postleitzahl und eine Hausnummer über die Address Autocomplete API abgerufen werden.