Receipt Printer Configuration - Getting Started

Note: Star TSP100 printers must be configured in Epson ESC/POS mode for cash drawer and receipt cutting functionality


Navigate to Configuration > Peripherals > Receipt Printer Configuration
CivicRec can print/cut thermal receipts using your receipt printer, and pop open POS cash drawers. To do this, we use a Java plugin that prints directly to your receipt printer and/or cash drawer.


Step 1 - Connecting your printer &/or cash drawer to your PC

  1. For USB printers, make sure it is connected and you installed the drivers from the manufacturer (either by cd or downloaded). The printer should be visible in "Devices and Printers" in Windows.
  2. For connecting directly via serial, see the "Connecting a Serial Printer in Windows" section at the bottom of the page.
  3. Cash drawers can be plugged directly into the PC, or more commonly, they are plugged into the receipt printer, which is plugged directly into the PC.


Step 2 - Installing QZ Tray App

  1. Make sure you have the QZ Tray App 2.0 installed


Step 3 - Configuring CivicRec

  1. In CivicRec, go to the "Configuration" tab and click "Peripherals" then "Receipt Printer Configuration" and wait for it to fully load. You will have to grant permission to the QZ Print Plugin. Use the "Always Allow" option so the plugin won't be blocked.
  2. Enter the name or partial name of the printer as it appears in "Devices and Printers" in Windows.
  3. If set up correctly, Rec1 will now be able to recognize your printer. Click "Test Printer Connection." It should print a test line and pop your cash drawer.
  4. Ensure the "characters per line" setting is set to match the specifications for your model of the receipt printer.
  5. Save the settings and try printing a test receipt. If everything was setup properly, it should print right out!


Step 4 - Using in CivicRec

  1. CivicRec uses a pop-up window that you can minimize in the background to stay connected to the receipt printer. This makes printing receipts extremely fast from the browser. When it opens for the first time, you'll have to make sure to "allow all popups from..." or CivicRec won't be connected to the receipt printer.
  2. In Point-of-Sale, you can print a test receipt by going to Options / Print Test Receipt. You will also have the cash drawer pops open, and a receipt printed when a POS transaction is completed.
  3. In the full checkout process (program registration or facility rental), a receipt will print once the transaction is completed.

Connecting a Serial Printer in Windows

Adding a "generic / text only" printer named CivicRec for compatibility and/or serial printers.
  1. Access the Printers section in the computer's control panel.
  2. Click "Add a Printer" and set the printer as a "local printer".
  3. You will then have a drop-down menu for what port the printer is on. 
    For serial: This should be set to COM1.
  4. When you get to the screen to select manufacturer/printer, leave it on "Generic / Text Only" and just click next.
  5. Make sure not to make it your default printer, it doesn't need to be shared, and you don't need a test page.
  6. The name of the printer should be CivicRec. You should now see a printer in your printer list called "CivicRec".
  7. Follow the first set of steps using the printer name CivicRec.
Note: Global Settings are stored in the CivicRec database, so they will never be reset. Local Settings are stored as a "cookie" and can be reset if you clear your browser history/cookies. We advise that everyone configure their printers the same way on all machines so that Global settings are used and local are not.

Cash Drawer Command Setup for Windows

In order to assure that the printer is sending a cash drawer kick command, do the following:
  1. Open Printers and Faxes (or Devices and Printers in Windows 7). In Windows XP, click Start, click
  2. Run, type control printers, then press Enter. In Windows Vista or Windows 7, click Start, type control printers, and press Enter.
  3. In Windows XP or Windows Vista, right-click your printer, click Properties, then click Printing Preferences. In Windows 7, right-click your printer, click Printer Properties then click Printing Preferences.
  4. Click the Document Settings tab.
  5. Click Cash Drawer. Set both cash drawers to open before printing. Click OK.
  6. Click the General tab. Click Print Test Page.
  7. Your cash drawer should open upon printing. If it does not, you may wish to troubleshoot cash drawer connectivity.

I'd Like to Request an Enhancement

0 out of 0 found this helpful