Marketplace · Extension
PostNL
Create PostNL barcodes and shipping labels, retrieve tracking and request optional delivery quotes.
About this package
What it does
Create PostNL barcodes and shipping labels, retrieve tracking and request optional delivery quotes. This is the carrier adapter for the Core Physical capability, not a replacement for shipping zones, merchant rates or a PostNL account. Label files are stored on the local application disk. 2
Requirements
Agovena Core ^0.0.1. Core Physical commerce is available automatically; install this Extension only for PostNL integration. 1
This extension is not marked production-ready. Validate its supported workflow in your own test environment before accepting customer orders.
Set up the package
Configure Core Physical commerce, then enable PostNL. Configure api_key, customer_code and customer_number. collection_location is optional, sandbox defaults to true and default_product_code defaults to 3085. Add accurate shipping addresses and product weights. Confirm that your PostNL contract supports the selected service and destination before offering it.
Operation and failure handling
Incomplete addresses or quote API failures return no live quotes. Label creation validates the street and house number; service code 3085 is rejected for destinations outside the Netherlands. Existing order-to-barcode mappings are reused. Invalid or missing label data produces an error rather than an empty PDF. Cancellation through this adapter is unsupported. Resolve label cancellation through the carrier process instead of assuming local order cancellation retracts it. 2