Using the official API ensures stable automatic synchronization of catalogs and waybill statuses. Automate data pre-filling to optimize warehouse operations and accelerate order delivery to customers.
| Availability |
Odoo Online
Odoo.sh
On Premise
|
|---|---|
| Compatibility |
Community
Enterprise
|
| Technical Name | delivery_np |
| Version | 19.0.1.2.4 |
| License | OPL-1 |
| Category | |
| Support | Free 60 days support and 360 days bug-fixing |
Use Case
Jorem ipsum dolor sit amet, consectetur adipiscing elit. Nunc vulputate libero et velit interdum, ac aliquet odio mattis. Class aptent taciti sociosqu ad litora torquent per conubia nostra, per inceptos himenaeos.
Forem ipsum dolor sit amet, consectetur adipiscing elit. Nunc vulputate libero et velit interdum, ac aliquet odio mattis. Class aptent taciti sociosqu ad litora torquent per conubia nostra, per inceptos himenaeos.
Dorem ipsum dolor sit amet, consectetur adipiscing elit. Nunc vulputate libero et velit interdum, ac aliquet odio mattis.
It is a long established fact that a reader will be distracted by the readable content of a page
Korem ipsum dolor sit amet, consectetur adipiscing elit. Nunc vulputate libero et velit interdum, ac aliquet odio mattis. Class aptent taciti sociosqu ad litora torquent per conubia nostra, per inceptos himenaeos.
Korem ipsum dolor sit amet, consectetur adipiscing elit. Nunc vulputate libero et velit interdum, ac aliquet odio mattis.
Odoo App Installation
Upload modules
Upload modules from the ZIP archive to your Odoo hosting, or a GitHub repository connected there.
Place the unzipped modules in your custom add-on directory and restart the Odoo system service.
Update App List
After restarting, activate the Developer Mode, and go to the Apps menu.
Click on Update Apps List to fetch the new modules in the list.
Activate the App
Install the new module, finding it by name and clicking on the Activate button.
* If you don't see the module, try to remove the default Apps filter from the search bar.
Configuration
Follow the instructions in the module description to complete the installation process and start using the app.
Manual
Initial Setup
After installing the module, complete the initial setup:
-
01Assign user access rights
-
02Add an account
-
03Configure account settings
Access Rights
The module adds a dedicated Nova Poshta menu to manage shipments and waybills. To configure user access, open user settings and select a role in the Nova Poshta field on the Access Rights tab:
- No: The user does not have access to the Nova Poshta menu
- User: Provides limited read-only access
- Administrator: Provides full permissions for all objects
Account Setup
The Nova Poshta integration operates via API. Retrieve your API key from the Nova Poshta business portal and create an account in Odoo.
To view the list of accounts, go to Nova Poshta — Configuration — Accounts.
To create an account, click New. In the pop-up window:
-
01Enter the Account Name
-
02Paste the generated API Key
-
03Select a Company (if running a multi-company Odoo environment)
-
04Click Add
Account Settings
Set default values in the Nova Poshta account settings to automatically pre-fill shipment details.
Under Sender Data, click Add to specify the sender address.
In the address window:
- Select the type: Address, Warehouse, or Postomat
- Select the City
- Enter the Street, Building, and Flat number if you selected Address
- Select the Warehouse or Postomat depending on the chosen type
- Add a Note (optional)
Click Create to save the sender address
Under General Data, specify default shipment pre-fill parameters:
- Recipient: Counterparty recipient
- Cargo Type: Parcel, Cargo, Documents, Tires and Rims, or Pallets
- Description: Shipment description (manage in Configuration — Parcel Descriptions)
- Payer Type: Sender, Recipient, or Third Party
- Payment Form: Non-cash or Cash
- Seat: Packaging template (manage in Configuration — Templates)
- Minimum Cost: Declared shipment value
- Minimum Weight: Shipment weight
Under Backward, specify default redelivery parameters:
- Cargo Type: Documents or Money Transfer
- Payer Type: Sender or Recipient
- Payment Control: Enable or disable this service (see the Shipments section)
- Account Journal: Accounting journal for payments
General Settings
Global configuration options are available under Nova Poshta — Configuration — Settings — General.
Native Odoo logic adds a delivery line to the sales order. To bypass adding delivery lines, enable Create TTN directly in Sales. Once enabled, you can use order delivery data in inventory transfer documents by turning on Stock Compatibility.
Select the default Label Type for waybill printing.
Enable Use Company Registry to identify legal entities using their company registration number (Company ID) instead of Tax ID.
Partners
The module adds a Nova Poshta tab to partner forms, allowing you to configure:
- Contact persons
- Delivery addresses or Nova Poshta warehouses or postomats
- Preferred service and counterparty types
To add a contact, under Contacts, click Add a line and enter the name and phone number.
To add a destination, under Addresses, click Add a line and fill in the create address pop-up.
Under Defaults, select preferred service and counterparty types to automatically pre-fill shipment forms.
Products
You can configure specific shipment descriptions and packaging options at the product level for Nova Poshta deliveries. Open a product form, go to the Inventory tab, and configure the Nova Poshta section:
- Enter or select a product shipment Description
- Select a Seat
- Enable Individual if the product cannot be packed together with other items in the same box
Shipments
The module allows you to:
- Add Nova Poshta delivery services to sales orders
- Create and manage shipments
- Configure dimensions and parcel seats
- Calculate delivery costs
- Generate waybills (TTN)
- Use the Payment Control service
Creating a Shipment from a Sales Order
You can create a Nova Poshta shipment from a sales order in two ways:
- Native Odoo workflow: Adds a delivery line to the order
- Direct shipment creation: Creates a shipment without adding a delivery line
To add a delivery line to a sales order, click Add Shipping.
In the pop-up window:
-
01Select a Shipping Method associated with your account
-
02Select or create a recipient Contact
-
03Select or create a destination Address
-
04Click Add
Adding a delivery line increases the total sales order amount. To create a shipment directly without modifying the order total, click Create TTN NP.
In the pop-up window:
- Select or create a Partner.
- Select an existing contact for the partner or enable Add New Contact to create a new one and fill in the New Contact section.
- Select a Delivery Method linked to your account.
- Enter a shipment Description.
- Specify the Assessed Cost.
- Select the destination (address, warehouse, or postomat) or click Add New Address to create one.
Creating a Standalone Shipment
The Nova Poshta menu provides two methods to create shipments without linking them to sales orders:
- New — Create a shipment from scratch
- Quick Add — Create a shipment with pre-filled default data
Shipment Details
Configure shipment details by specifying sender, recipient, parcel, payment, and dispatch date information.
For address deliveries, specify the preferred delivery date and time interval.
The Settings tab contains parcel parameters, delivery costs, payment terms, and additional options.
Under Delivery Cost, select:
- Payer Type: Sender, Recipient, or Third Party
- Payment Form: Cash or Non-cash
Redelivery (Cash on Delivery)
To use Cash on Delivery services:
-
01Enable Backward under Backward Delivery
-
02Enter the Amount
-
03Select the Payer: Sender or Recipient
-
04Select Cargo type: Documents or Money Transfer
Payment Control
Nova Poshta offers a Payment Control service that transfers post-delivery funds directly to a business bank account. To use Payment Control:
-
01Sign a corporate agreement with Nova Poshta, as this service is available only to businesses and sole proprietors (details: https://novaposhta.ua/en/for-business/financial-services/cash-delivery-agreement).
-
02Open your business account settings, enable Payment Control under Backward, and select an Account Journal.
-
03In the shipment form, select a Delivery Method associated with your business account.
-
04On the Settings tab under Backward Delivery, enable Payment Control and enter the Amount.
Once the recipient accepts and pays for the parcel, funds are automatically transferred to your business account.
Local Express
The Local Express service is available exclusively to business clients and online stores operating in Kyiv. Requirements:
- Select a Delivery Method associated with your corporate account
- Ensure both sender and recipient addresses are within Kyiv city limits
- Enable the Local Express option
Parcel Seats
Nova Poshta shipments require parcel seat information. On the Dimensions and Seats tab, enter either the total seat count or individual seat parameters depending on the service type.
Warehouse or Address delivery: Enter the total Seats Amount. When created from a sales order, calculated weight and volume pre-fill automatically. To manually override calculated values, complete the Manual Weight and Manual Volume fields.
Postomat delivery or detailed seat configuration: Enable Specify Shipping Seats. Seat details are pre-filled automatically based on the packaging template assigned to the first product in the sales order or the account-level default seat.
For each seat, you can select official Nova Poshta packaging (full list under Configuration — NP Packaging).
If an item requires manual handling on non-conveyor belts, enable the Manual option.
To use preset packaging templates, click Add from Templates, select templates in the pop-up window, and click Add.
To let inventory users manage parcel seats directly from stock operations, enable Stock Compatibility in general settings. When enabled, confirming a sales order populates the delivery document and adds a Dimensions and Seats tab.
Delivery Cost and Waybill
Once all shipment details are entered, click the action buttons at the top of the page to get a rate and generate a waybill (TTN).
Confirming the shipment generates the waybill in Nova Poshta.
If you modify shipment details after creation, click Sync with NP to push updates to Nova Poshta.
Use the icons in the TTN field to print shipping labels or delete the waybill.
You can select the shipping label to print by default when you click the print icon (see the General Settings section for details).
Waybills
The Nova Poshta — Documents menu allows you to track waybill statuses generated through Odoo or link external existing waybills.
Linking an External Waybill
To import and track an external Nova Poshta waybill in Odoo, click Link TTN. In the pop-up window:
-
01Enter the waybill number
-
02Select a Delivery Method
-
03Select a Sales Order (optional, to link the waybill to an existing order)
-
04Click Add
Another way to link a waybill to a sales order is to use the Link an Existing TTN action.
Managing Waybills
The waybill form displays complete logistics information and quick links to related documents. Use the action buttons to manage waybills:
- Update: Update status from Nova Poshta
- Print: Print default shipping label
- Cancel: Cancel the shipment
To print a non-default label type, click Print action and select the desired type.
Synchronization
The module automatically retrieves data from Nova Poshta using Odoo scheduled actions.
Because Nova Poshta directories and catalogs contain large amounts of data, some scheduled actions are split into separate sync tasks to maintain system performance.
Prepare catalog synchronization: Checks task completion statuses and generates new processing queues at scheduled intervals.
Process action tasks: Handles payment registration for the Payment Control service.
Run catalog synchronization: Downloads Nova Poshta catalogs (cities, warehouses, streets, delivery time intervals).
Tracking documents: Refreshes waybill statuses.
Default synchronization intervals match Nova Poshta recommendations. You can adjust scheduled action and sync task intervals or run synchronization manually.
Changelog
13.0.1.0.0 2020-12-09
- Initial version
14.0.3.3.1 2024-06-12
- Implement avoiding an empty Nova Poshta data on adding a delivery method in sale orders.
14.0.3.3.0 2024-02-29
- Implement the logic to create and specify recipients with the type "Organization".
- Fix the "DateTime" param for new TTN creation - check that the date is not less than the current.
14.0.3.2.1 2024-02-15
- Improve the NP Data form.
- Implement handling of shipping address for partners in Sale Orders.
14.0.3.2.0 2024-02-14
- Implement editing of TTN.
- Add checks on TTN canceling.
14.0.3.1.0 2024-01-28
- Add the Shipping Date field to specify the date when a shipping will be transefed to a Nova Poshta warehouse.
14.0.3.0.0 2024-01-18
- Implement a new logic to handle contacts and delivery addresses for multi Nova Poshta accounts.
14.0.2.1.0 2023-08-24
- Implement the shippings seats management.
- Add a wizard to add a new account of Nova Poshta.
- Add a wizard to to create a new Nova Poshta Document (TTN).
14.0.2.0.0 2023-03-14
- Add ability to create TTN without a sale order or stock picking.
- Extend TTN fields.
- Improve translations to Ukrainian.
14.0.1.0.1 2021-07-27
- Add the parameter "Внутрішній номер замовлення" (InfoRegClientBarcodes)
- Add the parameter "Додаткова інформація" (AdditionalInformation)
14.0.1.0.0 2021-06-21
- Migration from 13.0
15.0.2.1.0 2024-08-23
- Implement importing of existing TTNs by a wizard.
- Improve a Nova Poshta document views.
15.0.2.0.1 2024-06-12
- Implement avoiding an empty Nova Poshta data on adding a delivery method in sale orders.
15.0.2.0.0 2024-03-15
15.0.1.1.0 2023-11-23
- Implement the shippings seats management.
- Add a wizard to add a new account of Nova Poshta.
- Add a wizard to to create a new Nova Poshta Document (TTN).
15.0.1.0.0 2022-05-11
- Migrate from 14.0
16.0.2.5.0 2025-12-16
- Implement importing of existing TTNs by a wizard.
- Improve the logic to process payments when TTN is delivered.
16.0.2.4.0 2024-12-12
- Implement logic to set the preferred delivery date for shipping to an address.
- Add the time interval model.
16.0.2.3.2 2024-11-01
- Improve the Nova Poshta contact mapping for delivery to partners with the Organization recipient type.
16.0.2.3.1 2024-09-11
- Change button icons.
- Allow selecting of a Nova Poshta data in stock pickings.
16.0.2.3.0 2024-07-30
- Add a flag for Nova Poshta accounts to show when an API key is expired.
- Add checks to avoid duplicating of TTN when they are confirmed from different places.
- Improve the tree view of Nova Poshta accounts.
16.0.2.2.4 2024-07-29
- Restrict a NP data confirmation if it has been created from SO.
16.0.2.2.3 2024-06-12
- Implement avoiding an empty Nova Poshta data on adding a delivery method in sale orders.
- Add checking of incorrect API keys.
16.0.2.2.2 2024-06-07
- Add checking for uniqueness for NP API keys.
- Add logic to archive related delivery carriers on removing a Nova Poshta account.
- Add description for backward payment fields.
- Improve UA translations.
16.0.2.2.1 2024-03-19
- Add to the alternate delivery wizard a total amount of a sale order.
- Add a domain for the sender address form.
16.0.2.2.0 2024-03-07
- Implement ability to create and select recipients with the Organization type.
16.0.2.1.0 2024-01-02
- Implement editing of TTN.
- Add checks on TTN canceling.
- Add the "shipment_date" field to specify the date when a shipping will be placed to Nova Poshta.
- Improve UA translations.
- Improve the NP Data form.
- Implement handling of shipping address for partners in Sale Orders.
16.0.2.0.1 2023-12-13
- Improve UA translations.
- Improve model forms.
16.0.2.0.0 2023-12-12
- Add the wizard to quick Nova Poshta shipping creating.
- Add the wizard to add new Nova Poshta account.
- Rebuild logic for Nova Poshta contacts and addresses.
16.0.1.1.1 2023-11-28
- Fix a nova poshta contact assigning.
16.0.1.1.0 2023-11-23
16.0.1.0.0 2022-11-30
- Migration from 15.0.
17.0.1.6.3 2026-06-11
- Improve Nova Poshta time intervals synchronization.
17.0.1.6.2 2026-04-17
- Add opportunity to manage seats from stock picking form.
- Implement auto assigning seats for delivery data from order or Nova Poshta config.
17.0.1.6.1 2026-02-03
- Add fields to store latest Nova Poshta TTN and state of it for sale order.
17.0.1.6.0 2025-12-16
- Implement logic to set the preferred delivery date for shipping to an address.
- Add the time interval model
17.0.1.5.3 2025-11-13
- Add a button to open NP TTN from sale orders.
17.0.1.5.2 2025-03-29
- Add an option to choose what field to use to get a company code, registry, or VAT.
17.0.1.5.1 2025-03-28
- Add option to transfer NP data from sale orders to stock picking, in case when the delivery line is not in SO.
17.0.1.5.0 2025-03-27
- Add checking of the Nova Poshta contact names and phone.
- Add checking of the assessed cost amount when the basckward amount is specified and it's greater.
17.0.1.4.5 2025-02-18
- Improve the method to create the Address deliveries without a flat number.
17.0.1.4.4 2024-11-01
- Improve the Nova Poshta contact mapping for delivery to partners with the Organization recipient type.
17.0.1.4.3 2024-10-29
- Improve the automated action processing.
- Refactor the search of unique references.
17.0.1.4.2 2024-10-10
- Improve the logic to process payments when TTN is delivered.
17.0.1.4.1 2024-09-26
- Add the Assessed Cost filed to the new shipping wizard.
17.0.1.4.0 2024-08-30
- Add a wizard to link a created elsewhere TTN.
17.0.1.3.1 2024-08-19
- Add handling of boolean values on importing.
17.0.1.3.0 2024-07-29
- Add a flag for Nova Poshta accounts to show when an API key is expired.
- Add checks to avoid duplicating of TTN when they are confirmed from different places.
- Improve the tree view of Nova Poshta accounts.
17.0.1.2.2 2024-06-12
- Implement avoiding an empty Nova Poshta data on adding a delivery method in sale orders.
17.0.1.2.1 2024-06-07
- Add checking for uniqueness for NP API keys.
- Add logic to archive related delivery carriers on removing a Nova Poshta account.
- Add description for backward payment fields.
- Improve UA translations.
17.0.1.2.0 2024-05-24
- Allow selecting of a Nova Poshta data in stock pickings.
17.0.1.1.0 2024-05-14
- Add an action to create a Nova Poshta document from the partner form.
- Link the Nova Poshta data to partners.
17.0.1.0.0 2024-03-07
- Migration from 16.0.
18.0.1.2.7 2026-08-07
- Add wizard to set seats for shipment data from existed templates.
18.0.1.2.6 2026-07-29
- Update the Nova Poshta tracking URL.
18.0.1.2.5 2026-07-06
- Improve views.
18.0.1.2.4 2026-06-11
- Improve Nova Poshta time intervals synchronization.
18.0.1.2.3 2026-04-17
- Add opportunity to manage seats from stock picking form.
- Implement auto assigning seats for delivery data from order or Nova Poshta config.
18.0.1.2.2 2026-04-10
- Improve multi-company logic.
18.0.1.2.1 2026-02-03
- Add fields to store latest Nova Poshta TTN and state of it for sale order.
18.0.1.2.0 2025-12-16
- Implement logic to set the preferred delivery date for shipping to an address.
- Add the time interval model.
18.0.1.1.0 2025-03-29
- Add option to transfer NP data from sale orders to stock picking, in case when the delivery line is not in SO.
- Add checking of the Nova Poshta contact names and phone correctness.
- Add checking of the assessed cost amount when the basckward amount is specified and it's greater.
- Improve the method to create the address deliveries without a flat number.
18.0.1.0.1 2025-02-21
- Add the separated delivery product for each company, in the multi-company environment.
- Add an option to choose what field to use to get a company code, registry, or VAT.
18.0.1.0.0 2024-11-05
- Migration from 17.0.
19.0.1.2.4 2026-09-03
- Add model to store Nova Poshta error code messages with translations.
19.0.1.2.3 2026-08-26
- Improve processing of the Description and Additional Information params.
- Improve views for the Preffered Delivery Date field.
19.0.1.2.2 2026-08-24
- Improve UA translations.
- Improve the wizard to add new shippings.
19.0.1.2.1 2026-08-21
- Deactivate the Third-person payer type.
- Improve the Nova Poshta data form.
19.0.1.2.0 2026-08-19
- Improve UA translations.
- Reconfigure menus and add quick action buttons to lists.
19.0.1.1.11 2026-08-07
- Add wizard to set seats for shipment data from existed templates.
19.0.1.1.10 2026-07-29
- Update the Nova Poshta tracking URL.
19.0.1.1.9 2026-07-07
- Improve views.
19.0.1.1.8 2026-06-26
- Improve label printing for TTN.
- Add a print button to print TTN from stock pickings.
- Add a config parameter to specify the default label format.
19.0.1.1.7 2026-06-11
- Improve Nova Poshta time intervals synchronization.
19.0.1.1.6 2026-05-25
- Improve the Local Express feature.
19.0.1.1.5 2026-05-15
- Add option to add "LocalExpress" service for shipment.
- Add the custom description field for specifying a sale order reference by external integrations.
19.0.1.1.4 2026-04-30
- Improve UA translations.
- Improve the default package management.
19.0.1.1.3 2026-04-17
- Add opportunity to manage seats from stock picking form.
- Implement auto assigning seats for delivery data from order or Nova Poshta config.
19.0.1.1.2 2026-02-04
- Improve UA translations.
- Improve views for Sale Orders.
19.0.1.1.1 2026-02-03
- Add fields to store latest Nova Poshta TTN and state of it for sale order.
19.0.1.1.0 2025-12-16
- Add the time interval model.
- Implement logic to set the preferred delivery date for shipping to an address.
19.0.1.0.0 2025-10-24
- Migration from 18.0.
Resources
Learn how to configure data synchronization with Nova Post and connect a real-time waybill status update mechanism
How to ship products across Ukraine and worldwide via Nova Post delivery service in Odoo
How to integrate the Nova Poshta delivery into the company logistics processes in Odoo
