Skip to content
English
Go to shippypro.com
  • There are no suggestions because the search field is empty.

How to connect Nova Poshta to ShippyPro

Discover here how to connect Nova Poshta in just a few steps

Let's see how you can integrate Nova Poshta with ShippyPro in just a few steps and start shipping from Ukraine, both domestically and internationally.

Summary:

  1. Before you start
  2. Connection steps
  3. Supported services
  4. Additional options
  5. Troubleshooting & Errors
  6. FAQs

1. Before you start

Nova Poshta is a Ukrainian parcel and cargo carrier. With this integration you can create shipments, print labels and track your parcels directly from ShippyPro.

Before connecting, make sure you have:

  • An active Nova Poshta business account
  • Your Nova Poshta API Key, available in your Nova Poshta account. If you can't find it, contact your Nova Poshta account manager
  • A sender address located in Ukraine: shipments must depart from Ukraine

Optionally, you can also gather the Ref codes that Nova Poshta uses to identify your sender data (sender, contact person, city and address). If you leave them empty, ShippyPro will retrieve them automatically from your Nova Poshta account.

2. Connection steps

  1. Go to the Carriers page of your ShippyPro account.
  2. Click on the Nova Poshta logo.
  3. Fill in the connection fields:
  • API Key (required): your Nova Poshta API key
  • Sender Ref: the Ref code of the sender registered on your Nova Poshta account. If empty, it is retrieved automatically
  • Contact Ref: the Ref code of the sender's contact person. If empty, it is retrieved automatically
  • Sender City Ref: the Ref code of the sender's city. If empty, it is retrieved automatically
  • Sender Address Ref: the Ref code of the sender's address. If empty, it is retrieved automatically
  • Label Type (required): choose between PDF A4 and PDF 100x100
  • Service Type (required): the service to use (currently Standard)
  • Test: enable it only if you want to use Test Mode (see section 4)

Click on Connect to save the configuration.

💡 Tip: if your Nova Poshta account has more than one sender or address, we recommend filling in all the Ref fields, so that the correct sender data is always used.

Please note: credentials are not verified when you save the connection. We recommend creating a first shipment to make sure everything works correctly.

3. Supported services

  • Standard: Nova Poshta's standard service. It works in two ways:
    • Door to door: the parcel is delivered to the recipient's address (default)
    • Door to warehouse: the parcel is delivered to a Nova Poshta branch, when the Recipient Warehouse Ref option is set (see section 4)

Nova Poshta also supports:

  • PDF labels in A4 or 100x100 format
  • Track & Trace, also available on the Nova Poshta website
  • Cash on Delivery, with the amount automatically converted into UAH
  • Insurance, using the order total as declared value
  • Multiparcel shipments
  • Domestic and international shipments departing from Ukraine

Not supported: shipment deletion (Void), live rates, pickup booking, pickup point search, return labels, paperless documents, ZPL/EPL labels, CN22/CN23, Proof of Delivery.

4. Additional options

Delivery to a Nova Poshta branch

To deliver the parcel to a Nova Poshta branch instead of the recipient's address, fill in the Recipient Warehouse Ref option with the Ref code of the branch. The shipment will be created as door-to-warehouse.

Shipments to companies

To ship to a company, fill in both options:

  • Nova Poshta EDRPOU: the EDRPOU code of the recipient company
  • Nova Poshta Ownership Form: the ownership form code of the recipient company

Both fields are required: if only one is filled in, the recipient will be considered a private person.

Test Mode

⚠️ Important: Nova Poshta doesn't provide a separate test environment. Even with Test enabled, requests are sent to Nova Poshta's live system, so the shipments you create may be real shipments. Since shipments can't be deleted from ShippyPro, contact Nova Poshta if you need to cancel one.

Custom Label

The Custom Label option is currently not available for Nova Poshta.

5. Troubleshooting & Errors

Address not recognized / city or street not found

ShippyPro matches the recipient's city and street with Nova Poshta's address directory. If the address can't be found, check that:

  • The city name is spelled correctly
  • The street field contains only the street name and house number, without extra notes or abbreviations
  • Additional information (e.g. apartment, floor) is entered in the second address line

If the address is correct and the error persists, contact ShippyPro Support.

Sender data not found

Check that the API Key and the Ref codes entered in the connection are correct. If you are not sure about the Ref codes, leave them empty so ShippyPro can retrieve them automatically.

Error on shipments to companies

Make sure that both Nova Poshta EDRPOU and Nova Poshta Ownership Form are filled in with valid codes.

Internal Server Error / connection issues

This is usually a temporary issue on the carrier's side. Wait a few minutes and try again. Also check that the API Key was copied correctly, without extra spaces, and that your Nova Poshta account is active. If the problem persists, contact ShippyPro Support with the order details.

6. FAQs

Can I ship internationally with Nova Poshta?

Yes. Nova Poshta supports both domestic and international shipments, as long as they depart from Ukraine.

Do I need to enter the Ref codes?

No. Only the API Key is mandatory: if the Ref fields are empty, ShippyPro retrieves the sender data automatically from your Nova Poshta account.

Can I delete a Nova Poshta shipment from ShippyPro?

No, shipment deletion is not supported. To cancel a shipment, contact Nova Poshta directly.

Can I deliver to a Nova Poshta branch?

Yes, by entering the branch Ref code in the Recipient Warehouse Ref option. Pickup point search is not available in ShippyPro.

Is Cash on Delivery supported?

Yes. The COD amount is automatically converted into Ukrainian hryvnia (UAH).

Which label formats are available?

PDF A4 and PDF 100x100. ZPL and EPL formats are not supported.

Can I see live rates or book a pickup?

No, live rates and pickup booking are not currently available for Nova Poshta.

Is there a test environment?

No. Nova Poshta has no separate test environment, so shipments created with Test Mode enabled may be real ones.