Маршруты

Требуется разрешение routes:read.

GET /api/public/v1/routes/?status=active&date=2026-07-31
GET /api/public/v1/routes/{id}/

Маршруты доступны только для чтения. Создать или изменить маршрут через API нельзя — только через планирование. Ручные правки (перестановка точек, перенос заказа) выполняются диспетчером в интерфейсе.

Фильтры: status и date. Статусы маршрута: planned, active, completed, archived, cancelled.

Список возвращает сводные данные: id, name, status, date, has_vehicle, planned_mileage_km, planned_duration_min, actual_start_at, actual_end_at, total_weight_kg, total_volume_m3.

Карточка маршрута дополнительно содержит точки (stops):

{
  "id": 9042,
  "name": "Маршрут 1 — Минск Центр",
  "status": "active",
  "date": "2026-07-31",
  "planned_mileage_km": "63.80",
  "planned_duration_min": 214,
  "stops": [
    {
      "id": 71205, "position": 1, "stop_type": "order", "status": "pending",
      "order_id": 118234, "order_external_id": "РН-000123",
      "address": "г. Минск, пр. Независимости, 154",
      "lat": "53.936120", "lon": "27.653890",
      "eta": "2026-07-31T06:47:00Z",
      "planned_arrival_at": "2026-07-31T06:47:00Z",
      "planned_departure_at": "2026-07-31T07:02:00Z",
      "actual_arrival_at": null, "actual_departure_at": null
    }
  ]
}

Поле order_external_id содержит ваш номер документа — по нему сопоставляйте точки маршрута с накладными в своей системе.

Типы точек (stop_type): order — заказ, start_depot / mid_depot / end_depot — склад. Статусы точки: pending, in_progress, visited, confirmed, rejected, skipped.

Поле eta — то же, что planned_arrival_at. До построения маршрута обе пустые.

В текущей версии в ответе нет идентификатора машины и данных водителя.