PostNL API koppelen aan je website.

De PostNL API is de verzameling koppelingen waarmee software van een webshop of magazijn rechtstreeks met PostNL praat. Het gaat om een set losse diensten: een voor barcodes, een voor labels, een voor het voormelden van zendingen, een voor de status, en een paar voor de checkout.

PostNL richt zich daarmee op webshops met eigen software of een opensourceplatform, zoals WooCommerce. Je vraagt de sleutel aan in Mijn PostNL Zakelijk, onder API-beheer. Ben je nog geen klant, dan kun je via het Developer Portal een testsleutel aanvragen om te kijken wat er kan.

Alle API's werken met dezelfde sleutel in een header en zijn REST. Er is een sandbox op een eigen adres, met dezelfde opbouw als productie, zodat je de hele stroom kunt testen zonder echte zendingen.

Het begint met een barcode. Die vraag je aan bij de Barcode API, met je klantcode, je klantnummer en het type barcode. Elke zending krijgt er een, en die barcode is daarna de sleutel voor alles wat volgt.

Dan het label. De Labelling API krijgt de afzender, het adres van de ontvanger, de barcode, de afmetingen en de productcode, en geeft het label terug om te printen. Met de instelling confirm meld je de zending in dezelfde aanvraag voor bij PostNL; zonder die instelling volgt een aparte aanvraag bij de Confirming API.

En dan de status. De ShippingStatus API geeft de status per barcode of per eigen referentie, en ook een lijst van zendingen die in een bepaalde periode zijn bijgewerkt. PostNL adviseert die lijst elke 5 tot 15 minuten op te vragen. Wij zetten de status bij de order, zodat je klantenservice en je klantmails dezelfde informatie hebben.

De Checkout API geeft op basis van het adres van de klant de bezorgopties terug, zoals bezorgmomenten en afhaalmogelijkheden. De Locations API zoekt de PostNL-punten het dichtst bij een adres of bij coördinaten, of binnen een gebied, en kan één punt opzoeken als de klant het al heeft gekozen.

Het voordeel van een eigen koppeling is dat die keuzes in je eigen checkout staan, in je eigen opmaak, en dat de keuze van de klant meteen meegaat naar het label. Een gekozen PostNL-punt staat dan als adres op het label.

Met de Postalcode check controleer je bovendien het Nederlandse adres op postcode en huisnummer, voordat de bestelling wordt afgerond. Dat scheelt pakketten die terugkomen omdat een huisnummer net verkeerd was ingetypt.

Niet elke webshop heeft een eigen koppeling nodig. PostNL heeft zelf de plugin PostNL for WooCommerce, met meer dan 4.000 actieve installaties. Die maakt labels per order of in bulk, toont bezorgopties en afhaalpunten in de checkout en controleert Nederlandse adressen. Ook voor Shopify, Magento, Lightspeed en CCV zijn er plugins. Voor veel webshops is dat genoeg, en dan raden we dat ook aan.

Verzend je met meerdere vervoerders, dan ligt verzendsoftware zoals Sendcloud meer voor de hand: één omgeving voor alle labels, waarin PostNL er een van is. En doet een magazijn de verzending, dan koppelt dat systeem met de vervoerder. Dat zie je bij een magazijnsysteem als Picqer of bij fulfilment door een partij als Monta; je webshop praat dan met het magazijn, niet met PostNL.

Een directe koppeling op de API is de route als je orderflow afwijkt van wat een plugin verwacht. Denk aan een maatwerkplatform, orders die uit meerdere bronnen komen, eigen regels voor welke productcode bij welke order hoort, of een checkout die niet op WooCommerce draait.

PostNL werkt aan een nieuwe generatie API's, V4. Daarin vallen onder meer Checkout V4, met Locations en tijdvakken, en Warehouse V4, met Shipment, Return, Labelling, Confirming en Barcode. Volgens PostNL gaan die de huidige API's vervangen.

Een datum noemt PostNL niet. Klanten worden op tijd en gefaseerd uitgenodigd om over te stappen. Voor een koppeling die nu gebouwd wordt, betekent dat: houd de aanroepen naar PostNL op één plek in de code, zodat de overstap een aanpassing is in plaats van een herbouw.

In een WooCommerce-webshop beginnen we bij de vraag of de plugin van PostNL je orderflow dekt. Doet hij dat, dan richten we hem in en controleren we de eerste zendingen. Doet hij dat niet, dan bouwen we een uitbreiding die barcode, label en voormelding vanuit de order regelt en de status terugzet, met de sleutel op de server.

Op een maatwerksite in Next.js of in een eigen platform is het een serverkoppeling die bij een betaalde order de zending aanmaakt, het label klaarzet voor het printen en de status op een vast ritme ophaalt. De bezorgopties komen via een eigen route in de checkout.

Koppelingen als deze bouwen we binnen Design & Development.