Dates & Statuses in BodyShop Booster

Each Repair Status in BodyShop Booster is associated with a pair of dates - one Actual date and one Scheduled Date. These statuses and Actual dates are strongly coupled - it is not possible to change a status without also updating its associated Actual date, and it is not possible to update the Actual date associated with a status without also potentially changing the status.

Changing the status of a repair record is as simple as sending the date associated with that status as part of the POST to the /repair endpoint. Provided there are no ‘later’ statuses that already have associated dates that will become the current status.

Not all dates used in BodyShop Booster are associated with statuses, however all dates used in the Repair Events object in BodyShop Booster are all strongly coupled to Statuses.

When an Actual date associated with a status is updated in Booster, either by the CRM user, or by an external integration / Open API message received, the status is recalculated. This is a simple process - the system will simply take the ‘latest’ status of all statuses that have actual dates associated with them - provided the associated date is either today or in the past. Future dates are not counted for this process. Beyond that, the specific date values associated are not relevant for this process - it is entirely possible to have dates ‘out of order’ compared to the order of the statuses. If a status has any associated actual date not in the future, then it is included in consideration for which status is the ‘latest’.

‘Latest’ is determined by the order set by the Admin - the lower it is on the list, the later it takes place:

Open Screenshot 2025-03-07 at 19.25.26.png

Actual and Scheduled Dates

A scheduled date does not affect the status of the repair - it is simply shown (when an actual date does not exist for that status) as a target for the user to see. If it is in the past, it is shown in red.

It is possible to add a date in the future to an actual date associated with a status. In these cases, the status will be recalculated at 00:00 on that day.

For example, in the following screenshot:

Open Screenshot 2025-03-07 at 19.28.40.png

For this record, the estimate was written and sent on the 4th, and approved on the 5th (this is the current status). The booking is Scheduled to get made by the 6th, but as today is the 7th and hasn’t yet been replaced by an Actual date, that’s showing in red. The status of Arrived has an Actual date in the future (the 10th) which means that if nothing else changes on this record, on the 10th, the status will be updated to Arrived.

The following are the default statuses in BodyShop Booster, along with the associated Scheduled and Actual and Date Fields. The table also shows API fields where they exist for those date fields: