roos-fs tasks #365
Updated by Vadim Pariev 8 months ago
**General** Enable users in ROOS to click a button and instantly see the remaining kilometers until next oil change for a selected vehicle, based on its VIN number. We need to integrate the Geotab MyGeotab API into ROOS to fetch the current odometer value of a vehicle (using VIN → Device lookup) and calculate the kilometers remaining until the next oil change. NOT YET CLEAR <u>The oil change interval (every 15,000 km) this value is hardcoded on the device. Once the calculation is done, the value should be displayed in the vehicle details view.</u> **Flow** - User selects a vehicle (with VIN stated inside). - User clicks “Check Oil Change” button. **System performs:** - Authenticate with Geotab (if session expired). - Get Device by VIN. - Get Odometer Diagnostic Id (or cached globally). - Get latest StatusData for Odometer. **Business logic:** - Retrieve last service odometer from Geotab MaintenanceReminder if available. - Calculate next_service_due = last_service_km + interval_km. (if not provided inside the evice already) - Calculate km_remaining = next_service_due – current_odometer. (if not provided inside the evice already) Display result to user in the vichicle overview window. API DOCUMENTATION https://developers.geotab.com Authentication TBD