Why Your Business Needs This Integration

• Faster shipping: waybill data is filled out in a single process without unnecessary copying.
• Fewer errors: selecting the city and branch via search reduces the risk of incorrect details.
• Standard control: the team works according to a unified delivery processing scenario.
• Manager time savings: key sender fields are saved and reused.

What's on the 'Integrations / Nova Poshta' Page

1. API Key Block - key field and "Save" button.
2. Verification Block - "Test Connection" button.
3. City and Branch Search - helps select the correct sender data.
4. Sender Settings - saving city, branch, counterparty, contact, and phone.
5. Waybill (draft/test) - form for quick waybill creation.

Step 1. Connecting the API

In the API Key (Nova Poshta) field, insert the key from your Nova Poshta account and click "Save".

What the "Save" button does: saves the key in the system so CatPro can make requests to Nova Poshta.

Step 2. Testing the Connection

Click "Test Connection".

What the "Test Connection" button does: checks if the API is accessible and if the key is working correctly.

• If everything is fine, you will see a successful test message.
• If there is a problem, the system will suggest what needs to be checked (key or access).

Step 3. Configuring the Sender

This step needs to be done once, after which the data will be used for waybill creation.

1) City

• Start typing the name in the "City" field.
• Select the correct option from the list.

2) Branch/Post Office

• Enter the number or part of the name in the "Branch/Post Office" field.
• Click "Find" and select the desired branch.

What the "Find" button does: shows available branches for the selected city.

3) Sender (Counterparty)

• Click "Update" next to the sender field.
• Select your sender from the list.

What the "Update" button does: loads the current list of senders from your Nova Poshta account.

4) Nova Poshta Contact Person

• Click "Download" in the contacts block.
• Select the desired contact.
• Fill in the sender's name and phone fields (if needed).

What the "Download" button does: fetches contacts for the selected sender.

5) Saving

Click "Save Sender".

What the "Save Sender" button does: records the selected sender details for future waybill creation.

Step 4. Creating a Waybill (draft/test)

In the waybill block, fill in the recipient's details and shipment parameters:

• Recipient's full name and phone number.
• Recipient's city.
• Recipient's branch (via the "Find" button).
• Weight, declared value, number of items, description.
• Payment type, delivery payer, cash on delivery (if needed).

After filling in, click "Create Waybill (test)".

What the "Create Waybill (test)" button does: creates a draft waybill and returns the result in the lower block.

Quick Scenario for Managers

1. Save the API key.
2. Run the "Test Connection".
3. Configure the sender once.
4. Create waybills for shipments using the same scenario.

What This Provides for the Team

• A unified delivery processing standard among managers.
• Fewer manual actions and lower risk of errors in details.
• Faster order preparation for shipment.
• A transparent and repeatable process for scaling the business.