Checkbox ↔ Нова Пошта integration

The fiscal receipt is issued when the parcel is on its way, and the delivery status closes the order without a manager

An online store in Ukraine lives between two windows: the Нова Пошта cabinet, where the waybill is created, and the Checkbox cashier, where the receipt is issued. Between them sits a person who copies the order number, weight and amount, and at the end of the day reconciles receipts with parcels. The Checkbox ↔ Нова Пошта pair ties the two events to the order itself: the waybill is created when the order is confirmed, the receipt is issued at the moment agreed with the accountant, and the delivery and payment statuses come back to the order. Below: what moves between the systems, which scenarios we cover and which capabilities of both services we rely on.

Request an integration System page: Checkbox →System page: Нова Пошта →

What moves between the systems

Нова Пошта → CheckboxThe order becomes an express waybill in Нова Пошта at the moment it is confirmed: recipient, branch or parcel locker, weight and declared value are taken from the order, nobody retypes them.
Нова Пошта → CheckboxThe tracking number returns to the order right away and goes to the buyer in the usual notification.
Checkbox → Нова ПоштаThe fiscal receipt is issued in Checkbox at the moment your accountant chooses: on prepayment, on handing the parcel over, or when cash on delivery is received. The link to the receipt is stored with the order.
Checkbox → Нова ПоштаCheckbox itself reports back that the receipt was accepted by the tax office, and the order keeps the receipt number and time.
Нова Пошта → CheckboxDelivery statuses from Нова Пошта — arrived at the branch, received, returned — update the order, and the returned parcel starts the return procedure instead of hanging in the “shipped” status.
Checkbox ↔ Нова ПоштаReceipts and parcels are matched by order number, so the end-of-day report shows at once which shipments have no receipt and which receipts have no shipment.

What we connect

We check that the store has a Нова Пошта business cabinet with a signed service agreement: only such a cabinet can create waybills automatically. A private cabinet is not enough.
You create the Нова Пошта access key yourself in the business cabinet and hand it over; we never ask for the cabinet password.
In Checkbox we start with a test cashier: the first receipts go to the test register, and only after checking with the accountant do we switch to the live one registered with the tax office.
Together with the accountant we agree on the moment of the receipt for each payment method: prepayment on the site, payment at the branch, cash on delivery.
We set up the return flows: receipt confirmation from Checkbox and delivery statuses from Нова Пошта come back to the order in your store or CRM.
We run several real orders end to end — from confirmation to receipt at the branch — and only then switch it on for all orders.

Automation scenarios

Evening rush at the shipping desk

Before the manager creates waybills by hand in the Нова Пошта cabinet for every confirmed order and then issues a receipt for each in Checkbox, and by evening the two lists no longer match.

After the waybill and the receipt are created from the order itself, and the manager only prints the labels.

Cash on delivery and the receipt at the wrong time

Before receipts for cash-on-delivery orders are issued at shipping, and when the buyer does not pick up the parcel the accountant has to cancel receipts by hand.

After for cash on delivery the receipt is issued only when Нова Пошта reports that the parcel was received and paid for.

Returns nobody notices

Before a parcel that was not picked up comes back to the sender's branch, and the order stays “shipped” until someone checks the tracking by hand.

After the “returned” status from Нова Пошта changes the order status and opens the return task the same day.

End-of-day reconciliation

Before the accountant compares the Checkbox receipt list with the Нова Пошта shipment register line by line.

After both are tied to the order number, and the report shows only the mismatches.

How it works technically

For those who want to check: each point links to the official documentation page it comes from.

Nova Poshta's business pages describe automatic creation of an express waybill at the moment an order is placed on the site, plus editing the waybill, ordering a redirect and a return.
Source: novaposhta.ua ↗ checked 2026-09-27
The API key is generated by the client in the business account: Settings → Security → Create key → Get API Key.
Source: novaposhta.ua ↗ checked 2026-09-27
Automating order processing through API integration and the accounting-system module is listed among the capabilities of business clients who have signed a contract with Nova Poshta.
Source: novaposhta.ua ↗ checked 2026-09-27
Webhooks are set up with a POST /api/v1/webhook call, the URL is saved separately per cash register, and the request body is signed with HMAC-SHA256, verified via the x-request-signature header.
Source: wiki.checkbox.ua ↗ checked 2026-09-25
If the integration server responds with an error (code ≥400) or doesn't answer within 10 seconds, Checkbox retries the webhook for up to 24 hours with an exponential backoff (from 1 second to 30 minutes).
Source: wiki.checkbox.ua ↗ checked 2026-09-25
API authorisation uses a JWT token issued via cashier PIN or login/password (not OAuth); a single cashier can hold no more than 3 active tokens at once.
Source: wiki.checkbox.ua ↗ checked 2026-09-25

Limits

On the Нова Пошта side, automatic waybills need a business cabinet with a signed service agreement, which the company signs online with an electronic signature. On the Checkbox side, the test register allows at most 100 receipts a month, so the live register and cashier have to be registered with the tax office before launch, and one cashier can hold at most 3 active access keys. When the receipt is issued for each payment method is an accounting decision: we set it up the way your accountant says, we do not decide it for you.

How to start

Three steps from a first message to work on your project.

01
Leave a request
Describe the task in the form — in text or by voice. Budget and timing are optional.
02
We review and estimate
A developer studies the brief, asks about anything unclear and sends an estimate.
03
We start
Once scope and price are agreed, the work begins.

Leave a request

or write to info@coreviaflow.space

Live project We built and run Gemalli — a B2B export platform with producer pages, a CRM and a deal chat. Read the case →

Questions

Do we need to open a Checkbox register just for this?

No, the pair works with the register you already use. If you do not have one yet, we start with the test register and move to the live one after the accountant registers it with the tax office.

Where does the order live: on the site or in the CRM?

Wherever it lives now. The pair attaches the waybill and the receipt to the order in your store or CRM, and both statuses come back there. If orders are scattered across several places, we agree at the start which one is the main one.

What happens if Checkbox or Нова Пошта is unavailable for a while?

The order does not get lost: the waybill or receipt is queued and created when the service is back, and the manager sees in the order that the step is still pending. Checkbox itself retries its notifications for a day if our side did not answer.

Can the receipt be issued only after the parcel is received?

Technically yes: Нова Пошта reports the “received” status, and the receipt can be issued on that event. Whether this is right for your payment methods is decided by your accountant; we set up whichever moment they choose.