> ## Documentation Index
> Fetch the complete documentation index at: https://help.qrtub.com/llms.txt
> Use this file to discover all available pages before exploring further.

# CMMS Systems Integration

> Connect QR codes to your maintenance system using deep links and URL Templates

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

### Option 1: Direct Deep Links (If Supported)

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/{{item.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 Page Destinations

**View Asset Record**

```
https://app.upkeep.com/assets/{{item.assetID}}
```

**Create Work Order**

```
https://app.upkeep.com/work-orders/new?asset={{item.assetID}}
```

**View Maintenance History**

```
https://app.upkeep.com/assets/{{item.assetID}}/history
```

## Multi-System Page

Combine CMMS with other systems:

**Destinations:**

1. "Start Inspection" → Mitti (formerly 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

| Platform               | Web Access | Deep Links | Notes                 |
| ---------------------- | ---------- | ---------- | --------------------- |
| UpKeep                 | ✅          | Check docs | Mobile-first platform |
| Fiix                   | ✅          | Check docs | Web and mobile apps   |
| Maintenance Connection | ✅          | ❌          | Web-based             |
| Hippo CMMS             | ✅          | Check docs | Cloud-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

* [Pages Overview](/pages/pages-overview)
* [Key Concepts](/key-concepts)
* Contact your CMMS vendor for deep link documentation

***

**Ready to get started with QRtub?** [See plans and pricing →](https://qrtub.com/pricing)

Questions? Email us at [hi@qrtub.com](mailto:hi@qrtub.com)