Driver Vehicle

Manage driver vehicle information and documents

Update Vehicle Information

POST /conductor/update_vehicle.php

Update vehicle information for a driver.

Request Body

conductor_id · integer · required

Driver ID

vehiculo_marca · string

Vehicle brand/make (e.g., “Yamaha”, “Honda”)

vehiculo_modelo · string

Vehicle model (e.g., “FZ-16”, “CBR250”)

vehiculo_anio · integer

Manufacturing year

vehiculo_placa · string

License plate number (Colombian format)

vehiculo_color · string

Vehicle color

vehiculo_tipo · string

Vehicle type: moto, auto, or mototaxi

empresa_id · integer

Transport company ID (for company-affiliated drivers)

soat_numero · string

SOAT insurance number

soat_vencimiento · string

SOAT expiration date (ISO 8601)

tecnomecanica_numero · string

Tecnomecánica certificate number

tecnomecanica_vencimiento · string

Tecnomecánica expiration date (ISO 8601)

tarjeta_propiedad_numero · string

Vehicle ownership card number

Response

success · boolean

Update success status

message · string

Success message

vehicle · object

Updated vehicle data

Request Example

cURL

curl -X POST https://76.13.114.194/conductor/update_vehicle.php \
  -H "Content-Type: application/json" \
  -d '{
    "conductor_id": 25,
    "vehiculo_marca": "Yamaha",
    "vehiculo_modelo": "FZ-16",
    "vehiculo_anio": 2022,
    "vehiculo_placa": "ABC123",
    "vehiculo_color": "Negro",
    "vehiculo_tipo": "moto",
    "soat_numero": "SOAT123456",
    "soat_vencimiento": "2025-12-31",
    "tecnomecanica_numero": "TM789012",
    "tecnomecanica_vencimiento": "2025-06-30",
    "tarjeta_propiedad_numero": "TP345678"
  }'

Response Example

Success

{
  "success": true,
  "message": "Vehículo actualizado exitosamente",
  "vehicle": {
    "marca": "Yamaha",
    "modelo": "FZ-16",
    "anio": 2022,
    "placa": "ABC123",
    "color": "Negro",
    "tipo": "moto",
    "soat_numero": "SOAT123456",
    "soat_vencimiento": "2025-12-31T23:59:59.000Z",
    "tecnomecanica_numero": "TM789012",
    "tecnomecanica_vencimiento": "2025-06-30T23:59:59.000Z",
    "tarjeta_propiedad_numero": "TP345678"
  }
}

---

Vehicle Types

Viax supports three vehicle types:

Moto

Standard motorcycles for single passenger

Auto

Cars for multiple passengers

Mototaxi

Motorcycle taxis with passenger cabin

Vehicle Type Enum

enum VehicleType {
  moto('moto', 'Moto'),
  auto('auto', 'Auto'),
  mototaxi('mototaxi', 'Mototaxi');
  
  final String value;
  final String label;
  
  const VehicleType(this.value, this.label);
}

---

License Plate Format

Colombian license plates follow specific formats:

• Standard Format: ABC123 (3 letters + 3 numbers)
• Motorcycles: May use 6 characters alphanumeric

Plate Normalization

The API normalizes license plates to uppercase without spaces:

String normalizePlate(String plate) {
  return plate.toUpperCase().replaceAll(RegExp(r'[^A-Z0-9]'), '');
}

// Example:
normalizePlate('abc-123')  // Returns: 'ABC123'
normalizePlate('abc 123')  // Returns: 'ABC123'

---

Required Documents

For vehicle registration in Colombia, drivers must provide:

1. SOAT

   Mandatory traffic accident insurance (Seguro Obligatorio de Accidentes de Tránsito)

2. Tecnomecánica

   Technical-mechanical inspection certificate

3. Tarjeta de Propiedad

   Vehicle ownership card

4. Vehicle Photos

   Photos of the vehicle (front, side, interior)

---

Document Expiration Validation

Important: SOAT and Tecnomecánica must be valid (not expired) for the driver to be approved and remain active.

Check Document Validity

bool isDocumentValid(DateTime? expirationDate) {
  if (expirationDate == null) return false;
  return DateTime.now().isBefore(expirationDate);
}

bool isSOATExpiringSoon(DateTime? expirationDate) {
  if (expirationDate == null) return true;
  final warningDate = DateTime.now().add(Duration(days: 30));
  return expirationDate.isBefore(warningDate);
}

---

Completeness Check

The vehicle model includes helper methods to check if all required information is complete:

class VehicleModel {
  // Check if basic vehicle info is complete
  bool get isBasicComplete {
    return placa.isNotEmpty &&
        marca != null && marca!.isNotEmpty &&
        modelo != null && modelo!.isNotEmpty &&
        anio != null &&
        color != null && color!.isNotEmpty;
  }
  
  // Check if all documents are complete
  bool get isDocumentsComplete {
    return soatNumero != null && soatNumero!.isNotEmpty &&
        soatVencimiento != null &&
        tecnomecanicaNumero != null && tecnomecanicaNumero!.isNotEmpty &&
        tecnomecanicaVencimiento != null &&
        tarjetaPropiedadNumero != null && tarjetaPropiedadNumero!.isNotEmpty;
  }
  
  // Check if all required photos are uploaded
  bool get isPhotosComplete {
    return fotoVehiculo != null && fotoVehiculo!.isNotEmpty &&
        fotoTarjetaPropiedad != null && fotoTarjetaPropiedad!.isNotEmpty &&
        fotoSoat != null && fotoSoat!.isNotEmpty &&
        fotoTecnomecanica != null && fotoTecnomecanica!.isNotEmpty;
  }
}

Error Responses

400 · Bad Request

Invalid vehicle data or expired documents

404 · Not Found

Driver not found

500 · Internal Server Error

Server error during update

See Also

• Driver Profile - Manage driver profile
• Driver Documents - Upload driver documents