Skip to content
ConsumerBusiness
Postnl.nl
Business solutions

Updated Shipment API v4 and Checkout API v4

For easier integration, fewer errors, and greater flexibility

The new Shipment API v4 and Checkout API v4 simplify the process of pre-announcing shipments and offering delivery options. These APIs replace product codes with clear product names and use consistent terminology throughout the process. This makes integration easier, reduces errors, and provides greater flexibility.

What is Shipment API v4?

The Shipment API v4 makes it easier to pre-announce shipments, create, and print labels. Instead of working with complex product codes, you can now use logical and clear product names. This ensures faster and more accurate handling of pre-announcements and shipment preparation.

What are the benefits?

  • Clear product names instead of codes

    Product codes are replaced with recognizable product names, making pre-announcements less error-prone and easier to understand, especially for new users.

  • Flexibility in label choice

    With the new API, you can choose between portrait or landscape labels based on your preferences. You can also select the file type that best suits your printer. This ensures legible shipping labels and a consistent presentation of your shipments.

  • Better alignment with other PostNL processes

    The new API aligns seamlessly with our other processes, such as invoices. Consistent terminology applied in contracts, ensures clear and error-free communication.

When will the update be rolled out?

The new Shipment API v4 will be rolled out in the first half of 2025. You’ll receive timely notifications to give you plenty of time to switch. Older versions of the Shipping API and Labelling API will be phased out by mid-2026.

How XL Shop Group smoothly transitioned to the new Shipment API v4

Fewer errors, more flexibility, and a more efficient process. XL Shop Group and development partner No Pulp demonstrate how easy the transition can be.

Read about their experience

What is Checkout API v4?

The Checkout API v4 offers greater consistency and integrates perfectly with the new Shipment API. You can easily configure and manage delivery options, using the same terms and descriptions throughout the process. This simplifies integration and reduces errors.

What are the benefits?

  • Consistent delivery options

    The new API ensures a uniform approach to delivery options. This means the options you offer to your customers are processed in the same way during shipments. This consistency reduces errors and speeds up the process.

  • Seamless integration with the Shipment API

    The terms and fields in Checkout API v4 are aligned with Shipment API v4, ensuring smoother communication between the two APIs. This results in faster and easier integration with your systems.

  • Improved customer experience

    With Checkout API v4, you can offer your customers delivery options that are clearer and more user-friendly. This enhances the shopping experience and increases the likelihood of successful conversions.

When will the update be rolled out?

The Checkout API v4 will be rolled out alongside the Shipment API v4 in the first half of 2025. You’ll receive updates in advance about transitioning to the new version. The older version of the Checkout API will be phased out by mid-2026.

Other questions

Technical documentation

As soon as it becomes available, you can find the technical documentation, API specifications, and support on the developer portal. It contains everything you need for a fast and reliable integration.
Go to the Developer portal