Ukrposhta CRM integration
X10 CRM books Ukrposhta shipments straight from the lead card, resolves the postcode from the recipient's address, prints the paperwork and keeps parcel statuses current.
Recipient, address, weight and the cash-on-delivery amount come from the lead and its cart.
For door delivery the CRM looks the postcode up per building, not per street.
A mistaken shipment can be cancelled from the CRM while the branch has not accepted it yet.
The CRM tells a return from a completed delivery, so refusals never inflate your sales numbers.
Ukrposhta is cheaper than express delivery and reaches towns other carriers skip, which makes it the second mandatory channel for Ukrainian ecommerce. X10 CRM drives it from the same lead card and the same form as Nova Poshta, so the team never learns a second interface.
#What the integration gives you
- Shipments from the lead card — recipient, address or branch, weight and description are taken from the lead and its cart.
- Cash on delivery — the amount due is calculated from the cart, exactly as for the other carriers.
- Printable forms — the paperwork opens as a single file, including for a whole batch.
- Cancellation — a shipment that has not been registered yet can be voided straight from the CRM.
- Automatic tracking — statuses refresh on a schedule and move the lead through the funnel.
- Street and branch lookups — Ukrposhta's directories are available inside the form.
#Postcodes instead of branch numbers
The main difference from express carriers: Ukrposhta addresses everything by postcode. For branch delivery that is the branch's own code; for door delivery it is the code of the specific building.
#Returns stay separate from completed sales
Ukrposhta reports a return and a hand-over as very similar events, and a naive integration collapses them into one status. X10 CRM separates them during tracking, so a return becomes a refusal in the funnel, the goods go back into stock, and your conversion figure stays honest.
| Ukrposhta event | What the CRM does |
|---|---|
| Shipment accepted | Lead marked as shipped, stock written off |
| Arrived at the branch | SMS reminder to the customer can be triggered |
| Handed to the recipient | Lead moves to paid, the amount enters your statistics |
| Returned to sender | Lead moves to rejected, the goods return to stock |
Ukrposhta tracking runs on the same schedule as Nova Poshta — several times a day during working hours.
#What you need to connect it
- A contract with Ukrposhta and access to the Ecom cabinet
- A counterparty token and a tracking key — Ukrposhta issues these separately
- The recipient's address or branch filled in on the lead
- Status transition rules, if you want tracking to drive the funnel automatically
Delivery works the same way for every carrier in the CRM, so the step-by-step guide is shared: delivery setup. The rules by which tracking moves the pipeline are configured in statuses, groups and transitions, and batch printing in bulk actions on leads.
#Alongside the other carriers
Carriers in X10 CRM share one contract: one waybill form, one history, one tracker. Ukrposhta is usually enabled next to Nova Poshta and Meest, with the operator picking the carrier inside the lead depending on the destination and the order value.
Frequently asked questions
- What do I need to connect Ukrposhta to the CRM?
- A contract with Ukrposhta and the credentials from its cabinet: the Ecom key, a counterparty token and a tracking key. They are entered once on the delivery settings page and the CRM handles the rest.
- Can shipments go to a street address rather than a branch?
- Yes. For door delivery the CRM resolves the postcode for the specific building through Ukrposhta's address classifier, so the parcel is not routed to a neighbouring district's code.
- Is cash on delivery supported?
- Yes. The amount due comes from the lead's cart, exactly as with Nova Poshta and Meest.
- Can a mistaken waybill be cancelled?
- Yes, as long as the shipment has not been registered on Ukrposhta's side. Cancellation happens from the lead card and is recorded in its history.
- Does the CRM distinguish a return from a successful delivery?
- Yes. A return is its own status rather than "delivered": the lead moves to rejected, the goods go back into stock, and the conversion rate is not overstated.
- Can Ukrposhta and Nova Poshta be used at the same time?
- Yes. The carrier is chosen per lead, while the waybill form, shipment history and tracking are shared across all carriers.