Errors
pickup_buffer_violation
The pickup is too soon for the minimum notice period.
HTTP 422invalid_request_error
The time is in the future, and it is too soon. The courier needs time to travel to the collection point.
Why it happens
Each zone has a minimum notice period. The default values are:
| Period | Minimum notice |
|---|---|
| Busy period | 20 minutes |
| Other times | 15 minutes |
A fleet can set different values for each zone.
There are two causes:
exact— yourpickupTimeis inside the notice period. Your own times do not remove this rule.deliver_by— Univooz calculates the pickup time from your deadline, and that time is inside the notice period.
How to fix it
- Send a later
pickupTime. - For
deliver_by, send a later deadline. - For the earliest possible collection, send
{ "mode": "asap" }. Univooz obeys the notice period and returns the times inschedule.resolved.
Example response
{
"error": {
"type": "invalid_request_error",
"code": "pickup_buffer_violation",
"message": "Pickup must be at least 20 minutes from now.",
"param": "schedule.pickupTime",
"doc_url": "https://docs.univooz.com/errors/pickup_buffer_violation",
"request_id": "req_01KZCCF8ZH4M7XQ2VB9RSTNPKD"
}
}