--- metadata: - name: generator content: Diplodoc Platform v5.52.0 alternate: - https://yandex.kz/routing/doc/en/delivery/functions/courier-breaks.md - https://yandex.kz/routing/doc/kk/delivery/functions/courier-breaks.md - https://yandex.kz/routing/doc/ru/delivery/functions/courier-breaks.md - href: ru/delivery/functions/courier-breaks.md type: text/markdown title: Markdown version - href: ../llms.txt type: text/markdown title: llms.txt title: Яндекс Маршрутизация — функции — перерывы в работе курьера --- > **Documentation Index:** Fetch the complete configuration index at https://yandex.kz/routing/doc/ru/llms.txt # Перерывы в работе курьера Перерывы в работе курьера можно задавать не только при [планировании](https://yandex.kz/routing/doc/ru/vrp/properties-of-vehicles-rest-schedule.md#rest-schedule), но и после передачи маршрутов в Мониторинг и даже в процессе выполнения маршрута. На [карте](https://yandex.kz/routing/doc/ru/delivery/interface/map.md) перерывы не отображаются, но учитываются при [расчете ETA](https://yandex.kz/routing/doc/ru/delivery/functions/eta.md). ## Добавить перерыв {#add-break} Чтобы добавить курьеру перерывы в маршрут, отправьте POST-запрос к ресурсу [work_breaks](https://yandex.ru/routing/doc/ru/delivery/redoc/index.html#operation/addsWorkBreaks). В запросе укажите `company_id` и `route_id` — ID компании и ID маршрута. В теле запроса укажите: * `rest_duration_s` — длительность перерыва в секундах (минимальное значение: 1); * `work_time_range_till_rest` — время работы до отдыха, формат: [D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]]. #### Запрос {#add-request} cURL ```html curl -H "Content-Type: application/json" -H "Authorization: OAuth <ваш-токен>" -X POST -d @<Путь_до_файла_в_кодировке_UTF-8> https://courier.yandex.ru/api/v1/companies//routes//work_breaks ``` Файл ```json { "work_time_range_till_rest": "01:00:00-01:30:00", "rest_duration_s": 3600 }, { "work_time_range_till_rest": "02:30:00-03:00:00", "rest_duration_s": 1800 } ``` #### Результат {#add-result} ```json { "break_id": 1, "sequence_pos": 0, "work_time_range_till_rest": "01:00:00 - 01:30:00", "rest_duration_s": 1800 }, { "break_id": 2, "sequence_pos": 1, "work_time_range_till_rest": "02:30:00 - 03:00:00", "rest_duration_s": 1800 } ``` ## Получить информацию о перерывах {#get-break} Чтобы получить информацию о перерывах курьера на маршруте, отправьте GET-запрос к ресурсу [work_breaks](https://yandex.ru/routing/doc/ru/delivery/redoc/index.html#operation/getsWorkBreaks). Возможны следующие статусы перерывов: * `planned` — запланирован; * `started` — начался; * `finished` — завершился. #### Запрос {#get-request} cURL ```html curl -H "Content-Type: application/json" -H "Authorization: OAuth <ваш-токен>" -X GET -d https://courier.yandex.ru/api/v1/companies//routes//work_breaks ``` #### Результат {#get-result} ```json { "id": 1, "sequence_pos": 0, "work_time_range_till_rest": "01:00:00 - 01:30:00", "rest_duration_s": 3600, "status": "planned", "start_at": 1769743980 }, { "id": 2, "sequence_pos": 1, "work_time_range_till_rest": "02:30:00 - 03:00:00", "rest_duration_s": 1800, "status": "planned", "start_at": 1769802180 } ``` ## Удалить перерыв {#delete-break} Чтобы удалить перерыв, отправьте DELETE-запрос к ресурсу [work_breaks](https://yandex.ru/routing/doc/ru/delivery/redoc/index.html#operation/deletesWorkBreak). #### Запрос {#delete-request} cURL ```html curl -H "Content-Type: application/json" -H "Authorization: OAuth <ваш-токен>" -X DELETE -d https://courier.yandex.ru/api/v1/companies//routes//work_breaks/ ``` #### Результат {#delete-result} ```json { "id": 1, "sequence_pos": 0 } ``` ## Пример бизнес-кейса {#example} **Что требуется сделать** Нужно добавить несколько перерывов курьеру после того, как он начал движение по маршруту, и отследить, как это повлияет на [ожидаемое время прибытия](https://yandex.kz/routing/doc/ru/delivery/functions/eta.md) `estimated_service_time` (ETA) по заказам. **Как реализовать сценарий** 1. Чтобы получить актуальную информацию о маршруте, отправьте запрос к ресурсу [route-info](https://yandex.ru/routing/doc/ru/delivery/redoc/index.html#operation/getsRouteInfo). Для заказа с `id` = `410522528` ETA составляет 16:38. {% cut "Пример запроса" %} cURL ```html curl -H "Content-Type: application/json" -H "Authorization: OAuth <ваш-токен>" -X GET -d https://courier.yandex.ru/api/v1/companies//route-info?route_id= ``` {% endcut %} 2. Запланируйте два перерыва по 10 минут: * первый — не позднее чем через 40 минут работы; * второй — не позднее чем через 70 минут работы. Для этого отправьте запрос к ресурсу [work_breaks](https://yandex.ru/routing/doc/ru/delivery/redoc/index.html#operation/addsWorkBreaks) и задайте время работы до отдыха и длительность перерывов (в секундах). {% cut "Пример запроса" %} ```json { "work_time_range_till_rest": "00:30:00-00:40:00", "rest_duration_s": 600 }, { "work_time_range_till_rest": "01:00:00-01:10:00", "rest_duration_s": 600 } ``` {% endcut %} {% cut "Пример ответа" %} ```json { "id": 4974223, "sequence_pos": 0 }, { "id": 4974224, "sequence_pos": 1 } ``` {% endcut %} 3. Чтобы увидеть, как изменилось ожидаемое время прибытия, повторно отправьте запрос к ресурсу [route-info](https://yandex.ru/routing/doc/ru/delivery/redoc/index.html#operation/getsRouteInfo). Для заказа `id` = `410522528` новое ETA — 16:50 (заказ будет доставлен после перерыва). 4. Для проверки текущего статуса перерывов отправьте запрос к ресурсу [work_breaks](https://yandex.ru/routing/doc/ru/delivery/redoc/index.html#operation/getsWorkBreaks). {% cut "Пример ответа" %} ```json { "id": 4974223, "sequence_pos": 0, "work_time_range_till_rest": "00:30:00 - 00:40:00", "rest_duration_s": 600, "status": "started", "start_at": 1770039360 }, { "id": 4974224, "sequence_pos": 1, "work_time_range_till_rest": "01:00:00 - 01:10:00", "rest_duration_s": 600, "status": "planned", "start_at": 1770044160 } ``` {% endcut %} Написать в службу поддержки [//]: # (Вариант без html\: \[Написать в службу поддержки\]\(../../../feedback.md\))