univoozAPI
Orders

Order status

The eight statuses, and who can cancel when.

StatusMeaning
createdUnivooz sent the order to a fleet. No courier yet.
assignedThe fleet selected a courier.
acceptedThe courier accepted the job.
arrived_for_pickupThe courier is at the collection point.
picked_upThe courier has the goods.
arrived_for_deliveryThe courier is at the delivery point.
deliveredComplete. Final.
cancelledCancelled. Final.

The sequence moves forward only.

created means no courier yet and assigned means a courier, not accepted. The two do not overlap, so a filter on each in turn returns every order one time.

Who can cancel, and when

Who cancelsLast status that permits it
You, the businessarrived_for_pickup
The fleetarrived_for_delivery

Why. After picked_up, the courier has the goods. The decision is then not yours only.

If your organization delivers its own orders, you are the fleet for those orders. Your limit is then arrived_for_delivery. For this type of organization, order_not_cancellable usually occurs at delivered.

Nobody can cancel a delivered order. That is a return, and this API has no returns.

cancelled is final. A second cancellation gives an error.

The same rules apply everywhere: this API, the dashboard, and the courier's application.

When you can change an order

Up to and including arrived_for_pickup. After that: order_not_amendable.

Some fields never change. See field_not_amendable.

Charges

Univooz records the charge at creation. Cancellation does not remove it.

Test orders have no charge, at any status.

On this page