Overview
Drivly’s Scheduled Maintenance API simplifies the complex process of managing vehicle maintenance services, offering a straightforward solution for obtaining quotes and placing orders.Workflows
The Scheduled Maintenance API facilitates two primary functions,Quote Maintenance and Order Maintenance for all scheduled maintenance types.
Quote Maintenance
Obtain accurate quotes for scheduled maintenance services and repairs.Create Quote
Create Quote
To obtain a quote for scheduled maintenance services, you will need to provide the following information:Scheduled maintenance is different to most of our service offerings, as the price can change depending on other issues found during the regular maintenance.. This is why we provide an invoice instead of our typical quote:Upon payment, a service order will be generated with all pertinent details and an estimated completion time. Progress of the service order can be monitored using webhooks, ensuring timely updates throughout the scheduled maintenance process.
Create Quote
Example Response
Order Maintenance
Place orders for scheduled maintenance services, ensuring vehicles are quickly brought up to your standards.Place Order
Place Order
Creating a service order for scheduled maintenance allows you to schedule maintenance services in advance, ensuring your vehicle is always in top condition.You’ll be notified of the service order’s status via webhooks, ensuring you’re always up-to-date on the progress of your vehicle’s scheduled maintenance.
Create Order
Example Response
Typical Progression
Lets go over the typical progression of a maintenance service order. While these steps are typical, there may be issues, delays, or other factors that can affect the progression of your service order. If any problems arise, the service order’s status will be updated to eitherdelayed or canceled, and you will be notified of the issue via email and webhook.
1
After work has started
We’ll switch the status to
in-progress as an indication that work has started. During this time,
our team may find further issues that they can fix. You can configure the service to
pre-authorize a certain amount for these additional services. However, due to the nature of the work,
you must authorize ahead of time.2
An issue is found
While working on the vehicle, its possible that our team may find issues such as a worn-out belt or a leaky hose.Depending on your configuration, we may automatically authorize a certain amount to fix these issues. If the amount is
above the pre-authorized amount, we will notify you that the issue is present, but wont act on it until you request a maintenance order.
3
Work is completed
Once the service is completed, the service order will be updated to reflect the status of the service.After work is completed, the service order will be updated to include the status of the service, moving from
in-progress to completed.Webhooks
service.created - This event is triggered when a service order is created, providing you with the details of the order:
service.updated - This event is triggered when a service order is updated, providing you with the updated details of the order:
service.completed - This event is triggered when a service order is completed, providing you with the final details of the order: