Drivly’s Mechanical Repair API simplifies the complex process of managing mechanical repairs,
offering a straightforward solution for obtaining quotes and placing orders.
Obtain accurate quotes for mechanical repair services, including engine, transmission, and brake repairs.
To obtain a quote for Mechanical Repair services, you will need to provide the following information:
Create Quote
{"type":"mechanical-repair","vin":"WP0AF2A99KS165242","items":[// An Array of fault items, you can find// these in the vehicle's inspection report"fault_EbaCojKxsJL"]}
Example Response
{"id":"quote_sf7Y7c","status":"awaiting-payment","estimatedTime":"2024-01-01T12:00:00Z","checkoutLink":"https://checkout.driv.ly/quote_sf7Y7c","paid":false,"total":350,"items":[{"service":"mechanical-repair","price":350,"name":"Brake Repair for WP0AF2A99KS165242","description":"fault_EbaCojKxsJL","quantity":1}]}
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 mechanical repair process.
Place orders for mechanical repair services, ensuring vehicles are quickly brought up to your standards.
Creating a service order for mechanical repair services allows you to schedule, and pay for the service directly. This will create a service order which can be used to track progress and monitor costs.
For service orders, attaching a deal is highly recommended as this will allow you to keep all
pending invoices in one place. The final invoice for the deal will include this order, but is
rolled up into the total cost of the deal.
Create Order
{"type":"mechanical-repair","items":[// An Array of fault items, you can find// these in the vehicle's inspection report"fault_EbaCojKxsJL"],"vin":"WP0AF2A99KS165242","deal":"deal_8f7Y7c"// Optional, but recommended}
Example Response
{"id":"order_PUjabSbTExm1Ac","deal":"deal_8f7Y7c","status":"pending","estimatedTime":"2024-01-01T12:00:00Z","receiptLink":"https://checkout.driv.ly/order_PUjabSbTExm1Ac","paid":true,// Will always be true for a service order"total":350,"items":[{"service":"mechanical-repair","price":350,"name":"Brake Repair for WP0AF2A99KS165242","description":"fault_EbaCojKxsJL","quantity":1}]}
You’ll also be notified via webhooks of the service order’s status, ensuring you’re always up-to-date on the progress of your vehicle’s mechanical-repair.
Lets go over the typical progression of a mechanical repair 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 either delayed or canceled, and you
will be notified of the issue via email and webhook.
1
After payment is successful
A service order is created with the details of your quote, including the estimated time and cost.
The service order will start in the pending status, this means that its just waiting for the team to pick up the vehicle, and start work.
2
After some time has passed
The service provider will begin working on your vehicle, ensuring it receives the care it needs.
The service order will be updated to include the status of the service, moving from pending to in-progress.
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.
service.created - This event is triggered when a service order is created, providing you with the details of the order:
{"event":"service.created","type":"mechanical-repair","data":{"id":"order_PUjabSbTExm1Ac","deal":"deal_8f7Y7c","status":"pending",// pending, in-progress, completed, delayed, canceled"estimatedTime":"2024-01-01T12:00:00Z","receiptLink":"https://checkout.driv.ly/order_PUjabSbTExm1Ac","paid":true,"total":350,"items":[{"service":"mechanical-repair","price":350,"name":"Brake Repair for WP0AF2A99KS165242","description":"fault_EbaCojKxsJL","quantity":1}],"history":[// An Array to show the keys changed and when{"status":"pending","paid":true,"time":"2024-01-01T12:00:00Z"}]}}
service.updated - This event is triggered when a service order is updated, providing you with the updated details of the order:
{"event":"service.updated","type":"mechanical-repair","data":{"id":"order_PUjabSbTExm1Ac","deal":"deal_8f7Y7c","status":"in-progress","estimatedTime":"2024-01-01T12:00:00Z","receiptLink":"https://checkout.driv.ly/order_PUjabSbTExm1Ac","paid":true,"total":350,"items":[{"service":"mechanical-repair","price":350,"name":"Brake Repair for WP0AF2A99KS165242","description":"fault_EbaCojKxsJL","quantity":1}],"history":[{"status":"pending","paid":true,"time":"2024-01-01T12:00:00Z"},{"status":"in-progress","time":"2024-01-02T12:00:00Z"}]}}
service.completed - This event is triggered when a service order is completed, providing you with the final details of the order:
{"event":"service.completed","type":"mechanical-repair","data":{"id":"order_PUjabSbTExm1Ac","deal":"deal_8f7Y7c","status":"completed","estimatedTime":"2024-01-01T12:00:00Z","receiptLink":"https://checkout.driv.ly/order_PUjabSbTExm1Ac","paid":true,"total":350,"items":[{"service":"mechanical-repair","price":350,"name":"Brake Repair for WP0AF2A99KS165242","description":"fault_EbaCojKxsJL","quantity":1}],"history":[{"status":"pending","paid":true,"time":"2024-01-01T12:00:00Z"},{"status":"in-progress","time":"2024-01-02T12:00:00Z"},{"status":"completed","time":"2024-01-03T12:00:00Z"}]}}
