Once you created a job using the create a job endpoint, the Stuart dispatcher will work to assign a driver to your job at the appropriate time based on whether it’s an instant or scheduled job. Read more about Order tracking to understand how you can track the status of your orders.
In the unlikely event that a driver cannot be found to fulfil your order, these updates will follow:
- job status moves to
expired- delivery status moves to
cancelledwith cancellation reasonjob_expired.
The time taken to receive the above status updates will depend whether you have an expiration interval set up on your Stuart client account. If there is an expiration interval set up on your Stuart client account, your order will expire once this amount of time has elapsed with no driver found.
What happens if there’s no expiration interval set up ?
The job will search for a driver until the zone expiration interval is reached. After this point our support will be able to relaunch the job at anytime to continue searching for a driver. These expirations and relaunches won’t cause any status or id changes in the job or it’s deliveries. The job will only expire at the end of Stuart’s operational hours for the zone your job was created in.
Should I set up an expiration interval?
Without an expiration interval set up, your jobs will expire at the end of the day to allow for our support to relaunch the job after the initial zone expiration. This is useful for clients who do not need to operate within tight delivery windows, for example same day delivery. You may wish to set an expiration interval for your account if:
- You need to meet specific delivery windows
- The package contents need to remain hot or cold
How to set up my expiration interval?
The expiration interval is customisable (between 180 and 3600 seconds). Contact the Stuart Support Team at support@stuart.com to modify this value in order to better fit your delivery promise.