🛠️ mobile
Repair Jobs
Repair Jobs is where a mobile/cell-phone shop logs each device brought in for repair — customer, device details, the reported issue, estimated cost and advance paid — and tracks it through a five-step status pipeline: RECEIVED → DIAGNOSED → REPAIRING → READY → DELIVERED.
📍 Menu path: Mobile → Repair Jobs
👤 Who uses it: All roles with the Billing feature enabled
Overview
Every repair gets an auto-generated job number in the form REP-YYYYMMDD-NNN, where the date is today's date and NNN is a same-day sequence count for your store.
The filter chips at the top (ALL / RECEIVED / DIAGNOSED / REPAIRING / READY / DELIVERED) filter the job list; clicking a job opens a detail panel on the right with its full information and a delete action.
A "→ (next status)" quick-advance button appears directly on each job in the list as long as it has not reached DELIVERED, so you can move a job to its next status without opening the detail panel.
Before You Start
- You must have the Billing feature enabled on your plan.
Step-by-Step Guide
1 Create a new repair job
- Open Mobile → Repair Jobs and click "+ New Repair".
- Fill in Customer Name (required), plus Customer Phone, Device Brand, Device Model, IMEI and Issue / Problem as known.
- Enter Est. Cost and Advance (₹) if known, then click "Create Repair" — a job number is generated automatically and the job starts in RECEIVED status.
2 Advance a job through its lifecycle
- On the job list, click the "→ DIAGNOSED" button on a RECEIVED job once you have identified the fault.
- Continue clicking the next-status button as work proceeds: → REPAIRING, → READY, then → DELIVERED once the customer has collected the device.
- There is no quick-advance button once a job is DELIVERED — that is treated as a final state from this list view.
3 Filter and review jobs
- Use the status chips (ALL, RECEIVED, DIAGNOSED, REPAIRING, READY, DELIVERED) to narrow the list to one status at a time.
- Click any job to open its detail panel on the right, showing customer, phone, device, IMEI, issue, diagnosis, parts used, estimated cost, final cost and advance paid.
4 Delete a repair job
- Select a job to open its detail panel, then click "Delete Repair" and confirm.
- Deletion is immediate and permanent — there is no restore.
Every Field & Button, Explained
| Field / Button | What it does |
|---|---|
Job Number | Auto-generated as REP-YYYYMMDD-NNN — the date reflects when the job was created; NNN counts jobs created that same day for the store. |
Customer Name | Required. Who the repair is for. |
Customer Phone | Optional contact number for the customer. |
Device Brand / Model / IMEI | Optional details identifying the device brought in. |
Issue | Required. Free-text description of the reported problem, entered at creation. |
Diagnosis / Parts Used | Shown in the detail panel when present — there is no form field for these on the New Repair modal; they are set via the underlying update API only. |
Estimated Cost (₹) | What you expect to charge, entered at job creation. |
Final Cost (₹) | Shown in the detail panel only when set — there is no UI field to enter it from this screen. |
Advance Paid (₹) | Amount the customer has already paid upfront, entered at job creation. |
Status | RECEIVED → DIAGNOSED → REPAIRING → READY → DELIVERED, advanced one step at a time via the → button. Setting status to DELIVERED automatically stamps a Delivered At timestamp if one is not already set. |
Tips & Best Practices
- Record Advance Paid at job creation time — the New Repair form is the only place in this screen to capture it; there is no edit form for an existing job besides the status-advance buttons.
- Fill in Device Brand/Model/IMEI even when the repair is minor — it is the fastest way to tell two jobs for the same customer apart in the list.
Troubleshooting & FAQ
The detail panel shows no Diagnosis or Parts Used even though the technician noted them.
The New Repair and list-view quick-advance actions only ever send a status change — there is no form field on this screen for Diagnosis or Parts Used. Those fields only appear if they were set directly via the update API; from this screen alone they will stay empty.
Final Cost is always blank.
This screen never sends a finalCost value — it only lets you set Estimated Cost at creation and advance Status afterwards. Final Cost will remain blank unless set via the API.
I need to change the customer name, phone or device details after creating a job.
There is currently no edit form for these fields on an existing job — only the status can be advanced from the list view. Delete and recreate the job if these details were entered incorrectly.
Can I move a job backward, e.g. from READY back to REPAIRING?
Not from this screen — the quick-advance button only moves a job forward one step at a time through RECEIVED → DIAGNOSED → REPAIRING → READY → DELIVERED, with no button to move it backward.