Integration with Ukrposhta — is an additional Torgsoft option that allows you to create waybills (TTNs), print labels, and track Ukrposhta parcel statuses directly in the accounting program, without switching to a separate account on the postal service website.
The option is useful for online stores and retail outlets that send orders by post throughout Ukraine, including settlements where other carriers have limited coverage. Without integration, the manager manually transfers customer data to the postal service account, creates a TTN, and copies its number back into the program. For every order, this means extra actions and a risk of mistakes in the address or amount.
With the option, a TTN is created in a few clicks directly from the expense invoice based on the customer data already available. Standard and Express shipments, cash on delivery, declared value, and SmartBox boxes are supported. Parcel statuses can be updated automatically on a schedule if you configure the mass update task for Ukrposhta TTNs. If delivery or the cash-on-delivery commission is paid by the sender, Torgsoft can automatically create a financial expense based on the invoice. The license is valid for 1 year.
Ukrposhta TTNs directly from the accounting program
Creating, printing, and tracking Ukrposhta parcels in one Torgsoft window.
What integration with Ukrposhta is
Integration with Ukrposhta is data exchange between Torgsoft and the Ukrposhta service via API. The program sends shipment parameters to the postal operator and receives a declaration number, while movement statuses are pulled during tracking — after the parcel actually starts moving in the Ukrposhta system. This allows you to perform all shipment actions in the familiar expense invoice window instead of a separate account.
Basic concepts
TTN
A waybill is an electronic shipment document created in Torgsoft and registered on the Ukrposhta server.
Cash on delivery
The amount the recipient pays when receiving the parcel. It is pulled automatically from the expense invoice.
API keys
A set of keys from Ukrposhta (BEARER, StatusTracking, COUNTERPARTY TOKEN, and COUNTERPARTY UUID) that gives the program the right to work with the service.
SmartBox
Ukrposhta branded boxes with fixed payment. Entering the barcode is enough — dimensions and weight are not required.
Form 103a
An accompanying form for a group of shipments, printed from the program when parcels are handed over at the branch.
Transfer to account
Crediting cash-on-delivery payments directly to the sender's current account. Available for legal entities and FOPs.
Who this option is for
Online stores
Many delivery orders every day. A TTN is created from the invoice, and customer data does not need to be entered again.
Retail outlets with delivery
Stores that send goods to regions where Ukrposhta branches are closer or more convenient than other carriers.
Marketplace sellers
Orders from Prom.ua and similar platforms. The recipient card and address are pulled automatically.
Businesses with returns
Clothing, footwear, equipment. Return delivery via Ukrposhta is often cheaper than through other services.
Who does not need it. If you work only in a retail store without postal delivery or send individual parcels once a month — Ukrposhta's website account will be enough. The option is justified where there are many shipments and processing speed matters.
When to connect it immediately
- You regularly send orders by post and manually create TTNs in the account.
- You often work with cash on delivery and want amounts to be filled in automatically.
- You need to see all parcel statuses in one place without visiting the postal service website.
- As a FOP or legal entity, you want to receive cash-on-delivery payments directly to your current account.
What tasks the option solves
What it looks like before and after
Before
The manager copies the full name, phone number, and address from the program, opens the Ukrposhta account, manually creates a TTN, prints a label, and enters the declaration number back into the invoice. Statuses are checked one by one on the website.
After
The TTN is created from the invoice in a few clicks, the label is printed immediately, and the declaration number is added to the invoice automatically. The statuses of all parcels are updated on schedule and visible directly in the list.
How it works: 5 steps
Connecting keys. Get API keys from your Ukrposhta manager and enter the counterparty and sender in the menu «Settings — Parameters — Additional functions — Synchronization with Ukrposhta».
Creating a TTN. In the «Trade with invoice issuing» mode, on the invoice form in the «Delivery parameters» tab, click «Work with TTN» and select «Ukrposhta — Create new TTN».
Shipment parameters. Specify the delivery type (Warehouse-Door, Warehouse-Warehouse, Door-Warehouse, Door-Door), invoice type «Standard» or «Express», dimensions, and weight. For SmartBox, the box barcode is enough.
Finances and actions in case of non-delivery. If necessary, enable cash on delivery, cash-on-delivery transfer to an account, and the non-delivery scenario: «Return to sender», «Return after free storage», or «Do not return».
Printing and tracking. The program will print the label and, for a group, form 103a. The parcel status is visible in the «Ukrposhta tracking» window, and mass updating is configured in «Scheduled tasks».
Important. The option requires an internet connection. Status tracking starts working only after the TTN is actually registered at the branch and the parcel has been handed over to the operator.
Try the Ukrposhta integration in your business
Download the Torgsoft demo version free for 30 days and check how TTNs are created directly from the invoice. The data remains on your computer.
Option capabilities
Scenarios by niche
Clothing and footwear store
Many fittings mean many returns. Return delivery via Ukrposhta is often cheaper, so the seller can offer the customer favorable return terms and create all TTNs from the invoice.
Store on Prom.ua
Orders come from the platform, and the recipient card and address are pulled automatically. The manager only checks the data, creates a TTN, and prints the label — the postal service account is not needed.
Delivery to small settlements
Where other carriers have limited coverage, Ukrposhta remains the main channel. The option helps keep such shipments under control together with all the others.
Example
This example is illustrative. An online store sent about forty orders a day and manually created TTNs in the Ukrposhta account. Each shipment took several minutes of data copying, and address errors occurred.
After connecting the option, TTNs began to be created from the expense invoice, cash on delivery was set automatically, and parcel statuses were updated on schedule every morning. The manager stopped visiting the postal service website, and problem parcels became immediately visible by the icons in the invoice list.
Which options and equipment it works with
- Integration with Nova Poshta. A second postal service in the same «Work with TTN» window.
- Synchronization with Prom.ua. Pulls orders and recipient data from the marketplace.
- Inventory accounting. Stock control for the same goods you send.
- Label printer or a regular printer — for printing Ukrposhta labels and form 103a.
- Barcode scanner — for quickly entering the SmartBox box barcode.
Comprehensive automation. Together with order accounting, postal integrations, and financial accounting, Torgsoft keeps the entire order path — from sale to shipment and payment — in one database.
Price and connection terms
- Licenses. The option is available for Torgsoft Ultra and Torgsoft Terminal.
- Connection. The option is purchased for each workstation for separate versions, or one per local network, or one per terminal license server. Available from Torgsoft® version 2020.0.0 and newer.
- Demo version. Free for 30 days — can be activated in the menu «Settings — List of additional functions».
How to connect
- Leave a request or write to a Torgsoft representative in your region.
- Receive an activation code and activate the option in the menu «Settings — List of additional functions».
- Enter the API keys from Ukrposhta and the sender — and create your first TTN.
Frequently asked questions
What integration with Ukrposhta in Torgsoft provides
The option allows you to create TTNs, print labels, and track Ukrposhta parcel statuses directly from the accounting program, without switching to the account on the postal service website.
Can cash-on-delivery payments be received to a bank account (IBAN)
Crediting cash-on-delivery payments to a current account is available only to legal entities and FOPs with an agreement with Ukrposhta. For a sender with individual status, this field is hidden.
Why the TTN status does not update immediately after creation
Tracking starts working only from the moment the TTN is actually registered at the branch and the parcel is handed over to the operator. While the parcel is still in your warehouse, it is impossible to receive a status from the postal service server. Tracking data is stored in the Ukrposhta system for 6 months.
Do dimensions need to be entered for SmartBox
No. For SmartBox shipments, it is enough to enter or scan the box barcode — the parameters will be applied automatically. The declared estimated value for SmartBox must not exceed UAH 1000.
Can a TTN be corrected after creation
Yes. The program allows editing TTNs that have not yet been sent (not handed over to the postal service), including SmartBox. After the parcel has actually been handed over, editing is unavailable.
How to make sure the manager does not forget cash on delivery
This is automated. If the cash-on-delivery mark is set in the «Trade with invoice issuing» mode, the checkbox in the Ukrposhta shipment will be selected automatically.
Why an error occurs with the «Do not return» action
For shipments without return upon non-delivery, shipping must be paid by the sender. If the settings specify that delivery is paid by the recipient, the program will not allow «Do not return» to be applied.
Are delivery expenses recorded in accounting
Yes, if your store pays for shipping or the cash-on-delivery commission. In this case, you enable «Create expense by invoice», and the amount is written off from the selected cash desk or account. If everything is paid by the recipient, no expense is created.
Which licenses does the option work with
The option is available for Torgsoft Ultra and Torgsoft Terminal licenses. Available from Torgsoft® version 2020.0.0 and newer.
Is it difficult to add a new recipient
The recipient forms are simplified: you can create a customer and enter the delivery address with a minimum number of actions from one dialog window, without unnecessary menu navigation.
Go back to the previous step