AmRest applications

• Label manager Android application
• First things to do
• Installing the application
• Device registration
• Setting printers
• Application screens
• Web management
• Starting screen

Label manager Android application

First things to do

Datetime and Security

Let's make sure that the device is running the latest version of Android (this can usually be done in the last menu option under System Updates in the Android settings). 

In the Android settings, find Date and Time and verify that the time zone is set correctly (Europe/Amsterdam or Europe/Budapest), and that automatic time synchronization is enabled.

For certain tablets, it is necessary to enable the option for Unknown Sources, which can be found under the Android settings, in the Security section.

Wireless connection

The client device needs to be able to reach the server over the Internet. In the case of WiFi printing, client isolation should not be enabled on the network. Brother printers typically only support the 2.4GHz band.

Sunmi mobile printers

Sunmi V2s devices are initially set up for handling normal (non-adhesive) paper by default. In the Android device settings, this needs to be set to "Label mode."

Zebra printers

For Zebra printers, the printer needs to be initially configured for the correct paper size, gap setting, and final output. (Later on, using a USB connection, the application will be able to do this automatically.)

Installing the application

The application can be downloaded from the URL corresponding to the country and brand using the following path: /app.apk. For example: srbkfc.traxpire.cloud/app.apk

1. Download the apk file
   
   
   
2. Enable the permission for the browser
   
   
   
   
   
3. Open the downloaded apk file
4. Enable application installation permission for the browser
   
   
   
   
5. Enable all permissions for the application
   
   
   
   
6. Device is unregistered: "Network Access Denied"
   
   
   

Device registration

If the device has internet connectivity, it will attempt to connect to the server set in the "Settings" menu to verify the registration. If the device is not registered or does not have a valid registration, an error message will be displayed.

In application menu "Settings", the "Server URL" domain part should match with the proper domain and it always ends with "/api/v1/" (trailing slash). After saving this setting, a full synchronization will occur towards the configured server.

The device needs to be assigned to the restaurant through the website, in the "Devices" menu section.

The device ID can be found in the 3 dot's "Information" menu. (see the last screenshot's 3rd row)

 

Setting printers

In the case of network printing, the program checks every minute if the printer is accessible. If it is not, it will attempt to rediscover it. It is recommended to use a static DHCP server because the connection is based on IP address, which may change if network devices are restarted.

3 dot menu -> Settings

Sunmi V2s

Brand: sunmi
Sunmi Label Height: 25
Further settings do not have an impact in this case.

 

Brother QL-___

WiFi/Ethernet

Printer setup: books/devices/page/brother-ql-w-series-wifi-setup

Brand: Brother
Interface: Net
Paper Type: W62 (DK-22205)

1. Press "Search and select printers"
   
2. Wait for 1-3 seconds
3. Select the printer

 

 

Bluetooth

Brand: Brother
Interface: Bluetooth
Paper Type: W62 (DK-22205)

1. Pair the printer via Bluetooth
2. Press "Search and select printers"
   
3. Enable Bluetooth connection
4. Wait for 1-3 seconds
5. Select the printer

   

Application screens

Main controls

Header:

1. Current device time
2. Category filter
3. Network connection state (solid white means "OK", flashing white means "Searching for server")
4. "3 dot" menü
   • Printer status (Jumps to printer settings)
   • Do full sync (full server sync NOW)
   • Information (registration info)
   • Settings
   • Check for Update (forced check for new app version)
   • About

Labels

List of printed or saved labels. At the end of the line, the green indicator signifies successful server synchronization.
Clicking on the line allows you to reprint or delete the item.

The items are displayed in order of expiration, showing the ones that will expire first at the top.

After the expiration of the item - during opening hours and 30 minutes prior to it - the device emits an audible alert at maximum volume and marks the row with red background color. The alert will continue to repeat until the item is deleted.

If a product doesn't have an expiration date set on server, it is considered a durable item. In such cases, the user can freely set the expiration date. If none of the durable items appear in the "Labels" list, the application will eventually notify the user with a pop-up window.

Timers

There are automatically recurring countdowns that cannot be stopped. To delete them, you need to press and hold the name of the timer for more than 10 seconds. Expired countdowns emit an audible alert at maximum volume, using a different tone compared to the label sound.

Reports

Here is a list of items that do not appear on the "Labels" screen. (In the future, this menu option will be removed.)

Custom

It contains features used in specific Hungarian markets.
"Donation" - provides guidelines for handling and using donated meat-based items.
"Custom" - allows for custom, two-line labels. For example, it can be used to mark waste products. The labels printed here are not logged.

Web management

Starting screen

The features available to all customers can be accessed by clicking on the "home" icon after logging into the website.

Sidebar items:

Labels: 

It contains the list of labels saved or printed by the application.

By default, when configured with appropriate mail settings and valid email addresses, the server sends notifications about expired but not deleted items. After 1 hour, a notification is sent to the general manager, and after 3 hours, a notification is sent to the area coach.

Timers:

It contains the list of timers recorded in the application. (It does not show the current time of the timers.)

Custom labels:

It contains the list of custom, two-line labels and allows for adding new ones.

Users:

User management

Restaurants:

Restaurant management. Every restaurant needs to be configured with the following settings:

• "Identifier" (MPK number)
• "Name"
• "Place type"
• "Delivery" (some products are delivery-only)
• "Region"
• "Opening hours"
• a technical user, with role "user" (for example: 400001)
• a general manager, with role "general_manager"
• an area coach, with role "area_coach"

If no opening hours are set for a restaurant, the devices will not emit any audible alerts. If a restaurant never closes, the value of 00:00-23:59 needs to be specified.

Items:

Food items tree. The "Label template" determines the format of the printed label. The "normal" template contains only two lines: preparation time and expiration time. The "meat" type is reserved for meats. The "frozen" type includes a defrosting time as well.

If a product doesn't have an expiration date set on server, it is considered a durable item. In such cases, the user can freely set the expiration date. If none of the durable items appear in the "Labels" list, the application will eventually notify the user with a pop-up window.