Work Order Status Guide

Complete reference for all work order statuses

Quick Navigation

Understanding the Two-Stage Process

Important: BBU Cleaning uses a two-stage workflow. Work orders start in the Work Order Management stage (handled by field managers and cleaners), then get handed off to the Invoice Management stage (handled by office/accounting staff).

Stage 1: Work Order Management

Who: Field Managers & Cleaners

Purpose: Schedule, perform, and complete the cleaning work

1. DRAFT
2. NEEDS_ASSIGNMENT
3. SCHEDULED
4. IN_PROGRESS
5. COMPLETED_PENDING_REVIEW

Handoff Point: When manager approves work, it moves to Invoice Management

Stage 2: Invoice Management

Who: Office Staff & Accounting

Purpose: Review, approve, and invoice the completed work

6. PARTIALLY_APPROVED
7. REJECTED_NEEDS_RESUBMIT (→ back to Stage 1)
8. APPROVED_READY_TO_SYNC
9. SYNCED_TO_QBO ✅
10. SYNC_ERROR

Goal: Create invoice in QuickBooks and close the work order

Key Insight: Once a work order reaches APPROVED_READY_TO_SYNC, different people handle it (office staff, accounting) rather than field managers. This handoff ensures field teams focus on cleaning, while office teams handle invoicing.

The 11 Work Order Statuses

1. DRAFT

🟦 Blue

What it means: Work order is being created but not yet ready for assignment.

Who uses it: Admin, Manager

When to use:

  • Initial creation of a work order
  • Need to gather more information
  • Work order is incomplete
  • Preparing work orders in advance
Next steps: → NEEDS_ASSIGNMENT, SCHEDULED, or CANCELLED

2. NEEDS_ASSIGNMENT

⚠️ Yellow

What it means: Work order is ready but needs a cleaner to be assigned.

Who uses it: Admin, Manager

When to use:

  • Work order details are complete
  • Services and pricing are finalized
  • No cleaner has been assigned yet
  • Cleaner was unassigned from scheduled work
Next steps: → SCHEDULED or CANCELLED

3. SCHEDULED

📅 Purple

What it means: Work order is assigned to a cleaner and scheduled for a specific date/time.

Who uses it: Admin, Manager (set status); Cleaner (can start work)

Key features:

  • Cleaner can see it in their Work Orders tab
  • Shows "Best Route" button for cleaners
  • System tracks if overdue (past scheduled time)
  • Cleaners can "Clock In" to start work
Next steps: → IN_PROGRESS (Cleaner), DRAFT, NEEDS_ASSIGNMENT, or CANCELLED (Admin/Manager)

4. IN_PROGRESS

🔵 Blue

What it means: Cleaner is actively working on this work order right now.

Who uses it: Cleaner (assigned to work order)

While in progress:

  • Time tracking is active (if enabled)
  • GPS location captured
  • Cleaner can add notes
  • Manager can see real-time status
Next steps: → COMPLETED_PENDING_REVIEW (Cleaner) or CANCELLED (Admin/Manager)

5. COMPLETED_PENDING_REVIEW

🟡 Orange

What it means: Cleaner finished the work, now waiting for manager review/approval.

Who uses it: Cleaner (sets status); Manager (reviews)

Manager reviews:

  • Check work quality
  • View photos (if uploaded)
  • See time spent on job
  • Approve or reject work

⚠️ Appears in "Needs Review" filter

Next steps: → PARTIALLY_APPROVED, APPROVED_READY_TO_SYNC, REJECTED_NEEDS_RESUBMIT, or SCHEDULED (Manager)

6. PARTIALLY_APPROVED

🟢 Teal

What it means: Some line items/services are approved, but others need adjustment.

Who uses it: Admin, Manager

Use cases:

  • Work is mostly good but has issues
  • Some services completed well, others not
  • Approve part now, address rest later
  • Adjust pricing for some items
Next steps: → APPROVED_READY_TO_SYNC or REJECTED_NEEDS_RESUBMIT (Manager)

7. REJECTED_NEEDS_RESUBMIT

🔴 Red

What it means: Work was not acceptable and needs to be redone by cleaner.

Who uses it: Manager (rejects); Cleaner (fixes and resubmits)

What to include:

  • Detailed rejection notes
  • Photos showing issues (if available)
  • Specific problems to fix
  • How to correct the issues

🔔 Cleaner receives notification

Next steps: → COMPLETED_PENDING_REVIEW (Cleaner resubmits), APPROVED_READY_TO_SYNC (Manager overrides), or CANCELLED

8. APPROVED_READY_TO_SYNC

🟢 Green

What it means: Work is approved and ready to be invoiced in QuickBooks Online.

Who uses it: Admin, Manager (approve); Admin (sync)

This is the "invoice-ready" status:

  • All work reviewed and approved
  • Pricing finalized
  • Ready to generate invoice
  • Will sync to QuickBooks automatically or manually
Next steps: → SYNCED_TO_QBO (success) or SYNC_ERROR (failure)

9. SYNCED_TO_QBO

💚 Cyan

What it means: Invoice successfully created in QuickBooks Online. TERMINAL STATUS (work order complete).

Who uses it: Admin (automatic or manual)

Work order complete:

  • QuickBooks invoice created successfully
  • Invoice number assigned
  • Customer billed
  • Work order is now READ-ONLY

🎉 Success! This is the end of the work order lifecycle.

Next steps: None - Terminal status (cannot change)

10. SYNC_ERROR

⚠️ Red

What it means: Attempted to sync to QuickBooks but failed. Needs admin attention.

Who uses it: System (automatic on failure); Admin (fixes)

Common errors:

  • QuickBooks authentication expired → Reconnect
  • Customer not found in QuickBooks → Map customer
  • Duplicate invoice number → System auto-generates new
  • Connection failed → Check internet/QuickBooks status
Next steps: → APPROVED_READY_TO_SYNC (retry after fix) or SYNCED_TO_QBO (manual resolution)

11. CANCELLED

⚫ Gray

What it means: Work order was cancelled and will not be completed. TERMINAL STATUS.

Who uses it: Admin, Manager

When to cancel:

  • Customer cancelled the service
  • Work order created by mistake
  • Duplicate work order
  • Service no longer needed

🔒 Cannot reactivate cancelled work orders

Next steps: None - Terminal status (create new work order if needed)

Status Lifecycle - Visual Workflow

Standard Work Order Flow (Happy Path)

1. DRAFT
Admin creates work order, adds services
2. NEEDS_ASSIGNMENT
Admin marks ready for scheduling
3. SCHEDULED
Admin assigns cleaner, sets date/time
4. IN_PROGRESS
Cleaner arrives, starts work
5. COMPLETED_PENDING_REVIEW
Cleaner finishes, submits for review
6. APPROVED_READY_TO_SYNC
Manager reviews, approves work
7. SYNCED_TO_QBO ✅
System creates invoice - DONE!

Alternative Paths

  • • DRAFT → SCHEDULED (skip NEEDS_ASSIGNMENT)
  • • COMPLETED → PARTIALLY_APPROVED → APPROVED
  • • COMPLETED → REJECTED → (fix) → COMPLETED
  • • APPROVED → SYNC_ERROR → (retry) → SYNCED

Emergency Exits

  • • Any status → CANCELLED (Admin/Manager)
  • • SCHEDULED → DRAFT (undo scheduling)
  • • COMPLETED → SCHEDULED (work not done)

What Can You Do? (By Role)

Admin

Full Control

✅ Can Do Everything:

  • • Any status → Any status
  • • Override any restriction
  • • QuickBooks sync operations
  • • Create/edit/delete work orders
  • • Manage all users

Use this power wisely!

Manager

Workflow Control

✅ Can Do:

  • • Create work orders (DRAFT)
  • • Assign cleaners (SCHEDULED)
  • • Approve/reject work
  • • Reschedule work orders
  • • Cancel work orders

❌ Cannot Do:

  • • Start/complete work (cleaner only)
  • • QuickBooks sync (admin only)

Cleaner

Field Work

✅ Can Do (if assigned):

  • • Start work (→ IN_PROGRESS)
  • • Complete work (→ COMPLETED)
  • • Resubmit after rejection
  • • Add notes
  • • Use time clock

❌ Cannot Do:

  • • Create/edit work orders
  • • Assign/unassign cleaners
  • • Approve/reject work
  • • Cancel work orders

Common Workflows (Step-by-Step)

✅ Standard Work Order (Happy Path)

  1. 1. DRAFT - Admin creates work order, adds services, sets customer
  2. 2. NEEDS_ASSIGNMENT - Admin marks ready for scheduling
  3. 3. SCHEDULED - Admin assigns cleaner, sets date/time
  4. 4. IN_PROGRESS - Cleaner arrives, clicks "Start Work"
  5. 5. COMPLETED_PENDING_REVIEW - Cleaner finishes, clicks "Complete Work"
  6. 6. APPROVED_READY_TO_SYNC - Manager reviews, clicks "Approve"
  7. 7. SYNCED_TO_QBO - System creates invoice automatically ✅

⚡ Quick Schedule (Skip Steps)

  1. 1. DRAFT - Admin creates work order
  2. 2. SCHEDULED - Admin assigns cleaner directly (skip NEEDS_ASSIGNMENT)
  3. 3-7. [Same as Standard Workflow]

💡 Faster when you know which cleaner to assign

🔄 Work Rejected and Fixed

  1. 1-4. [Same as Standard Workflow]
  2. 5. COMPLETED_PENDING_REVIEW - Cleaner submits work
  3. 6. REJECTED_NEEDS_RESUBMIT - Manager finds issues, adds notes
  4. 7. COMPLETED_PENDING_REVIEW - Cleaner fixes issues, resubmits
  5. 8. APPROVED_READY_TO_SYNC - Manager approves
  6. 9. SYNCED_TO_QBO - Invoice created ✅

⚠️ Always include specific rejection notes!

⚠️ QuickBooks Sync Error

  1. 1-5. [Same as Standard Workflow]
  2. 6. APPROVED_READY_TO_SYNC - Manager approves
  3. 7. SYNC_ERROR - QuickBooks sync fails (automatic)
  4. 8. (Fix issue) - Admin reconnects QuickBooks / maps customer
  5. 9. APPROVED_READY_TO_SYNC - Admin changes status to retry
  6. 10. SYNCED_TO_QBO - Retry succeeds ✅

💡 Check error message for specific fix needed

Troubleshooting Common Issues

❌ "Cannot transition from X to Y"

Problem: Trying to change status in a way that's not allowed.

Solution:

  • Check the Status Lifecycle Diagram for valid transitions
  • Verify your role has permission for that transition
  • If you're a cleaner, ensure you're assigned to the work order
  • Ask admin to perform the transition (admins can override)

⚠️ Work order stuck in COMPLETED_PENDING_REVIEW

Problem: Cleaner finished work but manager hasn't reviewed yet.

Solution:

  • For Manager: Review the work order and approve/reject
  • For Cleaner: Wait for manager review (you cannot change it)
  • Check "Needs Review" filter to find pending work orders

🔍 Work order not showing up in my list

Problem: Can't find a work order you expect to see.

Check:

  • Status filters: Click "All" to see all work orders
  • Role access: Cleaners only see assigned work orders in certain statuses
  • Search: Use search box to find by work order number or customer

⏮️ Need to "undo" a status change

Problem: Made a mistake, want to go back to previous status.

Allowed backward transitions:

  • SCHEDULED → DRAFT (admin/manager)
  • COMPLETED_PENDING_REVIEW → SCHEDULED (admin/manager)
  • SYNC_ERROR → APPROVED_READY_TO_SYNC (admin)

Note: SYNCED_TO_QBO and CANCELLED are terminal (cannot undo)

Status Transition Quick Reference

Current Status Next Status Options Who Can Do It Assignment Required?
DRAFT NEEDS_ASSIGNMENT, SCHEDULED, CANCELLED Admin, Manager No
NEEDS_ASSIGNMENT SCHEDULED, CANCELLED Admin, Manager No
SCHEDULED IN_PROGRESS, CANCELLED, NEEDS_ASSIGNMENT, DRAFT Cleaner (IN_PROGRESS); Admin/Manager (others) Yes (for IN_PROGRESS)
IN_PROGRESS COMPLETED_PENDING_REVIEW, CANCELLED Cleaner (COMPLETED); Admin/Manager (CANCELLED) Yes
COMPLETED_PENDING_REVIEW SCHEDULED, PARTIALLY_APPROVED, APPROVED_READY_TO_SYNC, REJECTED_NEEDS_RESUBMIT Admin, Manager No
PARTIALLY_APPROVED APPROVED_READY_TO_SYNC, REJECTED_NEEDS_RESUBMIT Admin, Manager No
REJECTED_NEEDS_RESUBMIT COMPLETED_PENDING_REVIEW, APPROVED_READY_TO_SYNC, CANCELLED Cleaner (COMPLETED); Admin/Manager (others) Yes (for COMPLETED)
APPROVED_READY_TO_SYNC SYNCED_TO_QBO, SYNC_ERROR Admin No
SYNCED_TO_QBO (none - terminal) - -
SYNC_ERROR APPROVED_READY_TO_SYNC, SYNCED_TO_QBO Admin No
CANCELLED (none - terminal) - -
Back to Top