Nova Post integration module for Base (Baselinker)
Arrange delivery to your store's customers directly through the order management section in Base (Baselinker).
- Basic features of the Nova Post app for Base (Baselinker)
- Order delivery options: to an address, a branch, or a parcel locker*
- Shipment labeling: generate and print shipping labels
- Tracking: quick access to tracking information within specific orders
- Shipment management: delete created shipments when necessary
* Delivery to branches and parcel lockers requires additional API Nova Post integration into the client’s services or manual management of branch maps on Nova Post websites
Що потрібно, щоб інтегрувати Nova Post у Base (Baselinker)
- 1Підписати договори з Nova Post на надання логістичних послуг. Якщо ви продаєте за кордон, вам знадобиться два договори: на внутрішню доставку по країні та на міжнародну – для доставки в інші країни. Для підписання договору зверніться до відділу продажів своєї країни.
- Контакти відділу продажів
- 2Підписати додатковий договір для послуги «Оплата при отриманні»*
*Тільки для продавців з Польщі, Чехії, Німеччини - 3Зареєструватись в My Nova Post у вашій країні після підписання договорів з контактними даними, які ви вказали в договорі контактами довіреної особи-представника
- 4

To configure the module, you need an active service contract with Nova Post and an API key issued to an authorized representative specified in the contract.
How to Configure the Nova Post Module on Base (Baselinker)
Field descriptions for configuring the Nova Post module in Base (Baselinker)
- Basic fields: this information is used later when placing an order, so you don't need to enter it every time.
- DescriptionAccount name
Display name for the account in the Base (Baselinker) panel.
API keyNova Post API key
How to get the API keyShipper VAT NumberTax identification number of the sender's company
API Nova Post parameter: companyTinSender - company nameName of the sender’s company
Sender - phone numberSender's phone number
Sender - e-mailSender's email address
Sender - countryCountry from where parcels are shipped (select from a list)
Sender - streetSender's street address
Sender - house numberSender's house number
Sender - apartment numberSender's apartment number
Sender - postal codeSender's postal code
Sender - citySender's city
Sender - nameFirst name of the sender
Sender - surnameLast name of the sender
Client numberContract ID with Nova Post
API Nova Post parameter: payerContractNumber
- Cash-on-Delivery (COD) Fields
- Account number for COD (IBAN)
IBAN listed in the contract for COD payments
- Bank account owner
Tax identification number of the sender's companyника
- Weight Settings
- Default Package Weight SettingsHow to calculate the fixed weight of a cardboard
- Percentage value adds a percentage of the parcel weight for packaging.
- Fixed value adds a defined fixed weight for packaging to all parcels.
- If shipping small parcels, set this to 0 to avoid inflating the parcel's weight.How to calculate the fixed weight of a cardboard
fixed value
Value of the fixed weight of the cardboard0
How to arrange parcel delivery using the Nova Post module in Base (Baselinker)
Delivery to an Address
How to correctly fill in the Address field
- Do NOT duplicate the following fields in the Address field: Postal code, City, State, Country.
- Order of writing:
- Street name → House number → Apartment number (if applicable)
- House number → Street name → Apartment number (if applicable)
- The Pickup at point block must remain empty.
- For Delivery to Ukraine:
- All words should be written in Latin characters without translation. For example: Budynok 10, Kvartyra 25, vul. Shevchenka, Kyi
- English abbreviations are allowed.
- Full name
Street
Avenue
Boulevard
Road
Lane
Apartment
- Abbreviations
St
Ave
Blvd
Rd
Ln
Apt
Strictly follow the rules for structured address entry to ensure delivery accuracy, minimize the risk of errors, and avoid delays in delivery.
The Nova Post API expects to receive a structured recipient address. A structured address is a set of data formatted in a specific way and sequence.
During integration, Base (Baselinker) transmits the recipient's address as a single line. On Nova Post's side, this line is processed by an automated parsing algorithm that separates it into individual elements to create the shipment.
If the address is entered incorrectly, the algorithm will be unable to process the shipment automatically. In such cases, order processing will be delayed due to the need for manual intervention by staff or there may be a risk of incorrect delivery to the wrong address.
Delivery to a Branch or Parcel Locker
For this delivery type, a specific branch or parcel locker must be specified. Baselinker does not integrate with the Nova Post branch directory, so customers cannot select a branch or locker during the order process. However, the Nova Post module can transmit these details through the Pick up at point section.
Ways to provide Branch or Parcel Locker data for delivery:
- Integrate Nova Post API with your online store or CRM. Enable users to select the desired branch or locker for delivery during the ordering process. The selected data will be automatically transferred to Baselinker. More details on the method
- Upload the current Branch and Locker directory to your order management platform. Customers can select the desired branch or locker for delivery. However, this directory will not update automatically. To display up-to-date delivery locations on the website, you will need to update the directory periodically. More details
- Manually on Base (Baselinker). Enter the delivery location details in the Pick up at point section based on the customer-provided Delivery address data:
How to fill in parcel details
- 1Scroll down to the Shipments section in the order card and click Nova Post to open the parcel creation form.
- 2Complete all mandatory fields in the form. Once finished, click Send package Nova Post. Detailed Field Descriptions
An example of filling in parcel data:

Description of the fields in the parcel creation form
- Field Name
Insurance
Content description
Cash on delivery
Weight, Length, Width, Height
- What to Enter
Declared value of the parcel
Description of the shipment*
*To ensure the automatic completion of parcel descriptions, select one of the settings in the Default settings of shipment and printouts section: Product list (Quantity, Name) or Product list (Quantity, SKU, Name, Price)COD amount*. If the field is left blank, the parcel will be delivered without COD.
*To process COD, the Account number for COD (IBAN) and Bank account owner fields must be completed in the module settings.Parcel dimensions: weight, length, width, height