How to Setup a Terminal-Driven Cash Drawer

November 1, 2024


On this page

This solution for them who does not use external printer for receipt printing, but prints receipts via terminal. 

In order to configure the cash drawer with a terminal the USB trigger device should be used to get it to work. The example of the usb trigger device:

 

Please follow these steps in order to configure the automatic opening of the cash drawer when receipts are printing via terminal:

  1. Connect the usb trigger device to your computer and cash drawer. 
  2. Log into POS → Settings → Printing Configuration → Enable “Try printing using go microservices”. Click Save.
  3. Go to Wizard. Make sure you have the printing microservice installed.  If not please refer to this article to install the printing microservice.
  4. Once the printing microservice is installed, please navigate to the Wizard again → Hardware → Integrations → Select Pos → Choose Printer → Click Continue.
  5. Toggle Golang printing microservice → click on the Golang microservice to see the list of printers.
  6. Configure the printer if you still do ot have. In this case, probably, you are setting up printing via terminal. Then tick the “Get full printer list” and form the Name dopdown select the terminal for receipt printing. 
  7. Scoll a bit down and enable the “Open Cash Drawer”.
  8. Enable the “Use external cash drawer”.
  9. Save the printer settings.
  10. Navigate to the Hardware -> Installer app -> micro-service manager -> from the UPDATE EXISTING MICRO-SERVICE select “printing-microservice” -> click 'Continue'.
  11. Make sure logLevel is DEBUG and the port name  "CashDrawerSerialPortName" is correct.
  12. "ExternalCashDrawer": true.
  13. Save new configuration.
  14. Click Start (if there only Stop button, click on it, then click on the Start)
  15. Go back to POS and refresh the page.
  16. In order to test the configuration click the “Cash Drawer” button on the POS grid.

Important to know

The cash drawer setup with the terminal stops working when the printing micro-service has been stopped. If to start the micro-service again then the setup that was performed following the steps above needs to be configured again from the start.