Adresvalidatie in Sendcloud

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.

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.

Adres geverifieerd Het adres is succesvol gevalideerd. Geen actie nodig. 

❮❯

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).

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.

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.

{
    "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"
                    }
                }
            ]
        }
    ]
}