Главная / Документация / Приложение курьера
Приложение курьера
Android 7.0 и новее
Приложение в закрытом тестировании. В магазинах его пока нет: установочный файл выдаёт поддержка по запросу. Сейчас работают вход по приглашению, смена, маршрутный лист, карточка заказа, закрытие с фотоотчётом, работа без связи и передача геопозиции в фоне. По ТЗ Раздела 4 остаётся сканирование штрихкода — дополнительная возможность, а не обязательная.
1. Установка
Диспетчер запрашивает установочный файл на support@fast-shipping.ru и передаёт его курьеру. При установке Android спросит разрешение ставить приложения из неизвестного источника — это ожидаемо для файла вне магазина.
Требуется Android 7.0 или новее.
2. Вход по приглашению
Пароля у курьера нет и не будет: приглашение всегда выпускает диспетчер.
- Диспетчер в панели, раздел «Курьеры», нажимает «Пригласить» и указывает номер телефона курьера.
- Система выдаёт короткий код и ссылку. Диспетчер передаёт их курьеру — голосом или сообщением.
- Курьер открывает приложение, вводит код (можно вставить ссылку целиком — приложение само возьмёт из неё код) и своё имя.
После этого устройство авторизовано, и вход больше не требуется. Приглашение одноразовое и действует 72 часа; просроченное придётся выпустить заново.
3. Смена
Список задач закрыт до нажатия «Начать смену». Это не формальность: пока смена не начата, адреса и телефоны получателей на телефон не выгружаются.
Если диспетчер временно закрыл доступ, приложение покажет экран ожидания и не будет собирать геоданные. Когда доступ вернут, достаточно нажать «Проверить».
4. Маршрутный лист
После начала смены появляется список адресов в порядке объезда, который рассчитал диспетчер. Номер слева — место точки в маршруте.
Показываются задачи только текущего дня: заказы, распределённые заранее на завтра, в приложение не приходят и не путают. Исключение — заказ, который курьер уже везёт: он остаётся в списке до закрытия, даже если наступили новые сутки.
Точки без рассчитанного номера уходят в конец списка — их разбирают после основного объезда.
5. Карточка заказа
Нажатие на точку в списке открывает карточку: адрес, имя получателя, окно доставки, состав заказа и сумма.
Отдельными блоками показываются то, ради чего обычно приходится звонить:
- Указание диспетчера — распоряжение компании по этому заказу. Стоит первым и выделено: это не пожелание жильца, а то, что велено сделать.
- Код домофона — крупно, чтобы набрать с экрана одной рукой.
- Просьба получателя — то, что он написал сам на странице отслеживания.
Внизу видно, брать ли деньги: «Взять с получателя» с суммой либо «Оплачено заранее». Курьеру нужен ответ на этот вопрос, а не название типа оплаты.
Кнопка «Позвонить» открывает набор номера получателя. Кнопка «Маршрут» передаёт точку во внешний навигатор — предлагаются только те приложения, которые на телефоне действительно установлены (Яндекс Навигатор, 2ГИС и любое другое картографическое). Если навигатора нет ни одного, точка откроется в браузере. У заказа без координат кнопка выключена: вести некуда.
6. Закрытие заказа
Порядок такой: в карточке нажимается «Начать доставку» — с этого момента получатель видит на странице отслеживания, что курьер выехал. Поэтому кнопку жмут при выезде к нему, а не заранее на складе.
По приезде — «Закрыть заказ». В окне закрытия выбирается один из трёх исходов:
- Вручил. По заказу с оплатой при получении спрашивается фактически полученная сумма — она подставляется из заказа, её можно поправить. По предоплаченному заказу вопроса о деньгах нет.
- Отказ. Доставка сорвана: получатель отказался, адрес неверный. Обязательно написать, что произошло.
- Перенос. Не вручил, но и не сорвал: не открыли дверь, просят приехать в другой день. Заказ не закрывается — он уходит в очередь диспетчера, и тот назначает новую дату. Причина обязательна.
Разделение отказа и переноса — не формальность. Закрыв отказом доставку, которая на самом деле состоится завтра, курьер портит компании метрику «доставлено в срок» на ровном месте.
Фотоотчёт делается кнопкой «Сделать фото» и не обязателен. Снимок сжимается прямо на телефоне и уходит в хранилище напрямую, минуя наш сервер, — так экономится мобильный трафик курьера. Пока фото отправляется, кнопка «Готово» заблокирована: иначе заказ закрылся бы без снимка, а переоткрыть закрытый заказ нельзя.
Сумму по невручённому заказу приложение не отправляет, даже если она была введена до смены исхода: денег по такому заказу нет, и в отчёте по инкассации они бы не сошлись.
7. Работа без связи
Курьер работает в подъездах, лифтах и подвалах: связь пропадает ровно в тот момент, когда он закрывает заказ. Поэтому действия не теряются.
Если сети нет, приложение сохраняет закрытие на телефоне и показывает «Нет связи — отправим, как появится». Для курьера на этом всё: заказ закрыт, можно идти дальше. В списке задач такая точка помечается «Ждёт сети» — работа зафиксирована, но ещё не доехала.
Отправка идёт сама при каждом открытии списка задач. Если хочется поторопить, наверху появляется полоса «Не отправлено действий: N» с кнопкой «Отправить».
Фотоотчёт, снятый без связи, остаётся на телефоне и уезжает вместе с закрытием. Порядок такой: сперва снимок в хранилище, потом сам факт закрытия — иначе прикрепить фото к уже закрытому заказу было бы некуда.
Что видит диспетчер. Если пока курьер был без связи заказ успели передать другому, факт доставки не откатывается: заказ закрывается за тем, кто его действительно вручил, и помечается расхождением для разбора. Деньги при этом числятся за ним же — иначе отчёт по инкассации показал бы наличные не у того курьера.
Момент закрытия записывается тот, что был на телефоне. Заказ, закрытый в 19:40 и отправленный в 21:00, в отчётах числится закрытым в 19:40.
8. Геопозиция
Пока идёт смена, приложение передаёт положение курьера диспетчеру каждые две минуты. Реже — карта диспетчера и оценка времени прибытия на странице получателя теряют смысл; чаще — быстрее садится батарея и расходуется мобильный трафик.
При выходе на смену Android спросит доступ к геопозиции. Выбирайте «Разрешить всегда». Вариант «Только при использовании приложения» выглядит достаточным, но им трек оборвётся ровно тогда, когда курьер уберёт телефон в карман и поедет между точками. Если выбран он, приложение покажет предупреждение с объяснением.
Пока идёт передача, в шторке висит уведомление «Смена идёт». Скрыть его нельзя — так устроен Android для служб, работающих с местоположением. Заодно это гарантия для курьера: видно уведомление — идёт сбор, нет уведомления — не идёт.
Сбор прекращается вместе со сменой. Не «через некоторое время» и не «когда приложение закроется»: нажали «Завершить смену» — служба остановлена, уведомление исчезло. То же происходит, если диспетчер выключил курьеру доступ.
Координаты хранятся 90 дней, затем удаляются автоматически. Правовое основание — трудовые или гражданско-правовые отношения курьера с компанией и информирование в приложении; подробнее в Политике обработки персональных данных.
Если телефон агрессивно экономит батарею (это часто у Xiaomi, Huawei, Oppo), система может усыпить приложение и оборвать передачу. В настройках телефона стоит исключить FastShipping из оптимизации батареи.
9. Что появится дальше
- Сканирование штрихкода — приёмка коробок на складе перед сменой и сверка при выдаче. Стикеры со штрихкодом панель уже печатает. Польза зависит от объёма: при двадцати с лишним точках за смену сканирование ловит забытую и перепутанную коробку на складе, где ошибка стоит минуту, а не у двери получателя. При пяти заказах в день сверка глазами быстрее.
- Публикация в магазине приложений — сейчас установочный файл выдаёт поддержка по запросу.
Приватность
Геопозиция собирается только при активной смене и полностью прекращается после её завершения. Координаты хранятся 90 дней, затем удаляются. Подробности — в Политике обработки персональных данных.