Eng
Integration with Baselinker
integration

Integrations

Nova Post integration module for Baselinker

Integrate Nova Post services into your workspace

  • What is Baselinker

    Baselinker is a convenient system for managing online sales.

    In Baselinker, a seller can process orders from various e-commerce platforms in a single, user-friendly interface. For example, orders from Amazon, Etsy, Shopify, and others are centralized on the platform.

    We have developed a dedicated Nova Post service integration module in Baselinker to enable the automation of order processing and simplify the process of arranging delivery. With this module, sellers can arrange the delivery of orders for their customers directly through the order management section in Baselinker.

Navigate the article:

⠀

Features of the Nova Post Module on 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

4 Steps to Integrate Nova Post on Baselinker

How to Configure the Nova Post Module on Baselinker

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.

<b><span class="custom-font-size font-size-16 custom-font-family font-family-Inter" style="font-weight: 700;font-style: normal;">1. Locate the Nova Post module on Baselinker. Go to the Integrations menu → Select Add Integration.</span></b>
1. Locate the Nova Post module on Baselinker. Go to the Integrations menu → Select Add Integration.
<b><span class="custom-font-size font-size-16 custom-font-family font-family-Inter" style="font-weight: 700;font-style: normal;">2. Navigate to the "Courier Services" Section: In the search bar, type Nova Post → Click on the Nova Post module icon.</span></b>
2. Navigate to the "Courier Services" Section: In the search bar, type Nova Post → Click on the Nova Post module icon.
<b><span class="custom-font-size font-size-16 custom-font-family font-family-Inter" style="font-weight: 700;font-style: normal;">3. Complete the Settings: Fill in all the required fields in the settings section and click Save.</span></b><br><br><a style="text-decoration: none;" href="#description" target="_self"><span style="color: rgb(218, 41, 28);"><b><span class="custom-font-size font-size-16 custom-font-family font-family-Inter" style="font-weight: 700;font-style: normal;">Detailed Description of Field Values&nbsp;&gt;&gt;</span></b></span></a>
3. Complete the Settings: Fill in all the required fields in the settings section and click Save.

Detailed Description of Field Values >>

Field descriptions for configuring the Nova Post module in Baselinker

The integration with Baselinker uses the standard Nova Post API, specifically the shipment creation method. During module setup, users provide all sender-related information, which is reused for orders, eliminating the need for repetitive input.

Each field in Baselinker corresponds to a parameter in the Nova Post API with similar logic but may have different names for better user understanding across various courier services. Below is a detailed explanation of each field and its corresponding API parameter.

  • Description

    Account name

    Display name for the account in the Baselinker panel.

    API key

    Nova Post API key

    How to get the API key 

    Shipper VAT Number

    Tax identification number of the sender's company

    API Nova Post parameter: companyTin

    Sender - company name

    Name of the sender’s company

    Sender - phone number

    Sender's phone number

    Sender - e-mail

    Sender's email address

    Sender - country

    Country from where parcels are shipped (select from a list)

    Sender - street

    Sender's street address

    Sender - house number

    Sender's house number

    Sender - apartment number

    Sender's apartment number

    Sender - postal code

    Sender's postal code

    Sender - city

    Sender's city

    Sender - name

    First name of the sender

    Sender - surname

    Last name of the sender

    Client number

    Contract 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

    API Nova Post parameter: bankAccountName

    Bank account owner

    Tax identification number of the sender's company

    API Nova Post parameter: bankAccountId

  • Default Package Weight Settings

    How to calculate the fixed weight of a cardboard

    Choose how to add the weight of the packaging to the parcel's weight:

    • 1
      Percentage value adds a percentage of the parcel weight for packaging.
    • 2
      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 cardboard

    0

How to arrange parcel delivery using the Nova Post module in Baselinker

The module supports the primary delivery types:

  • 1
    Delivery to an Address: No additional actions are required for this delivery type. The address provided by the customer is automatically transferred to Nova Post through the integration with Baselinker.
  • 2
    Delivery to a Branch or Parcel Locker: This requires additional integration or manual configuration, as Baselinker does not include built-in integration with the Nova Post branch directory.

For orders received via your own website: You can integrate the Nova Post branch directory using the Nova Post API. In this case, branch or parcel locker delivery information will be automatically transmitted to Baselinker.

For orders received via marketplaces or platforms without custom integration capabilities: Delivery to a branch or parcel locker must be set up manually.

Delivery to an Address

<b><span class="custom-font-size font-size-16 custom-font-family font-family-Inter" style="font-weight: 700;font-style: normal;">Complete all fields in the Delivery Address section as shown in the example</span></b>
Complete all fields in the Delivery Address section as shown in the example
<b><span class="custom-font-size font-size-16 custom-font-family font-family-Inter" style="font-weight: 700;font-style: normal;">Enter shipment details in the Shipments Section and click Send package Nova Post</span></b><br><br><a style="text-decoration: none;" href="#shipments" target="_self"><span style="color: rgb(218, 41, 28);"><b><span class="custom-font-size font-size-16 custom-font-family font-family-Inter" style="font-weight: 700;font-style: normal;">How to Fill the Shipments Section</span></b></span></a><b><span class="custom-font-size font-size-16 custom-font-family font-family-Inter" style="font-weight: 700;font-style: normal;">&nbsp;</span></b><img class="np-block-inline-icon" src="https://site-assets.novapost.com/66d56a6f-0ada-4130-96ea-2d79f1054e04.svg">
Enter shipment details in the Shipments Section and click Send package Nova Post

How to Fill the Shipments Section 

How to correctly fill in the Address field

  • 1
    Do NOT duplicate the following fields in the Address field: Postal code, City, State, Country.
  • 2
    Order of writing:
    • 2.1
      Street name → House number → Apartment number (if applicable)
    • 2.2
      House number → Street name → Apartment number (if applicable)
  • 3
    The Pickup at point block must remain empty.
  • 4
    For Delivery to Ukraine:
    • 4.1
      All words should be written in Latin characters without translation. For example: Budynok 10, Kvartyra 25, vul. Shevchenka, Kyi
    • 4.2
      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, 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:

  • 1
    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 
  • 2
    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 
  • 3
    Manually on Baselinker. Enter the delivery location details in the Pick up at point section based on the customer-provided Delivery address data:
<b><span class="custom-font-size font-size-16 custom-font-family font-family-Inter" style="font-weight: 700;font-style: normal;">&nbsp;Navigate </span></b><a style="text-decoration: none;" href="https://novapost.com/en-pl/departments" target="_blank"><span style="color: rgb(218, 41, 28);"><b><span class="custom-font-size font-size-16 custom-font-family font-family-Inter" style="font-weight: 700;font-style: normal;">to the branch map</span></b></span></a><b><span class="custom-font-size font-size-16 custom-font-family font-family-Inter" style="font-weight: 700;font-style: normal;">: select the country and delivery city. Choose the desired delivery location: by branch or locker number, if provided by the customer. Enter the address provided in the Delivery address and select the nearest branch or locker.</span></b>
 Navigate to the branch map: select the country and delivery city. Choose the desired delivery location: by branch or locker number, if provided by the customer. Enter the address provided in the Delivery address and select the nearest branch or locker.
<b><span class="custom-font-size font-size-16 custom-font-family font-family-Inter" style="font-weight: 700;font-style: normal;">Access the branch or locker details: Click Copy to copy the information.</span></b>
Access the branch or locker details: Click Copy to copy the information.
<b><span class="custom-font-size font-size-16 custom-font-family font-family-Inter" style="font-weight: 700;font-style: normal;">Return to the order card on Baselinker: Open the Pick up at point section, paste the copied information into the ID field, and save the changes.</span></b><br><br><b><span class="custom-font-size font-size-16 custom-font-family font-family-Inter" style="font-weight: 700;font-style: normal;">Complete the Shipment Details. Fill in the required shipment details in the Shipments section and click Send Package Nova Post.&nbsp;</span></b><a style="text-decoration: none;" href="#parcel-data" target="_self"><span style="color: rgb(218, 41, 28);"><b><span class="custom-font-size font-size-16 custom-font-family font-family-Inter" style="font-weight: 700;font-style: normal;">How to fill the Shipments section&nbsp;</span></b></span></a><img class="np-block-inline-icon" src="https://site-assets.novapost.com/66d56a6f-0ada-4130-96ea-2d79f1054e04.svg">
Return to the order card on Baselinker: Open the Pick up at point section, paste the copied information into the ID field, and save the changes.

Complete the Shipment Details. Fill in the required shipment details in the Shipments section and click Send Package Nova Post. How to fill the Shipments section 

How to fill in parcel details

  1. 1
    Scroll down to the Shipments section in the order card and click Nova Post to open the parcel creation form.
  2. 2
    Complete 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

How to print a Label for a parcel from Baselinker

<b><span class="custom-font-size font-size-16 custom-font-family font-family-Inter" style="font-weight: 700;font-style: normal;">Label for a single parcel in each order</span></b>
Label for a single parcel in each order
<b><span class="custom-font-size font-size-16 custom-font-family font-family-Inter" style="font-weight: 700;font-style: normal;">Print labeling for multiple parcels or a single parcel</span></b>
Print labeling for multiple parcels or a single parcel

How to track parcels in Baselinker

<b><span class="custom-font-size font-size-16 custom-font-family font-family-Inter" style="font-weight: 700;font-style: normal;">Package number – this is the express waybill number. Clicking on it allows you to track the parcel.</span></b>
Package number – this is the express waybill number. Clicking on it allows you to track the parcel.
<b><span class="custom-font-size font-size-16 custom-font-family font-family-Inter" style="font-weight: 700;font-style: normal;">Parcel tracking page</span></b>
Parcel tracking page