Skip to content
agovena.
agovena.
Get started
Community
Back to marketplace

Marketplace · Extension

PostNL

Create pre-announced PostNL shipments with barcodes and labels, follow tracking and use priced PostNL delivery options when available.

About this package

What it does

The PostNL extension is a carrier for the shipping features in Agovena Core. It creates a pre-announced PostNL shipment with barcode and label, reads tracking and can add priced PostNL delivery options to checkout. It is an Extension, not a Module: orders, products and addresses keep their generic Core fields, and PostNL barcodes, labels and product codes stay inside this extension.

Production status

Production-ready for the documented scope. Every operation under Supported operations is implemented against the PostNL REST APIs for barcodes, labels, shipment status and checkout and verified with automated tests that replace the provider with faked HTTP responses, without network calls. Live acceptance on your own PostNL account remains an operator responsibility: create one shipment, download its label and follow its tracking with your own PostNL contract before you ship customer orders. Operations under Not supported are not advertised.

Requires Agovena Core ^0.0.1. Shipping is part of Core, so no additional Module is required.

Set up the package

Shipping is part of Core, so only this extension needs enabling. Save the PostNL API key, customer code and customer number, keep sandbox on for tests and keep your Core shipping rates configured. Fulfillment uses product code 3085 unless another product is selected.

Operation and failure handling

The extension enforces one parcel per order and stores the barcode before decoding the label, so a retry never pre-announces a second parcel. A failed label keeps status label_failed; reprint it from Mijn PostNL. Cancelling a pre-announced parcel and customs shipments are not supported.

Open the provider guide

Sources

Search documentation

Search guides, commands and API endpoints

What are you looking for?

Documentation