Skip to content

Integration with Nova Poshta

R7K12 CRM lets you connect several Nova Poshta accounts.

1. Getting the Nova Poshta API key

Clients who have signed a contract with Nova Poshta can get an API key from their account manager. Everyone else should do the following to create the integration: 1.1 Sign up on the Nova Poshta website, log in to your account and open the “Settings” section. 1.2 In the window that opens, select the “API 2.0” tab. 1.3 Click the “Create a new key” button. 1.4 Accept the terms of the license agreement and click the “Create a new key” button. 1.5 Copy the key and go to the R7K12 website.

Getting the API key in the updated Nova Poshta interface

  1. Log in to the Nova Poshta website with your username and password.

  1. Click the “Log in to the new account” icon.

  1. Open the “Security” tab and click the “Create a new key” button.

  1. Accept the terms of the license agreement by clicking the “Create” button.

  1. Copy the generated key and go to the R7K12 website.

2. Creating the integration in R7K12

2.1 Go to the “CRM” section, then to “Settings”, and select the “Integrations” tab on the right. 2.2 Click the “Create” button on the Nova Poshta icon. Add your accounts (one or more) as (Key name/API key) pairs. Set the required number of waybill copies and click the “Save” button.

3. Mapping Nova Poshta statuses to CRM statuses

The “Statuses” page lists the delivery statuses: Nova Poshta statuses in the left column and user statuses in the right column. Each Nova Poshta status can be matched with any CRM status, which will be shown in the system as the parcel moves. As the example shows, a single CRM status, “Delivering” (right), is set for four shipment statuses (left). For the Nova Poshta status “Arrived at the branch”, the CRM status “Arrived at branch” is specified. So when the product is shipped, the status of its deal will automatically change to “Delivering”. Only when the product arrives at the branch will the status in the CRM change to “Arrived at branch”, and so on.

4. Adding warehouses and addresses

Warehouses or addresses for each Nova Poshta account can be added on a dedicated “Warehouses” page.

5. Default values

For convenience, fill in the default values that will be used when creating deals.