Technician Guide — Using the Mobile App
A step-by-step guide for technicians using the ServCraft mobile app in the field. This covers everything from sign-in to job completion, and the other modules in the app.
First-Time Setup
Downloading the App
- Android: Google Play Store → search "ServCraft"
- iOS: Apple App Store → search "ServCraft"
- Huawei: Huawei AppGallery → search "ServCraft"
If the older app is already on the phone, the store offers version 4.x as an ordinary update to the same listing. It is not a separate app.
Signing In
Open the app and sign in with the same username (or email) and password as the web app. The boxes are labelled Username or email and Password, and the button is Sign in. There is no separate mobile account. Forgot password? asks for an email address and sends a reset link.
Sign-in goes through ServCraft's central sign-in service, which has three effects:
- Signing in on a second phone with the same user ends the first phone's session. Signing in to the web app does not.
- Error messages are plain. "Invalid email or password." means the credentials were wrong. "This account is locked or expired." means the account itself has a problem. A message beginning "Cannot connect to server" means the phone could not reach the service.
After a sign-out the app remembers who was signed in and shows "Welcome back" with the username filled in and only the password to type. Not you? Switch user deletes that person's data from the phone, so the next user starts with a full first sync.
Use WiFi for the first login. When you sign in for the first time, the app downloads all your jobs, inventory, customers, and settings. This initial sync can take a few minutes depending on data volume. The app does not ask about cellular data and does not block it, but the download is large, so WiFi is the sensible choice.
The first sync shows a "Syncing your workspace" screen and asks you to keep the app open until it completes. Closing the app mid-sync can cause data to be incomplete. If the business has more than about 50,000 job, quote, query, invoice, purchase order, appointment, task, comment and attachment records, the app first asks "How far back should we sync?" with the choices 3 months, 6 months, 12 months and All data. Older data stays on the server and can be pulled later with Resync Data on the Sync screen.
Push Notification Permission
After you sign in, the app will ask permission to send notifications. Allow this. Push notifications are how the office sends you updates about new jobs and appointment reminders.
Push notifications also need Receive Push Notifications ticked on your employee record in the web app. If you allowed notifications and still get none, ask the office to check it (see Employees & Users).
Location Permission
After the notification question, the app asks for permission to access your location. This is not required and the app works without it. Allowing location lets the app record the phone's GPS position when it saves a change for sending.
The Home Screen
After signing in, you see the home screen. A blue banner at the top says "Welcome back" with your name. It also holds the sync chip, which shows the sync status, and the gear icon that opens settings.
Below the banner the home screen shows these sections:
| Section | What it shows |
|---|---|
| Job tracker | The number of open jobs that started in a chosen period and the number of jobs closed in it, with a gauge showing the percentage of closed jobs. The period defaults to the last 7 days. The picker offers 7, 14, 21, 28, 90 and 365 days, this month, this year and all time. Tapping the total opens the Jobs list with closed jobs included, showing jobs changed since the start of the period. That list can hold a different number of jobs than the tracker, which counts open jobs by start date and closed jobs by closed date. |
| Current timers | Any timers currently running, each with a button to stop it. The section is hidden when none is running. |
| My Jobs | Open jobs assigned to you that have no start date, or a start date or last change within the past 7 days or the coming week. A job that is closed, archived or still a draft is not shown. |
| Upcoming Appointments | Your appointments over the next 7 days. When there are none the section says "You have no appointments in the next 7 days". |
| Recent comments | The latest comments on jobs, customers, quotes, invoices and the other modules the user may open. A user restricted to their own work sees only comments they wrote. How many show is set by Recent comment count in Dashboard settings. |
| Upcoming Stock Takes | Stock takes assigned to you that are pending or being counted, scheduled within the coming week and still within their validity period. Up to three show. |
Job tracker, Current timers and My Jobs only show for users with the Jobs permission, and Upcoming Appointments only for users with the Appointments permission.
A Create a Job button floats at the bottom for users who may open the Jobs module. Pull down on the screen to refresh it.
Two kinds of message can appear under the banner:
- Account warning. A coloured message appears when the company's account is on trial, locked or owing money. The wording comes from the subscription information the server sends, and the app shows it as received.
- Update card. "Keep your app running smoothly. Update by [date]." with an Update button appears when the app is below the minimum version set in the system and the deadline has not passed. Before the deadline a full-screen "Update required" message also appears and offers Later, which hides it until the app is next restarted. After the deadline the app shows a full-screen "App version is expired" message that only allows an update.
Tap any item to open it directly. You can choose which sections show on the home screen in the settings drawer under Dashboard: Show job tracker, Show my jobs, Show my appointments, Show recent comments, and Recent comment count. Current timers and Upcoming Stock Takes show whenever they apply.
Moving Around the App
A bar along the bottom of the screen holds Home, up to three of the modules the user may open, and More. For a user with full permissions the bar reads Home, Jobs, Customers, Quotes and More. The other modules sit on the More screen under the heading "More tools for the job": Invoices, Purchases, Queries, Inventory, Assets, Appointments and Stock Takes. Tapping More a second time goes back to where the user was.
A module only appears if the user has the matching permission. Stock Takes also needs the business to have the stock control and stock take features switched on.
The gear icon on the Home and More screens opens the settings drawer from the right. It has:
| Item | What it does |
|---|---|
| Sync Queue | Opens the Sync screen. The row shows the queue status: Syncing, Failed, the number of changes waiting to send, or Up to date. |
| Feedback & Support | Sends feedback or a support request. See "Feedback and Support" below. |
| About | App version, build number and the company's copyright line. |
| What's new | Shows the release notes of the version the app is running, when there are some. |
| Dashboard and Jobs | The App settings. Dashboard chooses what shows on the home screen. Jobs has Always include jobs created by me, which applies in the Use legacy view lists and the Job tracker. |
| Use legacy view | Switches the main lists back to their layout from before version 4.1.0. |
| Log Out | Signs out after a confirmation. It is also at the bottom of the More screen. |
The version number appears at the foot of the drawer as "ServCraft v" followed by the number.
Finding Your Jobs
From the home screen: Tap a job listed under "My Jobs".
From the Jobs list:
- Tap Jobs in the bottom bar
- Type in the Search Jobs box. Search matches job numbers, customer names, contact names, the job's service item, its custom fields and the numbers of linked invoices. It does not search serial numbers
- Tap the Preferences button beside the search box to filter by status, assignee, job type, dates and more
The list is divided into Recent, Today and Upcoming sections. Recent starts collapsed, so tap its header to see older jobs. The Preferences sheet and the way sections work are explained in Lists, Filters and Card Settings.
Default view: The My jobs quick action in Preferences shows only jobs assigned to you. If your account does not have the "View all items" permission, the list is limited to your own jobs. Preferences then has no Assignee section and no My jobs quick action, only Today.
Working a Job
1. Open the Job
Tap the job to see full details. The top card shows the job number, its current status, the Start Timer button and the buttons for status, attachments, pictures, forms and signatures. Below it are:
- Contact: the customer, contact and their mobile and work numbers
- Job details: store, job type, product, the description of the work required, start date and status date. Tap the job type or the description to change them
- Job properties: the job's custom fields
- Assigned Employees: who is on the job, with an Edit button
- Related actions: a list with a count for Forms, Quotes, Invoices, Purchase Orders, Appointments, Materials, Timers, Tasks, Comments, Attachments and Messages. Quotes, Invoices, Purchase Orders and Appointments only appear if the user has that module's permission
- The Location of the job, which can be changed to another location of the same customer if the user has the Change location permission
A Print icon at the top of the job prints a job document. When the business has not configured its own documents, the choices are Customer, Sign Off, Workshop and Job Sheet. A three-dot menu next to it holds Close Job and Archive Job for users with those permissions.
A closed or archived job shows a "Closed" or "Archived" band across the top. A closed job locks the status button, the job details, the materials and the task list until someone reopens it with Open Job in the three-dot menu.
2. Start the Timer
Before you do any work, start the timer:
- Tap Start Timer at the top of the job
- The button turns into a running counter that shows hours, minutes and seconds. It also appears under Current timers on the home screen
- Only one timer can run for you at a time. If another one is running, the app says "Other timer running on" followed by that job and customer, and asks whether to stop it. Tap Stop to end the other timer, then tap Start Timer again
- If you change the job's status while a timer is running, the app asks "A timer is currently running, do you wish to stop it before continuing?" unless the new status stops timers by itself
3. Navigate to the Customer
Tap Open in Maps to send the job's address to your maps app. On iPhone the app opens Apple Maps. On other phones it opens Google Maps. Call contact dials the contact's mobile number, or their work number when there is no mobile number. Open in Maps is greyed out when the job has no address, and Call contact when it has no phone number. With neither, the buttons are not shown.
4. Do the Work
While working:
Add Notes:
- Tap Comments under Related actions
- Type your note in the box that says "Type a comment..." and tap Save Internal Comment. The arrow beside that button offers Save Public Comment
- Comments are Internal (office and staff only) or Public (visible to the customer). Saving a public comment, or switching an existing comment between Internal and Public with Make Public or Make Internal, requires the Public comments permission
- Tapping an existing comment opens Modify Comment. Edit Comment there needs the Edit comment permission, and adding a comment needs the Comments permission
Take Photos and Attach Files:
- Tap Take Picture to photograph straight into the job. Tap Attachments to see everything attached and use Add Attachment, which offers Camera, Gallery, File and Sketch
- Each photo is attached to the job as soon as it is taken
- Up to 20 files can be added at once. If more are chosen, the app says "Too many files", shows how many to remove and lists the files so some can be taken off
- A file larger than the business's upload size limit is refused with a message giving the limit. The limit was raised from 10 MB to 25 MB for all customers on 12 November 2026, so larger videos now go up, and no app update is needed. Photos are compressed first, so most are accepted
- An attachment's details screen offers View / Download, Rename and Delete Document
- Attachments marked secure are only shown to users with the Secure attachments permission, and this includes signatures and sketches
- Common uses: before/after, faulty parts, completed installation, equipment photo
Log Parts Used:
- Tap Materials on the job. Adding, editing and removing materials needs the Manage materials permission, and the list is locked on a closed job
- Tap Add Material, then search for the part by name, code or category, or scan its barcode with the scanner button in the search box
- Set the description and quantity, then confirm. The unit cost price box only shows for users with the Manage costing permission. The arrow beside Add Material offers Add Bundle, which adds a prepared bundle of items
- Materials can be grouped into sections. A section's menu offers Edit, Add Materials / Service, Ungroup Items and Delete Section, and a material's menu offers Edit, Create Section and Delete. Press and drag the grip on a row to rearrange the order
- A material that has an image on its inventory item shows that image on the row
- Materials show as used, and come off your van stock, when they are marked as used. See "Inventory & Van Stock" below
Barcode scanning: Aim the camera at the barcode or QR code. The app looks the code up in inventory and opens the matching item, or says "No inventory item found" with the code it read. This is faster than typing for parts with long codes.
5. Update Job Status
The status button on the job shows the job's current status. Tap it to open Change status, which lists the statuses the job can move to, each with its colour:
- Select the appropriate status
- If the status needs forms completed or tasks completed first, the app says "Cannot change job status." and explains what is missing
- If the status asks for details, a "Complete required fields" screen opens. Fields marked with an asterisk must be filled in before Save. Examples are an employee, a date, materials used, or a customer signature taken on the Signatures screen
- The app saves the new status on the phone and sends it with the next sync
6. Complete Forms
If the job has a checklist or form attached:
- Tap Forms. The screen has a To Do tab and a Completed tab, and Add additional forms adds another form to the job when the job allows it
- Open the form and fill in each field. Fields can be text, numbers, yes or no, a choice, a date, a signature, images and tables with Add Row
- Tap Save Draft to keep it and come back later, or Submit when it is finished. Submitting asks "Confirm Complete Form?" because the form cannot be edited afterwards
- The card menu has Rename and, on forms that can be filled in more than once, Re-Use Form
Some forms are single-use and show a Single-Use tag. Others can be used again each time.
7. Get Customer Signature
If the business requires sign-off:
- Tap Signatures on the job
- The Signatures button on the job is greyed out unless the technician has the Edit job permission (under Jobs on the employee's Permissions tab). The web app's Actions → Signatures option on a job is greyed out for the same reason
- The Signatures screen offers a Customer Signature button and a Technician Signature button. A button disappears once that signature has been captured
- On the capture screen, type the Signatory Name, which is required. For the technician signature the employee list can be used to pick the name. Then sign in the box marked "Sign here" and tap Save. Clear starts the box again
- The screen shows "By signing the above you agree that the work is complete" beneath the pad. No other terms are shown
- Each captured signature appears on the Signatures screen with the signatory's name, when it was captured and a Re-sign button that replaces it. A signature captured offline is marked "Captured offline"
- Alternatively, let the customer scan the QR code at the bottom of the Signatures screen under "Let your customer sign on their own device by scanning the QR code below". The code only appears when the job has a customer, and scanning it opens the Customer Zone signature page for that job
- Signatures taken in a Signature field on a form follow that field's signature template. The form's signature screen shows the template's terms under Terms of Acceptance, offers Re-sign only when the template allows it, and can show "Signature is hidden" instead of the image. See Signature Templates
8. Stop the Timer
When work is complete:
- Tap the running counter at the top of the job, or Stop Timer on the job's Timers screen
- The Timers screen lists each time entry with its start, end, date and duration, and tags it Running, Billable or Overtime. If a time doesn't look right, tell the office so it can be corrected
9. Mark the Job Complete
- Tap the status button → pick the completion status (whatever your business calls it, for example Complete)
- The office is notified
- Any triggered automations fire (e.g., customer notification email)
Appointments
The Appointments screen shows scheduled appointments a week at a time. Users restricted to their own work see only their own.
- A strip at the top shows the days of the week, with a dot under each day that has appointments and arrows to move to the previous or next week
- The days are listed below, with Today highlighted and the time and customer of each appointment
- A day with nothing planned says "No plans yet" and "Tap to add an appointment"
- Tap an appointment to see its full details
Appointments are usually created by the office dispatcher, but the app also has a Create Appointment button, so you can add one yourself. A job, quote or query also has an Appointments entry that creates an appointment already linked to it.
Tasks
A job's task list is under Tasks in Related actions, and it opens as "Task Items for" the job number. Queries have a task list too.
- Tap the box beside a task to mark it complete. A task that asks for something, such as a number, a choice or a photo, opens a Complete Task Item screen first
- The kinds of answer a task can ask for are Text, Number, Yes / No, Date, Date & time, Attachment, Take photo, Single select, Multi-select, Customer signature, Employee signature and Complete forms
- The app checks the answer before it lets you finish, with messages such as "Text is required", "Number is required", "Selection is required", "Date is required" and "At least one attachment is required, or mark as incomplete"
- A task that needs a signature or completed forms cannot be completed with Mark as Complete. It completes once the signature or forms exist
- Mark as Incomplete clears a completed result after a confirmation
- Add Task Item appears for users with the Add task items permission. Each task can be given a due date and assigned employees, and a task template can fill the list in one go
- Press and drag a task to rearrange the order
- On a closed job the list is locked: tasks cannot be added, edited or reordered, but they can still be completed
Quotes, Invoices and Purchases
The Quotes, Invoices and Purchases modules are in the bottom bar or on the More screen. Each list follows the layout described in Lists, Filters and Card Settings.
Creating one. The Create quote, Create invoice or Create purchase order button starts a three-step wizard ("Create Quote • Step 1 of 3" and so on). Step 1 chooses the customer and contact, step 2 the location and step 3 the items. A contact is needed before Next moves on. When a quote or invoice is started from a job or query, it is linked to that job or query and the link cannot be changed. In step 3, Add Item offers Inventory, Description, Customer Asset, Job Materials and Bundle, and items can be grouped into sections.
Working with one. Opening a quote, invoice or purchase order shows its details, and its actions sheet offers the actions allowed for its status and the user's permissions:
| Module | Actions |
|---|---|
| Quote | Copy Quote, Copy to Invoice, Copy to Purchase Order, Cancel Quote, Approve Quote, Accept/Decline, Revert to Draft, Send Quote, Download, Open Customer, Add New Job, Add New Query, View Job, View Query, Unlink Job or Query, and Payment QR Code when a payment gateway is active |
| Invoice | Copy Invoice, Cancel Invoice, Approve Invoice, Mark As Paid, Send Invoice, Download, Open Customer, Add New Job, Add New Query, View Job, View Query, and Payment QR Code when a payment gateway is active |
| Purchase order | Copy Purchase Order, Cancel Purchase Order, Approve Purchase Order, Send Purchase Order, Download, Add New Job, Add New Query, View Job, View Query |
Approving a quote, invoice or purchase order needs the matching approve permission, and so does sending any of the three. Reverting a quote to draft needs the quote revert permission. Sending opens an email to the contact with the document attached, and the app refuses with "Cannot send quote" when the contact is set not to receive email. A purchase order's header (location, dates, reference, delivery address and employee) can still be edited after the Draft status, but its items and discount can only be edited in Draft. Items on a purchase order can be dragged into a new order.
Customers and Contacts
Customers shows one A-Z list of customers and their contacts. Tap the Create customer button for a new customer. A customer's page shows Customer information, Custom fields, Contacts, Locations, Forms, Comments, Attachments and Messages. A contact has its own page with comments, messages and contact details such as phone numbers. Tapping a phone number or email address opens the phone's dialer or mail app.
Queries
Queries is the list of customer enquiries. It follows the list layout in Lists, Filters and Card Settings, with filters for Type, Status, Priority and Assignee. Create query starts a three-step wizard. A query's page shows its Quotes, Invoices, Appointments and Tasks, has Call contact and Open map buttons, and a Change status button. Its menu offers Close Query, Archive Query and Create Job.
Messages
A job, quote, invoice, purchase order, customer or contact has a Messages entry that lists the messages sent for it. Starting a new one asks for Email or SMS. The compose screen has To, Subject for email, a Select Template list, Use Tag to insert replacement tags and attachments, and Send Message. A sent message is queued on the phone and goes out with the sync.
Inventory & Van Stock
Adding parts to a job's materials does not deduct them straight away. They are deducted from stock when the materials are marked as used: when the job moves to a status set to mark materials as used, when an invoice linked to the job is approved, or when the job is closed and the business has that preference switched on (see How Materials Are Marked as Used).
Viewing inventory:
- Tap Inventory in the bottom bar or on the More screen
- The list shows each item with its stock level (In stock, Low stock, Out of stock, or Not stocked for services)
- Search with the Search Inventory box, or tap the barcode icon to scan an item's barcode and open it
- Open an item to see its details, pricing, linked products and images. Images can be added from the camera or gallery, and one can be chosen as the primary image
- Adjust Stock on an item records a quantity in or out with a reason
Assets. The Assets module lists customer assets, which can also be attached to jobs under Customer Assets. Create an Asset adds one, and its page shows Asset details, Purchase and warranty information and custom fields. The assets list can hide scrapped assets with Include scrapped.
When stock runs low:
- Notify the office via a comment on the job or a direct message
- A stock transfer or purchase order will be raised to replenish your van
Stocktakes on Mobile
If you're assigned a stocktake:
- It appears on your home screen under "Upcoming Stock Takes", and the Stock Takes list shows "Today's Stock Takes" and "Other Stock Takes", with an All Stocktakes and My Stocktakes switch for users who manage stock takes (other users see only their own)
- Tap it to open it, then tap Start Counting. The assigned employee or a stock take manager can do this while the stock take is within its validity period. The button stays unavailable, with the message "Cannot start stock take until your device is finished syncing with server.", while changes are still waiting to send
- Count each item in your van or warehouse and enter the actual quantity. Use the plus and minus buttons or type the number, then Next to save it and move on. Skip sets an item aside, but a skipped or pending item must be counted before the stock take can be completed
- The scanner button finds an item by its barcode, the filter and sort buttons narrow the items and order them by inventory code or bin location, and Add item to count adds an item that is not on the list, but only on stock takes set up to allow it
- When every item is counted, open the summary, which shows Counted, Skipped and Pending items. The button at the bottom reads "N still to count" and stays disabled until nothing is pending or skipped, then reads Complete Stock Take. Tapping it asks "Complete Counting" and you confirm
- Starting, counting and completing are saved on the phone and sent with the next sync
Settings, Support and Updates
Settings is the drawer that opens from the gear icon on the Home and More screens. See "Moving Around the App" above for the full list. To trigger a sync manually, tap the sync chip at the top of the home screen. Tapping it while the phone is offline shows "You're offline — changes will send when you reconnect".
The Sync screen. Sync Queue opens the Sync screen. It shows the current status and the last sync, the pending queue and its items, and Sync Now. Send stuck items to support sends a report of items that will not sync. Its Sync settings card has Reduce cellular data usage, Resync Data and Clear Message Cache. Resync Data only appears when the first sync was limited to a number of months. It asks "Confirm Resync Data?" and takes the user back to the "How far back should we sync?" choice.
Feedback and Support. Feedback & Support in the drawer first asks "Want to show us the screen you have a problem with?". Add a screenshot lets you move to the screen in question and take the picture, and No thanks goes straight to the form. The form has a Title and a Description, both required, and Submit sends them. A confirmation says "Ticket created!" and tells the user to watch their email inbox for a reply. If it fails, the app says to email support@servcraft.co.za.
What's new. After an update to a version that has release notes, a "What's new" card shows once on the home screen. The What's new row in the drawer shows it again at any time. Version 4.0.0 shows a longer welcome for people updating from the older app.
If you're having issues, support will ask for your app version number. It is shown at the foot of the settings drawer and on the About screen.
Permissions and What You Can See
What you see in the app depends on your permissions set in ServCraft by your admin:
| Permission state | What you see |
|---|---|
| "View all items" permission OFF (typical technician) | Only your own jobs, appointments, quotes, invoices, purchase orders, queries and stock takes. Preferences has no Assignee section and no My jobs quick action |
| "View all items" permission ON (full access) | Everything, with the My jobs quick action in Preferences to narrow the Jobs list to your own |
| Jobs permission OFF | The Jobs module does not appear in the app |
The same applies to every module. A module such as Quotes, Invoices, Purchases, Queries, Inventory, Assets, Appointments or Customers only appears when the user has its permission. Some buttons depend on a permission too, for example Signatures needs Edit job, Close Job needs Close job, Add Task Item needs Add task items and the materials list needs Manage materials.
If you can't see a job you expect to see, it's likely either not assigned to you or your permissions restrict your view. Contact your office admin.
Common Issues
"I can't see my jobs"
- Tap the sync chip at the top of the home screen to trigger a sync
- Check if you have internet connection — if offline, check that the initial sync was completed
- Check if the job is assigned to you (not a different technician)
- Open the Recent section, which starts collapsed, and check Preferences for filters that are switched on, including whether Include closed jobs is off
"My timer stopped / reset"
A running timer is saved on the phone, so it is still running when the app is reopened. If it's missing, check the job's Timers screen, and notify the office if the times are wrong so they can be corrected.
"A photo I took isn't showing in the web app"
The photo is saved locally. It will upload when you have a connection. Open Sync Queue in the settings drawer to see if it's still waiting.
"I changed the job status but the office can't see it"
If you're offline, status changes queue locally and sync when you reconnect. Tap the sync chip to force a sync.
"The phone says 'ServCraft Preview' or 'This preview app has now closed'"
ServCraft Preview was a separate test version of the new app that could be installed beside the main one. It closed on 6 November 2026 and now only shows a message with an Open ServCraft button that takes the user to the main app. The main app is the one to update from the store if it is still on an earlier version, because the 4.x app reached all the stores on 16 October 2026 as an update to the existing app.
"Can I dictate the job description instead of typing it?"
The app has no voice-to-text feature of its own. The Description of the job box is an ordinary text field, so your phone's keyboard voice typing works in it like in any other app. See Creating a Job.
Related Topics
- The Job Lifecycle
- Time Tracking & Job Inventory
- Offline & Sync
- Lists, Filters and Card Settings
- Stocktakes