Altijd het juiste adres

Veelgestelde vragen over de API

Plugins

Welke plugins zijn er beschikbaar?

Een lijst van plugins voor Shopware, Magento, WooCommerce en meer vindt je op de API-implementatiepagina.

Waarom moet ik extra betalen voor sommige plugins?

Gratis plugins worden geleverd "as is" zonder ondersteuning. Aangezien er veel verschillende plugins zijn voor verschillende platforms, kan het een uitdaging zijn om alles samen te laten werken. De broncode van sommige gratis plugins is daarom vrij toegankelijk om de partners die zich bezighouden met de implementatie zoveel mogelijk te helpen de site te ontwikkelen zoals zij dat willen.

De betaalde versies worden door derde partijen aangeboden die support op hun plugins leveren. Je hebt dan bij twee verschillende partijen een overeenkomst. Bij Postcode.nl voor de API en bij de derde partij voor de plugin. Deze overeenkomsten staan los van elkaar.

Staat je plugin niet in de lijst?

Geen nood, de API kan ook ingebouwd worden met behulp van de technische documentatie.

Test-API

Hoe kan ik de API testen?

Wanneer je een account aanmaakt, is dit altijd de eerste testtoegang, je sluit dus nog geen abonnement af. Je hebt zes maanden de tijd om de API te testen, en het aantal validaties dat je in de testtoegang kunt uitvoeren is gelimiteerd.

Na de test is het noodzakelijk dat je ons laat weten dat je klaar bent en het abonnement kan beginnen. Je kiest dan het abonnement dat je wilt afsluiten.

Meer validaties dan bestellingen

Waarom zie ik meer validaties dan bestellingen in mijn API account?

In de praktijk komt het aantal adresaanvragen nooit precies overeen met het aantal bestellingen in een webwinkel. Daar kunnen verschillende redenen voor zijn, zoals welke plugin wordt gebruikt of in je eigen implementatie.

De meest voorkomende redenen zijn:

• Dezelfde adressen worden vaak meerdere malen opgevraagd, bijvoorbeeld omdat een gebruiker hetzelfde adres meerdere malen invoert of omdat de software van de webwinkel het adres op meerdere plaatsen controleert. Één enkele opdracht kan dus leiden tot vele opvragingen. Door een gevalideerd adres tijdelijk (bijvoorbeeld tot een week) op te slaan, voorkom je dat hetzelfde adres onnodig door onze dienst wordt opgevraagd.
• Opvragingen met onjuiste postcodes of huisnummers: Deze verzoeken zullen nooit een adres opleveren. Controleer voordat je een zoekopdracht start of de postcode volledig en in het juiste formaat is en of het huisnummer met cijfers begint. Zorg er ook voor dat een adres pas kan worden geverifieerd als de gebruiker klaar is met typen.

Overschrijding van de validatielimiet

Wat gebeurt er als ik mijn huidige Tier overschrijd?

Allereerst, geen zorgen, de API wordt niet uitgeschakeld als je over je limiet heen gaat. Wij vinden het belangrijk dat de API blijft werken, zodat je klanten kunnen blijven bestellen en je processen niet worden onderbroken.

Om je op de hoogte te houden van je gebruik, worden meldingen per e-mail verstuurd. Dit gebeurt bij 50%, 80% en 100% van je limiet.

Bij 100% wordt het abonnement automatisch opgewaardeerd naar een correct en overeenkomstig niveau. Het systeem onderzoekt het aantal validaties in de vorige periode tijdens de huidige abonnementsperiode en maakt een prognose van het aantal verwachte aanvragen voor de rest van de abonnementsperiode.

Om een correcte inschatting van de prognose te maken, zal de upgrade niet plaatsvinden in de eerste maand van je abonnementsperiode.

Ga je Tier 5 overschrijden?

Op basis van de prognose wordt het verwachte verbruik gefactureerd in blokken van 10% van Tier 5 (d.w.z. 100 euro per Tier) en gelden ook de eenheidsprijzen per validatie van deze Tier.

Mijn API account en mijn abonnement

Hoe beheer ik mijn API account en mijn abonnement?

Credentials aanvragen

Wanneer je inlogt in de beheeromgeving met je beheerdersaccount, vind je in het menu een item "Credentials".

Als je erop klikt, zie je de Key. De Secret was alleen per e-mail verzonden en kan niet worden opgevraagd. Op diezelfde pagina vind je rechtsboven een knop om een nieuwe Key en Secret aan te maken. Deze worden dan automatisch per e-mail verzonden.

Factuur- en/of rekeninggegevens aanpassen

Helaas is het nog niet mogelijk om dit via de beheeromgeving te doen. Neem voor eventuele wijzigingen direct per e-mail contact met ons op.

Hervatting van het contract

Voor het hervatten en activeren van een oud contract kun je ook per e-mail contact met ons opnemen.

Opzegging van het abonnement

API annuleringen kunnen worden gedaan door in te loggen in de beheeromgeving, wat moet worden gedaan door de accountbeheerder.

In het menu "Beheer" is er een rubriek "Abonnement". Hier kan het abonnement bij de eerstvolgende gelegenheid worden opgezegd.

Address Autocomplete API vs. Nederlandse Postcode API

Wat is het verschil tussen de Address Autocomplete API en de Nederlandse Postcode API?

Met de Address Autocomplete API kunt je adressen opvragen voor alle beschikbare landen. Deze API is qua functionaliteit uitgebreider dan de Nederlandse Postcode API. Je kunt bijvoorbeeld niet alleen adressen aanvullen op basis van een postcode en een huisnummer, maar je kunt ze ook aanvullen met de automatische "autocomplete" functie. Handig als er adressen worden ingevoerd waarvan de postcode niet bekend is. De Nederlandse Postcode API werkt uitsluitend op basis van een postcode en een huisnummer om een volledig adres te verkrijgen.

Kan ik slechts één API gebruiken?

Uiteraard kun je de API's naast elkaar gebruiken. Zo kun je bijvoorbeeld voor al je klanten adressen opvragen via de Address Autocomplete API, en specifiek voor Nederlandse klanten de Nederlandse Postcode API. Sommige plugins doen dit automatisch, ze kiezen de juiste API wanneer een adresaanvraag wordt gedaan.

Waarom is de Address Autocomplete API duurder dan de Nederlandse Postcode API?

Adressen opgehaald via de Address Autocomplete API hebben een hogere eenheidsprijs, omdat deze API meer mogelijkheden biedt. Dit tarief geldt ook wanneer een Nederlandse postcode en huisnummer worden opgehaald via de Address Autocomplete API.