5. Scanner

1. Overview

ERP > Scanner

The ERP’s Scanner tool is an Embedded ERP extension to use a handle barcode scanner to process :

  • Inventories
  • Picking for order preparation
  • Create purchase order deliveries
  • Barcode comparison

This extension installs new Magento file with a specific theme optimized for a 240x320 pixels screen.


The menu is designed to be used ONLY  with Windows CE embedded scanner  devices

If you got a simple Barcode scanner (without integrated screen)

In ERP : you can use it in 3 different ways

  1. ERP > Order Preparation > Prepare Order

Then on the top of the screen click on “4.Packing”. This allow you to scan a product before packing it.

More details at : http://documentation.boostmyshop.com/embedded_erp/7_order_preparation.html#packing

  1. ERP > Purchasing > Purchase Order

Then click on an order which is not shipped. Now on the top right on the screen you have Scanner Delivery which allow you to scan the barcode of the delivery

More details at : http://documentation.boostmyshop.com/embedded_erp/6_purchase.html#products-arrival-purchase-order-delivery

  1. ERP > Stock Management > Stock Take

The click on a Stock Take opened.Now on the top right on the screen you have Scan Product which allow you to scan the barcode of any product and manage his stock level

More details at : http://documentation.boostmyshop.com/embedded_erp/4_stock_management.html#scan-products

2. Hardware compatibility

The menu ERP > Scanner is designed to be used ONLY with Windows CE embedded scanner devices :

  • Wifi barcode scanner with a touch screen
  • Magento admin panel access

Android version

Windows CE embedded scanner are quite expensive and the user interface is becoming very old fashioned. We have developed an Android application that can replace ERP -> Scanner on all features. The application is connected directly to your magento using magento APIs.

Doc: http://documentation.boostmyshop.com/erpdroid/index.html

Application: http://www.boostmyshop.com/english/magento-erp-for-android.html


ERP > Scanner is compatible with a scanner that send a “terminating Character”.

Ex: if you scan a barcode 123456789 and if the scanner sends 123456789# for example, the scanner will be compatible with ERP.

In the ERP scanner option, the #, the “terminating Character”,  is called a “Postamble”.

to configure it please look at http://documentation.boostmyshop.com/embedded_erp/5_scanner.html#configuration

Alternatively, since ERP 2.9.3, there is the possibility to set No Postamble in configuration, but if will work if the scanner send a carrier return after the digit scanned.

Here are some scanners we tested and we can recommend, classified by ranges :

Low-end scanners

Esky USB Automatic Handheld Barcode Scanner

  • Performances : Low performances
  • Price : Around 15-30 (€ / $)
  • Mobility : Restricted mobility (cable connection)

Esky ES013 Bluetooth Barcode Scanner

  • Performances : Low performances
  • Price : Around 30-50 (€ / $)
  • Mobility : Good mobility (a few meters around the computer, as far as bluetooth range allows)

Mid-level scanners

Gryphon Series Scanners

  • Performances : Good performances
  • Price : Around 150-300 (€ / $)
  • Mobility : Restricted mobility (cable connection)

Performances : Ability to read barcodes more or less easily (depends of lighting of the place, distance from which barcodes are scanned, barcodes size ...)


We do not guarantee that all these scanners will work with your product barcodes, because of course we are not sellers of scanners.

The other magento interfaces of ERP (ERP > Order preparation > packing , ERP > Purchase > ... > Purchase delivery...) are designed to use with an simple barcode scanner (without integrated screen), it is recommended when you have a local PC computer in your warehouse and you want to minimize the cost of the setup.

3. Configuration

Scanner configuration is available in menu System > Configuration > ERP > Scanner


Settings Description
Screen width Type a value in pixel
Screen height Type a value in pixel
Remove scroll bars Yes / No
Mobile user agent Enter the name of the operating system of the mobile tool, which will allow to display the page in the adapted format


Setting Description
Hide product row when qty reached Yes / no
Postamble Control character added at the end of a scan (most of time # ). . Alternatively, since ERP 2.9.3, there is the possibility to set NO Postamble here, but if will work if the scanner send a carrier return after the digit scanned..

Free delivery

Setting Description
Affect product to warehouse Choose the warehouse
Stock movement caption Enter a name
Prevent location change if product is in stock in another location Yes / no

Purchase order

Setting Description
Scan location after scanning product Yes / No

4. How to use

4 menus are available : go in ERP > Scanner

  • Inventory : To search products, change stock level and link barcodes to products
  • Order Preparation : allow the picking for the order preparation.
  • Purchase order : create deliveries for Purchase Orders
  • Purchase delivery : receiving merchandise, scan your products with this menu.
  • Barcode comparison : compare twice products
  • Logout : use for logout


A search bar help you to quickly find a product.

5. Inventory

In the first screen, you can search a product scanning its barcode

If only one product matches to the search, you’re redirect to the product sheet, else results are displayed


Select product to display product sheet :


This view displays various information in the section “default” you will find:

  • Stock: indicates the amount of stock default
  • Available: The amount available
  • Location: scanner label where it will be stored product then click “Close” to apply changes

The “barcode” tells you different barcodes for the same product

Order preparation

You can pick products for order preparation from this screen. It displays all required products to ship orders in Order Preparation > Selected orders. For each product, remaining qty is displayed.

Each time you scan a barcode, the qty is decreased. When the required quantity is complete, the picking of order preparation is finished.


Purchase Order

Here, you can create purchase order delivery :


First, select supplier to see orders linked


Next, select purchase order,once the order selected you will see the list of products waiting for delivery


All purchase order’s products are displayed.

From this page you can scan products awaiting delivery to the purchase order, once the quantity of a product resulted, it disappears from the list.

Once the list is empty, the products of the purchase order has been received, click “create delivery” to complete the delivery.

You can find delivery by going to the menu ERP > Purchase > Purchase order, select the tab and click the “Delivery” for viewing.

6. Login page

If you encounter login issue using The scanner on a Windows CE scanner for example

  • On your server FTP , go in app/design/adminhtml/default/default/template

the login page of Magento is login.phtml

ERP provides a customized file called

“login.phtml for scanner login form”

Installation process

  1. Save Login.phtml by renaming it to login_original.phtml
  2. Rename  “login.phtml for scanner login form” into login.phtml
  3. Go to System > Configuration > ERP > Scanner > Display -> Mobile_user_agent, and set the “user agent” of your device

To get the “user agent” of of your device open this page with your device


A user agent is string that identify a device on the web.


Chrome : Mozilla/5.0 (Windows NT 6.1; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/41.0.2272.118 Safari/537.36

Iphone :

Mozilla/5.0 (iPhone; CPU iPhone OS 6_1_3 like Mac OS X) AppleWebKit/536.26 (KHTML, like Gecko) Version/6.0 Mobile/10B329 Safari/8536.25

etc ...

Datalogic on WIndows Ce should be

Mozilla/4.0 (compatible; MSIE 6.0; Windows CE; IEMobile 6.12)

You must define in the field the a keyword that will identify the mobile.

7. Datalogic configuration

Some additional configuration may be required for the datalogic devices :

Postamble configuration

The postamble is an additional character added by the scanner after you scan a barcode : it informs ERP that a barcode is being scanned.

  • Double click on the barcode icon in the system tray > reader parameters > Text formatting > Postamble
  • Set # as postamble. Then, select menu file > save

To get a full screen browser

  • Windows > Settings > Control panel > Datalogic desktop utility
  • Admin Tab : « enable datalogic desktop »
  • IE Tab ; uncheck all checkboxes in IE interface
  • Win tab : uncheck « show task bar »
  • Then click on the « ok » button
  • If you want to display « Datalogic desktop utility » again, click on F6 (blue button + 6)


Datalogic may loose wifi connexion just after startup. If you’re stuck on a « Page unavailable » message, just wait a few seconds and refresh screen with F5 (blue button + 5)