QR Code Generation

Every vehicle in your fleet needs a QR code that customers can scan to start a rental. Levy Fleets automatically generates scannable QR codes that link directly to your vehicles through the mobile app.

How QR Codes Work

When a customer scans a vehicle's QR code:

1. The code contains a deep link URL: https://fleets.levyelectric.com/open/[vehicle-id]
2. The mobile app opens (or the App Store if not installed)
3. The customer is taken directly to that vehicle's rental screen
4. They can then start a ride after authentication

QR Code Features

Design Elements

Each generated QR code includes:

• Scannable QR pattern: High-contrast black on branded background
• Vehicle label: The vehicle number/ID printed below the code
• Branded background color: Levy brand color (#DAF8F2)
• High error correction: Level "H" by default (30% damage tolerance)

Technical Specifications

Generating Single QR Codes

From the Vehicle Detail Page

1. Navigate to Dashboard > Vehicles
2. Click View on any vehicle to open the detail page
3. Click Download QR Code in the actions menu
4. The QR code downloads as a PNG file

From the Vehicles List

1. Navigate to Dashboard > Vehicles
2. Find the vehicle row you need
3. Click the QR icon button
4. The QR code downloads immediately

File Naming

Downloaded files are named: vehicle-[vehicle-number]-qr.png

Example: vehicle-VH-001-qr.png

Bulk QR Code Generation

Generate QR codes for multiple vehicles at once:

Using the Dashboard

1. Navigate to Dashboard > Vehicles
2. Select multiple vehicles using the checkboxes
3. In the bulk action bar, click Download QR Codes
4. A ZIP file downloads containing all selected QR codes

Bulk Download Limits

• Maximum 100 vehicles per request
• Files are packaged in a ZIP archive
• ZIP file named: vehicle-qr-codes-[date].zip

ZIP Contents

Each QR code in the ZIP is named individually:

vehicle-qr-codes-2024-12-25.zip
├── vehicle-VH-001-qr.png
├── vehicle-VH-002-qr.png
├── vehicle-VH-003-qr.png
└── ...

QR Code Formats

PNG Format (Default)

• Best for: Printing, physical stickers
• Features: Includes vehicle label, branded background
• File size: Varies by size setting (typically 10-50KB)

SVG Format

• Best for: Scalable graphics, high-resolution printing
• Features: Vector format, infinite scaling
• Limitation: Does not include the vehicle label
• File size: Smaller than PNG

Error Correction Levels

QR codes can be generated with different error correction levels:

Printing Guidelines

Recommended Sizes

Print Quality

For best results:

• Use at least 300 DPI for physical prints
• Generate at 2x the physical size (e.g., 1024px for a 512px print)
• Use weather-resistant materials for outdoor vehicles
• Consider UV-resistant lamination

Sticker Placement

Recommended locations:

1. Handlebar stem: Most common, eye-level for scanning
2. Deck/frame: Secondary location, visible when parked
3. Battery compartment: For staff identification

Deep Link URL Structure

Standard Format

https://fleets.levyelectric.com/open/[identifier]

Identifier Resolution

The system uses the best available identifier:

1. vehicle_number (preferred): Human-readable ID like "VH-001"
2. UUID (fallback): Full vehicle UUID if no vehicle_number set

URL Examples

https://fleets.levyelectric.com/open/VH-001
https://fleets.levyelectric.com/open/SCOOTER-123
https://fleets.levyelectric.com/open/abc12345-xxxx-xxxx-xxxx-xxxxxxxxxxxx

Best Practices

Consistent Naming

Use consistent vehicle numbers for clean QR labels:

• Good: VH-001, VH-002, VH-003
• Avoid: Scooter1, test, new_vehicle_march

Regular Updates

Regenerate QR codes if:

• Vehicle number changes
• QR code becomes damaged or unreadable
• Rebranding or URL changes

Testing

Before mass printing:

1. Generate a test QR code
2. Print at intended size
3. Scan with mobile app to verify
4. Check the correct vehicle appears

Archiving

Keep digital copies of all QR codes:

• Use bulk download to create archives
• Store in cloud backup
• Include vehicle list for reference

Troubleshooting

QR Code Won't Scan

1. Check print quality: Ensure sufficient contrast
2. Verify size: May be too small for camera
3. Clean the code: Remove dirt or obstructions
4. Check error correction: Lower levels are more sensitive to damage

Wrong Vehicle Opens

1. Verify vehicle ID: Check the QR links to correct vehicle
2. Regenerate code: Create a fresh QR for the vehicle
3. Check for duplicates: Ensure vehicle_number is unique

Mobile App Not Opening

1. App not installed: User needs to install the app first
2. Deep link configuration: Contact support if consistent issue
3. Old QR code: May contain outdated URL format

Bulk Download Fails

1. Check selection: Ensure vehicles are selected
2. Reduce batch size: Try fewer vehicles (max 100)
3. Browser limits: Some browsers block large downloads
4. Network timeout: Try again with smaller batch

Permissions

Any authenticated user can generate QR codes for vehicles in their subaccount.