Что нового

2026-10-27

Порядок точек доставки

Новое поле dropoff_order в POST /quotes и POST /orders выстраивает точки доставки в кратчайший маршрут от точки забора: optimized — все точки, optimized_keep_last — все, кроме последней, которая остаётся последней. По умолчанию — given: курьер объезжает точки в переданном порядке, как и раньше.

Порядок объезда приходит в новом поле visit_order. tracking_urls, dropoffs в расчёте стоимости и index в PATCH по-прежнему следуют вашему порядку точек.

См. Заказы.

2026-10-26

Сколько стоит размер груза

Новый метод GET /cargo-sizes показывает, сколько каждый размер груза добавляет к цене доставки и до какого веса он рассчитан. Суммы — для города вашей компании.

{
  "cargo_sizes": [
    { "cargo_size": "S",  "surcharge": 0,   "max_weight_kg": 10 },
    { "cargo_size": "M",  "surcharge": 50,  "max_weight_kg": 20 },
    { "cargo_size": "L",  "surcharge": 100, "max_weight_kg": 40 },
    { "cargo_size": "XL", "surcharge": 150, "max_weight_kg": null }
  ]
}

Здесь доставка груза размера M стоит на 50 ₽ дороже, чем S, на любом расстоянии. В ответе POST /quotes эта сумма теперь видна у каждой точки доставки в поле cargo_surcharge.

См. Стоимость.

2026-10-16

Тарифы по городам

Govza работает в нескольких городах, и у каждого свой тариф. POST /quotes считает поездку по тарифу города, в котором забор, а GET /pricing отдаёт тариф города вашей компании.

См. Стоимость.

2026-10-05

Проверка доступности

POST /availability при оформлении заказа отвечает, может ли Govza взять доставку прямо сейчас: входят ли точки в зону обслуживания, есть ли свободный курьер рядом с точкой забора и как скоро он до неё доберётся.

{
  "available": true,
  "pickup": { "in_service_area": true },
  "dropoffs": [{ "in_service_area": true }],
  "couriers": { "status": "available", "pickup_eta": 6 },
  "reasons": []
}

См. Доступность.

2026-09-20

Причина отмены в вебхуке

Событие order.cancelled теперь содержит причину и комментарий отмены:

{
  "event": "order.cancelled",
  "status": "cancelled",
  "cancellation": { "reason": "address_related", "comment": null }
}

Для остальных событий поле cancellation равно null. См. Webhook.

Больше данных в ответах о заказе

Ответы POST /orders, GET /orders, GET /orders/{external_order_id} и PATCH/PUT/cancel дополнены тремя полями:

• delivered_at — момент завершения заказа;
• driver — имя, телефон и транспорт курьера (появляется после назначения);
• driver_location — последнее местоположение курьера, только в статусах assigned и in_progress и только если оно обновлялось за последние 30 минут.

{
  "status": "in_progress",
  "delivered_at": null,
  "driver": { "name": "Иса", "phone": "+79280003396", "transport": { "model": "Camry", "number": "A123BC" } },
  "driver_location": { "latitude": 43.2389, "longitude": 45.7127, "heading": 120, "updated_at": "2026-09-18T08:27:00.000Z" }
}

См. Заказы.