Skip to main content

​
Overview

Vehicle management allows you to register and maintain information about the vehicles you use for Viax trips. Each vehicle must be verified and approved before you can use it for passenger transport.

​
Vehicle Types

Viax supports four vehicle categories:
Motorcycle
  • License required: A2 or higher
  • Capacity: Driver + 1 passenger
  • Best for: Solo passenger trips
  • Insurance: Third-party liability minimum
Requirements:
  • Valid registration (SOAT)
  • Technical inspection (revisión técnico-mecánica)
  • Age: Less than 10 years old

​
Vehicle Entity Structure

From the source code: 
class Vehicle {
  final int? id;
  final String tipoVehiculo;      // 'moto', 'carro', 'moto_carga', 'carro_carga'
  final String? placa;             // License plate number
  final String? marca;             // Make/brand
  final String? modelo;            // Model
  final int? anio;                 // Year
  final String? color;             // Color
  final String? soatUrl;           // SOAT document URL
  final String? tecnicoMecanicaUrl; // Tech inspection URL
  final DateTime? soatVencimiento;  // SOAT expiration
  final DateTime? tmVencimiento;    // Tech inspection expiration
  
  bool get isComplete {
    return placa != null &&
        placa!.isNotEmpty &&
        marca != null &&
        modelo != null &&
        anio != null &&
        soatUrl != null &&
        tecnicoMecanicaUrl != null;
  }
}

​
Adding a Vehicle

1

Go to vehicle section

Navigate to Profile > My Vehicles > Add Vehicle
2

Enter vehicle details

Fill in required information:
  • Vehicle type (moto, carro, etc.)
  • Plate number (format: ABC123)
  • Make/Brand (e.g., Chevrolet, Yamaha)
  • Model (e.g., Spark, FZ16)
  • Year (e.g., 2020)
  • Color
3

Upload documents

Required documents:
  • SOAT (mandatory insurance)
  • Tecnomecánica (technical inspection)
  • Tarjeta de Propiedad (ownership card)
  • Vehicle photos (front, back, both sides)
All documents must be current and not expired.
4

Submit for verification

Submit your vehicle for admin approval.Verification typically takes 24-48 hours.
5

Receive approval

Once approved, you can select this vehicle for trips.

​
Document Requirements

​
SOAT (Mandatory Insurance)

  • Valid and not expired
  • Plate number must match registered vehicle
  • Coverage: At least third-party liability
  • Clear, readable photo or scan
  • PDF or JPG format
  • Max file size: 5MB

​
Tecnomecánica (Technical Inspection)

  • Valid certificate from authorized center
  • Not older than 1 year
  • Vehicle must have passed inspection
  • Clear photo showing:
    • Certificate number
    • Expiration date
    • Vehicle plate
    • Pass/approval stamp

​
Tarjeta de Propiedad (Ownership Card)

  • Official vehicle registration document
  • Owner name must match driver or show authorization
  • Both sides of card photographed
  • Clearly shows plate number and vehicle details

​
Updating Vehicle Information

You can update certain vehicle details: Can be updated without re-approval:
  • Color
  • Phone number (contact)
  • Notes
Requires re-approval:
  • Plate number
  • Make/model
  • Year
  • SOAT document
  • Technical inspection
  • Vehicle type
Changing critical information like plate number requires admin re-verification before the vehicle can be used again.

​
Document Expiration

The app tracks document expiration dates: 
// Document expiration tracking
class Vehicle {
  DateTime? soatVencimiento;       // SOAT expiration
  DateTime? tmVencimiento;         // Technomechanical expiration
  
  bool get hasValidSOAT {
    return soatVencimiento != null &&
           soatVencimiento!.isAfter(DateTime.now());
  }
  
  bool get hasValidTM {
    return tmVencimiento != null &&
           tmVencimiento!.isAfter(DateTime.now());
  }
}

​
Expiration Notifications

30 Days Before

First reminder to renew expiring documents

15 Days Before

Urgent reminder with instructions

7 Days Before

Final warning before document expires

On Expiration

Vehicle automatically disabled from service

​
Multiple Vehicles

You can register multiple vehicles:
  • Add up to 5 vehicles per driver account
  • Switch between vehicles before going online
  • Each vehicle verified independently
  • Cannot use multiple vehicles simultaneously
  • Set a default vehicle for quick starts

​
Switching Vehicles

1

Go offline

You must be offline (not accepting trips) to switch
2

Select vehicle

Go to Profile > My Vehicles > Active Vehicle
3

Choose vehicle

Select from your approved vehicles
4

Confirm

Confirm the switch
5

Go online

Now online with the selected vehicle

​
Vehicle Photos

Upload clear photos of your vehicle: Required angles:
  • Front view
  • Rear view (showing plate)
  • Driver side
  • Passenger side
  • Interior (front and rear seats)
Photo guidelines:
  • Good lighting (daytime preferred)
  • Clean vehicle
  • Clear plate number visibility
  • No filters or editing
  • Recent photos (within 3 months)

​
Colombian Plate Number Format

Viax validates Colombian license plates: 
// Plate validation from source
static final RegExp colombianPlateRegex = RegExp(
  r'^[A-Z]{3}[0-9]{3}$',
  caseSensitive: false,
);

// Examples:
// ABC123 ✓ Valid
// XYZ789 ✓ Valid  
// AB1234 ✗ Invalid (wrong format)
// ABCD12 ✗ Invalid (4 letters)

​
Vehicle Verification Status

StatusDescriptionCan Use for Trips
pendingAwaiting admin reviewNo
approvedVerified and activeYes
rejectedFailed verificationNo
expiredDocuments expiredNo
suspendedTemporarily disabledNo

​
Removing a Vehicle

To remove a vehicle from your account:
You cannot remove your only vehicle if you have active trip history with it.
  1. Ensure no active trips with this vehicle
  2. Go to My Vehicles
  3. Select vehicle to remove
  4. Tap Remove Vehicle
  5. Confirm removal
Removed vehicles can be re-added later but require re-verification.

​
Troubleshooting

Common causes:
  • File too large (over 5MB)
  • Wrong format (only JPG, PNG, PDF)
  • Poor image quality
  • Network connection issue
Solutions:
  • Compress image before upload
  • Use supported formats
  • Ensure good lighting and clarity
  • Try again with stable internet
Check rejection reason in notification:
  • Expired documents
  • Unreadable photos
  • Plate number mismatch
  • Vehicle doesn’t meet requirements
Correct the issue and resubmit.

​
Next Steps

Document Verification

Learn about required documents and verification

Profile Management

Manage your driver profile

Start Driving

Begin accepting trips with your vehicle

Build docs developers (and LLMs) love

Get started for freeTalk to us