Nova Post Delivery

After installing the module, configure user access rights for the Delivery Hub menu. Navigate to user settings, go to the Access Rights tab, and select the role in the Delivery Hub section:

• No: No access to the Delivery Hub menu
• User: Access to view information
• Administrator: Full access and management rights

The Delivery Hub menu contains the following sections:

• Accounts: Delivery service account settings
• Notes: Delivery note management
• Waybills: List of all created waybills
• Contacts: List of partners and delivery addresses
• Products: Product list
• Catalogs: List of divisions, parcel lockers, and other pickup/drop-off points
• Configuration: General settings

To integrate Nova Post with Odoo, follow these steps:

• 01
  Obtain API keys to link your accounts
• 02
  Add a delivery provider account in Odoo
• 03
  Synchronize catalogs
• 04
  Configure the delivery provider account

How to Get an API Key

To obtain an API key, follow these steps:

• 01
  Log in to your Nova Post account
• 02
  Navigate to Integrations — API keys
• 03
  Click Create API key
• 04
  Copy the API key value

Adding an Account

Return to Odoo and create a new delivery provider account:

• 01
  Navigate to Delivery Hub
• 02
  Open Configuration
• 03
  Click Add New Account

Next, fill in the pop-up window:

• 01
  Select Nova Post as the delivery provider type
• 02
  Enter a Name
• 03
  Paste the copied API key
• 04
  Click Add

Initial Synchronization

Perform an initial synchronization of catalogs, such as divisions and units of measure. These catalogs contain essential information for further configuration.

Since catalogs contain a large number of records, synchronization takes time. To reduce it and avoid unnecessary data, specify the countries you work with. On the Settings tab in the Synchronization section, specify the Countries of origin and destination:

If the Countries field remains empty, the module synchronizes all the countries where the Nova Post service is available.

Click Synchronize to start the initial synchronization:

Account Settings

On the Settings tab, specify the default data for delivery notes.

To designate the person responsible for shipments, click Add in the Sender field:

Fill in the contact details:

• Enter personal data (Names, Phone, and Email)
• Select the Country and Division
• Click Add

Then, specify the following default information:

• Description — Shipment description
• Payer Type — Sender, recipient, or third party
• Declared Amount — Declared shipment value
• Package — Shipment package template
• HS Code: Ukrainian Classification of Goods for Foreign Economic Activity (UCGFEA) for international shipments

In the Sales section, choose the action for the delivery line in the sales order according to your needs:

• Add a delivery line: Adds a line based on native Odoo logic
• Do not add a delivery line: No addition
• Add a delivery line with 0 price amount: Adds free delivery

Nova Post Parameters

In the Nova Post section, specify mandatory information for this carrier:

• Delivery Tariff: Standard, Economy, or Express
• Cargo Type: Parcel or Documents
• Incoterm: DAP — Delivered at Place or DDP — Delivered Duty Paid
• Export Reason: For Personal Purposes, Selling, Repair, Return, or Other

If you do not specify a Delivery Tariff, Nova Post determines it automatically.

The module allows specifying package and shipment descriptions not only at the account level but also at other levels, enabling flexible settings.

Package

To add a package, navigate to Configuration — Packages — Package templates:

Click New to create a package template and fill in the details:

The package selection field at the account level is on the Settings tab in the Common section:

To specify a package for a specific product:

• Open the product template on the Inventory tab
• Select Delivery Package
• Enable the Individual Package option if the product cannot be packed with others

Shipment Description

The field for the shipment description at the account level is on the Settings tab in the Common section:

To specify an individual description for a specific product, open the product template on the Inventory tab and fill in the Delivery Description field:

You can also specify the description at the package template level:

The module allows you to:

• Add Nova Post delivery services to sales orders
• Create and manage delivery notes
• Configure individual delivery note places
• Calculate delivery costs
• Create waybills
• Upload supporting documents for international shipments

Adding Delivery to Sales Orders

Add a delivery address with a Nova Post division during order creation. Select the delivery provider and click Add Address. To create a delivery note via Nova Post, click Add Shipping:

In the pop-up window, select the Shipping Method and click Add:

Delivery note created:

Creating a Delivery Note Manually

To create a delivery note manually without a linked sales order, navigate to Delivery Hub — Nots and click New:

Delivery Note Settings

You can modify the following delivery note settings:

• Sender
• Recipient Partner and Recipient
• Pre-set parameters from the delivery provider account on the Settings tab

Delivery Note Places

On the Dimensions & Places tab, manage the description, dimensions, and other data for shipment items:

Delivery Cost and Waybills

Once the delivery note is filled with necessary data, calculate the delivery cost and create a waybill using the buttons at the top of the page:

After confirming the delivery note, the module creates a waybill:

Use the buttons in the Waybill field to delete it or manually synchronize its status.

If you make changes to the delivery note, click Update to send the updated data to Nova Post:

Attachments

International shipments require supporting documents. To add them:

• 01
  Open the delivery note on the Attachments tab
• 02
  Upload the file
• 03
  Click the Upload button