AirQR
Cash drawer

Connect an electronic cash drawer

Your cash drawer (float, cash in and out, counting, X and Z reports) works with no equipment. An electronic drawer is an optional extra that opens the box for you: connect it through a receipt printer with the guided set-up, choose when it opens, and see every time it opened.

8 min read

AirQR has two layers that work together but do not need each other.

  1. The cash drawer on screen. On the Cash drawer page you open a shift with a float, record cash in and out with a reason, count the cash at closing and read the X and Z reports. This needs no equipment at all: no electronic drawer, not even a printer. See Open, count and close the cash drawer.
  2. An electronic cash drawer (optional). A drawer box with a cable (RJ11 or RJ12) into the back of your receipt printer opens when the printer sends it a short pulse. Connecting one makes the box open by itself, with no change to anything in layer 1.

Who can set it up and who can open it?

  • Connect, change, test and remove a drawer: anyone with access to Printing settings (owners and managers by default).
  • Open cash box (by hand): anyone who may use the cash drawer (Use the cash drawer: owners, managers and cashiers by default). Owners can change this in Team → Staff → Roles.
  • Opening by hand needs no manager PIN yet. Every manual open is recorded with the person, the time and the reason.

How do I connect one? (guided set-up)

Open the Cash drawer page and find Electronic cash drawer. It says Not connected (optional) and has Connect one. (You can also press Add in Devices → Cash drawers.)

  1. Choose how it connects: Through a receipt printer's drawer port (the way almost every drawer connects). Directly by USB or serial is shown but switched off: it needs the AirQR printing app and is coming later.
  2. Choose the receipt printer it is plugged into, give it a name if you like, and press Test open. (Add the receipt printer first if you have not.)
  3. AirQR asks Did the drawer open?
    • Yes, it opened: AirQR remembers it works (your name and the time are kept in the audit log) and its status becomes Connected. Then choose when it opens by itself.
    • No: AirQR offers Pin 2 or Pin 5 (if pin 2 does nothing, try pin 5) and the pulse length (a stiff lock may need 150 to 250 ms), then Test again. Also check the cable is in the printer's drawer socket, not the network socket, and that the drawer is not locked with its key.

If you stop half-way, the drawer stays saved with the status Never tested.

Set it up from the AirQR app

Owners and managers can also do the same set-up on an Android phone or tablet: More → Settings → Devices → Cash drawers. Pick the receipt printer (including a Bluetooth or Wi-Fi printer connected to this phone), press Test open, answer Did the drawer open?, and if it did not, try the other pin or a longer pulse. Choose when it opens, pin it to a till if you like, and switch it on or off. The app needs your own sign-in for this, not a shared tablet's PIN. When the app prints for your outlet (a phone or tablet that is a print station), it sends the pulse to its printer by itself on every payment the drawer is set to open for, the same as the web does.

What cable and drawer do I need?

  • A drawer with an RJ11 or RJ12 cable, plugged into the drawer (DK) port of your receipt printer. The printer sends the pulse; AirQR never talks to the drawer itself.
  • Drawers that only open from a USB or serial trigger box are not supported. Use a drawer that plugs into the printer.

What does the status mean?

  • Connected: the printer it is plugged into is online, the drawer is set up, and the last test or open was acknowledged by the printer (or you confirmed it opened).
  • Not responding: the printer is offline, or the last open failed or may not have gone through ("not sure it opened"). Fix the printer (see Printer troubleshooting) and press Test open.
  • Never tested: no test has been acknowledged or confirmed yet.

The card always shows Last opened (time) by (person) ((reason or what opened it)), or Not opened yet. Most drawers cannot tell the printer whether they are open, so AirQR does not show Open or Closed or alert about a drawer left open.

How opening works

  • A drawer opens once for each payment it opens for. A cash-only drawer counts from the latest cash payment, an On any payment drawer from the latest payment of any kind (a bill put on credit or paid from an advance is not a payment that collects money).
  • A check paid in parts counts by its parts: if one part is cash (for example UPI plus cash), the check has a cash payment, in whichever order the parts were taken. The cash part opens a cash drawer when it is taken, and the bill that prints afterwards does not open it again.
  • Reprinting a bill or printing a duplicate never opens it.
  • If two drawers are plugged into one printer (pin 2 and pin 5), each opens by its own rule.
  • If the printer is offline and a backup printer prints instead, the backup opens its own drawer by its own settings, never the first printer's.

When does the drawer open by itself?

For each drawer choose On a cash payment (the default), On any payment or Never for payments. You can also tick When an X or Z report prints and When the shift opens or closes. Never still lets you open it by hand with Open cash box.

If a printer has Open cash drawer switched on in its own settings and you have not added a drawer, nothing changes: it still opens for cash payments. When you add a drawer to that printer, the drawer's choices are used instead, even if you later switch the drawer off. AirQR created a drawer, named "Through (printer name)", for every printer that already had that switch on. Such a drawer keeps following the printer's own switch and pin (turn the printer's switch off and the drawer stops opening) until the first time you save it in Devices → Cash drawers.

Can I pin a drawer to one till?

Yes. In the drawer's settings (Devices → Cash drawers → Edit), Till lists the signed-in browsers of the outlet. Choose one and a payment opens this drawer only when the payment is taken on that till. Any till at this outlet (the default) opens it for payments from every till. Reports, the shift and Open cash box ignore the pin. Payments that do not come from a till (a guest's online or QR payment) do not open a pinned drawer.

No sale and the other reasons

Press Open cash box on the Cash drawer page, on the drawer's line in Devices, or in the payment window. Choose No sale (opening the drawer without a sale, for example to give change from a note), Giving change or Payout, and confirm. The reason, your name and the time are kept in the audit log and counted in the X and Z reports. Print again on a drawer pulse in Recent prints that already printed does the same: it needs the same permission.

The payment window

When you take a payment, a line under the payment methods says which drawer it will open (Opens (name)), or This payment doesn't open a drawer (for example a card payment with a cash-only drawer) or No drawer set up. People who may use the cash drawer also see Open cash box there.

Drawer activity

The Cash drawer page lists Drawer activity: every time a drawer was asked to open, newest first, with the time, the drawer, who, why (the reason you gave, or Payment, X or Z report or Shift) and the result: Sent, Waiting, Failed, Not sure it opened (the printer may have opened it) or Not recorded (old print history has been cleared). Each open is tied to the cash drawer shift that was open at the time, and a shift's report lists the opens of that shift. Anyone who can use the cash drawer can see it.

What do the X and Z reports show?

The Cash drawer section of an X or Z report (on screen and printed) shows Drawer opened: how many times the drawer was asked to open during the shift, how many were by hand, and how many of those were No sale. It shows only when the drawer opened at least once.

The drawer does not open

  • Press Test open. If the printer prints nothing and stays quiet, the printer is offline: check Printer troubleshooting.
  • Try the other pin (Edit the drawer and choose Pin 5).
  • Check that the cable is in the drawer socket of the printer (the RJ11 / RJ12 one, not the network socket) and that the drawer is not locked with the key.
  • Some printers need the Open cash drawer option in their own driver. If you print through the AirQR printing app, that is not needed.

New to AirQR?

Try everything free for 28 days, no card needed. Already a customer? Sign in to follow these steps in your dashboard.

Still stuck? Contact support at support@airqr.in.