Wat is de PostNL API?
Kort antwoord: geen enkele API, maar een verzameling. PostNL biedt afzonderlijke interfaces voor labels genereren, zendingen volgen, retouren aanmelden, adressen valideren en bezorgopties opvragen, en je gebruikt er in de praktijk zelden alle vijf van. Elke interface heeft eigen velden en eigen gedrag, en dat is de reden dat een PostNL-koppeling meer werk is dan de documentatie suggereert: je bouwt niet een koppeling, je bouwt een samenspel.
Waarvoor organisaties PostNL gebruiken.
Bijna elke Nederlandse organisatie die iets fysiek verstuurt doet dat via PostNL, van webshops en B2B-distributie tot organisaties die documenten, monsters of onderdelen versturen als onderdeel van hun dienstverlening. De volumes verschillen enorm en dat bepaalt de vraag: bij tien zendingen per dag is handmatig een label maken irritant, bij vijfhonderd is het een fulltimebaan.
Wat je met PostNL kunt.
Via de API maak je labels aan in het juiste formaat, koppel je een barcode aan een order, vraag je de actuele zendingstatus op en meld je een retourzending aan, terwijl adresvalidatie bezorgfouten voorkomt voordat het pakket de deur uit is. Wat PostNL niet doet, is weten waar jouw order vandaan komt: de API krijgt een adres, een gewicht en een producttype en levert een label. Alles daarvoor en daarna is jouw proces, en daar zit dan ook de winst: niet in het label zelf, maar in het wegnemen van de stappen eromheen.
Wat een PostNL-koppeling oplevert.
Met een PostNL-koppeling verdwijnt het overtypen tussen je orderoverzicht en het verzendportaal. Labels worden rechtstreeks uit je ERP of maatwerk webshop gegenereerd, in bulk en met het juiste producttype per order, en wie pakbon en label in een handeling print verdient dat werk in weken terug. Track-and-trace komt in je eigen omgeving te staan, bijvoorbeeld in een dealerportaal of klantportaal, in plaats van in een mail met een link naar een externe site. En retourlabels kan de ontvanger zelf aanvragen in jouw omgeving, zonder tussenkomst van de servicedesk.
Welke data tussen PostNL en je systemen stroomt.
Richting PostNL gaan adresgegevens, gewichten, afmetingen, producttype en referentienummers. Terug komen barcodes, labelbestanden, statusupdates en bezorgmomenten. De statuskant is daarbij doorlopend in plaats van eenmalig: een koppeling die alleen bij verzending praat weet niets van een zending die vastloopt. Wil je de ontvanger voor zijn voordat hij gaat bellen, dan haal je statussen periodiek op en koppel je ze terug aan de order.
PostNL-integratie in de praktijk: hoe Cube koppelt.
Cube bouwde een PostNL-integratie als onderdeel van een verzendproces waarin labels en zendingstatus rechtstreeks uit het orderproces komen. Het ontwerp begint daarbij altijd bij de uitzonderingen, want die bepalen of een koppeling houdbaar is: orders die tot een zending worden samengevoegd, zendingen vanuit meerdere locaties, en producttypen die per order verschillen. Wie alleen de standaardsituatie bouwt, komt die uitzonderingen alsnog tegen, maar dan in productie.
Standaardconnector of maatwerkkoppeling.
Hier is het eerlijke antwoord het duidelijkst van allemaal: voor een standaard webshop bestaat er een plug-in, en die is beter dan wat wij voor dat geld bouwen. WooCommerce, Shopware, Magento en de rest hebben allemaal een PostNL-koppeling die werkt. Bouw pas maatwerk als je verzendproces afwijkt van wat die plug-ins aannemen, bijvoorbeeld wanneer labels uit je ERP moeten komen in plaats van uit de webshop, je vanuit meerdere locaties verstuurt, je orders combineert tot een zending, of je een eigen platform hebt waarvoor geen plug-in bestaat. Sta je in de eerste categorie, dan zeggen we dat en ben je snel klaar bij ons.
Een PostNL-koppeling laten bouwen.
We beginnen bij het verzendproces zoals het nu gaat, inclusief de uitzonderingen die niemand opschrijft. Daaruit volgt welke PostNL-interfaces je nodig hebt en waar in je landschap de koppeling hoort te zitten. Bekijk ook onze aanpak voor API-koppelingen.
Kort samengevat.
De PostNL API bestaat uit meerdere interfaces voor labels, tracking, retouren, adresvalidatie en bezorgopties. Een koppeling levert winst op in de stappen rond het label, niet in het label zelf. Voor standaard webshops is een plug-in de betere keuze; maatwerk pas bij labels uit ERP, meerdere verzendlocaties, gecombineerde zendingen of een eigen platform.
Verzendproces automatiseren zonder losse handelingen?
Labels en track-and-trace uit je eigen systemen halen? Neem contact op, dan kijken we eerst naar je verzendproces en pas daarna naar de techniek.