The Job Lifecycle
In one sentence: Every job in ServCraft moves through a series of statuses from creation to closure — understanding this journey is the single most important thing you can know about ServCraft.
The Two Types of Job Journeys
There are two common paths a job can take in ServCraft:
Path A: Simple Field/Office Job Customer contacts the business → Job created → Technician assigned → Work done → Invoice sent → Payment received → Job closed
Path B: Workshop/Repair Job Customer brings in an item → Job created for assessment → Technician assesses and diagnoses → Quote sent if repair needed → Customer decides → Repair done (or job closed if declined) → Invoice sent → Payment received → Job closed
Most businesses use a variation of one of these two paths. The key difference is whether there is an assessment phase and whether a quote is required before work begins.
To set up statuses for a workshop, including capturing the machine as a customer asset at booking-in, see Job Settings.
Important: Job statuses in ServCraft are fully configurable per business. Each Job Type is linked to a workflow, and the workflow defines which statuses exist, what they are called, what order they connect in, and which fields are required at each one. The status names used below ("Draft", "Assessed", "Work in Progress", etc.) are typical examples — a specific customer's statuses may have completely different names.
The Full Job Lifecycle — Step by Step
Stage 1: Creation
What happens: A job is created in the system. This can happen in several ways:
- An office staff member creates it on the web app (most common)
- A technician creates it on the mobile app while in the field
- The system creates it automatically from a recurring job schedule
- Staff create it from a query, which is what a customer's web form submission produces
What the job record contains at this point:
- Customer and contact details
- Location (where the work will be done)
- Job type (the category of work)
- Description of the problem or work required
- (Sometimes) an assigned technician
- (Sometimes) an initial appointment time
Typical status: Draft (a new job always starts in the first status of its Job Type's workflow — whatever that is called for the business)
What staff should know: Jobs in a Draft-style status are not active — they haven't been confirmed or assigned yet. Some businesses skip the Draft stage and go straight to creating active jobs, depending on their workflow.
Stage 2: Assessment (Workshop businesses only)
What happens: For workshop businesses (where customers bring items in for repair), a technician physically examines the item, diagnoses the problem, and captures:
- The fault code (what type of fault it is)
- The fault reason (the specific diagnosis)
- The fault cause (what caused the problem — e.g., "user damage", "power surge", "wear and tear")
- An assessment fee (if the business charges for assessment)
- Warranty status — is this item still under manufacturer warranty?
Status: Assessed
Why this stage exists: Before committing to a repair, the business needs to understand what's wrong and what it will cost to fix. This protects both the business (they don't do unpaid work) and the customer (they get a clear understanding of cost before agreeing).
What staff should know:
- Not all businesses use this stage. Field service companies often skip straight from Draft to Work in Progress.
- If a fault is covered by manufacturer warranty, the job will often follow a different path — no charge to the customer, but the business needs to claim from the manufacturer.
- An assessment fee can be charged even if the customer decides not to proceed with the repair.
Stage 3: Quoting (when applicable)
What happens: After assessment (or sometimes before any work begins), the business creates a quote and sends it to the customer. The quote details:
- What work will be done
- What parts will be used (line items with prices)
- What the labour cost will be
- The total price
- How long the quote is valid for
The customer receives an email with a link to view and accept (or decline) the quote online.
Status: Quote Awaiting
What happens next depends on the customer's decision:
| Customer Decision | What Happens |
|---|---|
| Accepts the quote | Status moves to Quote Accepted → Work begins |
| Declines the quote | Status moves to Quote Declined → Job is closed, assessment fee may apply |
| Ignores the quote | Quote expires after the set period → Business follows up or closes the job |
What staff should know:
- Not every job requires a quote. For field service companies with standard pricing, jobs often go directly to Work in Progress.
- Quotes can be created from within a job or independently (see Quotes section).
Stage 4: Work in Progress
What happens: The technician is actively working on the job. This might mean:
- Travelling to a customer's site
- Working in the workshop on a repair
- Installing equipment
- Performing a maintenance service
During this stage, the technician (typically via the mobile app) is:
- Tracking time — using the start/stop timer to log exactly how long the job takes
- Logging inventory — recording which parts they used and in what quantities (stock is deducted later, when the materials are marked as used; see How Materials Are Marked as Used)
- Capturing photos — documenting the work, the equipment, the before/after state
- Adding notes and comments — recording important information about the job
- Communicating — any messages to the office or customer
Status: Work in Progress
Why time and parts tracking matter:
- Time tracking records how long the job took, per technician, for internal reporting (timers do not create invoice lines, see Time Tracking & Job Inventory)
- Parts tracking ensures the business gets reimbursed for materials used
- Both create an accurate profit picture for the job
What staff should know: If a technician forgets to start their timer, they can manually add a time entry after the fact. If they forget to log parts they used, this can also be added retroactively — but it requires care, as stock levels need to be adjusted.
Stage 5: Completion
What happens: The technician has finished the work. On the mobile app they open the job, tap the coloured button that shows the current status and pick the next status from the Change status list, for example Complete. This triggers:
- The job status updates for the office staff to see
- If the status is set to end timers, the timer stops. Otherwise, if the technician has a timer running on the job, the phone asks whether to stop it first
- If configured: the customer receives an automatic notification
- If configured: an invoice is automatically generated
Before marking complete, the technician should:
- Ensure all parts used are logged
- Capture any required photos
- Get the customer's signature (if the business requires sign-off)
- Complete all task checklist items — if the target status is configured to require tasks, the status change is blocked until every task item on the job is complete (see Job Task Checklists)
- Complete the job's required forms. If the target status is set to complete forms, the change is blocked until every form linked to the job type is completed and not expired
- Stop their timer, or leave it to the status to stop it
When a status change is refused: The web app shows "Cannot change status" with "You need to complete all required forms." or "You need to complete all tasks." The phone shows "Cannot change job status." with "Forms need to be completed and expired forms need to be renewed and completed." or "Tasks need to be completed." Both check forms first, so a job short of both is told about the forms. On the web the checks do not apply when the target is a start status.
Required fields on the phone: If the new status asks for details, the phone opens a Complete required fields screen before the change is saved. It lists every field the status asks for, both required and optional, already filled in where the job has a value. Required fields are marked with an asterisk and Save stays blocked until they are filled. If a status asks for Customer Assets, the phone refuses to save with "Customer Assets are required" until the job has at least one customer asset.
Getting customer sign-off: On the mobile app, technicians tap Signatures on the job (it needs the Edit job permission) and capture a digital signature on the Customer Signature button, entering the signatory's name first. This serves as proof of work completion. Some businesses also capture the technician's own signature, with the Technician Signature button. The Signatures screen can also show a QR code so the customer signs on their own phone.
Status: Complete
What staff should know:
- A job marked Complete by the technician still needs to be reviewed by office staff before it is invoiced.
- "Complete" means the work is done — it does not mean the job is closed or the customer has been billed.
- If a technician accidentally marks a job complete too early, an admin can revert the status.
Stage 6: Invoicing
What happens: Office staff review the completed job and generate an invoice. The invoice pulls in:
- The parts costs (from the inventory items logged)
- Any assessment fees
- Any agreed quote amounts
The invoice is reviewed, adjusted if necessary, and sent to the customer via email.
This is not technically a separate "status" — the job remains in "Complete" status while the invoice is being prepared. But this is a critical step in the process that many businesses struggle with (delayed invoicing = delayed cash flow).
What staff should know:
- ServCraft tracks jobs that are Complete but not yet invoiced — helping businesses identify what they haven't billed yet
- One job can have multiple invoices (e.g., a deposit invoice, then a final invoice)
- Invoices can be created directly from a job with one click — all the relevant data is pre-populated
Stage 7: Payment
What happens: The customer pays the invoice. Payment can be made:
- Online via the Customer Zone (credit card or instant EFT)
- By EFT (bank transfer), with staff manually recording the payment receipt
- By credit card or cash in-person
When payment is received, staff record it in ServCraft against the invoice. The invoice status changes to Paid.
What staff should know:
- Partial payments are supported — a customer can pay in instalments
- Payments are tracked per invoice with the date and amount
- If a business uses PayFast, online payments are captured automatically (no manual recording needed)
- Overdue invoices can be chased via automated email reminders or manual follow-up
Stage 8: Closure
What happens: Once the work is done, the invoice is paid, and everything is complete, the job is marked as Closed. This is the final state.
Status: Closed
Closed jobs drop out of the jobs list by default, so they don't clutter day-to-day work. Switch on the Closed Jobs filter on the jobs list to see them again. They stay fully accessible in the history.
Closing and archiving are separate. Archive Job (in the job's actions menu, or on a row of the jobs list) hides a job from the jobs list until the Archived Jobs filter is switched on. Archiving does not close the job or change its status, and Un-archive Job or Restore Archive reverses it. Archiving needs the Archive Job permission.
What staff should know:
- A job can only be closed once all required steps are done (varies by business configuration)
- When closing a job on the web, the system asks "Mark materials as used?" only if stock control is on, the job has materials not yet fully used, and the job preference Manually closing a job will mark materials as used is on. Materials can also be marked as used earlier, by a status with Mark Materials as Used ticked or by approving an invoice linked to the job (see Time Tracking & Job Inventory)
- Closed jobs can be reopened if something was missed. The Close job permission (employee record, Permissions tab, under Jobs) controls both the Close Job and the Reopen Job actions, so switching it off is how you stop a user closing jobs. Permission switches only take effect after Save changes on the employee's Permissions tab, and the employee is signed out and signs in again to pick them up. Moving a job to a status that has Close Job switched on still closes it, whatever the permission says. Reopening a job does not return stock for materials that were marked as used, and a used material cannot be removed from the job (see Correcting a Material After It Is Used).
- Closed jobs can still be viewed, printed, and referenced — they are never deleted
- A closed job keeps the date it was closed, shown as Closed Date in the job preview and in the job history on a customer or asset. A job closed from the phone gets this date too, set to the time of the change. If a job later moves to a status that does not close it, the closed date is cleared and the job is open again
- On the phone, the ⋮ menu on a job offers Close Job, Open Job (on a closed job), Archive Job and Unarchive Job. Each asks "Confirm Close Job?" or similar first, and each entry only shows for people with the Close job or Archive job permission
When Things Go Wrong: Common Scenarios
"The technician marked the job complete but they haven't finished"
The technician's status can be reverted by an admin. Go to the job, change the status back to Work in Progress. No harm done.
"The job has been sitting in Quote Awaiting for weeks"
This is normal — some customers take time to decide. ServCraft can be configured to send automatic reminders. If reminders have already been sent, the business should manually follow up and then close the quote if there's no response.
"We invoiced a job but realised we forgot to add parts to it"
You have two options: (1) Add the parts to the invoice before it's been sent; (2) Create a separate supplementary invoice. Avoid editing an invoice that has already been sent and accepted — it creates confusion.
"The job is Complete but we can't invoice it"
Check if there's a required field that hasn't been filled in. Statuses can be configured with mandatory fields (like a fault code or a signature), and can also require that all task checklist items are complete, before the job can progress.
"The status change is blocked with 'You need to complete all tasks'"
The target status is configured to require task completion. Open the job's task list and complete (or deactivate) the outstanding items — see Job Task Checklists. On the phone the same block reads "Tasks need to be completed."
"The status change is blocked with 'You need to complete all required forms'"
The target status has Complete Forms ticked, and a form linked to the job's type has not been completed for this job, or has expired. Complete or renew the form from the job's Forms. On the phone the block reads "Forms need to be completed and expired forms need to be renewed and completed."
"The customer cancelled a booked job"
Jobs cannot be deleted or cancelled in ServCraft. The web app and the mobile app offer only Close Job and Archive Job, plus the actions that undo them. Handle a cancellation like this:
- Remove the appointment(s). Delete each appointment from the scheduler or the appointment record. This takes it off the calendar but does not close the job, and no cancellation message goes to the customer, so let them know yourself (see Scheduling & Appointments).
- Close the job. Move the job to a status that has Close Job ticked. The recommended setup is a custom status called something like "Cancelled" with Close Job ticked (Settings → Jobs → Statuses, see Job Settings). Applying it closes the job and leaves a clear record of why it was closed. Close Job from the actions menu also works, but the status keeps the reason visible.
- Archive the job (optional) if it should not appear even when closed jobs are shown.
- Deal with linked quotes and invoices. Use Cancel Quote on any linked quote (see Quote Lifecycle). Use Cancel Invoice on any linked invoice. If the invoice has already synced to accounting, the reversal must also be processed in the accounting package (see Invoice Lifecycle).
"The job was done but it was warranty — do we still create an invoice?"
Yes, but the invoice should be for R0 (zero value) or should be marked as warranty. This creates a paper trail that the work was done, which is important for both the business's records and any manufacturer claims.
Important Business Rules
- A job always belongs to a customer — you cannot have a job without a customer
- Jobs can be assigned to multiple technicians (if a job requires a team)
- Jobs can have multiple appointments — each visit to the customer is a separate appointment, all linked to the same job
- Time entries are linked to specific employees — the system knows which technician spent how much time
- Parts logged on a job deduct stock from a specific warehouse — it matters which warehouse is selected
- Comments on a job can be internal (only visible to staff) or customer-visible (shown to the customer via the Customer Zone)
- Jobs can be grouped under a Project — see Projects
- On the phone, the Edit button on a job's Assigned Employees needs the Edit job permission, and so does the Signatures button
- When the business has asset label printing and the job has customer assets that are products, the web Print documents window has an Asset Labels section where you pick how many labels to print
Related Topics
- Creating a Job
- Scheduling & Appointments
- Time Tracking & Job Inventory
- Recurring Jobs
- Projects
- Job Task Checklists
- Quotes & Estimates
- Invoicing & Payments
- The Mobile App — Technician Experience