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.