Dutchie POS WebUSB hardware setup
This article applies to Dutchie POS.
Dutchie POS supports direct USB hardware connections with web browsers such as Chrome and Edge that support WebUSB (for printers), WebHID (for scanners) and WebSerial (for scales).
For receipt and label printers, this means PrintNode configuration is not required. PrintNode is recommended only for remote printing or multiple registers printing to the same fulfillment printer.
- Dutchie Register types
- Receipt, fulfillment ticket, and Z report printers
- Label printers
- Scanners
- Scales
- Customer-facing displays
- Additional hardware settings
Dutchie Register types
The Dutchie Register comes in two basic forms: a web application that works with various recommended devices and peripherals, and the Register Terminal, which is a Dutchie-specific device with specific supported peripherals.
Both can connect to peripherals via USB, and both also support remote connection via PrintNode for receipt and label printers if you require remote printing for fulfillment purposes.
Dutchie Register web application
The Dutchie Register web application works with these recommended devices and peripherals. We recommend using browsers that support WebUSB, WebHID, and WebSerial (including Google Chrome and Microsoft Edge). Other browsers do not support WebUSB printer connections but do support PrintNode connections.
Dutchie Register Terminal (Elo device)
The Dutchie Register Terminal is a Dutchie-branded device manufactured by Elo and configured exclusively for use as a Dutchie Register. This device is no longer available but is still supported. See compatible hardware for the Dutchie Register Terminal for a list of supported peripherals.
Receipt, fulfillment ticket, and Z report printers
Before you begin
-
Connect the receipt printer to your device via USB. You can use a USB hub or adapter if you need additional USB ports or your device has USB-C ports.
OR: - If you need to connect multiple registers to a single receipt printer for fulfillment purposes, use a connect via PrintNode instead.
- You can use a combination of these methods if needed. For example, you can use a direct USB connection for receipt printers and a PrintNode connection for fulfillment printers.
- USB connection requires a web browser that supports WebUSB, such as Google Chrome or Microsoft Edge.
Note for Windows users
A driver is required for connecting WebUSB receipt printers to Windows devices. If you use a Mac computer, a Dutchie Register Terminal, or a PrintNode connection, no driver is required.
Connect your printer in the Register settings
- With your printer connected either via USB or PrintNode, sign in to the Dutchie Register and select Settings from the left navigation menu.
- Select Receipt printer, Fulfillment ticket printer, or Z Report printer, depending on how you intend to use the printer you’re setting up. You can use the same printer for multiple purposes. If you don’t designate separate fulfillment and Z report printers, the designated receipt printer is used for all three purposes.
- Select your printer model from the dropdown.
If your USB-connected printer is not listed, click Add new printer and follow the on-screen instructions if connecting a new USB printer for the first time (WebUSB-compatible browsers only), or Refresh to scan for USB or PrintNode printers already configured for your register. - Choose whether you want this register to Auto-print receipts. This register-level setting temporarily overrides the register's default settings in the Backoffice (Settings > Devices > Registers) for your current session only, then reverts to the Backoffice setting after you sign out.
- Click Print to test the printer connection.
- If the test print was successful, click Save settings.
Printers connected via PrintNode may show as connected in the Register settings but fail to test print. If this happens, troubleshoot the printer connection in PrintNode.
- Click Return to settings to go back.
- Repeat these steps for any additional printers.
Once your printer is successfully connected, you can connect a cash drawer to it if needed and test its connection on the main Settings menu by clicking the Open cash drawer button.
Label printers
Before you begin
-
Connect the label printer to your device via USB and power it on. You can use a USB hub or adapter if you need additional USB ports or your device has USB-C ports.
OR: - If you need to connect multiple registers to a single receipt printer for fulfillment purposes, use PrintNode instead.
- You can use a combination of these methods if needed. For example, you can use a direct USB connection for receipt printers and a remote PrintNode connection for fulfillment printers.
- USB connection requires a web browser that supports WebUSB, such as Google Chrome or Microsoft Edge.
Note for Windows users
A driver is required for connecting WebUSB label printers to Windows devices. If you use a Mac computer, a Dutchie Register Terminal, or a PrintNode connection, no driver is required.
Connect the printer in the Register settings
- With your printer connected either via USB or PrintNode, sign in to the Dutchie Register and select Settings from the left navigation menu.
- Select Label printer.
- Select your label printer from the dropdown.
If your USB-connected printer is not listed, click Add new printer and follow the on-screen instructions if connecting a new USB printer for the first time (WebUSB-compatible browsers only), or Refresh to scan for other PrintNode label printers already connected to your Register. Zebra Programming Language (ZPL) is the only supported label printer protocol. - Select the Default label template this register should use and whether you want it to Auto-print labels for each transaction. These register-level settings temporarily override the register's default settings in the Backoffice (Settings > Devices > Registers) for your current session only, then revert to the Backoffice setting after you sign out.
- Click Print to test the printer connection.
- If the test print was successful, click Save settings.
Printers connected via PrintNode may show as connected in the Register settings but fail to test print. If this happens, troubleshoot the printer connection in PrintNode.
- Click Return to settings to go back.
Scanners
These setup steps are only for product scanning and Dutchie’s built-in ID scanning functionality. If you use our VeriScan integration for ID scanning, see this article instead.
- Connect the scanner to your device via USB. You can use a USB hub or adapter if you need additional USB ports or your device has USB-C ports.
- Sign in to the Dutchie Register and select Settings from the left navigation menu.
- Select Barcode scanner.
- WebHID-compatible browsers only: select Add new scanner and follow the on-screen instructions to authorize and connect your scanner.
- If using one of the recommended Zebra scanners, select Configure scanner. Other scanners will appear as a "default" scanner and may have limited functionality; consult the manual that came with your scanner to set it to HID or USB mode, then proceed to step 7.
- If your browser supports WebHID, you'll see a Zebra - HID option, which is the preferred option. Otherwise, select Zebra - Basic. The system will auto-detect your operating system and browser and will dynamically display the appropriate configuration barcodes. Scan the barcodes in order, then select Done.
- Click Test scanner, then try scanning each of the three test barcodes to verify your scanner is set up correctly.
- Click Back to scanner settings, then Return to settings.
Scales
If you’re using the Dutchie Register Terminal, follow these steps to configure your A&D scale with the required settings.
For all other devices, the scale should be left in its factory default settings. If you need to reset your scale to factory defaults, follow these steps.
- Use an RS232 serial cable and USB-to-serial adapter to connect your A&D scale to your register device. You can use a USB hub or adapter if you need additional USB ports or your device has USB-C ports.
- Sign in to the Dutchie Register and select Settings from the left navigation menu.
- Select Scale.
- If you’re using the 232Key app, select Default Scale.
If you're using an A&D Scale and WebSerial-compatible browser, select Add new scale and follow the on-screen instructions to connect and authorize your scale. - Once authorized, you can select A&D Scale from the dropdown.
- Place an item on the scale and press the PRINT button on the scale. Confirm that the weight reading from the scale appears in the Test weight reading field on the register.
The Dutchie Register web application is configured by default to work with the factory settings for A&D scales: 2400 bps, 7 bits, even parity.
The Dutchie Register Terminal requires 9600 bps, 8 bits, non-parity. - If you’re using a Dutchie Register Terminal or a different scale configuration, click Advanced Settings to select the settings that match your scale’s settings. If you have an A&D FX-series scale not connected via 232Key, you can click Auto-configure scale to detect your scale’s current settings and configure the Register settings match.
- Click Save settings and then Return to settings.
Learn about optional and recommended scale settings in the Backoffice.
Customer-facing displays
A customer-facing display is a secondary screen that shows products and cart information to the customer while a budtender rings up their order. If you haven't already done so, connect the display to your device via USB or HDMI. You can use a USB hub or HDMI adapter if needed.
- Sign in to the Dutchie Register and select Settings from the left navigation menu.
- Select Customer-facing display. If you don’t see this option, contact Dutchie Support to have it enabled for your location.
- Select a Monitor from the dropdown.
If your display is not listed, click Refresh in the dropdown. A browser dialog box may prompt you to grant the Dutchie Register permission to access your display settings before showing other compatible displays connected to your device. - Click Test open display to open the customer-facing display window on your selected monitor. You may need to turn off pop-up blockers and resize or reposition the display window.
- Use the toggle to enable or disable Open window upon login. This automatically opens the customer-facing display window on the selected monitor when you log in so you don’t have to manually open it every time. If disabled, you can manually open the display by clicking the Open customer-facing display button on the Settings page.
- Click Return to settings to go back.
Additional hardware settings
Default register
Dutchie Support can enable an optional Assign POS Registers to Physical Hardware setting for your location, making it so each register configured in your Backoffice corresponds to a specific device. This prevents users who don’t have the POS Manager permission from selecting a different register upon login or switching between registers on the same device.
When this setting is enabled, users with POS Manager permissions can assign a Default register to each device.
Select a register from the dropdown, then click Save settings.
Display settings
You’ll find these additional options under the Display tab:
- Pop up notes when entering cart: Toggle on to automatically show the Guest notes window when opening a cart with a customer assigned or when assigning a customer to a cart. This can also be configured by Dutchie Support to show the Journal instead.
- Show search in guest list: Toggle off to hide the search bar in the guest list and require budtenders to scan IDs to look up customer profiles. Toggle on to allow budtenders to search customers manually.
- Hide orders assigned to other registers: Toggle on to hide customer cards assigned to other registers from the guest list. Toggle off to show all customer cards in the guest list.
Keyboard settings (Register Terminal only)
By default, the Register Terminal uses an on-screen keyboard customized for Dutchie POS. The Keyboard tab allows you to access the Android operating system’s keyboard settings and use Android’s Gboard instead.