Wat houdt Shipment API v4 precies in?
De Shipment API v4 maakt het makkelijker om zendingen voor te melden, labels aan te maken en te printen. In plaats van gebruik te maken van complexe productcodes, kun je nu werken met logische en duidelijke productnamen. Dit zorgt voor een snellere en nauwkeurigere afhandeling van het voormelden en klaarmaken van zendingen.
Wat zijn de voordelen?
Duidelijke productnamen in plaats van codes
Productcodes worden vervangen door herkenbare productnamen. Dit zorgt ervoor dat het voormelden minder foutgevoelig wordt en makkelijker te begrijpen is, vooral voor nieuwe gebruikers.
Flexibiliteit in labelkeuze
Met de nieuwe API kun je kiezen tussen een staand of liggend label, afhankelijk van je voorkeuren. Ook kies je nu zelf het bestandstype dat bij jouw printer past. Dit zorgt voor goed leesbare verzendlabels en een uniforme presentatie van je zendingen.
Betere aansluiting bij andere PostNL-processen
De nieuwe API zorgt voor een betere aansluiting bij onze andere processen, zoals facturatie. De terminologie is ook consistent doorgevoerd in de contracten, wat voor een duidelijke en foutloze communicatie zorgt.
Wat is de planning?
De nieuwe Shipment API v4 wordt uitgerold in de eerste helft van 2025. We zorgen ervoor dat je ruim van tevoren geïnformeerd wordt, zodat je genoeg tijd hebt om over te stappen. De oudere versies van de Shipping API en Labelling API worden halverwege 2026 uitgefaseerd.
Wat houdt Checkout API v4 precies in?
De Checkout API v4 biedt meer consistentie en sluit perfect aan op de nieuwe Shipment API. Je kunt eenvoudig bezorgopties instellen en gebruiken, waarbij dezelfde termen en beschrijvingen door het hele proces worden gehanteerd. Dit maakt het integratieproces eenvoudiger en minder foutgevoelig.
Wat zijn de voordelen?
Consistente bezorgopties
De nieuwe API zorgt voor een uniforme aanpak van bezorgopties. Dit betekent dat de opties die je aanbiedt aan je klanten, op dezelfde manier worden verwerkt in de zendingen. Deze consistentie verkleint de kans op fouten en versnelt het proces.
Eenvoudige integratie met de Shipment API
De termen en velden in de Checkout API v4 zijn afgestemd op de Shipment API v4, waardoor de communicatie tussen beide API’s soepeler verloopt. Dit zorgt voor een snellere en makkelijkere integratie met jouw systemen.
Verbeterde klantbeleving
Door gebruik te maken van de Checkout API v4 kun je je klanten duidelijker en gebruiksvriendelijker bezorgopties aanbieden. Dit draagt bij aan een betere winkelervaring en verhoogt de kans op succesvolle conversies.
Wat is de planning?
De Checkout API v4 wordt samen met de Shipment API v4 uitgerold in de eerste helft van 2025. Je ontvangt tijdig updates over de overgang naar de nieuwe versie. De oudere versie van de Checkout API zal halverwege 2026 uitgefaseerd worden.
Andere vragen
Ja en nee. Met de overstap naar Checkout API v4 en Shipment API v4 heb je de integratie van je checkout en warehouse gemoderniseerd. Maar je moet je integratie wel onderhouden. We blijven doorgaan met API Life Cycle Management, wat betekent dat er in de toekomst nieuwe updates en verbeteringen kunnen komen.
Klanten maken momenteel gebruik van verschillende versies van deze API’s. We beginnen met een schone lei door de nieuwe versies te laten starten op v4. De huidige nieuwste versie is versie 3. Om uniformiteit te behouden volgen de API's de nummering naar v4. Dit maakt het voor klanten eenvoudiger om consistent met onze API’s te werken en voorkomt verwarring met verschillende versienummers.
Je zult de integratie met PostNL moeten gaan aanpassen. De wijzigingen hebben IT-impact die per klant verschillen. De IT-impact is namelijk in grote mate afhankelijk van hoe jouw huidige integratie is opgezet en op welke manier je de huidige API gebruikt. De impact kun je zelf inschatten op basis van de gedetailleerde informatie op de Developer portal.
Op de Developer portal wordt technische informatie geplaatst met daarin een overzicht van de te doorlopen stappen.
Shipment API versie 4 kan worden gebruikt voor het voorbereiden van e-commerce-zendingen door onze klanten in Nederland, voor het versturen van pakketten binnen Nederland, naar België en internationaal. In de loop van 2025 voegen we het brievenbuspakket toe en breiden we de internationale dienstverlening verder uit.
Later in 2025 wordt de dienstverlening voor klanten van PostNL België toegevoegd.
Heb je een of meerdere van onderstaande API-integraties met PostNL? Dan dien je die te vervangen door de nieuwe Shipment API v4.
- Labelling API
- Shipping API
Maak je gebruik van de Confirming API dan zul je die uiteindelijk ook moeten aanpassen. Communicatie hierover volgt op een later moment.
Heb je een of meerdere van onderstaande API-integraties met PostNL? Dan die je die te vervangen door de nieuwe Checkout API v4.
- Checkout API
- Timeframe API
- Deliverydate API
Op het moment dat je van ons bericht krijgt kun je direct overstappen op de nieuwe Shipment API v4 en de Checkout API v4, waarvoor je ruim de tijd krijgt.
Ja je krijgt een mail met informatie vanaf wanneer je kunt overstappen op de Shipment API v4 en de Checkout API v4, hoe je kunt overstappen, waar de technische informatie staat en wanneer de integratie afgerond moet zijn.
Bij de technische documentatie op de Developer portal komt een apart gedeelte voor de nieuwe Shipment v4 API en Checkout API v4. Daar is alle technische documentatie te vinden die je nodig hebt voor de overstap naar de nieuwe API's:
- Stappenplan voor de migratie – (waar en hoe te beginnen)
- Guidelines
- Open API Specification (OAS)
- Overzicht van alle beschikbare producten en services
- Error codes
- Reference codes
- FAQ’s
De nieuwe Shipment API v4 is geschikt voor het versturen van e-commerce zendingen naar binnen- en buitenland. In de nieuwe Shipment API v4 komen de volgende PostNL portfolio’s beschikbaar:
- Portfolio van PostNL pakketten NL
- Portfolio van PostNL pakketten BE
- Portfolio van PostNL International
Een gedeelte van het portfolio van Mail Nederland: Aangetekende brief Brievenbuspakket In de huidige Shipping API zit meer dan bovenstaande portfolio's. Denk bijvoorbeeld aan de portfolio’s van Logistics Solutions zoals Extra@Home. Deze komen niet beschikbaar in de nieuwe Shipment API v4. Specifiek voor deze dienstverlening kun je voorlopig nog de huidige API blijven gebruiken.
Het productaanbod van de nieuwe Checkout API v4 is gelijk aan het productaanbod van de huidige versies.