API Koppeling PostNL en DHL Laten Maken | MG Software

PostNL en DHL zijn de twee dominante pakketvervoerders in Nederland en verwerken samen dagelijks miljoenen zendingen. Beide partijen stellen zakelijke API's beschikbaar waarmee u programmatisch verzendlabels kunt genereren, pickups kunt inplannen, tarievenberekeningen kunt uitvoeren en de status van zendingen kunt volgen. Voor bedrijven die dagelijks tientallen tot duizenden pakketten versturen, is handmatig labelen geen optie meer.

PostNL biedt een Shipping API met REST endpoints voor het aanmaken van labels in diverse formaten (A4, A6, labelprinter), een Confirming API voor het bevestigen van zendingen richting sorteercentrum en een Track & Trace API die statusinformatie teruggeeft per barcode. De authenticatie verloopt via API keys die gekoppeld zijn aan uw zakelijke PostNL-contract. Naast de REST endpoints ondersteunt PostNL webhooks die statusupdates pushen naar uw systeem.

DHL beschikt over een Parcel API voor binnenlandse en Europese zendingen en een Express API voor internationale expresleveringen. De authenticatie bij DHL werkt met API keys en soms aanvullende accountcredentials, afhankelijk van het producttype. DHL levert labels als PDF of ZPL en biedt eveneens tracking-endpoints en statusnotificaties.

Het fundamentele verschil tussen beide carriers zit in de API-structuur, de labelvelden, de foutcodes en de tracking-events. Waar PostNL werkt met barcodetypes en productcodes die specifiek zijn voor de Nederlandse markt, hanteert DHL een internationaler productmodel. Een goed ontworpen integratie abstraheert deze verschillen achter een gemeenschappelijke interface, zodat uw applicatie niet afhankelijk wordt van de eigenaardigheden van een enkele carrier.

Zolang verzendlabels handmatig worden aangemaakt via de webportals van PostNL of DHL, blijft uw fulfillmentproces kwetsbaar voor typefouten in adressen, verkeerde productcodes en gemiste cut-off tijden. Elke fout die pas bij het sorteercentrum aan het licht komt, leidt tot vertraging, extra kosten en een teleurgestelde klant. Automatisering elimineert deze risico's structureel.

Een geintegreerd systeem genereert labels direct vanuit uw ordermanagement of WMS. Zodra een pickronde is afgerond, vraagt het systeem labels op bij de juiste carrier, print ze in het gewenste formaat en bevestigt de zending automatisch. De magazijnmedewerker hoeft alleen het label op het pakket te plakken. De hele flow, van order tot label, duurt seconden in plaats van minuten.

Track-and-trace integratie maakt het mogelijk om uw klanten proactief te informeren over de status van hun bestelling. In plaats van hen door te verwijzen naar de PostNL- of DHL-website, toont u tracking-informatie direct in uw eigen portaal of stuurt u geautomatiseerde e-mails en pushberichten bij relevante statuswijzigingen. Dat verhoogt de klanttevredenheid en vermindert het aantal "waar blijft mijn pakket"-vragen bij uw supportteam.

Voor bedrijven die beide carriers aanbieden, bijvoorbeeld op basis van bestemming, gewicht of servicelevel, biedt een multi-carrier integratie bovendien de flexibiliteit om per zending de beste optie te kiezen. Uw systeem kan op basis van regels automatisch bepalen of een pakket via PostNL of DHL verstuurd wordt, zonder dat een operator die beslissing handmatig hoeft te nemen.

Het hart van onze aanpak is een carrier-abstractielaag. In plaats van PostNL- en DHL-specifieke code door uw hele applicatie te strooien, definiëren we een gemeenschappelijk interface met operaties zoals createShipment, getLabel, getTracking en createReturn. Elke carrier krijgt een adapter die deze interface implementeert en de vertaling naar het specifieke API-formaat verzorgt. Dat betekent dat u later eenvoudig een derde carrier kunt toevoegen zonder bestaande code te wijzigen.

Voor PostNL implementeren we de Shipping API v2, configureren we de juiste productcodes (standaard, brievenbuspakje, avondlevering) en genereren we labels in het formaat dat past bij uw labelprinter. De Confirming API wordt aangestuurd zodra een zending fysiek het magazijn verlaat, en tracking-updates worden via webhooks of polling opgevangen en opgeslagen.

Bij DHL koppelen we de Parcel API voor nationale en Europese zendingen en, indien nodig, de Express API voor tijdkritische internationale leveringen. DHL-labels worden opgehaald als PDF of ZPL, afhankelijk van uw printinfrastructuur. Statusupdates volgen via de DHL Tracking API met webhook-integratie waar beschikbaar.

Cut-off tijden zijn cruciaal in logistieke integraties. Uw systeem moet weten wanneer de laatste pickup van de dag plaatsvindt en zendingen die na de deadline worden aangemeld, automatisch doorschuiven naar de volgende werkdag. Wij modelleren cut-off configuratie per carrier, per locatie en per servicelevel.

Foutafhandeling verdient extra aandacht omdat labelfalen directe impact heeft op de klanttevredenheid. Wij classificeren fouten naar type: adresvalidatiefouten worden teruggemeld aan de operator voor correctie, technische fouten worden herverwerkt via een retry-queue en structurele API-issues escaleren naar een alert channel. Elk label dat niet kan worden aangemaakt, wordt vastgelegd met context zodat het probleem snel te diagnosticeren is.

API keys voor PostNL en DHL geven toegang tot het aanmaken van zendingen op uw zakelijke account, wat directe financiele gevolgen heeft. Wij slaan keys op in een secrets manager en gebruiken per omgeving (development, staging, productie) aparte credentials. Sleutels worden nooit in broncode opgenomen en niet gedeeld via onveilige kanalen.

Beide carriers vereisen communicatie over HTTPS. Voor productieomgevingen adviseren we aanvullend IP-whitelisting waar de carrier dit ondersteunt, zodat alleen uw servers API-aanroepen kunnen doen. DHL biedt deze optie expliciet aan; bij PostNL is het afhankelijk van uw contractvorm.

Webhooks van carriers valideren we op basis van eventueel meegestuurde signatures of bekende IP-ranges. Onbekende payloads worden geweigerd en gelogd. Labels die persoonlijke adresgegevens bevatten, worden conform AVG-richtlijnen behandeld: we bewaren ze niet langer dan noodzakelijk en geven alleen geautoriseerde gebruikers toegang.

De grootste uitdaging bij een multi-carrier integratie is het verschil in API-structuur. PostNL en DHL gebruiken andere veldnamen, andere foutcodes en andere statusterminologie. Waar PostNL een zending "bezorgd" noemt, gebruikt DHL mogelijk "delivered" met een ander event-schema. Onze abstractielaag vertaalt deze verschillen naar een uniform model, maar de initiiele mapping vereist zorgvuldige analyse van beide API-documentaties.

Cut-off tijden vormen een tweede aandachtspunt. Elke carrier hanteert eigen deadlines die kunnen verschillen per regio, per seizoen en per servicelevel. Als uw systeem een label aanmaakt voor een zending die de cut-off net gemist heeft, wordt het pakket pas de volgende dag opgehaald. Wij configureren cut-off regels per carrier en locatie, en tonen waarschuwingen wanneer een zending dicht bij de deadline zit.

Internationale zendingen introduceren aanvullende complexiteit. Buiten de EU zijn douanedocumenten verplicht, met product-omschrijvingen, HS-codes en waardeverklaringen. PostNL en DHL stellen hiervoor elk eigen endpoints beschikbaar. Wij integreren deze stroom in het labelcreatieproces, zodat douanedocumenten automatisch worden gegenereerd op basis van orderdata uit uw systeem.

Carrier-API's worden regelmatig geüpdatet, soms met wijzigingen in endpoints, productcodes of authenticatiemethoden. Wij monitoren de changelogs van PostNL en DHL en plannen upgrades in onderhoudsvensters zodat uw operatie niet verrast wordt door breaking changes.

Daarnaast bewaken we dagelijks het slagingspercentage van labelcreatie en tracking-updates. Wanneer het foutpercentage boven een drempel komt, ontvangt uw team automatisch een alert. Periodiek analyseren we de logdata om patronen te ontdekken, zoals terugkerende adresfouten in bepaalde regio's, en adviseren we verbeteringen.

Een integratie met een enkele carrier, bijvoorbeeld alleen PostNL met labelcreatie en tracking, valt doorgaans binnen drie tot vier weken development. Het toevoegen van een tweede carrier verdubbelt de testinspanning maar niet de architectuurkosten, omdat de abstractielaag al staat.

Voor bedrijven met hoge volumes of complexe logistiek, denk aan multi-warehouse setups, internationale zendingen met douanedocumenten of carrier-selectie op basis van dynamische tarieven, is de doorlooptijd langer. Wij werken in sprints en leveren na elke fase werkende software.

Vraag een vrijblijvend scopegesprek aan. Samen brengen we uw zendvolumes, carrierbehoeften en systeemlandschap in kaart en geven we een realistische inschatting van investering en planning.