Doel: In dit artikel leggen we uit wat adresvalidatie is, waarom het belangrijk is, en op welke verschillende manieren je de adressen van je klanten in Sendcloud kunt controleren: rechtstreeks in het panel, via de Shipments API’s, of via plugins van derden.
Wat is adresvalidatie?
Adresvalidatie controleert of een verzendadres bestaat in officiële adresdatabases. Dit helpt ervoor te zorgen dat pakketten correct worden bezorgd en vermindert mislukte leveringen, retourzendingen en toeslagen van vervoerders.
Wanneer wordt een adres gecontroleerd?
In Sendcloud wordt adresvalidatie automatisch uitgevoerd wanneer een adres wordt geladen of aangemaakt. Dit kan op drie plekken in het panel gebeuren:
- Inkomende orders: bekijk in één oogopslag de validatiestatus van elke order in de nieuwe kolom Adrescontrole.
- Pack & Go (binnenkort beschikbaar): validatiefeedback in Pack & Go is binnenkort beschikbaar.
- Nieuw verzendformulier: bekijk validatiefeedback terwijl je handmatig een zending aanmaakt.
De validatie wordt op de achtergrond uitgevoerd en blokkeert je workflow niet. Je kunt nog steeds een label aanmaken, zelfs als een adres als ongeldig is gemarkeerd. Gebruik het validatieresultaat dus als richtlijn, niet als harde beperking.
Wat gebeurt er wanneer een adres wordt gevalideerd?
Elk adres krijgt één van meerdere statussen, afhankelijk van het resultaat. Je ziet deze statussen in de weergave Inkomende orders en in de ordereditor. In de onderstaande secties wordt uitgelegd wat elke status betekent en wat je ermee moet doen.
De kolom Adrescontrole in Inkomende orders
In de weergave Inkomende orders vind je een nieuwe kolom Adrescontrole die in één oogopslag de validatiestatus van elke order toont.
Hieronder staan alle statussen die een adres kan hebben. Klik op een status om de betekenis te bekijken.
Het adres wordt gevalideerd. Dit duurt meestal maar een moment.
Een ongeldig adres oplossen
Wanneer een order als Ongeldig is gemarkeerd, klik je op Oplossen in de kolom Adrescontrole om de modal Adrescontrole te openen. Daarin zie je twee kaarten naast elkaar:
- Origineel: het adres dat je hebt ingevoerd, waarbij de velden die onjuist lijken zijn gemarkeerd met een waarschuwingsicoon.
- Aanbevolen: het gecorrigeerde adres, gebaseerd op officiële postgegevens, waarbij de gecorrigeerde velden groen zijn gemarkeerd.
Als de eerste aanbeveling niet klopt, kun je een andere kiezen uit de vervolgkeuzelijst Gevonden adressen bovenaan de modal.
Om af te ronden:
- Klik op " Toepassen Aanbevolen" om de order bij te werken met het voorgestelde adres.
- Klik op "Origineel houden" als je het adres liever wilt laten staan zoals het is ingevoerd.
Adrescontrole in de ordereditor
Wanneer je een order opent om deze te bewerken, wordt de validatiestatus ook direct boven de adresvelden in de sectie Klant weergegeven. Het bericht dat je ziet, hangt af van het validatieresultaat en van de vraag of je het adres hebt gewijzigd sinds de order werd geladen. Bekijk de onderstaande voorbeelden om elke situatie te zien.
Andere manieren om adressen te valideren
Naast de functie in het panel kun je adressen ook eerder in je workflow valideren, namelijk op het moment dat een klant zijn adres invoert in je webshop. Dit gebeurt met tools van derden die onafhankelijk van Sendcloud zijn en draaien op je webshopplatform.
Het gebruik van een van deze tools naast de validatie in het Sendcloud-panel geeft je een “dubbele controle”: één tijdens checkout (om typefouten direct te voorkomen) en één voordat het label wordt aangemaakt (om alles op te vangen wat toch is doorgelaten).
| Waar het draait | Wanneer het valideert | Wie het levert |
|---|---|---|
| Sendcloud-panel (validatie in het panel) | Voordat een label wordt aangemaakt | Sendcloud |
| Sendcloud Shipments API | Wanneer je de API aanroept om een zending aan te maken | Sendcloud |
| Sendcloud Address Validation API | Wanneer je code deze aanroept (zelfde gedrag als API’s van derden) | Sendcloud |
| Webshopplugin | Tijdens checkout, terwijl de klant typt | Derde partij (bijv. Postcode.nl, ELEX) |
| API van derden | Wanneer je code deze aanroept | Derde partij (bijv. SmartyStreets, Postcode.nl) |
Waarom adressen valideren?
- Minder mislukte leveringen. Een typefout ontdekken voordat het label wordt aangemaakt betekent dat het pakket daadwerkelijk bij je klant aankomt, zonder retourzending, herverzending of toeslagen van de vervoerder.
- Lagere verzendkosten. Veel vervoerders rekenen toeslagen voor onjuiste adressen. Vooraf valideren verlaagt deze kosten.
- Hogere klanttevredenheid. Klanten ontvangen hun pakketten op tijd, op het juiste adres, zonder extra e-mails of vertragingen.
- Snellere checkout (met checkoutplugins). Veel plugins bieden automatische aanvulling van postcode + huisnummer, zodat klanten niet de volledige straatnaam en stad hoeven in te typen. (Opmerking: automatisch aanvullen maakt geen deel uit van Sendclouds validatie in het panel of de Shipments API.)
Opties van derden
Als je adressen wilt valideren tijdens checkout, of een andere validatiedatabase naast die van Sendcloud wilt gebruiken, zijn er twee soorten tools van derden om te overwegen: plugins (geïnstalleerd op je webshop) en API’s (aangeroepen vanuit je eigen code).
We kunnen geen specifieke tool aanbevelen, omdat de beste optie afhangt van je shopsysteem, de landen waarnaar je verzendt en je budget. Doe daarom zelf onderzoek voordat je een keuze maakt.
Plugins voor je webshop: valideren tijdens checkout, per land
Plugins worden rechtstreeks geïnstalleerd in je webshopplatform (Shopify, WooCommerce, PrestaShop, Magento, enz.) en valideren het adres terwijl je klant het tijdens checkout invoert. Adresvalidatiesoftware is vaak landspecifiek, dus kies er een die de landen dekt waarvandaan en waarnaar je verzendt.
| Land | Beschikbare plugins/applicaties |
|---|---|
| Oostenrijk | Postcode Check Implementation |
| België | Postcode Check Implementation |
| Frankrijk | Egon |
| Duitsland | Postcode Check Implementation |
| Luxemburg | Postcode Check Implementation |
| Nederland | |
| Spanje | ELEX Address Validation & Google Address Autocomplete Plugin for WooCommerce |
| Zwitserland | Postcode Check Implementation |
API’s van derden: valideren vanuit je eigen code
Deze API’s werken op dezelfde manier als de validatie van Sendcloud: je code stuurt een adres, de API controleert het aan de hand van een officiële adresdatabase en geeft een validatiestatus terug. Het verschil zit in de database die elke API gebruikt; verschillende aanbieders dekken verschillende landen met verschillende nauwkeurigheidsniveaus.
- SmartyStreets API: internationale adresvalidatie voor meer dan 40 landen en gebieden.
- Postcode.nl API: valideer en corrigeer adressen tijdens invoer of achteraf. Dekt Nederland, België, Duitsland, Luxemburg, Oostenrijk en Zwitserland.
Adressen valideren via de Sendcloud API
Als je zendingen aanmaakt via de Sendcloud Shipments API in plaats van via het panel, kun je dezelfde validatie-engine inschakelen die wordt gebruikt door de functie in het panel. De validatielogica, landendekking en beperkingen zijn identiek; alleen de manier waarop je ermee werkt verschilt.
Om validatie in te schakelen, neem je de volgende parameter op in je zendingsverzoek:
"validation_methods": ["here"]
Als het adres niet in onze database kan worden gevonden, geeft de API een foutmelding terug: "Address doesn't exist". Als er een aanbevolen adres wordt gevonden, wordt dat gebruikt in plaats van het oorspronkelijke adres dat in het verzoek is gedeeld. Bekijk voor alle details de Shipments API-documentatie.
De Address Validation API gebruiken
Wanneer je de Address Validation API gebruikt met "validation_methods": ["here"], komt het gedrag overeen met wat je in het panel ziet. De API-response geeft een lijst met overeenkomende adressen terug, waarbij één adres is gemarkeerd als "recommended": true. Dit geeft aan dat dit het adres is waarvan we het meest zeker zijn dat het bezorgd kan worden.
Als alle teruggegeven adressen "recommended": false hebben, betekent dit dat er geen adres met voldoende zekerheid kon worden geïdentificeerd voor een succesvolle bezorging.
De Address Validation API kan ook worden gebruikt om adressen alleen te valideren aan de hand van vervoerderslimieten. Laat hiervoor simpelweg de parameter "validation_methods": ["here"] weg uit je verzoek.
In dat geval kan een adres nog steeds worden gemarkeerd als "recommended": true als het voldoet aan de beperkingen van de vervoerder, zelfs als het niet is bevestigd als een echt bestaand, bezorgbaar adres.
Wanneer "validation_methods": ["here"] is opgenomen, worden zowel validatie van echte adressen als controles op vervoerderslimieten toegepast.
Voorbeeld: een verzoek dat niet door de validatie komt
Het onderstaande voorbeeld zal mislukken met de melding "Address doesn't exist", omdat de postcode 5611CR bij Eindhoven hoort, niet bij Amsterdam.
{
"label_details": {
"mime_type": "application/pdf",
"dpi": 72
},
"validation_methods": ["here"],
"to_address": {
"name": "John Doe",
"company_name": "Sendcloud",
"address_line_1": "Whitehall",
"house_number": "54",
"postal_code": "5611CR",
"city": "Amsterdam",
"country_code": "NL",
"phone_number": "+393895422999",
"email": "john.doe@sendcloud.com"
},
"from_address": {
"name": "Marie Doe",
"company_name": "Sendcloud",
"address_line_1": "Stadhuisplein 10",
"address_line_2": "2e verdieping",
"house_number": "10",
"postal_code": "5611 EM",
"city": "Eindhoven",
"country_code": "NL",
"phone_number": "+31612345678",
"email": "marie.doe@sendcloud.com",
"po_box": "PO Box 478"
},
"ship_with": {
"type": "shipping_option_code",
"properties": {
"shipping_option_code": "postnl:standard",
"contract_id": 517
}
},
"order_number": "1234567890",
"total_order_price": {
"currency": "EUR",
"value": "11.11"
},
"parcels": [
{
"dimensions": {
"length": "5.00",
"width": "15.00",
"height": "20.00",
"unit": "cm"
},
"additional_insured_price": {
"value": "50",
"currency": "EUR"
},
"weight": {
"value": "1.320",
"unit": "kg"
},
"parcel_items": [
{
"item_id": "5552",
"description": "T-Shirt XL",
"quantity": 1,
"weight": {
"value": 0.3,
"unit": "kg"
},
"price": {
"value": 12.65,
"currency": "EUR"
},
"hs_code": "620520",
"origin_country": "NL",
"sku": "TS1234",
"product_id": "19284",
"mid_code": "NLOZR92MEL",
"material_content": "100% Cotton",
"intended_use": "Personal use",
"properties": {
"size": "XL",
"color": "green"
}
},
{
"item_id": "98712",
"description": "Sneakers 42",
"quantity": 1,
"weight": {
"value": 1.02,
"unit": "kg"
},
"price": {
"value": 12.65,
"currency": "EUR"
},
"hs_code": "620520",
"origin_country": "US",
"sku": "TS1234",
"product_id": "19284",
"mid_code": "US1234567",
"material_content": "100% Cotton",
"intended_use": "Personal use",
"properties": {
"size": 42,
"color": "black"
}
}
]
}
]
}