Skip to main content

Scan a Unit's QR Code in the Field

When you scan a TuffOps unit QR while signed in, the app skips the public unit page and lands you on the Work Orders list filtered to that unit. From there, open the right job and start work.

Before you start​

  • You're signed into TuffOps in the same browser you'll use to scan.
  • The unit has a QR code. Blank QR codes don't resolve to a unit and return a 404.
  • You have at least one work order assigned for that unit, or you have permission to ask the office for one.

Steps​

  1. Open the camera

    Use your device's camera app or any QR-code scanner. The QR code on a unit is the round sticker the office attached during setup.

  2. Scan the code

    Point the camera at the QR code and hold steady. The scanner shows a URL like /u/<guid>.

  3. Open the URL

    Select the URL preview to open it in your default browser. If the browser is logged into TuffOps, the app redirects you to Work Orders filtered to this unit.

  4. Pick the right job

    The list shows every work order on this unit you have access to, in any status. Select the Edit action for the one you're working today. From there, start the work order when you arrive on site.

What happens next​

  • The redirect uses the unit's ID, not the QR GUID, to filter the list. The URL bar shows /work_orders?unit_id=<id>.
  • The list filter is sticky for the session. To clear it, select Clear at the top of the Filter card.
  • Scanning never opens a new work order or modifies the unit. It's purely a lookup.

Common situations​

SituationWhat to do
The list comes back empty after a scanNo work order is assigned to you for this unit. Either ask the office to assign one, or check with work_orders.supervise whether one exists in unassigned.
You see work orders that aren't yoursYou have work_orders.supervise. The list shows every work order on this unit, not just yours.
You scanned but the browser opened the public unit pageYou aren't signed into TuffOps in this browser. Sign in, then scan again — or open /u/<guid> after signing in.
The QR code is missing or damagedUse the Search field on the Work Orders list to find the unit by serial number or customer. Ask the office to print a replacement QR sticker afterwards.
You arrived but no work order is open and the customer is asking for serviceThe customer can submit a service request from the public scan flow themselves. Open /u/<guid> in a private/incognito window to see the form. The office triages it and creates a work order.

Troubleshooting​

The scan opens the public unit page even though you're signed in.

The browser that opened the URL isn't the one signed into TuffOps. iOS, in particular, may open links in an in-app browser (Mail, Messages) instead of Safari. Long-press the QR or copy the link, then paste into the browser where you're signed in.

The URL returns a 404.

The QR code isn't assigned to a unit, or it's a blank QR that hasn't been linked yet. Tell the office which sticker you scanned (the GUID is in the URL) so they can resolve it. Until then, search for the unit by serial number on the Work Orders list.

The redirect lands on Work Orders but the list shows every work order, not just this unit.

The unit_id filter didn't apply. Reload the page from the QR URL. If it persists, copy the URL from the bar and re-open it directly — a stale session filter may be overriding it.