Connecting Nova Poshta to an online store
Important: This service is currently available in Ukrainian only and is aimed at the Ukrainian market.
You can enable integration with Nova Poshta so that your customers can select the required post office from the list when making an order.
Tip: To date, there is no possibility to automatically create a shipping waybill. That is, information from your online store will not be transferred to your Nova Post account.
Content:
Getting an API key in your Nova Poshta account
Connecting the integration to the site on Weblium
Setting up the integration on Weblium
Creating a waybill based on orders
Extending the API key expiration date
Register a personal account on the Nova Poshta website or log in to an existing one.
Go to the Безпека (Security) tab and click on the Створити ключ (Generate a key) button:

Confirm the creation of the API key by clicking on the Створити (Generate) button:

Copy your API key in the Ключ (Key) column:

Note: In the "Сервіс" (Service) column, exactly "Бізнес-кабінет" (Business account) should be indicated but not "Мобільний додаток" (Mobile app), etc.
Important: The API key is generated for a period of 1 year. After the final date, the key stops working and can no longer be used on your site. You can learn how to renew your API key in the last section of this guide (this can be done ahead of time).
Open your site settings, go to the Shipment section and click the Connect button in the Nova Poshta section:

Paste your API key into the field and click on the Save button:

As in other shipment methods, you can add Comments for your customers and edit the inscriptions on the fields that customers of your store fill in, namely, change the name and placeholder inside these fields:
ㅤㅤㅤ1) In the Shipping method name field, you can respectively indicate the name of the shipping method you have chosen;
ㅤㅤㅤ2) In the Comments field, you can specify additional information for your customers, which will be displayed under the name of the shipping method;
ㅤㅤㅤ3) In the City field field, you can specify the text that will be displayed in the cart above and inside the field from which your customers will choose the city to receive the parcel;
ㅤㅤㅤ4) You can also change the name and placeholder text inside the Post office field field (where a customer selects a specific Nova Poshta post office in his city):

Note: The information from these fields comes directly from the Nova Poshta database.
The next option to configure is Post offices filter.
Here, you can select the types of post offices that will appear on the customer's side when choosing an office:

1) Post office - a regular post of Nova Poshta that accepts parcels weighing up to 30 kg (some offices have a lower maximum parcel weight).
2) Cargo department - they receive / issue a shipment with an actual and volumetric weight of up to 1,000 kg per departure item, a maximum length of up to 300 cm, and a height of up to 170 cm.
3) Parcel locker is an automatic terminal for receiving and sending parcels to do this at any time in a reasonably convenient way.
Tip: You can find more detailed information about the Nova Poshta parcel locker operation here.
Note: If you have large-size items, you may find it helpful to turn off this type of post (as well as regular post offices) and keep only the cargo department option.
4) PrivatBank parcel locker - the same as described in the previous item. Privatbank cooperates with Nova Poshta and provides its own parcel lockers for use.
5) Parcel Shop provides placement for receiving and issuing parcels weighing up to 15 kg in shopping centers and supermarkets in a small area.
Tip: You can learn more about this type of department here.
Important: As of today, such types of offices as "PrivatBank parcel locker" and "Parcel Shop" are unavailable. We currently have them because Nova Poshta still technically allows you to select these options, and accordingly, we also left them available. These 2 office types may become available again in the future, so you can leave them enabled if you wish.
You can also customize the shipping cost.
It can be fixed:

Important: A fixed price will be added to the total amount of the order.
...and custom:

And finally, you can choose payment methods when choosing which delivery option from Nova Poshta will be available to your customers:

Tip: Nova Poshta works stably with all the payment systems indicated in the screenshot above.
Don't forget to publish the site for all the latest changes.
After completing all the settings and saving them, you will see Nova Poshta in the shopping cart on your site:

Note: In the cart, the city and post office choice is available only in Ukrainian.
If your site is integrated with Nova Poshta, you can generate waybills (transportation documents) directly in Weblium for each order in your shop. To do this, you need to complete the initial integration setup, after which the Generate waybill button will become available in each order.
To perform these settings, your online store must already be integrated with Nova Poshta according to the instructions in the previous sections. Before you can generate waybills for orders, you need to specify the sender's details (your credentials) and the default parcel parameters (dimensions and weight). To do this:
In your site settings under Your Store, go to the Shipment subsection, click the three dots to the right of Nova Poshta, and select Manage.
In the Auto-generating the waybill section, fill in the sender's (seller's) details that will be used in all generated waybills as the sender.
ㅤㅤㅤ① Sender — choose the full name of the desired sender (contact person) from the dropdown list;
ㅤㅤㅤ② Sender’s phone number — the sender’s phone number;
ㅤㅤㅤ③ Sender’s city — select the city from which the parcel will be sent. You can start typing the city name to select it from the list;
ㅤㅤㅤ④ Sender’s post office — select the branch in your city from which you will send parcels. It is recommended to choose a branch where the maximum allowed parcel weight fits your items (if you have bulky or heavy goods, avoid selecting mini-branches);
ㅤㅤㅤ⑤ Payer for delivery — select who will pay for the delivery: Sender (you) or Receiver (buyer);
ㅤㅤㅤ⑥ Form of payment — choose the payment method: Cash at the branch (includes payment by bank card) or Bank transfer (bank transfer from a legal entity to Nova Poshta’s account);
ㅤㅤㅤ⑦ Shipment description — the value of this field will appear in the delivery description. You can use variables to automatically insert the necessary information, such as the order number, list of items, etc.
Note: Non-cash payment is available only to clients who have a contract with Nova Poshta for transportation services and no overdue debts. Generally, it is recommended to specify non-cash payment only if the sender (you) is the payer, as not all of your buyers may have a contract with Nova Poshta.
The Additional information about the shipment section deserves special attention:
Here, you can specify a template for generating additional useful information when creating a waybill. Clicking Show variables will reveal the variables you can use in your template:
Below, in the Parcel size and weight by default section, you need to specify the parameters that will be applied to all shipments by default. Specify parameters that are most typical for your shipments (most of the parcels you send):
Tip: You can specify average values or parameters for your smallest shipments. If the actual size exceeds the specified value, Nova Poshta operators will manually adjust the parcel dimensions and, if necessary, recalculate the cost. If the parcel is too large for the branch chosen by the buyer, Nova Poshta will contact you (usually by phone) to confirm another branch, such as the nearest cargo branch.
Specify the values for the parcel's weight, length, width, and height in the four fields consecutively.
Save the changes by clicking Save in the top right corner:
Done! You can now create waybills for orders via your site settings.
To create a waybill for an order, follow these steps:
In your site settings under Your Store, go to the Orders subsection and click on the required order:

In the right-hand menu at the bottom, in the Shipment section, click on the Generate waybill button:
Important: The text in the order details (sections Contact Information and Shipment) must be in Cyrillic.
In the pop-up window, fill in all the required information and click on the Generate button:

Additionally, pay attention to the section called Shipment Information:
ㅤㅤㅤ① Settings for entire shipment. You can set shipping parameters for individual locations. To set general parameters, check the box in this field;
ㅤㅤㅤ② Button to copy a shipment location;
ㅤㅤㅤ③ Button to delete a shipment location;
ㅤㅤㅤ④ Button to activate the manual processing option (it has to be checked if the parcel is not packed according to the rules of Nova Poshta);
ㅤㅤㅤ⑤ Button to add a shipment location (a seat).
If necessary, you can edit the created waybill:
On the Nova Poshta side, the waybill will appear as follows:
If you need to copy or delete a waybill, you can do so in the same location where it was created, namely in the order settings using the respective buttons located to the right of the waybill number:
Your API key can be renewed. This can be done if you go to the personal account of Nova Poshta, similar to the connection process, in the Налаштування (Settings) section, go to the Безпека (Security) tab and click on the clock icon next to the desired key:

…and extend it by pressing the Підтвердити (confirm) button:

However, several situations will not allow you to renew the key if the expiration date has already passed or if the key has been deleted. That is, the key's expiration date can be extended until its end date has come and it has not been withdrawn.
Important: If the key has expired, you need to repeat the connection process from this instruction (generate a new API key and re-enable it in your site settings instead of the obsolete key).
Tip: The key can be renewed in advance immediately after its creation.
You can enable integration with Nova Poshta so that your customers can select the required post office from the list when making an order.
Tip: To date, there is no possibility to automatically create a shipping waybill. That is, information from your online store will not be transferred to your Nova Post account.
Content:
Getting an API key in your Nova Poshta account
Connecting the integration to the site on Weblium
Setting up the integration on Weblium
Creating a waybill based on orders
Extending the API key expiration date
Getting an API key in your Nova Poshta account
Register a personal account on the Nova Poshta website or log in to an existing one.
Go to the Безпека (Security) tab and click on the Створити ключ (Generate a key) button:

Confirm the creation of the API key by clicking on the Створити (Generate) button:

Copy your API key in the Ключ (Key) column:

Note: In the "Сервіс" (Service) column, exactly "Бізнес-кабінет" (Business account) should be indicated but not "Мобільний додаток" (Mobile app), etc.
Important: The API key is generated for a period of 1 year. After the final date, the key stops working and can no longer be used on your site. You can learn how to renew your API key in the last section of this guide (this can be done ahead of time).
Connecting the integration to the site on Weblium
Open your site settings, go to the Shipment section and click the Connect button in the Nova Poshta section:

Paste your API key into the field and click on the Save button:

Setting up the integration on Weblium
As in other shipment methods, you can add Comments for your customers and edit the inscriptions on the fields that customers of your store fill in, namely, change the name and placeholder inside these fields:
ㅤㅤㅤ1) In the Shipping method name field, you can respectively indicate the name of the shipping method you have chosen;
ㅤㅤㅤ2) In the Comments field, you can specify additional information for your customers, which will be displayed under the name of the shipping method;
ㅤㅤㅤ3) In the City field field, you can specify the text that will be displayed in the cart above and inside the field from which your customers will choose the city to receive the parcel;
ㅤㅤㅤ4) You can also change the name and placeholder text inside the Post office field field (where a customer selects a specific Nova Poshta post office in his city):

Note: The information from these fields comes directly from the Nova Poshta database.
The next option to configure is Post offices filter.
Here, you can select the types of post offices that will appear on the customer's side when choosing an office:

1) Post office - a regular post of Nova Poshta that accepts parcels weighing up to 30 kg (some offices have a lower maximum parcel weight).
2) Cargo department - they receive / issue a shipment with an actual and volumetric weight of up to 1,000 kg per departure item, a maximum length of up to 300 cm, and a height of up to 170 cm.
3) Parcel locker is an automatic terminal for receiving and sending parcels to do this at any time in a reasonably convenient way.
Tip: You can find more detailed information about the Nova Poshta parcel locker operation here.
Note: If you have large-size items, you may find it helpful to turn off this type of post (as well as regular post offices) and keep only the cargo department option.
4) PrivatBank parcel locker - the same as described in the previous item. Privatbank cooperates with Nova Poshta and provides its own parcel lockers for use.
5) Parcel Shop provides placement for receiving and issuing parcels weighing up to 15 kg in shopping centers and supermarkets in a small area.
Tip: You can learn more about this type of department here.
Important: As of today, such types of offices as "PrivatBank parcel locker" and "Parcel Shop" are unavailable. We currently have them because Nova Poshta still technically allows you to select these options, and accordingly, we also left them available. These 2 office types may become available again in the future, so you can leave them enabled if you wish.
You can also customize the shipping cost.
It can be fixed:

Important: A fixed price will be added to the total amount of the order.
...and custom:

And finally, you can choose payment methods when choosing which delivery option from Nova Poshta will be available to your customers:

Tip: Nova Poshta works stably with all the payment systems indicated in the screenshot above.
Don't forget to publish the site for all the latest changes.
After completing all the settings and saving them, you will see Nova Poshta in the shopping cart on your site:

Note: In the cart, the city and post office choice is available only in Ukrainian.
Creating a Waybill Based on Orders
If your site is integrated with Nova Poshta, you can generate waybills (transportation documents) directly in Weblium for each order in your shop. To do this, you need to complete the initial integration setup, after which the Generate waybill button will become available in each order.
Initial Setup for Waybill Generation
To perform these settings, your online store must already be integrated with Nova Poshta according to the instructions in the previous sections. Before you can generate waybills for orders, you need to specify the sender's details (your credentials) and the default parcel parameters (dimensions and weight). To do this:
In your site settings under Your Store, go to the Shipment subsection, click the three dots to the right of Nova Poshta, and select Manage.

In the Auto-generating the waybill section, fill in the sender's (seller's) details that will be used in all generated waybills as the sender.

ㅤㅤㅤ① Sender — choose the full name of the desired sender (contact person) from the dropdown list;
ㅤㅤㅤ② Sender’s phone number — the sender’s phone number;
ㅤㅤㅤ③ Sender’s city — select the city from which the parcel will be sent. You can start typing the city name to select it from the list;
ㅤㅤㅤ④ Sender’s post office — select the branch in your city from which you will send parcels. It is recommended to choose a branch where the maximum allowed parcel weight fits your items (if you have bulky or heavy goods, avoid selecting mini-branches);
ㅤㅤㅤ⑤ Payer for delivery — select who will pay for the delivery: Sender (you) or Receiver (buyer);
ㅤㅤㅤ⑥ Form of payment — choose the payment method: Cash at the branch (includes payment by bank card) or Bank transfer (bank transfer from a legal entity to Nova Poshta’s account);
ㅤㅤㅤ⑦ Shipment description — the value of this field will appear in the delivery description. You can use variables to automatically insert the necessary information, such as the order number, list of items, etc.
Note: Non-cash payment is available only to clients who have a contract with Nova Poshta for transportation services and no overdue debts. Generally, it is recommended to specify non-cash payment only if the sender (you) is the payer, as not all of your buyers may have a contract with Nova Poshta.
The Additional information about the shipment section deserves special attention:

Here, you can specify a template for generating additional useful information when creating a waybill. Clicking Show variables will reveal the variables you can use in your template:

Below, in the Parcel size and weight by default section, you need to specify the parameters that will be applied to all shipments by default. Specify parameters that are most typical for your shipments (most of the parcels you send):

Tip: You can specify average values or parameters for your smallest shipments. If the actual size exceeds the specified value, Nova Poshta operators will manually adjust the parcel dimensions and, if necessary, recalculate the cost. If the parcel is too large for the branch chosen by the buyer, Nova Poshta will contact you (usually by phone) to confirm another branch, such as the nearest cargo branch.
Specify the values for the parcel's weight, length, width, and height in the four fields consecutively.
Save the changes by clicking Save in the top right corner:

Done! You can now create waybills for orders via your site settings.
Creating a Waybill (TTN)
To create a waybill for an order, follow these steps:
In your site settings under Your Store, go to the Orders subsection and click on the required order:

In the right-hand menu at the bottom, in the Shipment section, click on the Generate waybill button:

Important: The text in the order details (sections Contact Information and Shipment) must be in Cyrillic.
In the pop-up window, fill in all the required information and click on the Generate button:

Additionally, pay attention to the section called Shipment Information:
ㅤㅤㅤ① Settings for entire shipment. You can set shipping parameters for individual locations. To set general parameters, check the box in this field;
ㅤㅤㅤ② Button to copy a shipment location;
ㅤㅤㅤ③ Button to delete a shipment location;
ㅤㅤㅤ④ Button to activate the manual processing option (it has to be checked if the parcel is not packed according to the rules of Nova Poshta);
ㅤㅤㅤ⑤ Button to add a shipment location (a seat).

If necessary, you can edit the created waybill:

On the Nova Poshta side, the waybill will appear as follows:

Copying or Deleting a Waybill
If you need to copy or delete a waybill, you can do so in the same location where it was created, namely in the order settings using the respective buttons located to the right of the waybill number:

Extending the API key expiration date
Your API key can be renewed. This can be done if you go to the personal account of Nova Poshta, similar to the connection process, in the Налаштування (Settings) section, go to the Безпека (Security) tab and click on the clock icon next to the desired key:

…and extend it by pressing the Підтвердити (confirm) button:

However, several situations will not allow you to renew the key if the expiration date has already passed or if the key has been deleted. That is, the key's expiration date can be extended until its end date has come and it has not been withdrawn.
Important: If the key has expired, you need to repeat the connection process from this instruction (generate a new API key and re-enable it in your site settings instead of the obsolete key).
Tip: The key can be renewed in advance immediately after its creation.
Updated on: 02/22/2025
Thank you!