Courier mobile app for Android

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.

Для работы с кассами АТОЛ необходимо, чтобы устройство было на базе архитектуры ARM. 98 % представленных на рынке устройств построены именно на этой архитектуре.

Installation

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:

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.

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 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 button.

When you open the application, orders with delivery for today are displayed in the list. The 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 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:

 — call the recipient;

 — add a comment;

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

 — close the order as undelivered.

Orders for today

Click the 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 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 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:
   
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 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.

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

Button 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.

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:

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:

 — enable the client's waiting timer. Time of waiting for the client is rated in coutier's wage rate.

 — take a photo. The photo is automatically attached to the order.

 — write a comment to the order. The comment is displayed in the courier's order list.

 — view additional information on the order.

 — view the list of items. The function is available for orders of customers whose carddoes not allow partial buyout.

 — access to the pickup functions:

 — accept the pickup from the customer. For more information see «Receiving shipments from a customer».

 — open the shipping cost calculator. For more information see «Calculator».

 — create an order for the delivery of the collected goods.

 — printing of documents: labels, certificates or invoices. The function is available if the printer is connected to the phone via bluetooth.

 — 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:
   
2. «Edit packages» window will open. Change the data and click the Save button.
   

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 and . 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

The references are edited under References > Statuses > 28 Reasons for partial refusals.
Additional information to the items in the references: a valid reason, such as a damaged item, refusal should not affect the cost of delivery and discounts. In addition, even if the item should be kept in stock at the courier service, it will automatically go to the return to the customer.

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

The list of reasons is created in the References > Statuses > 6 Reasons for non-delivery section. To customize the status, select Additional information from the context menu and set additional parameters.

Some fields may be necessary for office staff, but not available to couriers. In this case, specify 0 in the first parameter.

For example, the additional information to the reason for non-delivery Transferred by recipient via phone should look like 1, 1, 0, 0: "Available to courier, Rescheduled (need to check and enter a new date and still deliver), Wasn't at the place(shouldn't have charged for full refund), Not our fault".

To make specifying the reason for non-delivery mandatory, set the value of the variable Запрашивать примечания для статуса "Не доставлено"

.

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:

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
  'Fields Settings > Parameters > Advanced
  С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 , then , 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 , than 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 button, then .
2. Specify the destination city and the weight of the order.

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

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.

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 .

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

• if you call the recipient:
  — call via telephony;
  — call via mobile data;
• if the recipient called you, select Incoming.

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

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 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.

Random number call

Tap on 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 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 .

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.

Телефон не отображается на карте в трекинге курьеров

• Убедитесь в том, что в телефоне включен GPS и позиционирование по сетям оператора и wi-fi.
• Убедитесь, что включен и работает мобильный интернет (без него телефон не сможет снять координаты по сетям и wi-fi).
• Убедитесь в корректности установки даты и времени на телефоне. Если дата неверная, треки вы будете видеть «не в той дате».

Обратите внимание, что в разделе «Телефоны» личного кабинета проблемные опции (GPS, сети, время телефона, время синхронизации, версия приложения) подсвечиваются розовым цветом, так что вы всегда можете быстро диагностировать неполадки у всех курьеров.

Телефон делает зигзаги между двумя траекториями

• В телефоне меняется время

К сожалению, достаточно частая ситуация, когда время на одном и том же телефоне перескакивает из-за того, что неверно настроен часовой пояс (в андроиде производитель так и не изменил время перехода на летнее/зимнее время, не скорректировали с учетом последних изменений российского законодательства), телефон берет время из базовых станций оператора, которые тоже не всегда корректно настроены: иногда бывает, что идешь по Москве, смотришь в телефон, а он показывает время на 3 часа больше, и погоду в Екатеринбурге, с полной уверенностью, что я туда переместился. Предполагаю, что операторы иногда копируют настройки базовых станций из других регионов. И еще он получает время со спутников, когда включен GPS. В итоге время может скакать. Решение — отключить в настройках телефона автоопределение часового пояса, автонастройку часов, выставить верный часовой пояс и текущее время вручную. Также в некоторых программах, например, в навител.навигаторе по умолчанию установлена галка для автокоррекции системного времени по спутникам. Такое тоже нужно отключить. Это тоже не дает гарантии, что время будет корректным — андроид даже так иногда приглюкивает.

• Переехала точка доступа WiFi

Google регистрирует у себя WiFi сети, по MAC-адресам точек доступа, и фиксирует их местоположение. Потом, когда телефоны позиционируются — они смотрят, какие wifi сети есть в радиусе действия, и спрашивают их координаты у гугла. Это позволяет позиционироваться в помещениях, а так же повышает скорость, точность и энергоэффективность позиционирования. Однако, если точку доступа перенесли в другое место — google какое-то время об этом может не знать, и передавать телефону координаты старого расположения точки доступа. Если в вашем офисе/складе есть такая точка доступа — попробуйте «рассказать» гуглу, что она переехала: в зоне доступа данной сети (лучше — чтобы телефон был к ней подключен) включите GPS (например — google-карты), убедитесь, что GPS подключился к спутникам, и какое-то время подождите. По логике — телефон должен «понять», что «надежные» координаты от спутников не совпадают с координатами по wifi, и сообщить об этом в google, чтобы там изменили координаты точки доступа. Насколько этот способ надежен и быстр — известно только Большому Брату :-)

Поиск заказа по штрихкоду

Для поиска заказов по штрихкоду нажмите кнопку «Сканер штрихкода». Откроется окно сканирования. Отсканируйте штрихкод с расширенной накладной, наклейки всего заказа и места. В случае успешного сканирования заказ будет принят курьером. Если отсканировать код еще раз — откроется сам заказ.

Срочные в мобильном приложении

Для доставки из пункта А в пункт Б предназначен функционал Срочные.

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

• в системе MeaSoft для срочного заказа должна быть создана карточка адреса. Чтобы создать карточку адреса, на вкладке Срочные в окне «Ввод нового заказа на срочную доставку» в левом нижнем углу нажмите на кнопку без иконки или настройте автоматическое создание карточки в переменных
  Справочники > Переменные > Срочные > Синхронизация с адресами > Автоматически создавать "Адреса"
  ;
• плановая дата забора должна быть текущей датой.

На отображение срочных заказов в мобильном приложении также влияют следующие флажки в административном личном кабинете:

• Разрешить невыданные заказы — если флажок установлен, курьер может взять себе не выданный никому до этого заказ. Подробнее см. раздел «Невыданные заказы»;
• Не показывать курьеру срочные с пустым статусом — если флажок установлен, в карточке срочного нужно указать курьера и изменить статус, например на «Передано курьеру»;

В мобильном приложении срочные заказы отличает наличие стрелки слева, изменение цвета шрифта адресов и расширенное количество статусов:

Стрелка вниз означает заказ только туда, двухсторонняя стрелка — туда-обратно.

Курьер отмечает этапы доставки при помощи статусов, устанавливаемых в карточке заказа.

Цвета адресов и статусы:

• верхний адрес желтый — поехал забирать, прибыл;
• верхний адрес зеленый — забрал;
• нижний адрес желтый, верхний адрес зеленый — поехал доставлять;
• нижний адрес зеленый, верхний адрес без цвета — доставил туда;
• нижний адрес зеленый, верхний адрес желтый — поехал обратно.

Чтобы установить статус курьера, в мобильном приложении откройте заказ и нажмите на кнопку с названием статуса, затем нажмите на кнопку Подтвердить:

Время в списке заказов и на карте изменяется в зависимости от статуса: до забора отображается время забора, после — время доставки.

Бесконтактная доставка по пин-коду

Если заказ был оплачен заранее или оплата по заказу не предусматривается, можно отправить покупателю СМС или e-mail с кодом.

Как только курьер передаст ему заказ (например, положит на скамейку рядом с подъездом), покупатель назовет код и курьер закроет заказ без получения подписи.

Для работы функциональности должны быть подключены Модуль отправки СМС сообщений и Модуль автоматизации, также необходима дополнительная настройка системы со стороны программиста.

Бесконтактная доставка по пин-коду работает следующим образом:

1. В карточку клиента на вкладку Пользовательские добавляется флажок Верификация по пин-коду. Его нужно установить.
2. Автоматизация генерирует пин-код и сохраняет в его карточке корреспонденции на вкладке Прочее в поле Пинкод.
3. Программист настраивает автоматическое задание на отправку пин-кода получателю в СМС после выдачи заказа курьеру. Если уже работает рассылка получателю о выдаче заказа курьеру, то пин-код будет добавляться в текст рассылки. Также отправить пин-код получателю можно вручную через E-mail или СМС из карточки корреспонденции, выбрав Функции > Разослать > SMS/E-mail получателю c указанием телефона диспетчера и пин-кодом.
4. В мобильном приложении курьер выбирает нужный статус для заказа и вводит пин-код доставки, который ему сообщает получатель.
5. Если пин-код утрачен или не пришел на телефон получателя, курьер может отправить пин-код повторно или изменить номер телефона получателя. Возможность изменять номер телефона для получения пин-кода управляется настройкой в личном кабинете курьерской службы: Настройки > Курьеры > Запретить менять номер телефона для получения пин-кода доставки.
6. Если пин-код совпадает, курьер вручает заказ и устанавливает статус. Если пин-код не совпадает, отображается ошибка.

Значение пин-кода курьеру не известно.

Логи мобильного приложения

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

Начиная с версии 3.33.05, курьер может отправить логи непосредственно из мобильного приложения через мессенджеры или на почту. Для этого откройте Еще > Отправить логи > Отправить и выберите удобный способ отправки.

Файлы логов мобильного приложения хранятся на мобильном устройстве:

• для версии приложения 3.24.07 и выше — в папке Android/data/ru.measoft.courier/files/logs;
• для версии приложения до 3.24.07 — в папке .courier/logs.

Формат названия файла:

• для версии приложения 3.24.07 и выше — год-месяц-день-час.log. Например, файл «2021-12-20-17.log» это запись за 20 декабря 2021 года с 17 до 18 часов;
• для версии приложения до 3.24.07 — месяц_день_час_мин.txt. Например, файл «02_16_12_00.txt» это запись за 16 февраля с 12.00 до 12.59 часов.

Чтобы копировать файлы логов:

1. На мобильном устройстве или при подключении к ПК откройте проводник или файловый менеджер и в поиске введите название папки логов «.courier/logs». Рекомендуется использовать файловый менеджер Total Commander.
2. Если поиск не дал результата, в настройках файлового менеджера или проводника включите отображение скрытых папок.
3. Повторите поиск.
4. Скопируйте файлы логов за нужный период. Перед отправкой в техподдержку объедините файлы в архив.
5. Если вы отправляете логи приложений разных курьеров, объедините текстовые файлы в архивы, для каждого курьера свой архив.

Фискализация

Фискализация — это формирование фискального документа. Фискализация кассового чека состоит из 3 процедур:

1. Создание чека в соответствии с ФФД (и требованиями Закона № 54-ФЗ по реквизитам).
2. Передача чека (соответствующего ФФД) в ОФД.
3. Передача чека в ФНС.

MeaSoft поддерживает следующие схемы фискализации в мобильном приложении:

• LIFE PAY
• АТОЛ

Удаленная фискализация LIFE PAY

Для работы удаленной фискализации LIFE PAY:

1. Заключите договор с фирмой LIFE PAY.
2. Перейдите Справочники > Фирмы, выберите фирму и создайте для нее фискальный регистратор (вкладка Устройства).
   1. В поле Номер фискального регистратора укажите через запятую:
      • 32-значный АПИ-ключ. Его можно найти в личном кабинете LIFE PAY;
      • номер телефона, на который зарегистрирован ЛК LIFE PAY. Номер должен начинаться с 7, без знака "+";
      • если планируется переход на ФФД 1.2, добавьте ссылку https://sapi.life-pay.ru/cloud-print-ffd1_2/.
   2. В поле Выберите тип устройства укажите Life-Pay облачная фискализация.
3. В карточках сотрудников в поле Телефон мобильный укажите телефоны курьеров, привязанные в личном кабинете LIFE PAY.
4. В устройстве курьера, помимо последней версии мобильного приложения, должно быть установлено приложение LIFE PAY.
5. В карточке клиента на вкладке Касса установите флажок Печатать кассовые чеки.
6. Клиент должен работать с фирмой, в которой создан фискальный регистратор из 2 пункта.
7. В заказе должен быть указан корректный телефон получателя.
8. У заказа обязательно должны быть вложения.
9. Сумма заказа должна быть не менее 30 рублей.

Возможные ошибки

• Ошибка #6010. Проверьте соответствие мобильного телефона курьера в карточке сотрудника с телефоном курьера в ЛК LIFE PAY.
• Ошибка фискализации (ошибка программирования реквизита 1226).
• При проблемах с облачной фискализацией в справочнике Фирмы > Устройства в поле Номер фискального регистратора добавьте через запятую третий параметр — ссылку https://sapi.life-pay.ru/cloud-print-ffd1_2/.

АТОЛ

Фискальный регистратор (далее ФР) АТОЛ 11Ф позволяет курьеру печатать чеки, подключив его к мобильному приложению с помощью Bluetooth. Также поддерживается модель АТОЛ 60Ф, но без эквайринга.

Регистрация ФР

Перерегистрировать ФР можно 11 раз. Регистрация ФР происходит с помощью программы «Утилита для регистрации ККТ», которая входит в пакет драйверов АТОЛ ККТ (DTO) последней версии. Рекомендуемая версия 8.14.02.02, которую можно скачать по ссылке.

ВАЖНО: для правильного налогообложения по агентскому договору и для возможности печати на чеке информации об агенте во время регистрации ФР установите флажок ПЛ. АГЕНТ:

Проверка наличия флажка «ПЛ. АГЕНТ»

1. В отчете о регистрации, который формируется программой «Тест драйвера ККМ»
2. Посмотрите информацию на чеке, который пробивается через ФР или ЛК ОФД.

• 

  Чек о регистрации

• 

  Чек ОФД

Настройка ФР

Для отправки чеков в ОФД настройте передачу данных через Windows-приложение «Тест драйвера ККМ» или мобильное приложение «Тест драйвера ККТ»:

• EthernetOverTransport — рекомендуемый метод. Используется интернет-соединение мобильного устройства, к которому подключается ФР;
• GSM модем — использование СИМ-карты (необходим модуль GSM и установленная СИМ-карта);
• Wi-Fi — использование сети Wi-Fi (необходим модуль wi-fi);
• EoU — передача чеков через подключение к ПК.

Подключение ФР к мобильному устройству

С подробным руководством по эксплуатации можно ознакомиться здесь.

1. Включите режим Bluetooth. Зайдите в сервисное меню:
   1. ФР должен быть выключен. Зажмите кнопку промотки кассовой ленты и включите ФР.
   2. После 5 звукового сигнала отпустите кнопку промотки.
   3. Зайдите в канал обмена (2 нажатия кнопки промотки).
   4. Включите Bluetooth (4 нажатия кнопки промотки).
2. Выйдите из сервисного меню (1 нажатие кнопки промотки).
3. На мобильном устройстве выполните поиск Bluetooth-устройств и выберите XXXXXXX-ATOL_11F.
4. Выполните подключение. ФР напечатает запрос на соединение.
5. Примите соединение сначала на мобильном устройстве, а потом на ФР (нажмите на кнопку промотки).

Подключение ФР к MeaSoft App

В мобильном приложении MeaSoft App:

1. Перейдите в раздел Настройки, выберите в верхнем меню Касса и нажмите кнопку Подключить. PIN-код устройства устанавливается в личном кабинете курьерской службы, на вкладке Курьеры, в карточке курьера.
   
2. Выберите сопряженное устройство в поле Устройство.
   
3. Нажмите на кнопку Назад. При подключении ФР издаст звуковой сигнал. Если не подключается, повторите попытку.

Информация при печати чека

1. Выводятся все товарные вложения.
2. Выводится телефон платежного агента (курьерской службы). Укажите телефон в личном кабинете курьерской службы: Настройки > Курьеры > Городской телефон офиса.
3. Выводятся наименование, ИНН и телефон поставщика (клиента).

Рекомендации

После пробития первых чеков проверьте их наличие в ОФД.

Возможные ошибки при печати чека:

1. Смена превысила 24 часа (3822) — для решения, необходимо зайти в настройки мобильного приложения, выбрать в меню «Касса» и создать Z-отчет.
2. Превышено количество дней на отправку чеков — чеки не уходили в ОФД. Необходимо их отправить любым способом (подключить кассу к интернету).

Эквайринг

Эквайринг — это безналичная оплата товаров и услуг банковскими картами. Система MeaSoft поддерживает ряд интегрируемых сервисов с терминалами, подключаемыми к мобильному устройству, а также можно использовать сторонние банковские POS-терминалы.
Обратите внимание, при отправке слип-чека по SMS может взиматься дополнительная плата.

Выбор платежной системы

У каждой платежной системы свои банки-эквайеры.

Название платежной системы	Метод эквайринга	Оборудование	Описание
LIFE PAY	Приложение	Терминалы Pinpad LIFE PAY, Ingenico ipp 320 и PAX SP 30	Инструкция
ibox	Приложение SDK SDK — это средства разработки, которые позволяют приложению MeaSoft взаимодействовать с POS-терминалом напрямую. По возможности нужно использовать этот способ. SDK не поддерживает ридеры, подключаемые через разъем наушников. Выбор в пользу SDK можно сделать в тех случаях, если на мобильном телефоне мало места для установки приложений.	Ридеры P17, P15, C15	Инструкция
Assist	Приложение	BluePad-50 QPOS Mini При оплате с помощью QR-кодов не требуется	Инструкция
Robokassa	Не требуется	Не требуется	Инструкция
LIFE POS Checkout	Интеграция уже поддерживается. В будущем добавим больше информации.

Выбор оборудования

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

• подключаемое через разъем для наушников (3,5 мм audio mini-jack). Это устаревший ненадежный способ;
• Bluetooth — наиболее надежный тип подключения при работе с платежами.

По функциональности оборудование разделяется на:

• чтение магнитной полосы. В последнее время перестает поддерживаться. Ведущие платежные системы уже начали запрещать проводить платежи магнитной полосой картами, у которых есть чип. Карт без чипов уже практически не осталось.
• чтение чипа. Поддерживается любым современным оборудованием.
• чтение бесконтактных карт. Поддерживается не любым оборудованием, на это рекомендуем обратить особое внимание. Функция передовая и востребованная.

Процесс оплаты заказа через терминал

Для проведения оплаты заказа картой должен быть выбран тип оплаты «Картой при получении» или в карточке клиента установлен флажок Спрашивать тип оплаты у получателя (в этом случае в окне заказа появится выпадающий список, в котором необходимо выбрать тип оплаты). Более подробно можно прочитать в разделе «Типы оплаты».

Упрощенно процесс оплаты банковской картой через терминал выглядит следующим образом:

1. Ввести данные платежа на мобильном устройстве курьера и провести/вставить чип/приложить карту к терминалу;
2. Лицо, осуществляющее платеж, подтверждает оплату с помощью электронной подписи через смартфон, либо с помощью кода, полученного посредством SMS-сообщения;
3. Курьер отправляет Слип-чек в электронном виде, как SMS-сообщение или на электронную почту плательщика.

LIFE PAY

Подключение оборудования

Перед использованием подключите Bluetooth-устройство к ОС Android.

Чтобы подключить терминал Ingenico RP750x:

1. Включите mPOS терминал.
2. Нажмите и удерживайте на терминале кнопку «*».
3. Нажмите на кнопку «2», чтобы начать новое сопряжение.
4. На мобильном телефоне начните сопряжение по Bluetooth, на экране телефона появится код сопряжения.
5. Введите код сопряжения на mPOS терминале.
6. Нажмите на зеленую кнопку на mPOS терминале. Терминал отобразит на экране «В паре устройства». Сопряжение устройств по Bluetooth выполнено.
7. В мобильном приложении перейдите в Еще > Настройки > Параметры эквайринга и выберите LifePay Приложение.

Инструкции по сопряжению других терминалов можно найти в документации к ним.

Проведение платежа через приложение LIFE PAY

Работа в приложении на Android в LIFE PAY

Для работы в MeaSoft App:

1. В настройках приложения выберите Параметры эквайринга > Приложение LifePay.
2. Закройте заказ как доставленный или частично доставленный с типом оплаты Картой при получении. Происходит автоматический переход в приложение LIFE PAY:

   

3. Нажмите на кнопку Оплатить. Сумма и номер заказа автоматически передаются в приложение LIFE PAY.

   

4. При необходимости отправки слип-чека через SMS введите номер телефона и/или e-mail плательщика и нажмите в приложении на кнопку По терминалу. За SMS может взиматься дополнительная плата.
5. Проведите оплату банковской картой по терминалу.

Возможные ошибки

Не проходит эквайринг. При этом мобильный номер курьера в MeaSoft и в личном кабинете LIFE PAY совпадает. Сбросьте кэш обоих приложений и переустановите их.

ibox

Предварительная настройка приема платежей описана в разделе «Интеграция с платежными сервисами».

Платеж через ibox SDK

1. При первом подключении терминала включите bluetooth на телефоне и через системное меню телефона выполните сопряжение устройств.
2. В настройках MeaSoft App выберите Параметры эквайринга > iBox SDK.
3. Закройте заказ как доставленный или частично доставленный с типом оплаты Оплата картой.
4. При первом подключении введите логин и секретный ключ (можно посмотреть в личном кабинете ibox). Обратите внимание, ввести нужно именно секретный ключ, а не пароль пользователя ibox.
   
   

   Номер телефона и e-mail получателя автоматически заполняются из карточки заказа для отправки слип-чека.

5. Происходит автоматический переход в приложение ibox. Перейдите на вкладку Настройки, выберите модель терминала и в открывшемся списке выберите устройство.
   
   
6. При первом подключении выберите терминал.
7. Проведите оплату банковской картой по терминалу.
   
   

Если нужно выйти из аккаунта ibox, замените логин и секретный ключ.

Платеж через модуль NFC

Чтобы начать использовать платежи с помощью модуля NFC на мобильном устройстве курьера, обратитесь в компанию ibox для изменения внутренних настроек клиента.

На мобильном устройстве курьера должна быть установлена ОС Android 9 или выше и приложение tap2go.

Настройте приложение tap2go:

1. Откройте приложение и введите логин и секретный ключ от учетной записи ibox.
2. Введите одноразовый СМС-код.
3. Установите 6-значный код доступа.

Чтобы принять оплату с помощью модуля NFC:

1. В настройках MeaSoft App выберите Параметры эквайринга > iBox SDK.
2. Закройте заказ как доставленный или частично доставленный с типом оплаты Оплата картой, заполните данные заказа и нажмите Сохранить.
3. Происходит автоматический переход в приложение ibox. Нажмите на кнопку ОПЛАТИТЬ NFC и проведите платеж.

Ошибка при проведении платежа на сумму 10000 рублей и более

Наиболее частая причина ошибки — устаревшая прошивка ридера. Для устранения ошибки обновите прошивку, подробнее см. в инструкции.

Платеж через приложение ibox

1. В настройках MeaSoft App выберите Параметры эквайринга > Приложение iBox.
2. Закройте заказ как доставленный или частично доставленный с типом оплаты Оплата картой. Происходит автоматический переход в приложение ibox.
3. Нажмите на кнопку Оплатить. Сумма и номер заказа будут автоматически переданы в приложение ibox.
4. При необходимости отправки слип-чека через SMS введите номер телефона и/или e-mail плательщика. Нажмите в приложении на кнопку Отправить. При нажатии на кнопку Пропустить чек отправлен не будет.
5. Проведите оплату банковской картой по терминалу.
   
   

Assist

Предварительная настройка приема платежей описана в разделе «Интеграция с платежными сервисами».

Чтобы начать использовать систему Assist:

1. Установите мобильное приложение Assist mPOS.
2. В настройках мобильного приложения MeaSoft App в выпадающем списке Параметры эквайринга выберите значение Assist mPOS.
3. Рядом со значением Assist mPOS появится кнопка . Нажмите на нее, введите PIN-код
   В личном кабинете курьерской службы в пункте основного меню Телефоны > Курьерские устройства откройте карточку курьера и скопируйте значение поля PIN-код POS-терминала.
   и нажмите на кнопку Проверить.
4. В окне «Настройки Assist» укажите логин, пароль и ИД магазина согласно вашим учетным данным Assist и нажмите на кнопку Сохранить.

Чтобы провести платеж:

1. В MeaSoft App в поле Тип оплаты выберите Оплата картой.
2. Укажите статус заказа Доставлено или Частично доставлено и нажмите на кнопку Сохранить.
3. При необходимости заполните информацию во всплывающем окне и нажмите на кнопку Сохранить.
4. Откроется мобильное приложение Assist mPOS. Вы можете выбрать способ проведения оплаты:
   • картой через терминал;
   • QR-код для считывания мобильным банковским приложением покупателя (СБП);
   • наличными.

После совершения оплаты получателю направляется электронный чек. У курьера заказ закрывается.

Особенности оплаты с помощью QR-кода

1. Оплата кредитной картой невозможна.
2. Система Assist дает 10 минут на завершение платежа пользователем. Это время настраивается на стороне Assist.

Если в MeaSoft App сразу не пришел ответ об успешной транзакции, курьер через 10 минут должен:

1. Снова открыть карточку заказа и проверить состояние заказа.
2. Если заказ не закрыт, проверить статус платежа в Assist mPOS и на основании этой информации указать в MeaSoft App в карточке заказа один из статусов:
   • Успешно — курьер подтверждает, что платеж совершен, заказ закрывается;
   • Платеж отменен — после этого курьер может снова выбрать тип оплаты и провести платеж.

Онлайн-платежи

Чтобы начать использовать систему Robokassa, в настройках мобильного приложения в выпадающем списке Параметры эквайринга выберите значение Онлайн-платежи.

Предварительная настройка приема платежей описана в разделе «Интеграция с платежными сервисами».

Чтобы провести платеж:

1. В поле Тип оплаты выберите Оплата картой.
2. Укажите статус заказа Доставлено или Частично доставлено и нажмите на кнопку Сохранить.
3. При необходимости заполните информацию во всплывающем окне и нажмите на кнопку Сохранить.
4. Откроется окно с штрихкодом для оплаты:
   

В этом окне вы можете:

• дать получателю отсканировать штрихкод с экрана;
• Выслать по СМС — выслать получателю смс-сообщение со ссылкой на оплату;
• Поделиться — переслать получателю ссылку на оплату, используя стандартные средства Android;
• Обновить заказы — проверить, прошла ли оплата заказа получателем. Если оплата совершена, заказ закроется автоматически.

После совершения оплаты получателю направляется электронный чек. У курьера заказ закрывается.