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
Next revision		 Previous revision
barcode_scanning:handheld_computer [2025/11/24 15:11] – [2. Select the supplier invoice] Gary Willettsbarcode_scanning:handheld_computer [2026/01/05 13:03] (current) – Gary Willetts
Line 9: Line 9:
 Currently mSupply is compatible with Honeywell handheld computer barcode scanners like the CK65 shown in the image above and the only function available on these scanners is goods receiving. Currently mSupply is compatible with Honeywell handheld computer barcode scanners like the CK65 shown in the image above and the only function available on these scanners is goods receiving.
  
-As with using simple barcode scanners as described in the previous pages of the documentation, mSupply reads GS1 type barcodes with these devices. These barcodes can be in either 1D linear or 2D QR-code or datamatrix forms. Non GS1 type barcodes will be scanned successfully but ignored by mSupply.+As with using simple barcode scanners as described in the previous pages of the documentation, mSupply reads GS1 type barcodes with these devices. These barcodes can be in either 1D linear or 2D datamatrix forms. Non GS1 type barcodes will be scanned successfully but ignored by mSupply.
  
  
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.
Line 117: Line 120:
  
 === a. If the barcode doesn't contain a GTIN === === a. If the barcode doesn't contain a GTIN ===
-You will be shown an error message and asked to scan again.+Te scanner will register the scan but it will be ignored. You must scan another barcode which contains a GTIN.
  
 === b. If the GTIN does not belong to an item in mSupply === === b. If the GTIN does not belong to an item in mSupply ===
Line 179: Line 182:
  
  
 +<WRAP important center round 90%>
 +**PLEASE NOTE:** You can also scan a barcode that does not contain a GTIN at any time. If you scan such a barcode before scanning a barcode that contains a GTIN then the scan will be ignored. If you scan it after scanning a barcode that contains a valid GTIN then any relevant information contained in the barcode (e.g. batch, expiry date etc.) will be assigned to the current supplier invoice line. If any of that informaiton exists for the line already (e.g. it already has a btach or expiry date set for it) then that information will be overridden with what was in the last barcode scanned.
 +
 +So be careful! If you mean to scan a GTIN containing the item for the next invoice line but accidentally scan a barcode that doesn't contain a GTIN, you will instead override the current invoice line's information with any information in the barcode you just scanned.
 +</WRAP>
 ==== 4. Scanning complete ==== ==== 4. Scanning complete ====
 When scanning is complete and all lines have been saved, you will be back at the list of invoice lines: When scanning is complete and all lines have been saved, you will be back at the list of invoice lines:
  • Last modified: 2025/11/24 15:11
  • by Gary Willetts