Migrate from Azuga Fleet to Nutshell

Azuga vehicles have no direct Nutshell equivalent. We create a custom field group (Fleet_Vehicle__c) on Nutshell's Person object. Vehicle ID, make/model, license plate, and current odometer migrate as custom fields. If the vehicle is a company asset, we link it to the owning Nutshell Company via a custom lookup field.

Driver records map directly to Nutshell Person records. Name, email, phone, and driver license number migrate as standard Person fields. Driver ID from Azuga is stored as Source_Driver_ID__c for traceability. The driver's Azuga Safety Score migrates as a custom Number field on the Person record.

Azuga assigns drivers to vehicles via the /driverVehicleMap endpoint. We resolve the driver to a Nutshell Person and the vehicle's owning organization to a Nutshell Company, then create a Person-Company relationship with a role of 'Fleet Driver' in Nutshell. Historical assignments are preserved as activity notes.

Trip records (start/end location, distance, duration, fuel consumed) have no native Nutshell object. We export full trip history as a supplementary JSON file linked by driver Person ID. In Nutshell, we create a summary note on the Person record noting total trips and mileage for the past 12 months.

Speed alerts, geofence entry/exit events, and hard-braking notifications are exported as a reference file. In Nutshell, we create a single summary Task per driver listing alert count by type for the last 90 days. Nutshell has no real-time alert engine, so alert workflows must be rebuilt using Nutshell Tasks or external tooling.

Equipment tracker records (beacon ID, equipment type, last known location) have no Nutshell equivalent. We create custom fields on the owning Nutshell Company record: Equipment_Count__c, Last_Service_Date__c, and Equipment_Summary__c (text summary of all tracked assets). Full equipment detail is exported separately.

Scheduled maintenance alerts and odometer-based service reminders do not map to any Nutshell object. We create a Note on the associated Company or Person record summarizing open and completed maintenance items. The full maintenance log is exported as a supplementary CSV for reference.

Azuga's internal account/group structure that groups vehicles and drivers maps directly to Nutshell Companies. Company name, address, and contact person (if stored in Azuga) migrate as standard Nutshell Company fields. All vehicles and drivers linked to this group become custom fields on and relationships to this Company.

Azuga's Safety Score (0–100, derived from speeding, hard braking, idle time, seatbelt events) has no Nutshell native field. We create Driver_Safety_Score__c as a custom Number field on Nutshell Person. Score history (monthly snapshots) is preserved in a supplementary export file linked by driver email.

Fuel purchase records from Azuga's fuel card integration do not map to Nutshell objects. We export fuel transaction history as a separate CSV linked by vehicle ID. A summary (total gallons, total cost, average MPG for the past 12 months) is stored as a text custom field on the owning Company for reference.

Azuga admin and fleet manager accounts resolve by email match against Nutshell user accounts. If a Nutshell user exists for the email, records are assigned to that user. Unmatched Azuga owners are flagged and assigned to a fallback Nutshell admin user. Azuga role/permission sets do not migrate — Nutshell roles are assigned manually post-migration.

Azuga SafetyCam video clips and incident footage are stored in Azuga's cloud and have no Nutshell equivalent. We preserve clip URLs and incident timestamps as a reference export linked by driver Person ID. Nutshell does not store media files natively — footage must remain in Azuga or a separate video storage system.