How to set up the Dutchie Register iPad app and connect your hardware

With the Dutchie Register iPad app, dispensaries migrating from Greenbits can run the Dutchie Register with their existing hardware.

If you aren’t migrating from Greenbits to Dutchie POS, we recommend continuing to use Windows devices, along with our recommended peripherals.

Table of contents

Recommended devices

We recommend iPad and iPad Pro within the last 3 generations with the latest version of iPadOS. When a new version becomes available, run a software update on each of your iPads after you close for the day because iPads can’t be used during the update process.

iPad Mini and older versions of iPadOS are not supported. If your iPad can no longer receive software updates from Apple, it is no longer supported.

The Dutchie Register iPad app is designed to work with same peripherals as Greenbits, including:

  • Star mC-Print3 or TSP100 receipt printers
  • Socket Mobile Bluetooth barcode scanners
  • Zebra USB or Bluetooth barcode scanners
  • Zebra label printers
  • A&D FX-300iN scales with Lantronix serial-to-Ethernet adapters

Connect your hardware

The Dutchie Register iPad app is designed to use the same connection methods as Greenbits, so most users won’t have to make any changes to their network setup or physical connections between peripherals.

integrated_scale_set-up_without_cables.jpg

Your peripherals and connections may vary slightly from the diagram above. For example:

  • Your barcode scanner may be a wireless Bluetooth model instead of the USB scanner pictured.
  • Your iPad and receipt printer may be connected via a USB-C cable instead of a Lightning cable, or there may be no wired connection between the iPad and receipt printer.
  • Your Zebra label printer may be a different model as long as it supports network connection via Ethernet (ZD-410 shown).
  • You may use a different network switch; the Trendnet switch shown is not required.

Install the app and sign in

  1. On your iPad, click here to download the Dutchie Register app from the App Store.
  2. Once downloaded, launch the app.
  3. When prompted, Allow Dutchie Register to find local devices on local networks and Bluetooth devices.
    ipad_allow local devices prompt.pngipad_allow bluetooh prompt.png
  4. Enter your Region. This is the server name that appears just after https:// in the URL that you use to log into the Dutchie Backoffice. You will only need to enter this the first time you log in on each iPad.
    region URL.png
    region login.png
  5. Enter your Dutchie POS username and password. After you begin a session by logging in with a username and password, you and other users will also have the option to log in with a PIN (if enabled for your location).
  6. If you have the POS Manager permission, select which Register you want to log into.

By default, Dutchie Registers are not associated with a specific iPad, and you can access any of your location’s Registers from any device. If you want to associate each Register with a specific iPad, contact Dutchie Support to have the Assign POS Registers to Physical Hardware feature enabled for your location. Then refer to the Default register section below.

You can add and configure Dutchie Registers in the Backoffice and can add as many Registers as you need with no additional subscription fees.

Connect peripherals in the app settings

Tap the Settings gear to begin, then select a device to connect.

ipadreg_settings gear.png

Receipt printer

Tap Select receipt printer. Tap Refresh if no printers appear in the dropdown.

Receipt printers connected to your network are identified by their MAC addresses:

ipadreg_select receipt printer_mac address.png

To identify a printer’s MAC address:

  1. Turn the printer off.
  2. While pressing and holding the paper feed button, turn the printer back on. Continue holding the feed button for several seconds until the printer prints a Network Configuration sheet.
  3. Note the MAC Addr (Printer), which corresponds to the MAC address shown in the app settings.
    mcPrint-3 diagnostic sheet w MAC address.png

Fulfillment ticket and Z report printers

By default, your receipt printer is also used for fulfillment tickets and Z reports.

To designate separate printers for fulfillment tickets or Z reports, select Fulfillment ticket printer or Z Report printer and select a different printer on your network.reg_settings_receipt fulfillment z report printers.png

Barcode scanner

Zebra scanners

If you have a USB barcode scanner, connect your Receipt printer before connecting your scanner.

  1. Remove the back cover of your Star mC-Print3 receipt printer.
    mcprint3_remove_cover.jpg
  2. Connect your scanner to one of the USB ports on your Star mC-Print3 receipt printer. Do not connect to the port labeled iPad 2.4A
    mcprint3_usb_ports.jpg
  3. In the Barcode scanner settings, tap Select barcode scanner. Tap Refresh if no scanners appear.
  4. USB scanners are identified based on the receipt printer they’re connected to:
    ipadreg_select barcode scanner.png
  5. Tap Configure scanner and select a scanner configuration option.
    • Zebra – Bluetooth is for the wireless Zebra CS6080 scanner.
    • Zebra – Basic is for wired CS6080 scanners and wired DS2208 scanners and may also support ID scanning.
      ipadreg_configure barcode scanner.png
  6. Scan the on-screen configuration barcodes in order.
  7. Tap Done.
  8. Tap Test scanner and then scan each sample barcode/QR code to confirm functionality.

Socket Mobile scanners

  1. Download and launch the Socket Mobile Companion app from the App store.
  2. Confirm Bluetooth is turned on in your iPad settings.
  3. Turn on the scanner by holding the power button until the LED indicator lights up.
  4. Enable Pairing Mode by holding the scan button until the device enters Bluetooth discovery mode.
  5. Follow the in-app prompts to connect and configure the scanner.
    socket companion app.gif
  6. In the Dutchie Register, tap Barcode scanner and select the Socket device.
  7. Tap Test scanner and then scan each sample barcode/QR code to confirm functionality.

Tip: Socket scanners are identified in the iPad Bluetooth settings, Socket Mobile Companion app, and in the Dutchie Register app settings by the last 6 characters in the device’s MAC address, which is printed on a sticker on the device itself:

D750_sticker.png

Label printer

  1. In the Label printer settings, tap Select label printer. Tap Refresh if no printers appear.
  2. Label printers are identified with their serial number (first row) and IP address (second row).
    ipadreg_settings_label printer_sn and ip.png

    • The serial number should be printed somewhere on the outside of the printer. Location varies by model.
    • To find a label printer’s IP address, first confirm the network light is solid green.
      receipt and label printer network light.png
    • Then press and hold the feed and cancel buttons for 2 seconds (ZD 410 shown).
      zd410_get_config.jpg
    • A Network Configuration label prints, which includes the IP address. Note that these labels include leading zeros that the Dutchie Register app will ignore. For example, this printer would appear in the app settings with an IP address of 10.1.12.82
      zd410_config_w_dhcp.jpg
  3. Select your Default label. Label templates are configured in the Backoffice.

Scale

Your A&D FX-300iN scale should be configured according to this guide.

  1. In the Scale settings, tap Select scale.
  2. Select Serial Port 1 (your scale’s RS232 serial cable should be connected to Serial Port 1 on your Lantronix adapter).
  3. Confirm the Test weight reading matches the digital reading on your scale.

Optional: Assign a default register for each device

By default, Dutchie Registers are not associated with a specific iPad, and users can access any of your location’s Registers from any device. If you want to associate each Register with a specific iPad, contact Dutchie Support to have the Assign POS Registers to Physical Hardware feature enabled for your location.

When this setting is enabled, users with the POS Manager permission can assign a Default register to each device. POS Managers can also switch between different registers on the same device, but other users will no longer have this ability.

reg_settings_default register.png
reg_settings_default register_assign.png

Display settings

You’ll find these additional options under the Display tab:

reg_settings_display tab.png

  • 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.