Skip to main content

Generate & Print a QR Code for a Unit

Generate a QR code on a unit so the customer can scan the sticker to see the unit's service history, request a service call, or hand the link to a tech. Once generated, the same code lives on the unit forever — print it as many stickers as you need, replace it as many times as you need.

The QR code points to a public URL like https://app.tuffops.com/u/<guid>. Anyone with the URL can see the unit's public page and submit a service request. Treat the URL as semi-public — share it with the customer freely, but don't post it on the open web.

Before you start​

  • The unit exists. If not, Add a Unit first.
  • You have the units.edit permission.
  • You have a printer that handles standard label stock or A4 paper. The print page lays out 3 codes per row in print mode.

Steps​

  1. Open the unit

    Select Units in the top navigation bar, then select the Edit action for the unit.

  2. Generate the code

    Find the QR Code card on the right side of the edit page. Select the Generate QR Code button. Confirm when prompted.

    (If you see a GUID and a Print QR Code button instead, the unit already has a code — skip to step 3.)

  3. Open the print view

    Select the blue Print QR Code button in the QR Code card. A new tab opens with the QR code laid out for printing.

  4. Print

    Select the green Print QR Codes button at the top of the new tab. Use your browser's print dialog to send to your label printer or to PDF.

    The printed sticker shows: the unit's QR code, Unit #ID, the manufacturer + model, the device type, the customer (if attached), the serial number (if set), and the GUID for ops reference.

  5. Stick it on the unit

    Mount the sticker somewhere visible on the unit's exterior. Avoid the air intake and any spot that gets washed down. Eye-level or just below tends to work best for handheld scanning.

What happens next​

  • The unit now has a qr_code_guid and a public URL.
  • The customer can scan the sticker to see the unit's service history and request a new service call. Their request shows up in Customer Requests.
  • A technician on a work order for this unit can scan the sticker to confirm they're at the right unit. (The work order edit page hides the QR scanner for units that already have a code installed.)
  • You can also copy the customer-facing URL with the Copy Customer Link button on the unit's edit page — useful for emailing or texting it.

Common situations​

SituationWhat to do
You need to print the QR for several units at onceOpen the Units list. Filter to the units you need. (Batch print is available via the URL but not yet wired into the list UI — printable from each unit's edit page for now.)
The sticker got damaged and you need a fresh oneOpen the unit and select Print QR Code again. Same GUID, same URL. The replacement is a drop-in.
You want to invalidate the URLThere's no built-in invalidate. Delete the unit (which frees the GUID) or contact support to rotate it. The URL can't be reused for another unit.
You're pre-printing labels before knowing which unit they're forUse Print Blank QR Labels instead. Field techs scan the blank label during a work order to install it on the unit.
The customer didn't get a sticker but you want them to have the linkSelect Copy Customer Link in the QR Code card on the unit's edit page and paste it into an email or WhatsApp.

Troubleshooting​

The Generate QR Code button isn't there.

The unit already has a QR code. Look for the GUID and the Print QR Code button in the same QR Code card. If you genuinely need a different GUID, that's not currently supported in the UI — contact support.

Generate fails with "This unit already has a QR code assigned."

Same as above — the GUID was generated by another user (or by a tech scanning a blank label) since you last loaded the page. Refresh the edit page.

The print page opens but the QR codes are blank squares.

The print page loads qrcodejs from a CDN. If you're on a network that blocks cdn.jsdelivr.net, the QR images won't render. Whitelist the CDN, or print from a different network. The GUID and unit info still show, so the print is partially salvageable for a tech to assign manually.

The customer scans the sticker and sees "Page not found".

The unit was deleted, or the URL points at a different environment (e.g. you printed from staging and tried to scan it against production). Confirm the URL printed under the QR — the host should be your production app domain.