barcode_scanning:handheld_computer

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
barcode_scanning:handheld_computer [2025/11/25 09:55] – [a. If the barcode doesn't contain a GTIN] Gary Willettsbarcode_scanning:handheld_computer [2026/01/05 13:03] (current) – Gary Willetts
Line 23: Line 23:
 The first step is to create users in mSupply for all the users who are going to use the barcode scanners. Follow the instructions here to do that: [[admin:managing_users]]. The users don't need any particular permissions to use the barcode scanner, they just need to be active and able to login to mSupply. The first step is to create users in mSupply for all the users who are going to use the barcode scanners. Follow the instructions here to do that: [[admin:managing_users]]. The users don't need any particular permissions to use the barcode scanner, they just need to be active and able to login to mSupply.
  
-==== 2. Download the mSupply scanner app ====+==== 2. Turn on the alternate server ==== 
 +The app on the barcode scanner communicates with mSupply via a REST API. To enable this communication you must turn on the Alternate server on the //Alternate server// tab of the mSupply preferences page. See the [[preferences:general#alternate_server_tab|16.01. General preferences]] page for details on this.  
 + 
 +==== 3. Download the mSupply scanner app ====
 Download the app from here: [[https://github.com/msupply-foundation/zapp/releases]] Download the app from here: [[https://github.com/msupply-foundation/zapp/releases]]
  
-==== 3. Load the mSupply scanner app onto the scanner ====+==== 4. Load the mSupply scanner app onto the scanner ====
 Load the mSupply scanner app (Zapp App) apk file onto the scanner device itself by following the manufacturer's instructions. Find the apk file on the device and tap on it to install it. When you have done that, you will see the //Zapp App// icon on the scanner's main screen: Load the mSupply scanner app (Zapp App) apk file onto the scanner device itself by following the manufacturer's instructions. Find the apk file on the device and tap on it to install it. When you have done that, you will see the //Zapp App// icon on the scanner's main screen:
  
 {{ .:pasted:20251117-101450.png?250 }} {{ .:pasted:20251117-101450.png?250 }}
  
-==== 4. Open the app ====+==== 5. Open the app ====
 Tap on the //Zapp App// icon and the app will open at the login window: Tap on the //Zapp App// icon and the app will open at the login window:
  
Line 42: Line 45:
 Enter the URL of your mSupply alternative server in the field (see the [[cold_chain_equipment:configure_coldchain_app_on_desktop#turn_on_the_alternate_server|20.03. Cold Chain App Notifications]] page for details on how this is set up). You only have to do this step the first time you open the app or if you need to change the URL).  Enter the URL of your mSupply alternative server in the field (see the [[cold_chain_equipment:configure_coldchain_app_on_desktop#turn_on_the_alternate_server|20.03. Cold Chain App Notifications]] page for details on how this is set up). You only have to do this step the first time you open the app or if you need to change the URL). 
  
-==== 5. Login to the app ==== +==== 6. Login to the app ==== 
-Enter your mSupply user name and password in the **Username** and **Password** fields. Then tap on the **Login** button to login to the app. Your credentials will be checked against those stored on the mSupply server found at the URL entered in step 4.+Enter your mSupply user name and password in the **Username** and **Password** fields. Then tap on the **Login** button to login to the app. Your credentials will be checked against those stored on the mSupply server found at the URL entered in step 5.
  
 Initial setup is now complete. Initial setup is now complete.
  • Last modified: 2026/01/05 13:03
  • by Gary Willetts