Skip to main content
Connect qrtub to Computerized Maintenance Management Systems (CMMS) like UpKeep, Fiix, or Maintenance Connection.

​
Overview

CMMS platforms track maintenance schedules, work orders, and asset history. Integrating with qrtub enables:
  • Scan equipment to open maintenance records
  • Create work orders from the field
  • Access service history on-site
  • Route users to different CMMS functions

​
Integration Approaches

Some CMMS platforms provide deep link URLs that open the mobile app: 
yourCMMS://asset/[ASSET_ID]
yourCMMS://workorder/create?asset=[ASSET_ID]
Check your CMMS documentation for deep link support.

​
Option 2: Web-Based Access

Most CMMS platforms have web interfaces accessible via standard URLs: 
https://app.upkeep.com/assets/[ASSET_ID]
https://app.fiix.io/web/wo/create?assetId=[ASSET_ID]

​
Option 3: URL Templates

Use qrtub’s URL Templates to automatically construct CMMS URLs with Item data: In qrtub:
  • Item field cmmsAssetID: “PUMP-042”
  • Destination URL template: https://app.yourcmms.com/assets/{cmmsAssetID}
Generated URL when scanned: https://app.yourcmms.com/assets/PUMP-042 Why this matters for bulk deployment: Configure the URL template once. Import or create hundreds of Items with their cmmsAssetID values. Each QR code automatically routes to the correct asset record in your CMMS—no manual URL configuration per Item.

​
Example Setup: UpKeep

​
Create Profile Page Destinations

View Asset Record 
https://app.upkeep.com/assets/{assetID}
Create Work Order 
https://app.upkeep.com/work-orders/new?asset={assetID}
View Maintenance History 
https://app.upkeep.com/assets/{assetID}/history

​
Multi-System Profile Page

Combine CMMS with other systems: Destinations:
  1. “Start Inspection” → SafetyCulture
  2. “View Maintenance” → CMMS
  3. “Log Issue” → Work order creation
  4. “Equipment Manual” → Documentation link
One QR code, all systems accessible.

​
Common CMMS Platforms

PlatformWeb AccessDeep LinksNotes
UpKeep✅Check docsMobile-first platform
Fiix✅Check docsWeb and mobile apps
Maintenance Connection✅❌Web-based
Hippo CMMS✅Check docsCloud-based
eMaint✅❌Enterprise platform
Note: Deep link availability changes. Check your CMMS documentation or contact support.

​
Best Practices

Field Mapping Ensure your qrtub Item fields match your CMMS asset identifiers:
  • Use same asset ID format
  • Include all necessary parameters
  • Test URLs before mass deployment
User Testing Before deploying 500 QR codes:
  1. Test on mobile devices (iOS and Android)
  2. Verify authentication works
  3. Confirm deep links open correctly
  4. Test from different network conditions
Vendor Lock-in Protection This is qrtub’s value: if you switch CMMS vendors, update Destinations in qrtub—don’t reprint QR codes.

​
Troubleshooting

“Page not found” errors:
  • Check asset IDs match between qrtub and CMMS
  • Verify URL structure with CMMS documentation
  • Test static URL first, then add URL template placeholders
Authentication issues:
  • Ensure users are logged into CMMS app
  • Check if CMMS requires session tokens
  • Consider SSO if your CMMS supports it

​
Resources