QR labels

Every asset automatically gets a QR code. Print labels, stick them on hardware, and scan from any smartphone to instantly pull up the asset record.

What the QR code encodes

The QR code encodes the asset's asset tag as a plain text string — for example, IT-0042. It does not contain a URL. This keeps codes short (better scan reliability from a distance), and means the code remains valid even if your domain name changes.

Generating a QR code

1. Open the asset detail page
2. The QR code appears in the right-hand panel, automatically generated from the asset tag
3. Click Download QR to save the PNG

The downloaded file is named after the asset tag — e.g. IT-0042.png.

QR codes via the API

httpCopy
GET /api/assets/{id}/qr
# No authentication required — QR codes are public
# Returns: image/png

The QR endpoint requires no authentication, making it suitable to embed in printed materials, intranet pages, or inventory management systems that generate labels automatically.

Printing labels

The QR code downloads as a 200×200px PNG at 72 dpi. For best results when printing:

• Print at actual size — do not scale up. QR codes scan better at their native resolution.
• A minimum printed size of 20×20mm is recommended for reliable scanning with typical smartphone cameras at arm's length.
• Add the asset tag text below the code as a human-readable fallback.
• Use a label printer (Brother QL series, Dymo LabelWriter) for durability. Office paper labels peel off quickly in most MSP environments.
• Consider laminated or polyester labels for equipment in harsh environments (data centres, warehouses).

Scanning labels in the field

Any smartphone camera (iOS or Android) reads the QR code without a separate app. The scanned result shows the asset tag text (e.g. IT-0042). Staff then:

• Open Tether in their browser on the client subdomain
• Use the search box to find the asset by tag
• Perform the checkout, checkin, or status update

Bulk label generation tips

To generate labels for all assets in a tenant:

bashCopy
# 1. Export asset list
curl -H "Authorization: Bearer $TOKEN" \
  https://acme.atechsolutions.org/api/assets/export/csv > assets.csv

# 2. For each asset_tag in the CSV, download its QR code
# The asset ID is in the JSON API — get it first:
curl -H "Authorization: Bearer $TOKEN" \
  https://acme.atechsolutions.org/api/assets | jq '.[].id'

# 3. Download QR PNG for each ID
curl https://acme.atechsolutions.org/api/assets/42/qr > IT-0042.png

Or use the Swagger UI at https://atechsolutions.org/docs to download QR codes interactively.