Magento
The Nova Post Shipping module for Magento 2 / Adobe Commerce is an official professional solution for automating international and local delivery to over 16 European countries and Ukraine.
The module integrates an interactive map widget into Magento checkout, allows automatic or manual generation of express waybills (EWs), calculates real-time or flat-rate shipping fees, and prints a complete set of accompanying and customs documents directly from the Order Grid or Order View.
Key Module Features and Available Delivery Destinations
Requirements for Correct Module Operation
Service agreement with Nova Post. A business client agreement with Nova Post is required for the plugin to work correctly. To sign an agreement, contact the sales department email in your country.
API key. Register in the My Nova Post business account and generate a key: detailed instructions. If testing is required, generate a test API key using this link.
Installing the Nova Post Module in Magento
The module can be installed in two official ways:
Download from Adobe Commerce Marketplace: Go to the Nova Post module page, add it to your account, and install it via the Web Setup Wizard or Component Manager.
Installation via Composer (recommended): Run the following command lines in your server terminal in the Magento root directory:
Module Configuration
Configuration in Nova Post Base Section
Go to: Stores → Configuration → Nova Post → Nova Post Base
Departure Countries: Select the countries from which you will ship orders (countries where your business/warehouses are registered). The selected countries will then appear in the list of available sender countries in the basic settings: Nova Post Settings → Shipment Departure Method → Country.
Configuration in Nova Post Settings Section
Go to: Stores → Configuration → Nova Post → Nova Post Settings
API Configuration Section
Production environment settings. Paste the production API key generated in your business account.
Test environment settings. Set Testing API to Yes if you are testing. Paste the test API key into the Stage API Key field. This allows you to test shipment creation without generating real waybills or charging service fees.
Contract Numbers Section
Domestic Contract Number: Specify the agreement number for domestic delivery.
International Contract Number: Specify the agreement number for international delivery to other countries.
Sender Data Section
Fill in the fields:
First Name / Last Name: Sender's first name and last name.
Email / Phone: Contact email and phone number.
Company TIN: Company tax ID (EDRPOU / TIN / NIP / VAT ID).
Company Name: Official company name.
EORI Code: EORI code (Economic Operators Registration and Identification). Mandatory for international shipments undergoing customs clearance (between EU and non-EU countries).
IOSS: Import One-Stop Shop number. Used for simplified VAT payment when selling goods valued up to €150 to EU buyers from outside the EU.
Shipment Departure Method Section
Set up the method for handing over parcels to the carrier:
Division: You will personally drop off parcels at the selected Nova Post branch, drop-off point, or parcel locker.
Address: Calling a Nova Post courier to your warehouse or office.
Product Information Section
Default data is used to calculate shipping fees if individual parameters are not filled in on the product page:
Default Product Weight (kg): Default product weight.
Length / Width / Height (cm): Default product dimensions.
Default HS Code: Default universal code for classifying goods at customs.
Shipment Automation Section
Automatic Shipment Creation determines how shipments are created:
Yes = automatically after the buyer places an order. The buyer will immediately receive an email with the parcel tracking number.
No = shipments are created manually by a manager via the admin panel
Carrier Shipping Calculation Section
Configure shipping fee calculations for each delivery type: Nova Post to Division (to a branch/parcel locker) and Nova Post to Address (by courier to an address).
For each type, specify Calculation Mode:
Carrier Calculation: Real-time calculation via Nova Post API based on weight, dimensions, declared or invoice value, and delivery destination.
Flat Rate: Fixed shipping fee set by the seller.
Free Delivery (Optional): Enable the option and set the order threshold: Free Delivery Threshold. Once this cart amount is reached, shipping becomes free for the customer.
Configuring Delivery Methods
Go to: Stores → Configuration → Sales → Delivery Methods → Nova Post
In this section, you activate delivery services visible to the buyer on the Checkout page by setting Enabled for Checkout to Yes.
Carrier Title, Method Title for Division, Method Title for Address: fields that define the carrier name and delivery method name. Filled in automatically.
Show Method If Not Applicable: specify whether to show the delivery method to the buyer if it is unavailable for their region.
Sort Order:
Nova Post to Division and Nova Post to Address Sections
Applicable countries determines which countries delivery is available to. Configure availability for each delivery method separately.
All Allowed Countries – all allowed countries.
Sell to specific countries – select countries where Nova Post delivery will be available. Specify only countries where Nova Post operates.
List of countries where Nova Post delivery is available: Ukraine, Moldova, Poland, Lithuania, Czechia, Romania, Germany, Slovakia, Estonia, Latvia, Hungary, Italy, Great Britain, Spain, France, Austria, Netherlands, USA.
Currency Setup
Go to: Stores → Configuration → General → Currency Setup
Base Currency: specify the settlement currency. Nova Post performs internal settlements in the store's Base Currency, which must match the currency of your agreement with Nova Post. For example, if shipping from Poland, enter PLN in Base Currency; if from Romania — RON.
Default Display Currency: currency displayed to the customer.
Allowed Currencies:
If you also use a display currency different from the base currency, Magento will convert the shipping fee according to your store's exchange rates (Stores → Currency Rates). This is standard Magento behavior for all delivery methods.
Product Settings
The module adds a dedicated Nova Post Product Settings block to each product page: Catalog → Products → edit product.
Since Magento natively supports only weight, the module adds missing fields required for accurate fee calculation and customs clearance:
Length (cm) / Width (cm) / Height (cm): Individual product dimensions. If left blank, default values from module settings will be used.
Product Title in English: Product title in English (mandatory for international declarations and invoices). If left blank, the system uses the default product title from Magento.
HS Code: Commodity classification code.
Please note: Nova Post delivery is available for physical items (Simple Products) only. If the cart contains virtual products only, the delivery selection step in Magento is skipped. To configure Configurable Products, make sure all child Simple Products have weight and dimensions specified.
Order Management and Waybill Creation
How to Create an Express Waybill
Available in two modes: Order View or Order Grid.
Order View – creating a shipment from the order details page
Order Grid – creating a shipment from the order list
Go to Sales → Orders and open the desired order.
In the Nova Post block, click the Create Shipment button.
In the Create Shipment - Preview modal window, review the details:
Sender: Sender details (from module settings).
Recipient: Recipient contacts and address/branch.
Parcels & Items: Dimensions, weight, parcel contents, HS codes, and item values.
Note: Additional shipment note (optional).
Click Create Shipment in the corner of the modal window.
Go to Sales → Orders.
In the Nova Post Shipment column, click Create Shipment in the corresponding order row.
Verify details in the preview window and confirm creation.
After successful waybill generation, its number will appear in the Nova Post Shipment column as an active hyperlink for quick tracking.
How to Generate Accompanying Documents
Depending on the shipping route, the module automatically generates the required document package:
Domestic or intra-EU shipping: standard barcode shipping label in 100x100 mm format.
Shipping on non-EU → EU and EU → non-EU routes:
Label: Standard shipping label 100x100 mm.
International Label: International consignment note with extended details.
Invoice: Commercial invoice for customs.
How to Print Accompanying Documents
Order View
Order Grid
Click the icon of the required document directly in the Nova Post Shipment column.
In the Nova Post block or via the Actions menu in the top bar, click the icon of the corresponding document. A PDF preview with download or print buttons will open in a modal window.
How to Find the Shipment Number and Track the Parcel
Order View
Order Grid
The shipment number is an active link. Click it to navigate to the Nova Post tracking page with full route details. The language of the tracking page is determined automatically based on current store view language settings.
How to Modify Details in an Express Waybill
If you need to change weight, address, or item list in an order after an EW has been created, delete the current EW and generate a new one with updated details:
In the Nova Post Shipment column in the order list or in the Nova Post block within the order, click the Trash Can icon.
Confirm action in the prompt window ("Are you sure you want to delete shipment...").
After deleting the previous tracking number, the system will show the Create Shipment button again, allowing you to generate a new waybill with updated parameters.
How to Grant Access to a Manager
The module is integrated with Magento role-based access control. In System → Permissions → User Roles, you can flexibly grant permissions to different managers:
Create Shipment — permission to create waybills.
Delete Shipment — permission to delete/cancel EWs.
Print Documents — permission to download and print accompanying documents.
API Logs
All API requests and responses during interaction with Nova Post are written to a dedicated log file, separate from general Magento logs. Logs include:
Successful operations — order ID, response status, express waybill number
Failed operations — order ID, error details
Network failures and timeouts.
The module records Nova Post logs in separate files:
var/log/novapost/debug.logvar/log/novapost/error.log
Authorization tokens and confidential data are automatically purged from all log entries.
Customer Checkout Journey
When placing an order with Nova Post delivery, the customer needs to:
Enter contact details: Email, first name, last name, phone number, country, city, street, building, and postal code.
Select Nova Post delivery method:
Delivery to a branch / parcel locker: The customer clicks the interactive map widget, selects a convenient location on the map or via address search, chooses type (branch or parcel locker), and confirms selection.
Courier delivery: Delivery is made to the address specified in contact details.
Specify payment method: Online payment or cash on delivery (COD).
Confirm order.
After waybill generation, a branded email is automatically sent to the buyer with order details, EW number, and a direct link to the parcel tracking page.
