Просмотр исходного текста страницы 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 [[Mobile devices API| 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.

Для работы с кассами АТОЛ необходимо, чтобы устройство было на базе архитектуры [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 ==
<table style = "float:right;">
<tr>
<td>
[[Файл:Android QR.png|thumb|200px|right]]
</td>
<td>

</td>
</tr>
</table>

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 [https://play.google.com/store/apps/details?id=ru.measoft.courier&hl=ru MeaSoft App], open and click '''Install'''. <!--Google Play application temporarily does not support geolocation and location data collection. You can download an application installation file with a full set of features [https://drive.google.com/file/d/16c1sINLSG3p4akDQA9cehJxy6_dk0DMr/view?usp=sharing here].-->

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 [http://https://support.google.com/android/answer/9431959?hl=ru Android help].

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

[[Файл:Image 5.png|none|710 px]]

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 Module Setup|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|300 px|none]]

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 account[[Courier Service Account#Phones|control panel]]. The '''Active''' section displays all devices connected to the system.

=== Registration by QR code scanning ===
# In the mobile app, tap the '''Scan Code''' button. The barcode scanner opens.
# 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.
# 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 ===
# 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.
# 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 [[#Unassigned orders|available urgent order]];
* [[#self-issue|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|25 px]] button and [[Courier mobile app for Android#Order search by barcode|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|25px]] button.

[[Файл:Общий вид мп.png|none|300px]]

When you open the application, orders with delivery for today are displayed in the list. The[[Файл:Andoid choose date.png|25px]] button displays orders with the status '''[[Courier mobile app for Android#Orders for today|Today]]''', '''[[Courier mobile app for Android#Scheduled orders|Scheduled]]''', '''[[Courier mobile app for Android#Closed orders|Closed]]''' or '''[[Courier mobile app for Android#Unassigned orders|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|25 px]] 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|25 px]] — call the recipient;

[[Файл:Button Comment.png|25 px]] — add a comment;

[[Файл:Button Going there.png|25 px]] — 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|25 px]] — close the order as undelivered.

=== Orders for today ===
Click the [[Файл:Andoid choose date.png|25px]] 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|25px]] 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|25px]] 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:
# 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|none|300 px]]
# 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 «[[Courier mobile app for Android#Urgent orders in mobile app|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 [https://home.courierexe.ru/courier 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|25px]] 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|25 px]] button.

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

[[Файл:Map.png|none|300px]]

Button [[Файл:Period.png|30px]] 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 [[Map Module#Automatic routing service| 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|25px]] 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|none|500 px]]

Courier regulations  — rules of work with the client and individual terms of delivery of orders. It is stored in the office application in the [[Clients and partners#Other|client card]].

The number in the route is displayed if the order has been assigned a number in the [[Map Module#Scheduling types|route]]. The same number is recorded in the delivery and acceptance certificate to the courier, if it is configured in the variable <mparam code="StoreGivnActPos/>. 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|Setting Statuses]]».

The order functions can be as follows:

[[Файл:МП функция 1.png|25 px]] — enable the [[#Client's waiting timer|client's waiting timer]]. Time of waiting for the client is rated in [[Wage (reference)|coutier's wage rate]].

[[Файл:МП функция 2.png|25 px]] — take a [[#Photographing|photo]]. The photo is automatically attached to the order.

[[Файл:МП функция 3.png|25 px]] — write a comment to the order. The comment is displayed in the courier's order list.

[[Файл:МП функция 4.png|25 px]] — view additional information on the order.

[[Файл:МП функция 5.png|25 px]] — view the list of items. The function is available for orders of customers whose card[[Clients and partners#Other|does not allow partial buyout]].

[[Файл:МП функция 6.png|25 px]] — access to the pickup functions:

: [[Файл:МП функция Принять забор.png|25 px]] — accept the pickup from the customer. For more information see «[[#Receiving shipments from a customer|Receiving shipments from a customer]]».

: [[Файл:МП функция калькулятор.png|25 px]] — open the shipping cost calculator. For more information see «[[#Calcuator|Calculator]]».

: [[Файл:МП функция создать заказ.png|25 px]] —  create an order for the delivery of the collected goods.

: [[Файл:МП функция печать.png|25 px]] —  printing of documents: labels, certificates or invoices. The function is available if the printer is connected to the phone via bluetooth.

: [[Файл:МП функция закрыть.png|25 px]] — 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. <!--Order can be edited if its statuses are either "Accepted" or "Read".-->

To change the weight or dimensions of a package:
# In the order card, click on the link with information about the weight and number of package:[[Файл:Заказ с местами.png|300 px|none]]
# «Edit packages» window will open. Change the data and click the '''Save''' button.[[Файл:Редактирование мест.png|300 px|none]]

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 [[Automation module configuration|notifications]] that the courier is on the way from the office system.

== Navigation to the delivery address ==
To set a route:
# In the order card, tap and hold the recipient's address.
# 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|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 ===
# In the order card, set the status to '''Delivered'''.
# 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 orders|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:
# In [[Shipment card#Other|shipment card]] the '''Partial buyout allowed''' box is checked.
# In [[Work with orders#Shipment card|shipment card]] the '''Cash Payment''' box is unchecked.
# For urgent orders: any order status, except for "Went to return" and "Delivered (one way)".

To close an order as partially delivered:
# In the order card, set the status '''Partially delivered'''.
# If the order is cash on delivery and a choice of payment type is available, set the value of the payment type.
# If there is a cash on delivery in the order, but there are no order items, enter the amount that the recipient actually transfers.<br>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|50 px]] and [[Файл:МП Добавить товар.png|50 px]]. The amount to be paid is displayed above the list.<br>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.
# Specify the reason for the refusal.
# 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|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.

<spoiler text="How to compile a list of refusal reasons">The references are edited under '''References''' > '''Statuses''' > '''28 Reasons for partial refusals'''.<br>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.</spoiler>
[[Файл:and4.jpg|none| 300px]]

=== Not delivered ===
If the order is not delivered, select the status '''Not delivered''', specify the reason and, if necessary, add a text comment. <spoiler text="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 <mparam code="GivnS3Message"/>.
</spoiler>
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|300 px|none]]

To return a closed order:
# Go to the list of [[#Closed orders|closed orders]] and open an order card.
# Click the "Return for execution" button.
# 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|Receiving shipments from a customer]]» function;
** by the delivery and acceptance certificate. Unmarked shipments are marked during[[Scan in at warehouse|scan in]] at the courier service company;
* the courier creates the request themselves. For that in [[Courier service account#|courier service account]] <rspoiler text="box">'''Fields Settings'' > '''Parameters''' > '''Advanced'''</rspoiler> '''Сouriers can create pickup orders''' should be checked.

To create a pickup request in the mobile app:
# Tap '''More''' > '''Create Pickup'''.
# 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:
# In the pickup card, click on the button [[Файл:МП функция 6.png|25 px]], then [[Файл:МП функция создать заказ.png|25px]], fill in the data for the shipment and click '''Save'''.
# 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|25 px]], than [[Файл:МП функция Принять забор.png|25px]] 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 [[Shipping#Microbranches|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:
# Open the order card with the type "Pickup", click on the [[Файл:МП функция 6.png|25 px]] button, then [[Файл:МП функция калькулятор.png|25 px]].
# Specify the destination city and the weight of the order.

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

[[Файл:and7.jpg|300px|none]]

=== 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|300px|none]]

== 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 [[Clients and partners#Client card|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 [[#Acquiring|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 [[#Fiscalization|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 [[Courier mobile app for Android#Conversation with the recipient|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 [[Courier mobile app for Android#Not delivered|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 «[[Integration with telephony#Mobile app integration|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 [[Coutier service account#Parameters_2|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|25 px]].

A window will appear where you can select the phone number and method of making the call:
* if you call the recipient:<br> [[Файл:Звонок через Asterisk.png|25 px]] — call via telephony;<br> [[Файл:Звонок по сотовой связи.png|25 px]] — 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|300 px|none]]

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|25px]] 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 account#Couriers|courier service aacount]].

[[Файл:and6.jpg|300px|none]]

=== Random number call ===
Tap on [[Файл:3 dots.png|25px]] 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 [[Integration with telephony|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|25 px]] 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|25 px]].

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 [[Functions#Courier Tracking|«Courier tracking»]].

== Troubleshooting ==

=== A message is displayed when the application is started ===
'''Synchronize the server with your client account. Contact your system administrator. '''
# In the MeaSoft office system, open '''References''' > '''Additional Modules'''.
# Uncheck the '''Client Account''' and '''Mobile Apps''' boxes. Click '''OK'''.
# Open '''References''' > ''Additional Modules''' again, check the checkboxes and click '''OK'''.
# After about an hour pull the order list 2 times from the top down in the mobile app.

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

Обратите внимание, что в разделе [https://home.courierexe.ru/extraclient/phones «Телефоны»] личного кабинета проблемные опции (GPS, сети, время телефона, время синхронизации, версия приложения) подсвечиваются розовым цветом, так что вы всегда можете быстро диагностировать неполадки у всех курьеров.

=== Телефон делает зигзаги между двумя траекториями ===
* '''В телефоне меняется время'''
К сожалению, достаточно частая ситуация, когда время на одном и том же телефоне перескакивает из-за того, что неверно настроен часовой пояс (в андроиде производитель так и не изменил время перехода на летнее/зимнее время, не скорректировали с учетом последних изменений российского законодательства), телефон берет время из базовых станций оператора, которые тоже не всегда корректно настроены: иногда бывает, что идешь по Москве, смотришь в телефон, а он показывает время на 3 часа больше, и погоду в Екатеринбурге, с полной уверенностью, что я туда переместился. Предполагаю, что операторы иногда копируют настройки базовых станций из других регионов. И еще он получает время со спутников, когда включен GPS. В итоге время может скакать. Решение — отключить в настройках телефона автоопределение часового пояса, автонастройку часов, выставить верный часовой пояс и текущее время вручную. Также в некоторых программах, например, в навител.навигаторе по умолчанию установлена галка для автокоррекции системного времени по спутникам. Такое тоже нужно отключить. Это тоже не дает гарантии, что время будет корректным — андроид даже так иногда приглюкивает.
* '''Переехала точка доступа WiFi'''
Google регистрирует у себя WiFi сети, по [https://ru.wikipedia.org/wiki/MAC-адрес MAC-адресам] точек доступа, и фиксирует их местоположение. Потом, когда телефоны позиционируются — они смотрят, какие wifi сети есть в радиусе действия, и спрашивают их координаты у гугла. Это позволяет позиционироваться в помещениях, а так же повышает скорость, точность и энергоэффективность позиционирования. Однако, если точку доступа перенесли в другое место — google какое-то время об этом может не знать, и передавать телефону координаты старого расположения точки доступа. Если в вашем офисе/складе есть такая точка доступа — попробуйте «рассказать» гуглу, что она переехала: в зоне доступа данной сети (лучше — чтобы телефон был к ней подключен) включите GPS (например — google-карты), убедитесь, что GPS подключился к спутникам, и какое-то время подождите. По логике — телефон должен «понять», что «надежные» координаты от спутников не совпадают с координатами по wifi, и сообщить об этом в google, чтобы там изменили координаты точки доступа. Насколько этот способ надежен и быстр — известно только Большому Брату :-)

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

== Срочные в мобильном приложении ==
Для доставки из пункта А в пункт Б предназначен функционал [[Работа со срочными заказами|Срочные]].

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

На отображение срочных заказов в мобильном приложении также влияют следующие флажки в [[Личный кабинет курьерской службы#Параметры|административном личном кабинете]]:
* '''Разрешить невыданные заказы''' — если флажок установлен, курьер может взять себе не выданный никому до этого заказ. Подробнее см. раздел «[[Мобильное приложение курьера для Android#Невыданные заказы|Невыданные заказы]]»;
* '''Не показывать курьеру срочные с пустым статусом''' — если флажок установлен, в карточке срочного нужно указать курьера и изменить статус, например на «Передано курьеру»;

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

[[Файл:МП Срочные.png|none|300px]]

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

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

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

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

[[Файл:МП карточка срочного.png|none|300px]]

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

== Бесконтактная доставка по пин-коду ==
Если заказ был оплачен заранее или оплата по заказу не предусматривается, можно отправить покупателю СМС или 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 ===

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

Чтобы начать использовать систему Assist:
# Установите мобильное приложение Assist mPOS.
# В настройках мобильного приложения MeaSoft App в выпадающем списке '''Параметры эквайринга''' выберите значение '''Assist mPOS'''.
# Рядом со значением '''Assist mPOS''' появится кнопка [[Файл:Assist настройки.png|25 px]]. Нажмите на нее, введите <rspoiler text="PIN-код"> В личном кабинете курьерской службы в пункте основного меню '''Телефоны''' > [[Личный кабинет курьерской службы#Курьерские устройства|Курьерские устройства]] откройте карточку курьера и скопируйте значение поля '''PIN-код POS-терминала'''.</rspoiler> и нажмите на кнопку '''Проверить'''.
# В окне «Настройки Assist» укажите логин, пароль и ИД магазина согласно вашим учетным данным Assist и нажмите на кнопку '''Сохранить'''.

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

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

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

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

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

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

Чтобы провести платеж:
# В поле '''Тип оплаты''' выберите '''Оплата картой'''.
# Укажите статус заказа '''Доставлено''' или '''Частично доставлено''' и нажмите на кнопку '''Сохранить'''.
# При необходимости заполните информацию во всплывающем окне и нажмите на кнопку '''Сохранить'''.
# Откроется окно с штрихкодом для оплаты: [[Файл:RBK Barcode.png|none|300 px]]
В этом окне вы можете:
* дать получателю отсканировать штрихкод с экрана;
* '''Выслать по СМС''' — выслать получателю смс-сообщение со ссылкой на оплату;
* '''Поделиться''' — переслать получателю ссылку на оплату, используя стандартные средства Android;
* '''Обновить заказы''' — проверить, прошла ли оплата заказа получателем. Если оплата совершена, заказ закроется автоматически.
После совершения оплаты получателю направляется электронный чек. У курьера заказ закрывается.