How to get a Nova Poshta API key
If KeyCRM is connected and «Грошовий переказ» (cash on delivery) is a payment method of its own there, choose “Do not sync” for that KeyCRM account. Otherwise the same revenue is counted twice: from KeyCRM and from Nova Poshta. A Nova Poshta key is valid for a year: when it expires, create a new one and replace it here.
- In finiq, open “Integrations” → “Registers, CRM & payments”, find the Нова пошта card and click “Connect”.
- Sign in to the Nova Poshta business account of the sender (sole proprietor or company) that ships cash-on-delivery parcels.
- Open «Налаштування» (Settings) → «Безпека» (Security) and click «Створити ключ» (Create key) under «Мої ключі API». Copy the key whose «Сервіс» column says «Бізнес-кабінет».
- Paste the key below. finiq only reads your waybills and their statuses and never creates or changes anything at Nova Poshta.
- Click “Check and continue”: finiq checks the access and shows the accounts.
- For each account, choose “New account”, “Existing account” or “Do not sync”.
- In “Load history for”, choose the number of months and click “Start syncing”. Transactions appear gradually.
Open the Nova Poshta account ↗
Good to know
- The «Нова пошта · накладені платежі» account shows the money Nova Poshta has collected from buyers and not yet paid out to you. A buyer picks up a parcel — income of the cash-on-delivery sum, dated when picked up, with the waybill number and the recipient’s name. Nova Poshta pays the money transfer out — an outflow of the paid sum from this account: mark it as a transfer to the cash desk, card or bank account the money reached (finiq offers the pair with the same sum). A commission kept from you is an expense of its own. Refusals, returns and parcels on the way book nothing: the money is still with the buyer.
- One account of the «E-wallet» type. NovaPay pays «Контроль оплати» out in a pool — one sum for several parcels — so the payout is not visible per waybill: your NovaPay or bank statement shows it. Mark that deposit as a transfer from this account (easiest with an auto-rule «Purpose contains …» → «Transfer»). If less arrives than the parcels’ sum, the difference is the commission: add it as an expense from this account.
- Parcel and payout statuses change for weeks, so every sync reads again the waybills created in the 60 days before it. Parcels picked up before the history starts are left out, together with their payouts. A year of history of a large shop can take a few minutes to load.
- A cash register, CRM or payment service connects with an access key: order payments and sales become operations automatically every 30 minutes, buyers become counterparties, and auto-rules work just as for banks. The key is stored encrypted.
- The key is encrypted and never shown in full; disconnecting the integration deletes it.
Who can do this. The owner, admins and financiers connect cash registers, CRMs and payment services.