Magic Button — guide

What Magic Button is

Doty+ is a marketplace of extensions for the Dotykačka till, and Magic Button is one button on the till under which those extensions open. Extensions are enabled in the Doty+ portal and used by the team on the till: the loyalty programme, shift checklists, orders to head office, and more. Every screen comes from the Doty+ server, so a new extension needs no new installation on the till. The app remembers only the server address and the till code.

What you need

• A till running Android 5.0 or newer, connected to the internet.
• Access to the Doty+ portal (the person doing the rollout receives a login and password).
• A till code from the portal. One till, one code.

1. Log in to the portal: dotyplus.dotyintegracje.org, menu Tills.
2. If the Dotykačka cloud is not connected yet, the portal asks for that first. Click Connect Dotykačka cloud and log in to Dotykačka.
3. Pick the branch where the till stands, type how you call that till in Till name, e.g. Bar 1, and click Add till.
4. The till code is shown only once, right after adding. Copy it straight away or write it down. If you lose it, add the till again and disconnect the old one.

The list on the same page shows every till, whether it is connected and when it last checked in. Disconnect till cuts it off from the server immediately; Reconnect switches it back on.

1. On the till, open the browser, go to dotyplus.dotyintegracje.org/download/en.html and download the app.
2. Open the downloaded file (from the notification bar or from Files, the Downloads folder).
3. Android asks for permission to install an app from this source. Allow this install only.
4. After installation, Magic Button appears on the app list.

If the installation ends with a message that the app could not be installed, an older version with a different signature is already on the till. Uninstall it and try again. After uninstalling, the settings have to be entered again.

On first launch the app shows the Server connection screen. Enter:

1. Tap Check connection. You should see “Server responding”.
2. Tap Save. The app goes to work.

If you see “No connection” instead, check in turn: does the till have internet, are the address and port typed without mistakes and is HTTPS on, is the till connected in the portal.

Working on the till

• The app is started from the app list, next to Dotykačka POS. Launching it with one button straight from the sales screen is in preparation.
• After opening, the app shows the tiles of the extensions enabled for this till. Tap one and the next screens take it from there.
• The bill is closed the usual way in Dotykačka. The app changes nothing about how you sell or take payment.

The barcode scanner

• A card can be scanned in three places: on the Magic Button main screen, on the list of bills and on an open bill.
• A scan on the main screen takes you to the loyalty programme's list of bills. A scan on the list stays on the list. Either way the top of the screen shows “Zeskanowano” (Scanned) with the card number, and the card goes to the bill you pick next. It waits a minute, after that the card has to be scanned again.
• A scan on an open bill goes straight to that bill.
• On a bill, scan straight away. There is no need to tap the field first, the app recognises the scanner on its own.
• In the loyalty programme the first scan is the customer card. The tiles with what to do about the bill appear only once the card has been read.
• The card stays while you move between tiles. A further scan inside the coupon flow adds a coupon.
• The Enter at the end of a code confirms the reading. Scanners send it themselves, nothing has to be configured.
• The previous customer's card is dropped with the Wyczyść (Clear) button.
• A number can still be typed by hand. Then you tap the field and confirm with the button.

The scanner needs version 0.2.3. On older versions a scan could open the first bill on the list or send the app back to the main screen.

The strip at the bottom of the screen

• From version 0.2.4 the bottom of every screen shows the app version, for example Magic Button 0.2.4.
• On the right is the light for the connection to the Doty+ server. Green: connected. Red: no connection, the app keeps retrying on its own. The last screen stays visible.
• The text kod kasy odrzucony (till code rejected) means the till was disconnected or removed in the portal. The app then shows the Ustawienia połączenia (Connection settings) button, where you enter the current code.
• On the loyalty programme's list of bills the first line says whether the programme itself answers. It is checked when the list opens, after Odśwież (Refresh) and every few minutes.
• The app version of each till is also shown in the portal, under Tills, in the App column.

Changing the settings

The connection settings open from the Connection settings button on the “No connection to the server” screen. If the till is connected and something needs changing, the simplest way is to disconnect it in the portal, so the app shows that screen, and reconnect it after the change. You can also clear the app's data in Android settings and enter everything again.

Common problems