Yes. Krokul CRM integrates with Ukrposhta through the eCom API. A manager creates a shipment right from the deal card, and Krokul sets up the address and recipient in Ukrposhta, returns the barcode and updates the parcel status on the deal by itself.
A manager opens the deal and clicks «Ship with Ukrposhta». Krokul takes the name, phone and address from the deal contact and creates an address (/addresses), a recipient client (/clients) and a shipment (/shipments) in Ukrposhta, in exactly the order the documentation requires. The barcode appears in the deal shipment and in the deal feed.
For payment on receipt, the manager enters the amount, and Krokul passes it in the postPay field of the shipment. Ukrposhta accepts a postPay no higher than declaredPrice, so Krokul sets the declared value to at least this amount. Krokul reads the state of the cash on delivery transfer from /transfers/shipment-postpays/{barcode}/with-recipient and closes the payment on the deal when the money has been transferred.
On a schedule, Krokul reads /shipments/{barcodeOrUuid}/lifecycle for every active barcode. Statuses such as IN_DEPARTMENT or DELIVERED appear in the deal feed, and a company rule moves the deal to the right stage. The manager sees where the parcel is without opening tracking separately.
When a shipment gets the RETURNING status, Krokul creates a task for the owner with the deal and the barcode. The manager has time to call the client while the parcel travels back, and the RETURNED status records on the deal that the goods have come back.
The manager prints the shipment address label from the deal card. To hand several parcels over at a branch, Krokul collects the selected shipments and gets the accompanying form 103a from the Ukrposhta forms service, which the warehouse prints as one file.
| Ukrposhta | Direction | Krokul | When |
|---|---|---|---|
Address (/addresses) and recipient client (/clients) | Krokul → Ukrposhta | Deal contact: name, phone, address | A manager creates a shipment |
Shipment (/shipments): weight, declaredPrice, postPay, deliveryType | Krokul → Ukrposhta | Deal shipment and cash on delivery amount | Right after the recipient is created |
| Shipment barcode | Ukrposhta → Krokul | Shipment in the deal card, deal feed | In reply to the shipment creation |
Lifecycle (/lifecycle): IN_DEPARTMENT, DELIVERED, RETURNING, RETURNED | Ukrposhta → Krokul | Shipment status, feed entry, deal stage | Krokul polls on a schedule while the shipment is active |
| RETURNING status | Ukrposhta → Krokul | Task for the owner | The shipment travels back to the sender |
| Cash on delivery transfer | Ukrposhta → Krokul | Actual deal payment | When Ukrposhta has transferred the money |
| Address label and form 103a | Ukrposhta → Krokul | Print buttons in the shipment and in the shipment register | When a manager or the warehouse asks for it |
card.won or card.statusChanged event filtered by stage. Each delivery carries the x-crm-signature header, which you check with your secret.card/api-read.externalRef/api-upsert, and write the statuses from /lifecycle to the deal feed through activity/api-create.Yes. Krokul takes the recipient from the deal contact, creates the address, client and shipment in Ukrposhta and shows the barcode in the deal shipment.
Krokul polls the shipment lifecycle by barcode itself, because Ukrposhta sends no events. The DELIVERED status is recorded on the deal, and polling for that shipment stops.
A contract with Ukrposhta. Under it, your account manager issues a bearer for eCom and for StatusTracking, a counterparty token and separate test environment values, which your flow or the Krokul connection to Ukrposhta uses.
Yes. The cash on delivery amount goes to the postPay field, and when Ukrposhta has transferred the money, Krokul records an actual payment on the deal.
Ukrposhta sends no status change events, so Krokul reads the shipment lifecycle on a schedule. Ukrposhta grants API access under a contract, and the keys for the live and test environments are different.
Tell us which service you use and what should move between it and Krokul. We reply with the way to do it and when it will be ready.
Request received. We reply to your email.
Ukrposhta is a trademark of its owner. Krokul is not affiliated with Ukrposhta.