# Set up repair order approval rules

Decide which repair orders are approved automatically and which ones wait for a manager.

Audience: dealer-managers
Availability: available
Canonical source: https://rooftoprv.com/docs/set-up-repair-order-approval-rules

Approval rules decide what happens when someone submits a repair order. A rule can approve it on the spot or send it to a manager. With no rules, every repair order waits for a manager.

## Before you start

- You need the **Approve repair orders** permission.
- **Service** shows in the menu only if you also have **Create repair orders** or **View all repair orders**.
- Rules apply to repair orders only. Inspections always go to a reviewer.

## See how rules are checked

ROOFTOP checks your rules from top to bottom each time a repair order is submitted or resubmitted. That includes when someone drags it to **Pending approval or review** on the board. The first rule that matches decides the result. If no rule matches, the repair order needs manual approval.

Order matters. Put the narrow rules first and the broad ones last.

## Add a rule

> **Warning:** A repair order with no costs has a total of $0, so any **Dollar threshold** rule with **Auto-approve** approves it. Ask your team to add costs before they submit.

Nothing is saved until you select **Save changes**. The button stays off until you change something. The page doesn't warn you if you leave with unsaved changes.

1. Go to **Service** > **Approval rules**.
   You can also select **Configure rules** on the **Approvals** tab.
2. Select **Add rule**.
   A new rule appears at the bottom. It starts as a **Dollar threshold** of 500 with the action **Auto-approve**.
3. Enter a **Name**, such as "Auto-approve under $500".
   Every rule needs a name. The name shows to the person who submits a repair order the rule approves.
4. Choose a **Condition**. **Work type** has limits. See the note under the table.

   | Condition | When it matches |
   |---|---|
   | **Dollar threshold** | The repair order's total is at or below **Max amount ($)** |
   | **Work type** | The repair order's type is the one you choose |
   | **Always** | Every repair order |

   Every repair order created in ROOFTOP has the type Internal, and there's no way to change it. A **Work type** rule set to **Sublet** or **Warranty** never matches. One set to **Internal** matches every repair order, like **Always**. If you choose **Work type**, select one of the **Work types** choices yourself, even if **Internal** already looks selected. If you don't, the save fails.

5. Choose an **Action**: **Auto-approve** or **Require approval**.
6. Select **Save changes**.
   You see "Approval rules saved".

## Change the order

1. On a rule, select the up or down arrow to move it.
   The rule numbers update.
2. Select **Save changes**.

## Remove a rule

To bring back a rule you removed by mistake, reload the page before you save.

1. On the rule, select the trash icon.
   The rule leaves the list right away, but it isn't removed for good until you save.
2. Select **Save changes**.

## Start from an example

**Approve small jobs, review the rest**
Add one rule: **Dollar threshold**, **Max amount ($)** 500, **Auto-approve**. Repair orders at or below $500 are approved when submitted. Anything larger matches no rule and waits for a manager.

**Approve everything**
Add one rule: **Always**, **Auto-approve**.

**Review everything**
Remove every rule, or add one rule: **Always**, **Require approval**.

## What happens next

- When a rule approves a repair order, the person who submitted it sees "Auto-approved by rule:" and the rule's name. The repair order moves to **Approved / ready**. Its timeline shows **Auto-approved** with the rule's name. No approval request goes to managers.
- When a repair order needs approval, it moves to **Pending approval or review** and shows under **Service** > **Approvals**.
- A rule change affects repair orders submitted after you save. Repair orders already waiting stay in the queue.
- Rules run only when a repair order is submitted. If a manager edits an approved repair order and the total goes up, it stays approved.

## Troubleshooting

**Save changes shows an error on a Work type rule**
No work type is selected yet. Select **Internal**, **Sublet**, or **Warranty** under **Work types**, then save again.

**A rule I expected to approve a repair order didn't**
A rule above it matched first. Move the rule up, or check the total against **Max amount ($)**. The total must be at or below the amount.

**Everything is approved automatically**
An **Always** rule with **Auto-approve** is near the top, or a **Dollar threshold** is set too high.

**The page says "Every rule needs a name"**
One of your rules has an empty **Name**. Enter one and save again.

**The page says a rule "needs a dollar threshold"**
That rule's **Max amount ($)** is empty. Enter an amount of 0 or more, and save again.

## Related guides

- [Approve or reject service work](https://rooftoprv.com/docs/approve-or-reject-service-work)
- [Create a repair order](https://rooftoprv.com/docs/create-a-repair-order)
