Главная / Документация / Приложение курьера

Приложение курьера

Android 7.0 и новее

Приложение в закрытом тестировании. В магазинах его пока нет: установочный файл выдаёт поддержка по запросу. Сейчас работают вход по приглашению, смена, маршрутный лист, карточка заказа, закрытие с фотоотчётом, работа без связи и передача геопозиции в фоне. По ТЗ Раздела 4 остаётся сканирование штрихкода — дополнительная возможность, а не обязательная.

1. Установка

Диспетчер запрашивает установочный файл на support@fast-shipping.ru и передаёт его курьеру. При установке Android спросит разрешение ставить приложения из неизвестного источника — это ожидаемо для файла вне магазина.

Требуется Android 7.0 или новее.

2. Вход по приглашению

Пароля у курьера нет и не будет: приглашение всегда выпускает диспетчер.

  1. Диспетчер в панели, раздел «Курьеры», нажимает «Пригласить» и указывает номер телефона курьера.
  2. Система выдаёт короткий код и ссылку. Диспетчер передаёт их курьеру — голосом или сообщением.
  3. Курьер открывает приложение, вводит код (можно вставить ссылку целиком — приложение само возьмёт из неё код) и своё имя.

После этого устройство авторизовано, и вход больше не требуется. Приглашение одноразовое и действует 72 часа; просроченное придётся выпустить заново.

3. Смена

Список задач закрыт до нажатия «Начать смену». Это не формальность: пока смена не начата, адреса и телефоны получателей на телефон не выгружаются.

Если диспетчер временно закрыл доступ, приложение покажет экран ожидания и не будет собирать геоданные. Когда доступ вернут, достаточно нажать «Проверить».

4. Маршрутный лист

После начала смены появляется список адресов в порядке объезда, который рассчитал диспетчер. Номер слева — место точки в маршруте.

Показываются задачи только текущего дня: заказы, распределённые заранее на завтра, в приложение не приходят и не путают. Исключение — заказ, который курьер уже везёт: он остаётся в списке до закрытия, даже если наступили новые сутки.

Точки без рассчитанного номера уходят в конец списка — их разбирают после основного объезда.

5. Карточка заказа

Нажатие на точку в списке открывает карточку: адрес, имя получателя, окно доставки, состав заказа и сумма.

Отдельными блоками показываются то, ради чего обычно приходится звонить:

Внизу видно, брать ли деньги: «Взять с получателя» с суммой либо «Оплачено заранее». Курьеру нужен ответ на этот вопрос, а не название типа оплаты.

Кнопка «Позвонить» открывает набор номера получателя. Кнопка «Маршрут» передаёт точку во внешний навигатор — предлагаются только те приложения, которые на телефоне действительно установлены (Яндекс Навигатор, 2ГИС и любое другое картографическое). Если навигатора нет ни одного, точка откроется в браузере. У заказа без координат кнопка выключена: вести некуда.

6. Закрытие заказа

Порядок такой: в карточке нажимается «Начать доставку» — с этого момента получатель видит на странице отслеживания, что курьер выехал. Поэтому кнопку жмут при выезде к нему, а не заранее на складе.

По приезде — «Закрыть заказ». В окне закрытия выбирается один из трёх исходов:

Разделение отказа и переноса — не формальность. Закрыв отказом доставку, которая на самом деле состоится завтра, курьер портит компании метрику «доставлено в срок» на ровном месте.

Фотоотчёт делается кнопкой «Сделать фото» и не обязателен. Снимок сжимается прямо на телефоне и уходит в хранилище напрямую, минуя наш сервер, — так экономится мобильный трафик курьера. Пока фото отправляется, кнопка «Готово» заблокирована: иначе заказ закрылся бы без снимка, а переоткрыть закрытый заказ нельзя.

Сумму по невручённому заказу приложение не отправляет, даже если она была введена до смены исхода: денег по такому заказу нет, и в отчёте по инкассации они бы не сошлись.

7. Работа без связи

Курьер работает в подъездах, лифтах и подвалах: связь пропадает ровно в тот момент, когда он закрывает заказ. Поэтому действия не теряются.

Если сети нет, приложение сохраняет закрытие на телефоне и показывает «Нет связи — отправим, как появится». Для курьера на этом всё: заказ закрыт, можно идти дальше. В списке задач такая точка помечается «Ждёт сети» — работа зафиксирована, но ещё не доехала.

Отправка идёт сама при каждом открытии списка задач. Если хочется поторопить, наверху появляется полоса «Не отправлено действий: N» с кнопкой «Отправить».

Фотоотчёт, снятый без связи, остаётся на телефоне и уезжает вместе с закрытием. Порядок такой: сперва снимок в хранилище, потом сам факт закрытия — иначе прикрепить фото к уже закрытому заказу было бы некуда.

Что видит диспетчер. Если пока курьер был без связи заказ успели передать другому, факт доставки не откатывается: заказ закрывается за тем, кто его действительно вручил, и помечается расхождением для разбора. Деньги при этом числятся за ним же — иначе отчёт по инкассации показал бы наличные не у того курьера.

Момент закрытия записывается тот, что был на телефоне. Заказ, закрытый в 19:40 и отправленный в 21:00, в отчётах числится закрытым в 19:40.

8. Геопозиция

Пока идёт смена, приложение передаёт положение курьера диспетчеру каждые две минуты. Реже — карта диспетчера и оценка времени прибытия на странице получателя теряют смысл; чаще — быстрее садится батарея и расходуется мобильный трафик.

При выходе на смену Android спросит доступ к геопозиции. Выбирайте «Разрешить всегда». Вариант «Только при использовании приложения» выглядит достаточным, но им трек оборвётся ровно тогда, когда курьер уберёт телефон в карман и поедет между точками. Если выбран он, приложение покажет предупреждение с объяснением.

Пока идёт передача, в шторке висит уведомление «Смена идёт». Скрыть его нельзя — так устроен Android для служб, работающих с местоположением. Заодно это гарантия для курьера: видно уведомление — идёт сбор, нет уведомления — не идёт.

Сбор прекращается вместе со сменой. Не «через некоторое время» и не «когда приложение закроется»: нажали «Завершить смену» — служба остановлена, уведомление исчезло. То же происходит, если диспетчер выключил курьеру доступ.

Координаты хранятся 90 дней, затем удаляются автоматически. Правовое основание — трудовые или гражданско-правовые отношения курьера с компанией и информирование в приложении; подробнее в Политике обработки персональных данных.

Если телефон агрессивно экономит батарею (это часто у Xiaomi, Huawei, Oppo), система может усыпить приложение и оборвать передачу. В настройках телефона стоит исключить FastShipping из оптимизации батареи.

9. Что появится дальше

Приватность

Геопозиция собирается только при активной смене и полностью прекращается после её завершения. Координаты хранятся 90 дней, затем удаляются. Подробности — в Политике обработки персональных данных.