We’ve updated Cartum’s integration with Nova Post. From now on, when processing an order, store managers will be able to create an international electronic waybill (IEW) in the admin panel for international delivery. After the IEW is created, the order status will be updated based on the waybill number.
You can set up the updated integration in Settings → Shipping methods and carriers → the delivery option Nova Post - Novapost.
How does the integration work?
When selecting the Nova Post delivery option at checkout, the customer will be able to choose a branch in their city.
When processing an order, the store administrator will be able to quickly create a waybill for international delivery. The order status will be tracked automatically based on the IEW number.
Which countries is the updated integration available for?
At the moment, the updated integration works for a limited list of countries, but we will expand this list over time.
The integration is available in the Czech Republic, Germany, and for shipments from/to Ukraine to/from these countries.
At this stage, automatic waybill creation is available only for branch delivery. For courier delivery, you can set up a separate option with city and delivery address selection.
Please note: some products may be subject to customs clearance requirements and duty payment. Some products may be prohibited for international shipments.
Nova Post business account
The sender’s business account is available at the following links:
Activating the Nova Post integration
To activate the integration, you need to obtain an API key from Nova Post.
How to generate an API key
Log in to the business account.
Go to Integrations.
In the API Keys section, click Create API key.
Ukrainian senders can use the same API key that is used to connect the Nova Poshta delivery option within Ukraine.
Integration setup
In Cartum’s admin panel:
Go to Settings → Shipping methods and carriers and select Nova Post - Novapost.
Make sure that the Type field is set to Novapost.
Select the checkbox Enable shipment document creation. After that, additional fields will appear in the settings.
Enter your API key in the appropriate field.
For shipments and receipts in the EU from countries outside it, enable Enable EU–Ukraine export/import fields in products
Fill in the Default settings.
Save the changes.
Please note: for Moldova and Italy, you can create a separate simplified delivery option with the type Nova Poshta - International delivery, leaving the Enable the ability to create waybills checkbox unchecked. Customers from these countries will also be able to select a branch from the list at checkout, but you will need to create waybills manually.
Default settings
These settings will be applied by default to all created IEWs. When processing a specific order, you can change any of these values.
In the default settings, specify the shipping data:
Enable EU–Ukraine export/import fields in products — if the checkbox is selected, you can specify additional import/export parameters for the EU when editing a product;
Note to order — these can be delivery instructions, requests for special handling, or other important details that help with processing and delivery;
Sender country currency;
Delivery payer — receiver, sender, or a third party;
Payer of customs fees — receiver, sender, or a third party;
Delivery payer contract number — a required field if a third party is selected as the delivery payer.
For certain routes where cash on delivery is available, you additionally need to fill in:
Bank account number — tax ID of a sole proprietor or legal entity (EDRPOU / TIN / NIP / etc.);
Bank account name — IBAN;
Commission payer — available values: receiver or sender.
Other shipment data:
Cargo type — parcel or documents;
Parcel description — shipment description: you need to specify the product categories in the cargo. By default, the value is Items.
Default shipment dimensions block:
Dimensions (width), mm — width in millimeters;
Dimensions (length), mm — length in millimeters;
Dimensions (height), mm — height in millimeters;
Actual weight, g — weight in grams.
Default sender details
Fill in the default sender details; they may vary depending on the selected sender type and the shipping country.
Customer type — available values: Privat person, Sole proprietor, or Legal entity.
For an Privat person, you need to fill in:
Sender phone;
Email;
Sender's full name.
For a Sole proprietor, you need to specify:
Taxpayer identification number (EDRPOU, TIN, NIP);
Legal company name;
EORI — a unique identification number in the EU, required for companies and sole proprietors engaged in importing, exporting, or transiting products across EU borders;
IOSS — One Stop Shop identifier. Sellers who have registered in the IOSS system can pay VAT in the destination country instead of buyers;
Sender phone;
Email;
Sender's full name.
For a Legal entity, you need to specify:
Taxpayer identification number (EDRPOU, TIN, NIP);
Legal company name;
EORI — an optional field; a unique identification number in the EU, required for companies and sole proprietors engaged in importing, exporting, or transiting products across EU borders;
IOSS — an optional field; One Stop Shop identifier. Sellers who have registered in the IOSS system can pay VAT in the destination country instead of buyers;
Sender phone;
Email;
Sender's full name.
And other sender and shipment details:
Sender country;
Sender city;
Sender branch;
Shipping method — from post office or from an address;
Incoterm — DAP or DDP, indicates the trade terms of the transportation agreement between the buyer and the seller based on the selected standard Incoterms rules.
Product information
If you selected the option Enable EU–Ukraine export/import fields in products, new parameters to fill in will appear in the product editor.
This data is required to create an IEW for shipments to/from the EU from other regions. If, when trying to create an IEW for certain products, the data is missing, you will see an error message with links to the products for which information is missing.
You can fill in the fields either manually for individual products or in bulk via the import table or via the API.
What data needs to be filled in for a product when shipping EU → other regions?
Manufacturer and model — required for electronic equipment;
Material — in the site’s primary language;
Material (eng) — in English;
Weight, g — the actual product weight with 10 g precision. Values that are not divisible by 10 will be rounded down to the nearest lower multiple of 10 g;
Packaging type — possible options: box or pallet;
Manufacturer country code — select from list, the country-of-manufacture code required to determine import duties and verify compliance with trade agreements;
Units of measurement — choose from an exhaustive list (pieces, kilograms, meters, centimeters, and grams);
UCT ZED (in the international classification — HS code) — a code from the international product classification used in international trade.
Selecting the Nova Post delivery option at checkout
If you ship orders from the Czech Republic, Germany, or Ukraine, and the customer selected one of these countries at checkout, then when placing the order they will be able to choose their city and a convenient branch from the dropdown list.
Creating a Nova Post IEW when processing an order
If the country to which the order is being shipped meets the integration requirements, then when processing the order you will see the fields required to create a Nova Post IEW.
The data you need to fill in may differ depending on whether the shipment is within the EU or is import/export to/from the EU.
Fill in the required fields in the International shipping settings block.
If the shipment will be from or to the EU, and the products do not contain all the necessary data for customs control, you will see the error Fill in the required customs fields with a list of products where the corresponding data is missing.
For each order, you can change in the IEW the data specified in the default delivery method settings.
Calculating and printing the waybill
After filling in all the data, you can generate and print the IEW
After the IEW is created, order statuses will be updated according to the shipment status — In transit, Delivered, Not delivered.