Courier mobile app for Android — различия между версиями

Материал из Меасофт
Перейти к: навигация, поиск
(Телефон не отображается на карте в трекинге курьеров)
(Device Selection)
 
(не показано 6 промежуточных версий этого же участника)
Строка 11: Строка 11:
  
 
The remainder of the device's specs—manufacturer, memory size, processor speed, screen type and size, etc. — tend to be more geared toward consumers. The tool should be easy to use and practical in operation. Our software uses extremely little hardware resources.
 
The remainder of the device's specs—manufacturer, memory size, processor speed, screen type and size, etc. — tend to be more geared toward consumers. The tool should be easy to use and practical in operation. Our software uses extremely little hardware resources.
 
Для работы с кассами АТОЛ необходимо, чтобы устройство было на базе архитектуры [https://ru.wikipedia.org/wiki/ARM_(%D0%B0%D1%80%D1%85%D0%B8%D1%82%D0%B5%D0%BA%D1%82%D1%83%D1%80%D0%B0) ARM]. 98 % представленных на рынке устройств построены именно на этой архитектуре.
 
  
 
== Installation ==
 
== Installation ==
Строка 525: Строка 523:
 
Please note that in the section [https://home.courierexe.ru/extraclient/phones «Phones»] of the courier service account problematic options (GPS, networks, phone time, sync time, app version) are highlighted in pink, so you can always quickly diagnose problems with all couriers.
 
Please note that in the section [https://home.courierexe.ru/extraclient/phones «Phones»] of the courier service account problematic options (GPS, networks, phone time, sync time, app version) are highlighted in pink, so you can always quickly diagnose problems with all couriers.
  
=== Телефон делает зигзаги между двумя траекториями ===
+
=== The phone zigzags between two trajectories ===
* '''В телефоне меняется время'''
+
* '''The time changes on the phone'''
К сожалению, достаточно частая ситуация, когда время на одном и том же телефоне перескакивает из-за того, что неверно настроен часовой пояс (в андроиде производитель так и не изменил время перехода на летнее/зимнее время, не скорректировали с учетом последних изменений российского законодательства), телефон берет время из базовых станций оператора, которые тоже не всегда корректно настроены: иногда бывает, что идешь по Москве, смотришь в телефон, а он показывает время на 3 часа больше, и погоду в Екатеринбурге, с полной уверенностью, что я туда переместился. Предполагаю, что операторы иногда копируют настройки базовых станций из других регионов. И еще он получает время со спутников, когда включен GPS. В итоге время может скакать. Решение — отключить в настройках телефона автоопределение часового пояса, автонастройку часов, выставить верный часовой пояс и текущее время вручную. Также в некоторых программах, например, в навител.навигаторе по умолчанию установлена галка для автокоррекции системного времени по спутникам. Такое тоже нужно отключить. Это тоже не дает гарантии, что время будет корректным — андроид даже так иногда приглюкивает.
+
Unfortunately, it is a quite common situation when the time on the same phone jumps because the time zone is incorrectly set (in Android manufacturer never changed the time of transition to summer/winter time), the phone takes the time from the base operator stations, which are also not always configured correctly: sometimes it happens that you walk through one city, look into the phone, and it shows the wrong time and the weather in another city, just like if you have moved there. There is an assumption that operators sometimes copy the settings of base stations from other regions. And it also gets time from satellites when GPS is on. As a result, the time can bounce around. Solution - disable time zone autodetection, autoset clocks in phone settings, set correct time zone and current time manually. Also in some programs, by default there is a tick for autocorrection of system time by satellites. This also needs to be disabled. This also does not guarantee that the time will be correct - Android still can have that kind of bug.
* '''Переехала точка доступа WiFi'''
+
* '''Wi-Fi hotspot moved'''
Google регистрирует у себя WiFi сети, по [https://ru.wikipedia.org/wiki/MAC-адрес MAC-адресам] точек доступа, и фиксирует их местоположение. Потом, когда телефоны позиционируются — они смотрят, какие wifi сети есть в радиусе действия, и спрашивают их координаты у гугла. Это позволяет позиционироваться в помещениях, а так же повышает скорость, точность и энергоэффективность позиционирования. Однако, если точку доступа перенесли в другое место — google какое-то время об этом может не знать, и передавать телефону координаты старого расположения точки доступа. Если в вашем офисе/складе есть такая точка доступа — попробуйте «рассказать» гуглу, что она переехала: в зоне доступа данной сети (лучше — чтобы телефон был к ней подключен) включите GPS (например — google-карты), убедитесь, что GPS подключился к спутникам, и какое-то время подождите. По логике — телефон должен «понять», что «надежные» координаты от спутников не совпадают с координатами по wifi, и сообщить об этом в google, чтобы там изменили координаты точки доступа. Насколько этот способ надежен и быстр — известно только Большому Брату :-)
+
Google registers its Wi-Fi networks, by [https://ru.wikipedia.org/wiki/MAC-адрес MAC addresses] of access points, and records their locations. Then, when the phones are positioned, they look at what wi-fi networks are in range, and ask Google for their coordinates. This allows positioning indoors, as well as increasing the speed, accuracy and energy efficiency of positioning. However, if the access point was moved to another location - Google may not know about it for a while, and transmit the coordinates of the old location of the access point to the phone. If your office/warehouse has such an access point, try to "tell" Google that it has moved: turn on GPS (e.g. Google Maps) in that network's access area (better - have your phone connected to it), make sure that GPS is connected to satellites, and wait for a while. Logically, the phone should "understand" that the "reliable" coordinates from the satellites do not match the wi-fi coordinates, and report this to Google, so that they change the coordinates of the access point. How reliable and fast this method is unknown.
  
== Поиск заказа по штрихкоду ==
+
== Order search by barcode ==
Для поиска заказов по штрихкоду нажмите кнопку «Сканер штрихкода». Откроется окно сканирования. Отсканируйте штрихкод с расширенной накладной, наклейки всего заказа и места. В случае успешного сканирования заказ будет [[Мобильное приложение курьера для Android#Прием заказов|принят]] курьером. Если отсканировать код еще раз — откроется сам заказ.
+
To search for orders by barcode, press the '''Barcode Scanner''' button. A scan window opens. Scan the barcode from the extended delivery slip, the label of the whole order and the package. If the scan is successful, the order will be [[Courier mobile app for Android#Accepting_orders|accepted]] by the courier. If you scan the code again, it will open the order itself.
  
== Срочные в мобильном приложении ==
+
== Urgent orders in mobile app ==
Для доставки из пункта А в пункт Б предназначен функционал [[Работа со срочными заказами|Срочные]].
+
For deliveries from point A to point B, there is an [[Working with urgent orders|Urgent]] function.
  
Чтобы срочные заказы отображались в мобильном приложении, должны быть выполнены условия:
+
In order for urgent orders to be displayed in the mobile app, the conditions must be met:
* в системе MeaSoft для срочного заказа должна быть создана карточка адреса. Чтобы создать карточку адреса, на вкладке '''Срочные''' в окне «Ввод нового заказа на срочную доставку» в левом нижнем углу нажмите на кнопку без иконки или настройте автоматическое создание карточки в <rspoiler text="переменных">'''Справочники''' > '''Переменные''' > '''Срочные''' > '''Синхронизация с адресами''' > '''Автоматически создавать "Адреса"'''</rspoiler>;
+
* An address card must be created in MeaSoft for an urgent order. To create an address card, on the '''Urgent''' tab in the '''Enter new urgent order''' window in the lower left corner, click the button without the icon or set up automatic creation of the card in <rspoiler text="variables">'''References''' > '''Variables''' > '''Urgent''' > '''Synchronization with addresses''' > '''Create "Addresses" automatically'''</rspoiler>;
* плановая дата забора должна быть текущей датой.  
+
* the scheduled pickup date must be the current date.  
  
На отображение срочных заказов в мобильном приложении также влияют следующие флажки в [[Личный кабинет курьерской службы#Параметры|административном личном кабинете]]:
+
The display of rush orders in the mobile app is also affected by the following checkboxes in [[Courier_Service_Account#Parameters|courier service account]]:
* '''Разрешить невыданные заказы''' — если флажок установлен, курьер может взять себе не выданный никому до этого заказ. Подробнее см. раздел «[[Мобильное приложение курьера для Android#Невыданные заказы|Невыданные заказы]]»;
+
* '''Couriers can take unassigned urgent orders''' — If the checkbox is checked, the courier can take the order that has not been given out to anyone before. See «[[Courier mobile app for Android#Unassigned orders|Unassigned orders]]»;
* '''Не показывать курьеру срочные с пустым статусом''' — если флажок установлен, в карточке срочного нужно указать курьера и изменить статус, например на «Передано курьеру»;
+
* '''Do not show urgent orders with an empty status to a courier'' — if the checkbox is checked, you need to specify the courier in the Urgent card and change the status, for example, to "Handed over to the courier";
  
В мобильном приложении срочные заказы отличает наличие стрелки слева, изменение цвета шрифта адресов и расширенное количество статусов:
+
In the mobile app, urgent orders are distinguished by an arrow on the left, a change in the color of the addresses' font, and an expanded list of statuses:
  
 
[[Файл:МП Срочные.png|none|300px]]
 
[[Файл:МП Срочные.png|none|300px]]
  
Стрелка вниз означает заказ только туда, двухсторонняя стрелка — туда-обратно.
+
The down arrow means order is one way, the two-way arrow means it is a round trip.
  
Курьер отмечает этапы доставки при помощи статусов, устанавливаемых в карточке заказа.
+
The courier marks the stages of delivery with the statuses set in the order card.
  
Цвета адресов и статусы:
+
Address colors and statuses:
* верхний адрес желтый — поехал забирать, прибыл;
+
* top address is yellow - went to pick up, arrived;
* верхний адрес зеленый — забрал;
+
* top address is green - picked up;
* нижний адрес желтый, верхний адрес зеленый — поехал доставлять;
+
* bottom address is yellow, top is address green - went to deliver;
* нижний адрес зеленый, верхний адрес без цвета — доставил туда;
+
* bottom address is green, top address has no color - delivered (one way);
* нижний адрес зеленый, верхний адрес желтый — поехал обратно.
+
* bottom address is green, top address is yellow - went back.
  
Чтобы установить статус курьера, в мобильном приложении откройте заказ и нажмите на кнопку с названием статуса, затем нажмите на кнопку '''Подтвердить''':
+
To set the courier status, in the mobile app open the order and tap the button with the status name, then tap the "Confirm" button:
  
 
[[Файл:МП карточка срочного.png|none|300px]]
 
[[Файл:МП карточка срочного.png|none|300px]]
  
Время в списке заказов и на карте изменяется в зависимости от статуса: до забора отображается время забора, после — время доставки.
+
The time in the order list and on the map changes depending on the status: before pickup the pickup time is displayed, after that - the delivery time.
 
 
== Бесконтактная доставка по пин-коду ==
 
Если заказ был оплачен заранее или оплата по заказу не предусматривается, можно отправить покупателю СМС или e-mail с кодом.
 
 
 
Как только курьер передаст ему заказ (например, положит на скамейку рядом с подъездом), покупатель назовет код и курьер закроет заказ без получения подписи.
 
 
 
Для работы функциональности должны быть подключены '''Модуль отправки СМС сообщений''' и '''Модуль автоматизации''', также необходима дополнительная настройка системы со стороны программиста.
 
 
 
Бесконтактная доставка по пин-коду работает следующим образом:
 
# В карточку клиента на вкладку '''Пользовательские''' добавляется флажок '''Верификация по пин-коду'''. Его нужно установить.
 
# Автоматизация генерирует пин-код и сохраняет в его карточке корреспонденции на вкладке '''Прочее''' в поле '''Пинкод'''.
 
# Программист настраивает автоматическое задание на отправку пин-кода получателю в СМС после выдачи заказа курьеру. Если уже работает рассылка получателю о выдаче заказа курьеру, то пин-код будет добавляться в текст рассылки. Также отправить пин-код получателю можно вручную через E-mail или СМС из карточки корреспонденции, выбрав '''Функции''' > '''Разослать''' > '''SMS/E-mail получателю''' c указанием телефона диспетчера и пин-кодом.
 
# В мобильном приложении курьер выбирает нужный статус для заказа и вводит пин-код доставки, который ему сообщает получатель.
 
# Если пин-код утрачен или не пришел на телефон получателя, курьер может отправить пин-код повторно или изменить номер телефона получателя. Возможность изменять номер телефона для получения пин-кода управляется настройкой в личном кабинете курьерской службы: '''Настройки''' > '''Курьеры''' > '''Запретить менять номер телефона для получения пин-кода доставки'''.
 
# Если пин-код совпадает, курьер вручает заказ и устанавливает статус. Если пин-код не совпадает, отображается ошибка.
 
 
 
Значение пин-кода курьеру не известно.
 
 
 
== Логи мобильного приложения ==
 
При обращении в техническую поддержку по вопросам работы мобильного приложения вам могут потребоваться файлы логов. Удаленный доступ к файлам невозможен, получить их можно только непосредственно с мобильного устройства.
 
 
 
Начиная с версии 3.33.05, курьер может отправить логи непосредственно из мобильного приложения через мессенджеры или на почту. Для этого откройте '''Еще''' > '''Отправить логи''' > '''Отправить''' и выберите удобный способ отправки.
 
 
 
Файлы логов мобильного приложения хранятся на мобильном устройстве:
 
* для версии приложения 3.24.07 и выше — в папке Android/data/ru.measoft.courier/files/logs;
 
* для версии приложения до 3.24.07 — в папке .courier/logs.
 
 
 
Формат названия файла:
 
* для версии приложения 3.24.07 и выше — <code>год-месяц-день-час.log</code>. Например, файл «2021-12-20-17.log» это запись за 20 декабря 2021 года с 17 до 18 часов;
 
* для версии приложения до 3.24.07 — <code>месяц_день_час_мин.txt</code>. Например, файл «02_16_12_00.txt» это запись за 16 февраля с 12.00 до 12.59 часов.
 
 
 
Чтобы копировать файлы логов:
 
# На мобильном устройстве или при подключении к ПК откройте проводник или файловый менеджер и в поиске введите название папки логов «.courier/logs». Рекомендуется использовать файловый менеджер Total Commander.
 
# Если поиск не дал результата, в настройках файлового менеджера или проводника включите отображение скрытых папок.
 
# Повторите поиск.
 
# Скопируйте файлы логов за нужный период. Перед отправкой в техподдержку объедините файлы в архив.
 
# Если вы отправляете логи приложений разных курьеров, объедините текстовые файлы в архивы, для каждого курьера свой архив.
 
 
 
== Фискализация ==
 
Фискализация — это формирование фискального документа. Фискализация кассового чека состоит из 3 процедур:
 
# Создание чека в соответствии с ФФД (и требованиями Закона № 54-ФЗ по реквизитам).
 
# Передача чека (соответствующего ФФД) в ОФД.
 
# Передача чека в ФНС.
 
MeaSoft поддерживает следующие схемы фискализации в мобильном приложении:
 
* [[#Удаленная фискализация LifePay|LIFE PAY]]
 
* [[#Bluetooth фискальные регистраторы АТОЛ|АТОЛ]]
 
 
 
=== Удаленная фискализация LIFE PAY ===
 
Для работы удаленной фискализации LIFE PAY:
 
# Заключите договор с фирмой LIFE PAY.
 
# Перейдите '''Справочники''' > '''Фирмы''', выберите фирму и создайте для нее фискальный регистратор (вкладка '''[[Фирмы#Добавление фискального регистратора|Устройства]]''').
 
## В поле '''Номер фискального регистратора''' укажите через запятую:
 
##* 32-значный АПИ-ключ. Его можно найти в личном кабинете LIFE PAY;
 
##* номер телефона, на который зарегистрирован ЛК LIFE PAY. Номер должен начинаться с 7, без знака "+";
 
##* если планируется переход на ФФД 1.2, добавьте ссылку <code>https://sapi.life-pay.ru/cloud-print-ffd1_2/</code>.
 
## В поле '''Выберите тип устройства''' укажите '''Life-Pay облачная фискализация'''.
 
# В карточках сотрудников в поле '''Телефон мобильный''' укажите телефоны курьеров, привязанные в личном кабинете LIFE PAY.
 
# В устройстве курьера, помимо последней версии мобильного приложения, должно быть установлено приложение [https://play.google.com/store/apps/details?id=com.lifepay.ui&hl=ru LIFE PAY].
 
# В карточке клиента на вкладке '''Касса''' установите флажок '''Печатать кассовые чеки'''.
 
# Клиент должен работать с фирмой, в которой создан фискальный регистратор из 2 пункта.
 
# В заказе должен быть указан корректный телефон получателя.
 
# У заказа обязательно должны быть вложения.
 
# Сумма заказа должна быть не менее 30 рублей.
 
 
 
==== Возможные ошибки ====
 
* Ошибка #6010. Проверьте соответствие мобильного телефона курьера в карточке сотрудника с телефоном курьера в ЛК LIFE PAY.
 
* [[Настройка модуля печати кассовых чеков#Ошибка фискализации (ошибка программирования реквизита 1226)|Ошибка фискализации (ошибка программирования реквизита 1226)]].
 
* При проблемах с облачной фискализацией в справочнике '''Фирмы''' > '''Устройства''' в поле '''Номер фискального регистратора''' добавьте через запятую третий параметр — ссылку <code>https://sapi.life-pay.ru/cloud-print-ffd1_2/</code>.
 
 
 
=== АТОЛ ===
 
<!--Приложение интегрировано с сервисом удаленной фискализации [https://life-pay.ru/], позволяющим существенно сократить затраты на закупку и содержание кассового оборудования за счет использования одного фискального регистратора и подключаемых к мобильным телефонам курьеров чекопечатающим принтерам.-->
 
Фискальный регистратор (далее ФР) АТОЛ 11Ф позволяет курьеру печатать чеки, подключив его к мобильному приложению с помощью Bluetooth. Также поддерживается модель '''АТОЛ 60Ф''', но без эквайринга.
 
 
 
==== Регистрация ФР ====
 
 
 
Перерегистрировать ФР можно 11 раз. Регистрация ФР происходит с помощью программы «Утилита для регистрации ККТ», которая входит в пакет драйверов АТОЛ ККТ (DTO) последней версии. Рекомендуемая версия 8.14.02.02, которую можно скачать по [http://www.courierexe.ru/download/ext_manual/KKT_8_14_02_02_Full.rar ссылке].
 
 
 
<span style="color: red;>ВАЖНО: для правильного налогообложения по агентскому договору и для возможности печати на чеке информации об агенте во время регистрации ФР установите флажок '''ПЛ. АГЕНТ'''</span>:
 
[[Файл:Pl agent pri registr.png|none|500 px]]
 
 
 
==== Проверка наличия флажка «ПЛ. АГЕНТ» ====
 
 
 
# В отчете о регистрации, который формируется программой [https://onedrive.live.com/View.aspx?resid=189C614ED00D4C23!128&app=OneNote&wd=target(//54-ФЗ.one%7C27377c95-2928-4aa8-8fd7-4b03b801c6ef/Итоги%20регистрации%7C56c0e2c1-4061-45a6-b2cf-831b0be3304e/)&authkey=!ABE4IM6eOvPtlrQ «Тест драйвера ККМ»]
 
# Посмотрите информацию на чеке, который пробивается через ФР или ЛК ОФД.
 
 
 
<gallery>
 
Файл:Pl agent na real check.png|Чек о регистрации
 
Файл:Pl agent check ofd.png|Чек ОФД
 
</gallery>
 
 
 
==== Настройка ФР ====
 
Для отправки чеков в ОФД настройте передачу данных через Windows-приложение «Тест драйвера ККМ» или мобильное приложение «Тест драйвера ККТ»:
 
 
 
[[Файл:Nastroika peredachi v ofd.png|none|300 px]]
 
 
 
* EthernetOverTransport — рекомендуемый метод. Используется интернет-соединение мобильного устройства, к которому подключается ФР;
 
* GSM модем — использование СИМ-карты (необходим модуль GSM и установленная СИМ-карта);
 
* Wi-Fi — использование сети Wi-Fi (необходим модуль wi-fi);
 
* EoU — передача чеков через подключение к ПК.
 
 
 
==== Подключение ФР к мобильному устройству ====
 
С подробным руководством по эксплуатации можно ознакомиться [http://www.courierexe.ru/download/ext_manual/atol-11f.pdf здесь].
 
 
 
# Включите режим Bluetooth. Зайдите в сервисное меню:
 
## ФР должен быть выключен. Зажмите кнопку промотки кассовой ленты и включите ФР.
 
## После 5 звукового сигнала отпустите кнопку промотки.
 
## Зайдите в канал обмена (2 нажатия кнопки промотки).
 
## Включите Bluetooth (4 нажатия кнопки промотки).
 
# Выйдите из сервисного меню (1 нажатие кнопки промотки).
 
# На мобильном устройстве выполните поиск Bluetooth-устройств и выберите XXXXXXX-ATOL_11F.
 
# Выполните подключение. ФР напечатает запрос на соединение.
 
# Примите соединение <span style="color: red;>сначала</span> на мобильном устройстве, а <span style="color: red;>потом</span> на ФР (нажмите на кнопку промотки).
 
 
 
==== Подключение ФР к MeaSoft App ====
 
В мобильном приложении MeaSoft App:
 
# Перейдите в раздел '''Настройки''', выберите в верхнем меню '''Касса''' и нажмите кнопку '''Подключить'''. PIN-код устройства устанавливается в личном кабинете курьерской службы, на вкладке '''Курьеры''', в [[Личный кабинет курьерской службы#Устройства курьера|карточке курьера]].[[Файл:ЛК КС карточка курьера.png|none|500 px]]
 
# Выберите сопряженное устройство в поле '''Устройство'''.[[Файл:Nastroika kassy.png|none|300 px]]
 
# Нажмите на кнопку '''Назад'''. При подключении ФР издаст звуковой сигнал. Если не подключается, повторите попытку.
 
 
 
==== Информация при печати чека ====
 
# Выводятся все товарные вложения.
 
# Выводится телефон платежного агента (курьерской службы). Укажите телефон в [[Личный кабинет курьерской службы#Курьеры|личном кабинете курьерской службы]]: '''Настройки''' > '''Курьеры''' > '''Городской телефон офиса'''.
 
# Выводятся наименование, ИНН и телефон поставщика (клиента).
 
 
 
==== Рекомендации ====
 
После пробития первых чеков проверьте их наличие в ОФД.
 
 
 
Возможные ошибки при печати чека:
 
# Смена превысила 24 часа (3822) — для решения, необходимо зайти в настройки мобильного приложения, выбрать в меню '''«Касса»''' и создать Z-отчет.
 
# Превышено количество дней на отправку чеков — чеки не уходили в ОФД. Необходимо их отправить любым способом (подключить кассу к интернету).
 
<!--
 
Поддержка решений для соответствия 54-ФЗ сейчас в разработке!
 
Данное приложение поддерживает работу с bluetooth фискальными регистраторами (ФР) [http://egais.atol.ru/products/kkt/kkt_5.html АТОЛ FPrint-11ПТК]
 
 
 
=== Подключение ===
 
[[Файл:android8.png|thumb|220px|right]]
 
Для подключения устройства к приложению выполните следующие действия:
 
 
 
# Включите ФР.
 
# В настройках телефона выполните поиск bluetooth устройств. Должен найтись ФР.
 
# Выберите ФР, нажмите «Сопряжение». Введите пин-код (по-умолчанию — 00000000).
 
# В приложении нажмите «Настройка» — «Касса» — «Подключить». Введите пин-код, устанавливаемый для приложения 2Can в личном кабинете. Функции подключения и отключения защищены вводом пин-кода от курьера, для того, чтобы он не мог проводить заказы без печати чека, отключая на время связь с кассой.
 
# Отобразится окно настройки подключения к кассе. Вам нужно только выбрать устройство — сопряженный фискальный регистратор.
 
# Закройте окно кнопкой «Назад» на телефоне. Приложение попытается подключиться к кассе. Если все хорошо — касса пикнет, и станут доступны кнопки снятия отчетов.
 
 
 
=== Отключение ===
 
Для отключения фискального регистратора в приложении нажмите '''Настройка''' > '''Касса''' > '''Отключить'''. Введите PIN-код.
 
 
 
=== Снятие отчетов ===
 
При подключенном к приложению ФР в окне '''Настройка''' > '''Касса''' доступны кнопки снятия X и Z-отчетов. Убедитесь, что касса включена, в ней достаточно ленты, нажмите на соответствующую кнопку.
 
 
 
=== Печать чеков ===
 
Если к приложению подключен ФР, происходит автоматическая попытка печати кассового чека при одновременно соблюдении следующих условий:
 
# Заказу присваивается статус '''Доставлено''' или '''Частично'''.
 
# Установлен признак необходимости печати кассового чека.
 
# Положительная общая сумма к оплате с получателя.
 
 
 
Заказ не будет сохранен, пока печать чека не завершится успехом.
 
 
 
На чеке печатается номер заказа и детализация товаров. Вложение с отрицательной ценой проводится как скидка по чеку.
 
 
 
В случае оплаты картой чек пробивается с соответствующим типом оплаты.
 
-->
 
 
 
== Эквайринг ==
 
Эквайринг — это [https://ru.wikipedia.org/wiki/%D0%AD%D0%BA%D0%B2%D0%B0%D0%B9%D1%80%D0%B8%D0%BD%D0%B3 безналичная оплата товаров и услуг банковскими картами]. Система MeaSoft поддерживает ряд интегрируемых сервисов с терминалами, подключаемыми к мобильному устройству, а также можно использовать сторонние банковские POS-терминалы.<br>
 
Обратите внимание, при отправке слип-чека по SMS может взиматься дополнительная плата.
 
 
 
=== Выбор платежной системы ===
 
У каждой платежной системы свои банки-эквайеры.
 
{| class="wikitable"
 
|-
 
!Название платежной системы!!Метод эквайринга!!Оборудование!!Описание
 
|-
 
|[https://life-pay.ru/tariffs/ LIFE PAY]||Приложение||Терминалы [https://life-pay.ru/acquiring/merchant-acquiring/ Pinpad LIFE PAY, Ingenico ipp 320 и PAX SP 30]||[[Мобильное приложение курьера для Android#LIFE PAY|Инструкция]]
 
|-
 
|[http://iboxmpos.com/russia/ru/products/iboxpro/ ibox]||Приложение<br><rspoiler text="SDK">SDK — это средства разработки, которые позволяют приложению MeaSoft взаимодействовать с POS-терминалом напрямую. По возможности нужно использовать этот способ. SDK не поддерживает ридеры, подключаемые через разъем наушников. Выбор в пользу SDK можно сделать в тех случаях, если на мобильном телефоне мало места для установки приложений.</rspoiler>||Ридеры [http://iboxmpos.com/russia/ru/chipandpinnfc/ P17], [http://iboxmpos.com/russia/ru/chipandpin/ P15], [http://iboxmpos.com/russia/ru/chipandsign/ C15]||[[Мобильное приложение курьера для Android#ibox|Инструкция]]
 
|-
 
|[https://www.assist.ru/o-podklyuchenii/ Assist]||Приложение||[https://docs.assist.ru/pages/viewpage.action?pageId=13893772 BluePad-50<br>QPOS Mini]<br>При оплате с помощью QR-кодов не требуется||[[Мобильное приложение курьера для Android#Assist|Инструкция]]
 
|-
 
|[https://robokassa.com/robokassa/rates/#ip Robokassa]||Не требуется||Не требуется||[[#Robokassa|Инструкция]]
 
|-
 
|LIFE POS Checkout ||colspan="3"|Интеграция уже поддерживается. В будущем добавим больше информации.
 
|}
 
 
 
=== Выбор оборудования ===
 
Приобретайте оборудование только у компании, выбранной в качестве партнера по эквайрингу.<br>
 
По способу подключения оборудование разделяется на:
 
* подключаемое через разъем для наушников (3,5 мм audio mini-jack). Это устаревший ненадежный способ;
 
* Bluetooth — наиболее надежный тип подключения при работе с платежами.
 
По функциональности оборудование разделяется на:
 
* чтение магнитной полосы. В последнее время перестает поддерживаться. Ведущие платежные системы уже начали запрещать проводить платежи магнитной полосой картами, у которых есть чип. Карт без чипов уже практически не осталось.
 
* чтение чипа. Поддерживается любым современным оборудованием.
 
* чтение бесконтактных карт. Поддерживается не любым оборудованием, на это рекомендуем обратить особое внимание. Функция передовая и востребованная.
 
 
 
=== Процесс оплаты заказа через терминал ===
 
Для проведения оплаты заказа картой должен быть выбран тип оплаты «Картой при получении» или в карточке клиента установлен флажок '''Спрашивать тип оплаты у получателя''' (в этом случае в окне заказа появится выпадающий список, в котором необходимо выбрать тип оплаты). Более подробно можно прочитать в разделе [[Мобильное приложение курьера для Android#Типы оплаты|«Типы оплаты»]].
 
 
 
Упрощенно процесс оплаты банковской картой через терминал выглядит следующим образом:
 
# Ввести данные платежа на мобильном устройстве курьера и провести/вставить чип/приложить карту к терминалу;
 
# Лицо, осуществляющее платеж, подтверждает оплату с помощью электронной подписи через смартфон, либо с помощью кода, полученного посредством SMS-сообщения;
 
# Курьер отправляет Слип-чек в электронном виде, как SMS-сообщение или на электронную почту плательщика.
 
 
 
=== LIFE PAY ===
 
 
 
==== Подключение оборудования ====
 
Перед использованием подключите Bluetooth-устройство к ОС Android.
 
 
 
Чтобы подключить терминал Ingenico RP750x:
 
# Включите mPOS терминал.
 
# Нажмите и удерживайте на терминале кнопку «*».
 
# Нажмите на кнопку «2», чтобы начать новое сопряжение.
 
# На мобильном телефоне начните сопряжение по Bluetooth, на экране телефона появится код сопряжения.
 
# Введите код сопряжения на mPOS терминале.
 
# Нажмите на зеленую кнопку на mPOS терминале. Терминал отобразит на экране «В паре устройства». Сопряжение устройств по Bluetooth выполнено.
 
# В мобильном приложении перейдите в '''Еще''' > '''Настройки''' > '''Параметры эквайринга''' и выберите '''LifePay Приложение'''.
 
Инструкции по сопряжению других терминалов можно найти в [https://support.life-pay.ru/knowledge_base/item/123729?sid=29360 документации] к ним.
 
 
 
==== Проведение платежа через приложение LIFE PAY ====
 
[https://support.life-pay.ru/ru/knowledge_base/cat/3/ Работа в приложении на Android в LIFE PAY]
 
 
 
Для работы в MeaSoft App:
 
# В настройках приложения выберите '''Параметры эквайринга''' > '''Приложение LifePay'''.
 
# Закройте заказ как доставленный или частично доставленный с типом оплаты '''Картой при получении'''. Происходит автоматический переход в приложение LIFE PAY:
 
#:
 
#: [[Файл:Приложение LifePay.png|250 px|none]]
 
# Нажмите на кнопку '''Оплатить'''. Сумма и номер заказа автоматически передаются в приложение LIFE PAY.
 
#:
 
#: [[Файл:Оплата LifePay.png|250 px|none]]
 
# При необходимости отправки слип-чека через SMS введите номер телефона и/или e-mail плательщика и нажмите в приложении на кнопку '''По терминалу'''. За SMS может взиматься дополнительная плата.
 
# Проведите оплату банковской картой по терминалу.
 
 
 
==== Возможные ошибки ====
 
'''Не проходит эквайринг.''' При этом мобильный номер курьера в MeaSoft и в личном кабинете LIFE PAY совпадает. Сбросьте кэш обоих приложений и переустановите их.
 
 
 
=== ibox ===
 
 
 
Предварительная настройка приема платежей описана в разделе [[Интеграция с платежными сервисами#ibox |«Интеграция с платежными сервисами»]].
 
 
 
==== Платеж через ibox SDK ====
 
# При первом подключении терминала включите bluetooth на телефоне и через системное меню телефона выполните сопряжение устройств.
 
# В настройках MeaSoft App выберите '''Параметры эквайринга''' > '''iBox SDK'''.
 
# Закройте заказ как доставленный или частично доставленный с типом оплаты '''Оплата картой'''.
 
# При первом подключении введите логин и секретный ключ (можно посмотреть в личном кабинете ibox). Обратите внимание, ввести нужно именно секретный ключ, а не пароль пользователя ibox.<br>[[Файл:Авторизация iBox.png|250 px|none]]
 
#: Номер телефона и e-mail получателя автоматически заполняются из карточки заказа для отправки слип-чека.
 
# Происходит автоматический переход в приложение ibox. Перейдите на вкладку '''Настройки''', выберите модель терминала и в открывшемся списке выберите устройство.<br>[[Файл:Настройка iBox.png|250 px|none]]
 
# При первом подключении выберите терминал.
 
# Проведите оплату банковской картой по терминалу.<br>[[Файл:Оплата iBox.png|250 px|none]]
 
Если нужно выйти из аккаунта ibox, замените логин и секретный ключ.
 
 
 
==== Платеж через модуль NFC ====
 
Чтобы начать использовать платежи с помощью модуля NFC на мобильном устройстве курьера, обратитесь в компанию ibox для изменения внутренних настроек клиента.
 
 
 
На мобильном устройстве курьера должна быть установлена ОС Android 9 или выше и приложение [https://play.google.com/store/apps/details?id=com.tap2go.softpos&hl=ru tap2go].
 
 
 
Настройте приложение tap2go:
 
# Откройте приложение и введите логин и секретный ключ от учетной записи ibox.
 
# Введите одноразовый СМС-код.
 
# Установите 6-значный код доступа.
 
 
 
Чтобы принять оплату с помощью модуля NFC:
 
# В настройках MeaSoft App выберите '''Параметры эквайринга''' > '''iBox SDK'''.
 
# Закройте заказ как доставленный или частично доставленный с типом оплаты '''Оплата картой''', заполните данные заказа и нажмите '''Сохранить'''.
 
# Происходит автоматический переход в приложение ibox. Нажмите на кнопку '''ОПЛАТИТЬ NFC''' и проведите платеж.
 
 
 
<spoiler text="Ошибка при проведении платежа на сумму 10000 рублей и более">Наиболее частая причина ошибки — устаревшая прошивка ридера. Для устранения ошибки обновите прошивку, подробнее см. в [http://courierexe.ru/download/buildibox.zip инструкции].</spoiler>
 
 
 
==== Платеж через приложение ibox ====
 
# В настройках MeaSoft App выберите '''Параметры эквайринга''' > '''Приложение iBox'''.
 
# Закройте заказ как доставленный или частично доставленный с типом оплаты '''Оплата картой'''. Происходит автоматический переход в приложение ibox.
 
# Нажмите на кнопку '''Оплатить'''. Сумма и номер заказа будут автоматически переданы в приложение ibox.
 
# При необходимости отправки слип-чека через SMS введите номер телефона и/или e-mail плательщика. Нажмите в приложении на кнопку '''Отправить'''. При нажатии на кнопку '''Пропустить''' чек отправлен не будет.
 
# Проведите оплату банковской картой по терминалу.<br>[[Файл:Отправка чека ibox.png|none|250 px|Отправка чека ibox]]
 
  
=== Assist ===
+
== Contactless delivery via PIN ==
 +
If the order was paid in advance or if payment is not provided for the order, you can send the recipient an SMS or e-mail with a code.
  
Предварительная настройка приема платежей описана в разделе [[Интеграция с платежными сервисами#Assist|«Интеграция с платежными сервисами»]].
+
As soon as the courier hands them the order (for example, puts it on a front porch), the recipient will say the code and the courier will close the order without getting a signature.
  
Чтобы начать использовать систему Assist:
+
For the functionality to work, the '''SMS module''' and the '''Automation module''' must be connected, also additional configuration of the system by the administrator is required.
# Установите мобильное приложение Assist mPOS.
 
# В настройках мобильного приложения MeaSoft App в выпадающем списке '''Параметры эквайринга''' выберите значение '''Assist mPOS'''.
 
# Рядом со значением '''Assist mPOS''' появится кнопка [[Файл:Assist настройки.png|25 px]]. Нажмите на нее, введите <rspoiler text="PIN-код"> В личном кабинете курьерской службы в пункте основного меню '''Телефоны''' > [[Личный кабинет курьерской службы#Курьерские устройства|Курьерские устройства]] откройте карточку курьера и скопируйте значение поля '''PIN-код POS-терминала'''.</rspoiler> и нажмите на кнопку '''Проверить'''.
 
# В окне «Настройки Assist» укажите логин, пароль и ИД магазина согласно вашим учетным данным Assist и нажмите на кнопку '''Сохранить'''.
 
  
Чтобы провести платеж:
+
Contactless pin code delivery works as follows:
# В MeaSoft App в поле '''Тип оплаты''' выберите '''Оплата картой'''.
+
# The '''Verify by pin code''' checkbox is added to the '''Custom''' tab of the client card. It must be checked.
# Укажите статус заказа '''Доставлено''' или '''Частично доставлено''' и нажмите на кнопку '''Сохранить'''.
+
# Automation generates a pin code and stores it in the '''Other''' tab of the shipment card in the '''PIN''' field.
# При необходимости заполните информацию во всплывающем окне и нажмите на кнопку '''Сохранить'''.
+
# Administrator sets up the automatic task to send the pin code to the recipient by SMS after the order is given to the courier. If the recipient is already receiving a hand over notification, the pin code will be added to the text. You can also send the pin code to the recipient manually via E-mail or SMS from the shipment card by selecting '''Options''' > '''Send''' > '''SMS/E-mail to recipient''' with the dispatcher phone number and pin code.
# Откроется мобильное приложение Assist mPOS. Вы можете выбрать способ проведения оплаты:
+
# In the mobile app, the courier selects the desired status for the order and enters the delivery pin code that the recipient tells him.  
#* картой через терминал;
+
# If the pin code is lost or did not come to the recipient's phone, the courier can send the pin code again or change the recipient's phone number. The ability to change the phone number to get the pin code is controlled by the setting in the courier service account: '''Settings''' > '''Couriers''' > '''Courier cannot edit phone number intended for receiving delivery PIN'''.
#* QR-код для считывания мобильным банковским приложением покупателя (СБП);
+
# If the pin code matches, the courier hands over the order and sets the status. If the pin code does not match, an error is displayed.  
#* наличными.
 
  
После совершения оплаты получателю направляется электронный чек. У курьера заказ закрывается.
+
The value of the pin code is unknown to the courier.
  
'''Особенности оплаты с помощью QR-кода'''
+
== Mobile app logs ==
 +
When contacting technical support with questions about the mobile app, you may need log files. The files cannot be accessed remotely and can only be retrieved directly from the mobile device.
  
# Оплата кредитной картой невозможна.
+
Starting with version 3.33.05, the courier can send logs directly from the mobile app via messenger or by email. To do this, open '''More''' > '''Send logs''' > '''Send''' and select a convenient method of sending.
# Система Assist дает 10 минут на завершение платежа пользователем. Это время настраивается на стороне Assist.
 
::Если в MeaSoft App сразу не пришел ответ об успешной транзакции, курьер через 10 минут должен:
 
:# Снова открыть карточку заказа и проверить состояние заказа.
 
:# Если заказ не закрыт, проверить статус платежа в Assist mPOS и на основании этой информации указать в MeaSoft App в карточке заказа один из статусов:
 
:#*'''Успешно''' — курьер подтверждает, что платеж совершен, заказ закрывается;
 
:#*'''Платеж отменен''' — после этого курьер может снова выбрать тип оплаты и провести платеж.
 
  
=== Онлайн-платежи ===
+
The log files of the mobile app are stored on the mobile device:
Чтобы начать использовать систему Robokassa, в настройках мобильного приложения в выпадающем списке '''Параметры эквайринга''' выберите значение '''Онлайн-платежи'''.
+
* for application version 3.24.07 and higher - in the folder Android/data/ru.measoft.courier/files/logs;
 +
* for application version up to 3.24.07 - in the folder .courier/logs.  
  
Предварительная настройка приема платежей описана в разделе [[Интеграция с платежными сервисами#Robokassa|«Интеграция с платежными сервисами»]].  
+
File name format:
 +
* for application version 3.24.07 and higher — <code>year-month-day-hour.log</code>. For example, file «2021-12-20-17.log» is a log from December 21, 2021 from 5 until 6 p.m.;
 +
* for application version up to 3.24.07 — <code>month_day_hour_min.txt</code>. For example, file «02_16_12_00.txt» is a log from February 16 from 12.00 until 12.59 a.m.
  
Чтобы провести платеж:
+
To copy log files:
# В поле '''Тип оплаты''' выберите '''Оплата картой'''.
+
# On your mobile device or when connected to a PC, open an explorer or file manager and enter the name of the logs folder ".courier/logs" in the search box. It is recommended to use the Total Commander file manager.
# Укажите статус заказа '''Доставлено''' или '''Частично доставлено''' и нажмите на кнопку '''Сохранить'''.
+
# If the search is unsuccessful, turn on the display of hidden folders in the file manager or explorer settings.
# При необходимости заполните информацию во всплывающем окне и нажмите на кнопку '''Сохранить'''.
+
# Repeat search.
# Откроется окно с штрихкодом для оплаты: [[Файл:RBK Barcode.png|none|300 px]]
+
# Copy the log files for the desired period. Before sending them to tech support, merge the files into an archive.
В этом окне вы можете:
+
# If you are sending application logs to different couriers, merge the text files into archives, a different archive for each courier.
* дать получателю отсканировать штрихкод с экрана;
 
* '''Выслать по СМС''' — выслать получателю смс-сообщение со ссылкой на оплату;
 
* '''Поделиться''' — переслать получателю ссылку на оплату, используя стандартные средства Android;
 
* '''Обновить заказы''' — проверить, прошла ли оплата заказа получателем. Если оплата совершена, заказ закроется автоматически.
 
После совершения оплаты получателю направляется электронный чек. У курьера заказ закрывается.
 

Текущая версия на 08:56, 1 сентября 2023

Purpose

The application is made to cooperate with both the Measoft system and external systems that can be linked through unique API. The application is meant to be used by drivers and waking couriers alike. First and foremost, when creating the application, the delivery of purchases from local online retailers was taken into account.

Device Selection

The Android OS version 5.0 or later must be installed on a mobile device in order to use the MeaSoft App mobile application. The majority of mobile handsets on the market nowadays come with Android OS versions 5.1 and above already installed. The principle "the newer the Android version, the better" should be your guide when selecting a device, all other things being equal.

The application utilises mobile device modules for GPS, GSM, Wi-Fi, and Bluetooth during operation, although these modules are present in all models currently on the market (with very few exceptions).

It's crucial for accurate barcode reading that the camera has focusing.

The remainder of the device's specs—manufacturer, memory size, processor speed, screen type and size, etc. — tend to be more geared toward consumers. The tool should be easy to use and practical in operation. Our software uses extremely little hardware resources.

Installation

Android QR.png

To install the courier app, scan the QR code on the right or open the Play Market or AppGallery (for Honor/Huawei devices) on your device, search for MeaSoft App, open and click Install.

Select Сonfirm.

Note. You need a Google account, an Internet connection, and the device's time and date set in order for the app store to function. It is advised to make a different account for every device.

The application can be launched from the list of installed applications after it has been installed.

In order for the application to function properly, it is advised that:

  • you make sure if the Play Store's 'Play Store > Menu > Settings >Auto-update apps option is turned on. The app on couriers' devices needs to be updated because we frequently release new versions.
  • you grant the application complete control over all activities. More on permissions in Android help.

Configuration

Check the Mobile Device Module box under References > Additional modules to synchronize the Measoft system with the application:

Image 5.png

Note that there is a link to a Courier Service Account, username and password, with which you can log in to the CSA and manage the phones. After checking ALL users must log out of the system and log in again. After that, synchronization with the server will continue up to 1-2 hours in the background.

Keep MeaSoft operating at least at one workplace, for instance on the server, to properly synchronize orders with your client account and the courier's mobile application.

Another way to ensure continuous synchronization is if you have automation service connected, set References> Variables > System > Synchronization in Scheduler to Yes.

User Registration

When you log in to the mobile app for the first time, the registration window is displayed. You can open it later by opening Settings > General > Re-Registration in the main application window.

МП регистрация.png

To start using, register the application. There are 2 ways to do this:

  • scan the QR code,
  • enter your username and password.

The list of mobile devices of couriers is displayed in the courier service accountcontrol panel. The Active section displays all devices connected to the system.

Registration by QR code scanning

  1. In the mobile app, tap the Scan Code button. The barcode scanner opens.
  2. In the Measoft system, open the employee card to whom you need to register the phone. In the card, go to the Additional tab and click on the Register phone button. A QR code will be displayed.
  3. Scan the QR code with your phone's camera.

The application will inform you about the registration result.

Registration of the application by entering a username and password

  1. Enter your company's login information and password on the courier's mobile application. Open References> Additional Modules in the Measoft system to view the username and password.
  2. Select the appropriate phone in the courier service account's Phones tab, click the Edit button, and then choose the preferred courier from the drop-down list in the Select Courier field. Press Save.

Receiving orders

Orders can be handed over to the courier in the following ways:

  • the order assigned to the courier by the manager appears in the application. If the business process provides for it, the courier can [[#Receive Orders|]] confirm that he received the order;
  • the courier in the app takes the available urgent order;
  • self-issue of pre-scheduled orders.

A notification about a new order is presented in the application and an alarm sets off when new orders are received.

The notification has an OK button. The courier confirms order acceptance by clicking on it. In the Measoft system, the shipment receives the status Read as per the courier's words at the same time.

Until the OK button is clicked, the notification will keep coming up frequently. The notification is not visible from 9 p.m. to 8:59 a.m.; instead, notification is sent in the morning.

Accepting orders

With this function, the courier can confirm that he has received the issued orders. This is an optional operation, you can skip it.

To confirm the acceptance, click on the Button Barcode.png button and scan the order or package barcode.

A colored dot will appear on the main screen to the right of the order. Point Color Values:

  • red — the order has not been accepted yet;
  • yellow — the order has been partially accepted, not all packages have been scanned;
  • green — the order is fully accepted.

When the order is fully accepted, the order status changes to "Accepted".

List of orders

The main screen of the application displays a list of orders. You can go to it from anywhere by clicking on the Android order list.png button.

Общий вид мп.png

When you open the application, orders with delivery for today are displayed in the list. TheAndoid choose date.png button displays orders with the status Today, Scheduled, Closed or Unassigned.

Orders for which delivery has already been rescheduled have a pink background.

Overdue orders are highlighted with a red frame.

The following information is displayed in the list for each order:

  • order number;
  • customer name (in parentheses);
  • recipient name;
  • delivery address;
  • delivery time slot(if available);
  • number of packages (if available);
  • instruction (if available);
  • delivery mode — vertical colored bar on the left. The color is determined by the settings in References > Statuses > 17 Urgency modes.

To change the position of an order in the list, select the order and, holding it, move it to the desired position. This way, for example, you can move all pickups to the top of the list. After moving, a button Отменить перемещение.png will become available on the top panel, with which you can return the list to its original form.

Quick order actions

If you move the order in the list from right to left, the quick edit buttons will become available:

Button Call.png — call the recipient;

Button Comment.png — add a comment;

Button Going there.png — set the status "On my way". When you hold down the button, a navigator selection opens to build a route to the recipient;

Button Undelivered.png — close the order as undelivered.

Orders for today

Click the Andoid choose date.png button and select «Today» to view orders. Orders sent to the courier in this method are displayed in the Delivery section with the status (both primary and "as per the courier") Handed over. Orders are displayed as issued regardless of when they were issued, therefore if a courier received an order a year ago and it still has the status Handed over, it will be displayed as issued.

The number of delivered orders that the courier should currently have on hand is shown in the list's top line, along with the overall number of orders for today and the number of closed orders (if payment was accepted in cash or by card separately). On the right, synchronization arrows for the server are visible. The arrows are coloured green for successful synchronization, yellow for unsuccessful synchronization but reasonably current data (up to 30 minutes), and red for unsuccessful synchronization for longer than 30 minutes. When the header is clicked, a statistics window appears with information such as the sums the courier accepted, the total number of orders delivered and unfulfilled, the time of the most recent unsuccessful attempt to synchronize with the server, and the most recent successful synchronization.

If there are less than two hours until the delivery window closes, orders on the list are highlighted in yellow; if there are less than one hour to go, they are marked in red.

Scheduled orders

You can view orders planned for delivery but not yet issued in the application so that the courier can arrange upcoming deliveries.

Click the Andoid choose date.png button and select «Scheduled» to view planned orders.

In this mode, orders that have been scheduled for delivery but have not yet been given to the courier are shown. Such orders have the "Issue to courier" field filled up in the MeaSoft system. The planned delivery date is not taken into consideration, therefore orders that were scheduled for delivery by courier a year ago and have not yet been delivered or cancelled are still shown as scheduled.

At the top of the list is a tally of scheduled orders.

Closed orders

Click the Andoid choose date.png button and select «Closed». The list shows orders with the following statuses:

  • green — delivered,
  • pink — not delivered,
  • yellow — partially delivered.

Orders disappear from the list in the mobile app after confirming their status in the Megasoft system.

You can attach photos to closed orders. They will be added as an attachment to the order.

By pressing the "Back" button, you can return to the "Today" list.

Unassigned orders

The list of unassigned orders displays urgent orders for which no courier is assigned.

To assign an unassigned order to yourself for delivery:

  1. Click on the order in the list of unassigned orders and in the confirmation window click on the Yes button. Order card will open:
    MobileApp TakeOrder.png
  2. Click on the button Handed over to the courier and confirm the change of the order status.

After confirmation in the Measoft system, the order is assigned the same status. In the mobile app, the order is moved to the list of orders for today. П For more information about the delivery of urgent orders, see the section «Urgent orders in mobile app».

Updating the order list

Every five minutes, the list of orders is automatically updated. In some occassions The Android OS may lower the refresh rate to once every 10–20 minutes.

Pull the order list down to force an update.

Click on the top information bar to view the date and time of the last successful update as well as the latest update attempt.

Orders' contents remain constant. The application just shows an order's addition or deletion.

Orders list on the courier's personal account

The courier can view the orders for tomorrow in Courier Personal Account on desktop for more convenient planning of future work.

To log into the mobile app click More > PC Access. In the window that opens tap Get PIN, than go to courier PA page and enter the PIN. To save this authorization for a month, check the box Remember me.

Scheduled orders are located on the Orders for tomorrow tab.

Please note that the PIN code has a 5-minute validity period. If you didn't have time to log into the account before this period expired, you will need to obtain a new PIN code.

Self-issue

If the courier has no incomplete orders from the previous days, they can add the order that is planned for them to the application themselves.

An order must meet the following conditions:

  • be scheduled for this courier;
  • the date of delivery of the order must be today.

Tap the Button Barcode.png button and scan the shipment barcode to issue an order. Scan each package's barcode if the shipment contains several packages.

Your order list will now include a scanned item, and the tracking status of the shipment in the Measoft system will now read Handed over.

Display on the map

To display orders on the map, click on the Button Map.png button.

An interactive map opens on which orders and the current position of the device are marked:

Map.png

Button Period.png is designed to filter orders by time slots. When you click on the button on the left, the time slots of orders assigned to the courier appear on the map. You can select one or more slots, and the corresponding addresses will be displayed on the map.

The colors of address labels can be as follows:

  • custom colors corresponding to the time slot. Time slots and colors are configured in the References > Statuses > 61 Time slots. The label on the map takes the status color only if the time slot exactly matches the status slot;
  • orange — the order slot does not match the preset slots and there are less than 2 hours left for delivery;
  • red color — less than an hour left or expired;
  • green color — all other orders.

The colour of the label on the map is decided by the earliest time slot if there are multiple orders at the same address.

Orders are numbered on the map in accordance with the order of the route, built using automatic routing service, or according to the shipment transfer certificate.

A hint with order information is shown when you click on the mark. The order card is opened by clicking the hint.

Andoid choose date.png button allows you to filter the dispalyed orders.

You can see the quantity of the orders in the upper right corner if they could not be displayed on the map. Click on the line with the quantity to be taken to the list of orders that were not found.

Order card

Open the order card in one of the following ways:

  • click on the order line in the list;
  • click on the hint on the map;
  • scan the barcode of the order.

The order card contains the following elements:

МП Схема карточка заказа.png

Courier regulations  — rules of work with the client and individual terms of delivery of orders. It is stored in the office application in the client card.

The number in the route is displayed if the order has been assigned a number in the route. The same number is recorded in the delivery and acceptance certificate to the courier, if it is configured in the variable Сохранять номер строки в акте передачи курьеру
. Using these numbers, you can organize a paperless process of accepting returns from the courier.

Order statutes — for more information, see the section «Setting Statuses».

The order functions can be as follows:

МП функция 1.png — enable the client's waiting timer. Time of waiting for the client is rated in coutier's wage rate.

МП функция 2.png — take a photo. The photo is automatically attached to the order.

МП функция 3.png — write a comment to the order. The comment is displayed in the courier's order list.

МП функция 4.png — view additional information on the order.

МП функция 5.png — view the list of items. The function is available for orders of customers whose carddoes not allow partial buyout.

МП функция 6.png — access to the pickup functions:

МП функция Принять забор.png — accept the pickup from the customer. For more information see «Receiving shipments from a customer».
МП функция калькулятор.png — open the shipping cost calculator. For more information see «Calculator».
МП функция создать заказ.png — create an order for the delivery of the collected goods.
МП функция печать.png — printing of documents: labels, certificates or invoices. The function is available if the printer is connected to the phone via bluetooth.
МП функция закрыть.png — close pickup functions.

The set of available functions depends on the type of order and its parameters.

Editing the weight and dimensions of packages

The courier can edit the weight and dimensions of the order items if they are not specified or not correct.

To change the weight or dimensions of a package:

  1. In the order card, click on the link with information about the weight and number of package:
    Заказ с местами.png
  2. «Edit packages» window will open. Change the data and click the Save button.
    Редактирование мест.png

The package is generated and presented in the office application in the shipment card on the Packages tab with the information entered by the courier if there was no package in the dispatch card and the courier changed the parameters.

"On my way" notification

Click on the recipient's address in the order card to change the status to On My Way for an order.

To cancel the status tap on the recipient's address once more within 30 seconds of setting the status.

The server and office system receive the status On My Way after 30 seconds.

Recipients may receive notifications that the courier is on the way from the office system.

Navigation to the delivery address

To set a route:

  1. In the order card, tap and hold the recipient's address.
  2. Select navigator.

Please note: Navigation may not be available if the delivery address could not be determined on the map. For more information, see the section «Display on map».

Setting statuses

Statuses can only be changed for orders For today..

To change the status of an order, open its card. The following statuses are available:

  • Delivered;
  • Recieved;
  • Partially delivered;
  • Not delivered.

Full delivery

  1. In the order card, set the status to Delivered.
  2. On the phone screen, obtain the recipient's signature, then press the Save button. It is expected that the recipient has given the courier the necessary amount of money. After a successful card payment through an integrated service or fiscalization, the order will be saved in such scenario.

As a result, MeaSoft receives the order status and signature. You can view the signature in the shipment card by clicking Features > Attached files, as well as in the client account.

A closed order disappears from the list of orders For today and moves to the Closed. It is impossible to change the status of such an order.

Partial delivery

Partial delivery is possible if the following conditions are met for the order:

  1. In shipment card the Partial buyout allowed box is checked.
  2. In shipment card the Cash Payment box is unchecked.
  3. For urgent orders: any order status, except for "Went to return" and "Delivered (one way)".

To close an order as partially delivered:

  1. In the order card, set the status Partially delivered.
  2. If the order is cash on delivery and a choice of payment type is available, set the value of the payment type.
  3. If there is a cash on delivery in the order, but there are no order items, enter the amount that the recipient actually transfers.
    If there are order items with prices and quantity in the order, specify the quantity of goods transferred to the customer using the buttons МП Удалить товар.png and МП Добавить товар.png. The amount to be paid is displayed above the list.
    If there are items marked with barcodes in the order, Scan button will appear. To close the order, it is required to scan the barcodes of the items that the customer is refusing.
  4. Specify the reason for the refusal.
  5. Get the recipient's signature on the phone screen and click on the Save button. It is assumed that the courier has accepted the required amount of money from the recipient. In case of card payment via integrated service or fiscalization, the order will be saved after successful payment.

If the seller has a buyout amount at which shipping for the recipient becomes free, and no differential shipping cost is configured for the order, the partial shipping courier can remove the delivery as an order item.

If the customer has rejected all items and you only need to charge the customer for delivery, make a partial refund on all items and leave only delivery in the order items.

Note. If the pre-paid items are returned, the courier does not refund the customer's money. The goods' vendor is responsible for all transfers for refunds.

How to compile a list of refusal reasons

And4.jpg

Not delivered

If the order is not delivered, select the status Not delivered, specify the reason and, if necessary, add a text comment. How to set up a list of reasons for non-delivery

To save the order, press «Save».

Return the order for execution

If the courier set the "Not Delivered" status by mistake or if the recipient called back and said they were ready to recieve a delivery, the courier can return the completely undelivered order for execution and complete it.

The option is enabled in the courier service account settings: Settings > Couriers > Allow couriers to return not delivered orders for execution. As a result, the Return for execution button appears in the mobile app in the card of a closed not delivered order:

МП вернуть в работу.png

To return a closed order:

  1. Go to the list of closed orders and open an order card.
  2. Click the "Return for execution" button.
  3. Open your order list for today and update it.

The option does not work for urgent orders and orders with partial returns.

Pickups

There are the following ways to work with a pickup:

  • the courier receives a request to pick up the order in the mobile application. The order appears in the order list and is labeled "PICKUP!". The courier takes the items from the recipient:
    • by scanning the marking barcode with the «Receiving shipments from a customer» function;
    • by the delivery and acceptance certificate. Unmarked shipments are marked duringscan in at the courier service company;
  • the courier creates the request themselves. For that in courier service account box
    Сouriers can create pickup orders should be checked.

To create a pickup request in the mobile app:

  1. Tap More > Create Pickup.
  2. Fill in the fields of the form and click on the Save button.

The pickup is automatically assigned to the courier who created it.

Creating delivery orders

Courier can create orders for delivery of accepted pickups. To do this:

  1. In the pickup card, click on the button МП функция 6.png, then МП функция создать заказ.png, fill in the data for the shipment and click Save.
  2. Repeat step 1 for each shipment.

Cost and delivery time is calculated according to the customer's plan.

Orders are transferred into the office system and are assigned to the couriers.

Receiving shipments from a customer

To accept shipments from a customer, in the pickup card click on МП функция 6.png, than МП функция Принять забор.png and scan labels or delivery slips.

The Collected from sender status is set for fully received items in the client account. The client can choose whether to print the delivery slips for all items or only for those received by the specific courier using the "Print Reports" button.

The Accept button appears if there are unaccepted orders for delivery from the selected customer in the system. Acceptance of shipments is also carried out among them.

If the courier works in a microbranch at the time of receipt of the shipment, the order is automatically issued to him for delivery, if the destination city of the order is the same as the courier's city.

Calculator

The delivery cost calculator is available for orders with the "Pickup" type.

To calculate the delivery cost:

  1. Open the order card with the type "Pickup", click on the МП функция 6.png button, then МП функция калькулятор.png.
  2. Specify the destination city and the weight of the order.

This will display the possible modes of urgency, cost and timing.

And7.jpg

Pickup with cash payment

When the status Received is set for the pickup with the amount, in addition to the possibility of entering info, a window appears with the confirmation of the amount of received funds. It may be different from the initially declared amount.

And8.jpg

Payment types

Orders can be paid by cash or card. If card payment is selected, the app will display the word "Card!" next to the amount to be accepted from the order recipient.

To allow the recipient to choose the type of payment, in MeaSoft open client card and on the Finance tab check the Ask recipient for payment type checkbox. As a result:

  • a drop-down list with payment types appears in the order window in the application. Information about the selected type is transferred to MeaSoft along with the delivery status;
  • if card payment is selected, when you save the order with the status Delivered or Partially delivered, you try to pay via selected service. The order is saved only after successful transaction.

The inscription "PAID!" in the order card appears when there is an acquiring transaction ID.

Receipt printing

To set up the receipt printing, in MeaSoft in the client card on the "Cash register" tab, check the "Print receipts" box. As a result:

  • in the application, the word "Receipt!" will appear in the order card next to the amount to be accepted from the recipient;
  • when you save an order with the status Delivered or Partially delivered, the receipt is printed with the help of the selected fiscalization method. The order status is not saved if fiscalization has not been performed.

Rescheduling

Situations when it may be necessary to reschedule a delivery may be as follows:

  • the courier does not meet the set delivery time slot, they need to extend the deadline by a couple of hours or reschedule the delivery. They call the recipient, agree with them to reschedule, and mark it on the call status. In this case, the goods remain with the courier, the order is still in the list of orders of the courier;
  • the recipient informed the courier that they could not accept the order. In this case, the courier sets order status Not delivered, indicates the reason Rescheduled by recipient and takes the order back to the office. The order disappears from the list in the app. Subsequently the order can be given to another courier or the delivery can be cancelled.

Calls

Calls from the mobile app can be made via mobile data or via the telephony server Asterisk. For more information see the «Mobile app integration».

Conversation with the recipient

In the app, you can call the recipient or note that the recipient called you and set the result of the call. You can disable the query for the result in courier service account.

To call the recipient or mark an incoming call:

  • in the order card, press and hold the phone number;
  • in the order list, move the order to the left and click on Button Call.png.

A window will appear where you can select the phone number and method of making the call:

  • if you call the recipient:
    Звонок через Asterisk.png — call via telephony;
    Звонок по сотовой связи.png — call via mobile data;
  • if the recipient called you, select Incoming.

After the call, the window for selecting the result of the call appears.

Перенос даты.png

Select a status, add a comment if necessary, and click the OK button.

If you want to reschedule the delivery time by agreeing with the recipient, select "Reschedule" and specify the new time slot and delivery date. Then enter a comment if necessary and click the OK button. As a result, the new delivery time will be displayed in the shipment card and in the list of orders in the mobile application.

Call statuses are stored in the References > Statuses > 77 Call Results. The statuses set by the courier are saved in MeaSoft and are available in the order card via the Functions > Message History button and on the Issue tab in the Calls column.

Call sender

Expand the sender section of the order form. Tap and hold the sender's phone number. The application prompts you to select the desired number and makes a call to it.

Call the office

Tap the 3 dots.png button in the main menu and select the Calls setting item. In the window that opens, click the Call the office button. The system will try to connect to the internal number of the caller group via Asterisk. If the attempt was not succesfull — will call the standard dialer by giving it the office phone number, which can be specified under Settings > Couriers of the courier service aacount.

And6.jpg

Random number call

Tap on 3 dots.png button in the main menu and select Calls. In the line below the Call the office button, enter the phone number and click the Call button.

Overview

After selecting a phone number, the application sends a request to the server. The server registers the fact of the call and sends a request to the telephony server Asterisk, if connection is set up. The courier is notified that the request is accepted. Then the telephony server calls the courier, then the recipient and connects them.

If the app fails to send a request or if the telephony connection is not set up, the app calls the standard dialer and sends it a command to make a call.

For successful calls from the mobile application via the phone server in the courier card must be entered the cell phone number in the appropriate field.

Customer Waiting Timer

To start the timer, in the order card click on the button МП функция 1.png and confirm the action.

The timer will stop when the courier sets the delivery status.

The waiting time in minutes is transferred with the Waiting status and is stored in the Waiting field of the shipment card.

After receiving the waiting time on orders, you need to recalculate the cost of delivery, so that the system additional service Waiting will work.

Taking photos

You can attach photos to the order card by clicking the button МП функция 2.png.

If no photos are attached to the order, the camera will open immediately.

Take a picture of the object and confirm that it should be attached to the order. You will see a window with all the photos attached to the order.

To add a photo, click the Add button.

To delete a photo, tap and hold the photo for a few seconds, then confirm the deletion.

Photos are sent to the system when you save the order card. ' To view the attached photos, in the shipment card, click Options > Attached files. The photos are also available in the client account.

Courier tracking

The application tracks the current location of the device in the background and transfers this information to the office system. It uses GPS (only when the phone is charging, periodicity - 10 seconds) and mobile data/Wi-Fi (when the phone is not charging, periodicity - 5 minutes) to determine the position.

Google Maps determine position by GPS. The application uses it only when the phone is charging, otherwise the battery will run out in a couple of hours. In the background mode, Wi-Fi+GSM detection is used. This requires:

  • high-precision positioning mode (by GPS, Wi-Fi and mobile networks) in the location settings of the phone;
  • Wi-Fi is enabled (even if the phone is not connected to networks);
  • working mobile data connection - a must, the coordinates are taken only from Google servers.

If these conditions are met, the CA will mark the possibility of positioning in two ways and will be able to see the tracks of the courier.

The high-precision mode is set depending on the phone model. For example, in Xiaomi Mi-4C, if you press and hold the GPS button, in the upper drop-down list of options, the Location settings screen opens (this screen can also be called via Settings > Other settings > Privacy > Location). There is a choice of 3 options there:

  • high precision (GPS+Wi-Fi+GSM);
  • battery saving (Only Wi-Fi+GSM);
  • by the device (Only GPS).

To view the current position and tracks of couriers in MeaSoft, go to Options > Courier Tracking. For more information see «Courier tracking».

Troubleshooting

A message is displayed when the application is started

Synchronize the server with your client account. Contact your system administrator.

  1. In the MeaSoft office system, open References> Additional Modules.
  2. Uncheck the Client Account and Mobile Apps boxes. Click OK.
  3. Open References'> Additional Modules again, check the checkboxes and click OK.
  4. After about an hour pull the order list 2 times from the top down in the mobile app.

Phone does not appear on the map in the courier tracking

  • Make sure your phone has GPS and network positioning and wi-fi enabled.
  • Make sure that the mobile connection is on and working (without it the phone will not be able to take coordinates by networks and wi-fi).
  • Make sure the date and time settings on your phone are correct. If the date is wrong, you will see tracks "on the wrong date".

Please note that in the section «Phones» of the courier service account problematic options (GPS, networks, phone time, sync time, app version) are highlighted in pink, so you can always quickly diagnose problems with all couriers.

The phone zigzags between two trajectories

  • The time changes on the phone

Unfortunately, it is a quite common situation when the time on the same phone jumps because the time zone is incorrectly set (in Android manufacturer never changed the time of transition to summer/winter time), the phone takes the time from the base operator stations, which are also not always configured correctly: sometimes it happens that you walk through one city, look into the phone, and it shows the wrong time and the weather in another city, just like if you have moved there. There is an assumption that operators sometimes copy the settings of base stations from other regions. And it also gets time from satellites when GPS is on. As a result, the time can bounce around. Solution - disable time zone autodetection, autoset clocks in phone settings, set correct time zone and current time manually. Also in some programs, by default there is a tick for autocorrection of system time by satellites. This also needs to be disabled. This also does not guarantee that the time will be correct - Android still can have that kind of bug.

  • Wi-Fi hotspot moved

Google registers its Wi-Fi networks, by MAC addresses of access points, and records their locations. Then, when the phones are positioned, they look at what wi-fi networks are in range, and ask Google for their coordinates. This allows positioning indoors, as well as increasing the speed, accuracy and energy efficiency of positioning. However, if the access point was moved to another location - Google may not know about it for a while, and transmit the coordinates of the old location of the access point to the phone. If your office/warehouse has such an access point, try to "tell" Google that it has moved: turn on GPS (e.g. Google Maps) in that network's access area (better - have your phone connected to it), make sure that GPS is connected to satellites, and wait for a while. Logically, the phone should "understand" that the "reliable" coordinates from the satellites do not match the wi-fi coordinates, and report this to Google, so that they change the coordinates of the access point. How reliable and fast this method is unknown.

Order search by barcode

To search for orders by barcode, press the Barcode Scanner button. A scan window opens. Scan the barcode from the extended delivery slip, the label of the whole order and the package. If the scan is successful, the order will be accepted by the courier. If you scan the code again, it will open the order itself.

Urgent orders in mobile app

For deliveries from point A to point B, there is an Urgent function.

In order for urgent orders to be displayed in the mobile app, the conditions must be met:

  • An address card must be created in MeaSoft for an urgent order. To create an address card, on the Urgent tab in the Enter new urgent order window in the lower left corner, click the button without the icon or set up automatic creation of the card in variables
    ;
  • the scheduled pickup date must be the current date.

The display of rush orders in the mobile app is also affected by the following checkboxes in courier service account:

  • Couriers can take unassigned urgent orders — If the checkbox is checked, the courier can take the order that has not been given out to anyone before. See «Unassigned orders»;
  • 'Do not show urgent orders with an empty status to a courier — if the checkbox is checked, you need to specify the courier in the Urgent card and change the status, for example, to "Handed over to the courier";

In the mobile app, urgent orders are distinguished by an arrow on the left, a change in the color of the addresses' font, and an expanded list of statuses:

МП Срочные.png

The down arrow means order is one way, the two-way arrow means it is a round trip.

The courier marks the stages of delivery with the statuses set in the order card.

Address colors and statuses:

  • top address is yellow - went to pick up, arrived;
  • top address is green - picked up;
  • bottom address is yellow, top is address green - went to deliver;
  • bottom address is green, top address has no color - delivered (one way);
  • bottom address is green, top address is yellow - went back.

To set the courier status, in the mobile app open the order and tap the button with the status name, then tap the "Confirm" button:

МП карточка срочного.png

The time in the order list and on the map changes depending on the status: before pickup the pickup time is displayed, after that - the delivery time.

Contactless delivery via PIN

If the order was paid in advance or if payment is not provided for the order, you can send the recipient an SMS or e-mail with a code.

As soon as the courier hands them the order (for example, puts it on a front porch), the recipient will say the code and the courier will close the order without getting a signature.

For the functionality to work, the SMS module and the Automation module must be connected, also additional configuration of the system by the administrator is required.

Contactless pin code delivery works as follows:

  1. The Verify by pin code checkbox is added to the Custom tab of the client card. It must be checked.
  2. Automation generates a pin code and stores it in the Other tab of the shipment card in the PIN field.
  3. Administrator sets up the automatic task to send the pin code to the recipient by SMS after the order is given to the courier. If the recipient is already receiving a hand over notification, the pin code will be added to the text. You can also send the pin code to the recipient manually via E-mail or SMS from the shipment card by selecting Options > Send > SMS/E-mail to recipient with the dispatcher phone number and pin code.
  4. In the mobile app, the courier selects the desired status for the order and enters the delivery pin code that the recipient tells him.
  5. If the pin code is lost or did not come to the recipient's phone, the courier can send the pin code again or change the recipient's phone number. The ability to change the phone number to get the pin code is controlled by the setting in the courier service account: Settings > Couriers > Courier cannot edit phone number intended for receiving delivery PIN.
  6. If the pin code matches, the courier hands over the order and sets the status. If the pin code does not match, an error is displayed.

The value of the pin code is unknown to the courier.

Mobile app logs

When contacting technical support with questions about the mobile app, you may need log files. The files cannot be accessed remotely and can only be retrieved directly from the mobile device.

Starting with version 3.33.05, the courier can send logs directly from the mobile app via messenger or by email. To do this, open More > Send logs > Send and select a convenient method of sending.

The log files of the mobile app are stored on the mobile device:

  • for application version 3.24.07 and higher - in the folder Android/data/ru.measoft.courier/files/logs;
  • for application version up to 3.24.07 - in the folder .courier/logs.

File name format:

  • for application version 3.24.07 and higher — year-month-day-hour.log. For example, file «2021-12-20-17.log» is a log from December 21, 2021 from 5 until 6 p.m.;
  • for application version up to 3.24.07 — month_day_hour_min.txt. For example, file «02_16_12_00.txt» is a log from February 16 from 12.00 until 12.59 a.m.

To copy log files:

  1. On your mobile device or when connected to a PC, open an explorer or file manager and enter the name of the logs folder ".courier/logs" in the search box. It is recommended to use the Total Commander file manager.
  2. If the search is unsuccessful, turn on the display of hidden folders in the file manager or explorer settings.
  3. Repeat search.
  4. Copy the log files for the desired period. Before sending them to tech support, merge the files into an archive.
  5. If you are sending application logs to different couriers, merge the text files into archives, a different archive for each courier.