Repair Status Workflow

The 8 Repair Statuses

Every repair is always in exactly one status.

• Received, intake; newly created
• Diagnosing, technician investigating the fault
• Waiting Parts, paused waiting for parts to arrive (branch status)
• Repairing, actively repairing
• Testing, QA/testing the repair
• Ready, complete, awaiting customer pickup
• Delivered, handed back to customer
• Cancelled, repair cancelled

Main Advancement Path

Status advancement is sequential. Clicking 'Advance Status' moves to the next step.

1. 1Received → Diagnosing
2. 2Diagnosing → Repairing
3. 3Repairing → Testing
4. 4Testing → Ready (Admin/Manager only)
5. 5Ready → Delivered (Admin/Manager/Cashier, records final payment)

Waiting for Parts (Detour)

If you need to order a part mid-repair, switch the job to Waiting Parts.

• Can only be entered from Diagnosing, Repairing, or Testing.
• Fixmo saves the previous status.
• When the part arrives, click 'Resume' and the repair returns to where it was before.
• Cashiers cannot change Waiting-Parts status.
• You cannot advance status while the repair is Waiting Parts, resume first.

Role-Based Advancement

Who can move the repair forward depends on role.

• Admin & Manager, can advance any status
• Technician, can advance up to Testing (cannot take a job past Testing)
• Cashier, can only advance Ready → Delivered (during customer handover with payment)

What Happens When You Deliver

Marking the repair Delivered triggers several automatic actions.

• All serial units linked to the repair move from USED_IN_REPAIR to COMPLETED_REPAIR.
• Customer receives the 'Delivered' notification (in-app, WhatsApp if enabled, email if enabled).
• If 'Auto-invoice on repair delivered' is on (Pro/Business), Fixmo auto-creates and sends an invoice.
• The Delivered timestamp is stored (used for analytics and dedup of customer notifications).

Cancelling a Repair

You can cancel a repair by clicking 'Cancel Repair'. Cancelled repairs stop appearing in active lists but remain in history for reporting. Only Admins can delete a cancelled repair permanently.

Reverting Repair Status (Admin Only)

Admins can step the repair back to an earlier stage.

1. 1Open the repair detail page.
2. 2Click 'Revert Status' in the header.
3. 3Pick any earlier status (must be strictly earlier).
4. 4Optionally add a reason for the audit log.
5. 5If parts were consumed, pick each one and choose 'Return to Stock' or 'Keep on Repair'. Serial-tracked parts return to IN_STOCK and branch stock is incremented.
6. 6Confirm. The reversal is logged in the status history with a reversal flag and a snapshot of part decisions.

Status Change Notifications

Each status change triggers notifications to the customer (subject to per-status toggles in Settings > Notifications and the Email/WhatsApp settings).

• In-app notifications always fire for the shop team.
• WhatsApp notifications fire if connected and the per-status toggle is on and the customer has 'Has WhatsApp' checked.
• Email notifications fire if email is connected, the per-status toggle is on, and the customer has an email.
• Ready and Delivered are deduplicated, a revert-then-re-advance won't resend the same customer alert.