Overzicht
PostNL is de primaire post- en pakketvervoerder van Nederland, die het merendeel van de binnenlandse pakketleveringen en een significant aandeel van de internationale verzending vanuit Nederland afhandelt. Voor hoog-volume Nederlandse e-commerceoperaties, logistieke providers en fulfilmentbedrijven die directe contracten hebben onderhandeld met PostNL, biedt de PostNL API directe toegang tot PostNL's verzendingsinfrastructuur — labelgeneratie, track en trace, bezorgopties, afhaalpuntlocaties en tijdvensterberekeningen — zonder de intermediaire laag die platforms zoals MyParcel of SendCloud toevoegen.
Directe PostNL API-integratie is de juiste keuze voor operaties die het intermediaire platformmodel zijn ontgroeid — de hoog-volume verzender met een direct PostNL-contract die gunstige tarieven krijgt, de logistieke provider die PostNL-verzending beheert namens meerdere klanten, of de fulfilmentoperatie die diepe integratie met PostNL's systemen nodig heeft.
Wij bouwen PostNL API-integraties voor Nederlandse hoog-volume verzenders, logistieke providers, fulfilmentoperators en e-commerceplatforms die directe PostNL-contracten hebben en hun operationele systemen direct moeten verbinden met PostNL's verzend-API.
Wat PostNL Integratie Dekt
PostNL API authenticatie. De PostNL API gebruikt API-sleutelauthenticatie voor de huidige REST API-generatie.
API-sleutel: de PostNL API-sleutel uitgegeven als onderdeel van het PostNL-ontwikkelaarsaccount en contractopzet. De apikey header opgenomen in elk PostNL API-verzoek. Afzonderlijke API-sleutels voor de sandbox-omgeving en de productieomgeving.
Klantnummer en -code: naast de API-sleutel vereisen PostNL API-verzoeken voor labelgeneratie de klantcode (CustomerCode) en het klantnummer (CustomerNumber) van het PostNL-contract.
Verzendlabels genereren. De primaire PostNL API-operatie — barcodegebonden verzendlabels genereren voor pakketten.
Zendingen bevestigen: het POST /v1/shipment eindpunt (Confirming API) voor het genereren van PostNL-verzendlabels. De verzoekbody met het Customer object, het Message object en de Shipments array van zendingsobjecten.
Zendingsobject: de Addresses array met het ontvangersadres (AddressType: "01") en het afzenderadres (AddressType: "02"). Het Dimension object met het gewicht in grammen. De ProductCodeDelivery voor de PostNL-productcode.
Productcodes: PostNL-productcodes die het specifieke verzendproduct identificeren — 3085 voor standaard binnenlands pakket, 3087 voor standaard pakket met handtekening, 3089 voor standaard pakket met only-recipient bezorging, 3096 voor avondbezorging, 3385 voor brievenbuspakket.
Labelrespons: de labelgeneratierespons met de ResponseShipments array die de barcode en de Labels array bevat met de base64-gecodeerde labelafbeeldingsdata.
Barcodegeneratie: het GET /v1/barcode eindpunt voor het vooraf genereren van barcodes voor labelaanmaak.
Bezorgopties. Beschikbare PostNL-bezorgopties opvragen voor specifieke adressen en tijdvensters.
Bezorgdatum: het GET /v1/deliverydate/delivery eindpunt voor het berekenen van de vroegst mogelijke bezorgdatum voor een pakket.
Verzenddatum: het GET /v1/deliverydate/shipping eindpunt voor het berekenen van de laatste mogelijke verzenddatum om een gespecificeerde bezorgdatum te bereiken.
Tijdvensters: het GET /v1/timeframe/calculate/timeframes eindpunt voor het ophalen van beschikbare bezorgtijdvensters voor een specifiek adres.
Afhaalpunten en locaties. PostNL-afhaalpuntlocaties opvragen voor klanten die pakketlocker of PostNL-servicepuntverzameling prefereren.
Dichtstbijzijnde locaties: het GET /v1/locations/nearest eindpunt voor het ophalen van de dichtstbijzijnde PostNL-afhaalpunten bij een gegeven adres of coördinaten. De afhaalpuntdata met locatienaam, adres, openingstijden en de locatiecode.
Afhaalpuntbezorging: de zending met een afhaalpuntbezorgadres — het AddressType: "09" afhaalpuntadrestype met de locatiecode.
Track en trace. Zendingsstatus en trackinginformatie ophalen.
Zendingsstatus: het GET /v1/status/barcode/{barcode} eindpunt voor het ophalen van de huidige status van een zending op barcode. De statusrespons met de huidige fase, de statusbeschrijving en de eventgeschiedenis.
Statusfasen: PostNL zendingsstatus fasen — fase 1 (ophaling bij afzender), fase 2 (sortering bij PostNL), fase 3 (onderweg voor bezorging), fase 4 (bezorgd of bezorgpoging).
Batchstatus: het POST /v1/status/barcode eindpunt voor het bevragen van de status van meerdere barcodes in een enkel verzoek.
Notificatie-e-mails sturen. PostNL's mogelijkheid om bezorgingsnotificatie-e-mails te sturen naar ontvangers namens de afzender.
Internationale verzending. PostNL's internationale pakket- en pakketproducten voor grensoverschrijdende zendingen.
Internationale productcodes: de PostNL-productcodes voor internationale verzending. De productkeuze gebaseerd op bestemmingsland, gewicht en vereist serviceniveau.
Douanedocumentatie: het Customs object in het internationale zendingsverzoek. Het customs-object met het ShipmentType, het InvoiceNr en de Content array van douane-regelitems met omschrijving, hoeveelheid, gewicht, waarde, HS-code en herkomstland.
Adresvalidatie. Nederlandse bezorgadressen valideren met PostNL's adressendatabase.
Labelformaten en afdrukken. PostNL-labeluitvoer in de formaten die labelprinters vereisen.
GraphicFile formaat: de Printertype parameter in het labelverzoek — GraphicFile|PDF voor PDF-uitvoer, ZEBRA|Starline voor Zebra thermische printer ZPL-formaat.
Labelafmetingen: het PostNL A6-labelformaat voor standaard labelprinters en het A4-formaat voor desktopprinteromgevingen.
PostNL Checkout API. De checkout-integratie die PostNL-bezorgopties oppervlakt bij e-commercecheckout.
Bezorgopties bij checkout: de combinatie van tijdvensterberekening, afhaalpunt opzoeking en bezorgdatumberekening die PostNL-bezorgvoorkeuren presenteert aan klanten tijdens checkout.
Integratiepatronen
Hoog-volume labelgeneratie. Het magazijnbeheersysteem of orderbeheersysteem dat PostNL-labels in bulk genereert bij inpakstations.
E-commerce checkout integratie. De PostNL checkout-integratie die bezorgopties presenteert aan klanten tijdens het afrekenproces.
Zendingsmonitoring. Het statusmonitoringsysteem dat uitstaande PostNL-zendingen volgt door de bezorglevenscyclus — uitzonderingen detecterend (mislukte bezorgpogingen, retour naar afzender) en klantnotificaties of operationele interventies triggert.
Multi-client logistiek platform. De logistieke provider of fulfilmentplatform die PostNL-verzending beheert namens meerdere klantaccounts.
Gebruikte Technologieën
- C# / ASP.NET Core — primaire PostNL integratie implementatie .NET HTTP-client met JSON-serialisatie voor de PostNL REST API gebruikend
- Rust / Axum — hoge-prestatie PostNL labelgeneratie voor zeer hoog-volume verzendoperaties
- TypeScript / Node.js — PostNL-integratie voor Node.js-gebaseerde e-commerce en orderbeheerplatforms
- Python — PostNL API-scripting en dataverwerking voor fulfilmentoperaties
- REST / HTTP — PostNL API-communicatie
- SQL (PostgreSQL / MySQL) — zendingsrecords, barcode-naar-order mapping, labelopslag, trackinggeschiedenis
- Redis — barcodecaching, labelcaching voor herdrukken, statustracking, taakcoördinatie
- ZPL / PDF — labelformaatuitvoer voor thermische labelprinters en PDF-gebaseerd afdrukken
- Hangfire / geplande taken — batch zendingsstatuspollen, uitzonderingsdetectie, dagelijkse zendingsrapportage
- Docker — gecontaineriseerde integratiedienst implementatie
- GitHub Actions — CI/CD pijplijn voor integratiedienst implementatie
Direct PostNL vs Intermediaire Platform
De keuze tussen directe PostNL API-integratie en een intermediair platform zoals MyParcel of SendCloud hangt primair af van volume en contractstatus.
Intermediaire platforms zijn geschikt voor bedrijven zonder directe PostNL-contracten, voor lagere-volume verzenders die baat hebben bij de geconsolideerde tarieven van het intermediair en voor bedrijven die multi-vervoerder flexibiliteit nodig hebben.
Directe PostNL-integratie is geschikt wanneer het bedrijf een direct PostNL-contract heeft onderhandeld met volume-gebaseerde tarieven, wanneer de operatie toegang nodig heeft tot PostNL-producten of API-mogelijkheden die het intermediair niet blootstelt, of wanneer de operatie PostNL-verzending moet bieden als platform aan zijn eigen klanten.
PostNL Verbonden met Uw Verzendoperaties
PostNL API-integraties gebouwd voor hoog-volume productiegebruik — correcte klantnummer- en productcodeconfiguratie, batch labelgeneratie voor inpakstation doorvoer, ZPL en PDF labelformaatondersteuning voor thermische en desktopprinters, track en trace-monitoring met uitzonderingsdetectie en de operationele betrouwbaarheid waarop dagelijkse fulfilmentoperaties vertrouwen.