Managing Customers
This page covers everything on the customer detail page — the tabs, contacts, locations, lifecycle management, and how to handle deactivation and archiving.
The Customer Detail Page
Every customer has a detail page accessible by clicking their name in the customer list. The page is organised into tabs:
| Tab | What It Contains | When It Shows |
|---|---|---|
| Details | Customer info, classification, custom fields | Always |
| Contacts | People associated with this customer | Always |
| Locations | Physical addresses for this customer | Always |
| Jobs | All jobs linked to this customer | Only if jobs exist (and you have Jobs permission) |
| Quotes | All quotes for this customer | Only if quotes exist (and you have Quotes permission) |
| Invoices | All invoices for this customer | Only if invoices exist (and you have Invoices permission) |
| Queries | All service queries/tickets | Only if queries exist (and you have Queries permission) |
| Assets | Customer equipment and products tracked | Only if assets exist (and you have Assets permission) |
| Appointments | Scheduled appointments | Always (if you have Appointments permission) |
| Attachments | Files, documents, photos | Always |
| Messages | Email and SMS history | Always |
The Options menu. The Options button in the toolbar holds the actions that start from this customer: Forms (only when the business has customer forms), New Customer, Send Customer zone link, Copy Customer zone link, and Create Job, Create Quote, Create Invoice, Create Query and Create Asset for the modules the user has permission to use. Forms used to sit on the Details tab and now open from this menu. A job, query or asset started from here is locked to this customer, so only its contact and location can be changed. Cancel on a new query or asset returns to this customer.
Tabs only appear when there's data in them (except Details, Contacts, Locations, Appointments, Attachments, and Messages, which are always visible). So a brand new customer will show only those always-visible tabs until work is created.
Editing Customer Details
The Details tab has two sections. Customer details holds the name (labelled Company Name for a company and Customer Name for a person), the This customer is a company tick box, the Customer Code and the three primary pickers described below. Additional details holds the rest:
- VAT number, company reg number
- Customer Type, Industry Type, Media Type
- Customer Status and Account Manager
- Custom fields
- Default discount
Change any field and click Save in the toolbar. Cancel returns to the customer list. Below the fields sit the comments and the history of changes to the customer.
Primary Contact and Primary Addresses
Under Customer details there are three pickers: Primary Contact, Primary Delivery Address and Primary Postal Address. A customer has one of each.
- Click a picker to see the customer's active contacts or addresses. Every row except the current primary shows "Set as primary". Choosing a row makes it the primary. The choice is kept with the rest of the page, so click Save to store it.
- The pencil next to a row opens that contact or address for editing.
- Add contact, Add delivery address or Add postal address at the bottom of the list opens the matching dialog to create a new one. When a customer has none yet, the picker reads "No contact yet" (or "No delivery address yet") and clicking it adds one.
- The list gets a Search contacts or Search addresses box once there are more than eight entries.
- A contact with a mobile number has a green WhatsApp button beside the name. It opens a WhatsApp chat in a new tab.
- A contact who is also the accounting contact carries an Accounting tag.
The pickers are read only for users without permission to edit customers.
Some fields are shown or hidden based on your business's Field Settings. If you can't see a field you expect, check with your admin.
Contacts
Managing Contacts
The Contacts tab shows a table of the contacts linked to this customer. Each contact represents a person. The columns are Contact Name, Email Address, Mobile Number, Designation, Primary Contact and Accounting Contact. Next to each mobile number there is a green WhatsApp icon (hover text "Chat via whatsapp"). Clicking it opens a WhatsApp chat with that number in a new tab. A number that starts with 0 is treated as a South African number. The Active contacts filter is on by default, so deactivated contacts are hidden until you switch it off.
Actions available:
- Add Contact: the button above the table opens the contact dialog (headed "Creating a contact") to add a new person
- Edit Contact: click a row to open the dialog (headed "Editing contact [name]") and change the details
- Primary contact and Primary accounting contact: tick boxes in the dialog under "Role for this customer" (see below)
- Deactivate and Activate: a button at the bottom left of the dialog (see below)
The same dialog opens from the Primary Contact picker on the Details tab and from the contact selector when you create a job, quote or invoice.
The Contact Dialog
The dialog has these parts:
- First name, Last name, Email, Mobile number and Designation. Under the mobile number a line reads "Defaults to South Africa. For international numbers, include the country code." Include the country code for a number outside South Africa.
- A link, Add work, home or fax number, or ID number, that reveals the Work number, Home number, Fax number and ID number fields.
- Messages tick boxes: Send emails to this contact, Send SMS to this contact and Send SMS marketing ("Only if they've agreed to receive marketing."). While a box is off, that contact cannot be picked as a recipient.
- Role for this customer tick boxes: Primary contact and Primary accounting contact.
- Create (or Save), Cancel and, on an existing contact, Deactivate or Activate.
A contact needs a first name, a last name, and an email address or a mobile number.
Moving a role. A customer always has a primary contact and a primary accounting contact. To take a role off a contact, tick it on another contact instead. If you untick it on the contact that holds it, a "Select new primary contact" or "Select new accounting contact" box asks which contact should take over, and the change is made when you save.
Deactivating a contact. A customer must keep at least one active contact. If the contact is the only active one, Deactivate is greyed out with the hover text "A customer needs at least one active contact. Please add another contact before deactivating this one." If the contact holds a role, the "Deactivate contact" box says which other contact takes the role over. When several contacts could take it, the box is headed "Select new primary contact" (or accounting contact) and asks you to choose one. Activate brings a deactivated contact back.
Primary Contact
Every customer has one Primary Contact. It is the contact shown in the Primary Contact picker on the Details tab, and this person:
- Is listed first in contact searches
- Is defaulted on new jobs and quotes where a contact is required
- Receives email notifications linked to this customer (where configured)
Accounting Contact
The Accounting Contact (also called the Primary accounting contact) is the contact that syncs to the connected accounting system (Xero, Sage One, or QuickBooks). When ServCraft pushes a customer to Xero, for example, it includes this contact's name and email as the Xero contact details.
Best practice: The accounting contact should be the person who handles invoices and payments — typically the accounts payable contact.
Contact Fields
| Field | Notes |
|---|---|
| First Name, Last Name | Required |
| Email Address | Required if no mobile |
| Mobile Number | Required if no email |
| Work Number, Home Number, Fax Number, ID Number | Optional, behind the "Add work, home or fax number, or ID number" link |
| Designation | Job title — selected from a configurable list |
| Send emails to this contact, Send SMS to this contact | Notification permissions per contact |
| Send SMS marketing | Ticked while the contact accepts marketing SMS. Unticking it opts the contact out of bulk communications |
Recording a contact's role (Designation). Designation is a dropdown, not a free-text box. You can only pick a designation that already exists, and there is no option to add a new one from the contact form. Set the list up first in Settings → Customers, on the Designations tab: click Create, type the role (for example "Procurement Manager" or "Accounts Payable") and save. After that, open the customer's Contacts tab, click Add Contact (or open an existing contact) and pick the role from Designation. The Designation field always appears on the contact form; if no designations have been set up, its dropdown is empty.
Locations
What Is a Location?
A location is a physical address associated with the customer. Locations are used when scheduling jobs — the technician needs to know where to go.
Location types:
- Delivery — a service address (where work is done). Most locations are this type.
- Postal — a mailing address (where invoices or letters are sent). Often different from the service address.
Managing Locations
The Locations tab shows a table with the columns Description, Type, Address and Country. A blue Primary tag sits in the Type column beside the primary address of each type. The Active locations filter is on by default.
From the Locations tab, you can:
- Add Location: the button above the table opens a dialog headed "Add new location"
- Edit Location: click a row to open the dialog headed "Editing location [name]"
- Primary [type] address: the tick box under "Role for this customer" in the dialog
- Deactivate and Activate: the button at the bottom left of the dialog
A customer with multiple branches should have one location per branch. When a job is created for that customer, the scheduler picks the relevant location.
Location Fields
| Field | Notes |
|---|---|
| Name | A name for this location: "Head Office", "Warehouse", "Cape Town Branch" |
| Address Type | Delivery or Postal |
| Address | One box with up to five lines. Each line you type becomes one address line |
| Country | Defaults to South Africa |
| Use latitude / longitude | Optional tick box that reveals coordinates, for an exact spot such as a farm or site |
One Primary Address per Type
A customer has one primary delivery address and one primary postal address.
- The first location of a type is always the primary of that type, and its tick box is locked on.
- Making another location primary takes the role from the previous one.
- When you change a location's type, it becomes the primary of its new type if it is the only one there. Otherwise it is not primary.
- If you untick Primary on the current primary, or move it to another type, a box headed "Select new primary [type] address" asks which other location of that type takes over. The change is made when you save.
- Deactivate on a primary location asks the same question. With a single other location of that type, the box says which one will become primary. If it is the only active location of its type, the box warns that the customer will have no primary address of that type. Unlike contacts, a customer can have no active locations.
Customer Status, Activation, and Archiving
Note: ServCraft does not have a pipeline or formal stage-progression system for tracking customers through a lifecycle. Customer Status is a configurable label only — it does not drive any automated stage transitions.
Customer Status
The Customer Status field is a configurable label for where this customer is in their business relationship. Common examples:
| Status | What It Typically Means |
|---|---|
| Lead | Prospect — not yet a paying customer |
| Live | Active paying customer |
| On Hold | Temporarily paused (e.g., dispute, payment issues) |
| Cancelled | Relationship ended |
The exact status options are configured in Settings → Customers → Statuses. Some businesses use status to drive workflows or filters.
Active vs Inactive
A tag next to the breadcrumbs at the top of the customer page shows whether the customer is Active, Hidden or Archived. For an active or hidden customer the tag is also the control. Click it and choose Hide this customer ("This customer won't display for you or anyone on your team.") or Show this customer ("This customer will display again for you and your team."). The tag is read only for users who cannot edit customers.
| Setting | Effect |
|---|---|
| Active | Customer appears in job creation, quote creation, etc. |
| Hidden (inactive) | Customer does not display for you or anyone on your team. The search bar at the top of the page still finds it. All historical data is preserved. |
Hiding a customer asks for confirmation ("Hide [name]?") and saves straight away, with no need to click Save. A message confirms "[name] is now hidden" or "[name] is visible again". A hidden customer's Details tab shows a banner, "This customer is hidden. It won't display for you or anyone on your team.", with a Show this customer button. The tag and banner replace the Active switch that used to sit on the Details tab.
When to deactivate: When a customer relationship ends but you want to keep their history. They won't clutter the active list, but all their jobs, invoices, and communications are still accessible.
To view inactive customers: In the customer list filters, turn on the "Inactive Customers" toggle. (A separate "Archived Customers" toggle shows archived records.)
If a customer is deactivated, you cannot create new jobs or invoices for them without reactivating first.
Deactivating a customer when an accounting integration is live
Deactivating (hiding) a customer queues it for sync, and what happens on the accounting side depends on the integration's Customer Direction setting and on the accounting system. When the direction is the "ServCraft to" option or Bidirectional, Xero archives the contact and QuickBooks makes the customer inactive. Sage One does nothing: the Sage One sync only sends active customers, so the customer stays active in Sage One until someone deactivates it there by hand. With the "to ServCraft" option or None, ServCraft sends nothing to any of the three.
The other way round, a customer made inactive in Sage One or QuickBooks, or archived in Xero, becomes inactive in ServCraft on the next pull when the direction is the "to ServCraft" option or Bidirectional. With Sage One on Bidirectional, a customer deactivated only in ServCraft becomes active again if someone later edits it in Sage One. See Customer Sync Direction for the full rules.
Archiving
Archiving is a softer form of removal — it moves the customer out of the default view with a visual flag. Archives can be undone. Use archiving when you want to temporarily or definitively remove a customer from view but might need to restore them.
Archive vs Deactivate: In practice, both hide the customer from normal searches. Archive has an undo capability and a distinct visual indicator.
Accounting Sync Status
If an accounting integration is active, the customer page shows the sync status:
| Status | What It Means |
|---|---|
| Sync Pending | Queued for sync — waiting for the background job |
| Synced | Successfully synced to accounting system |
| Deleted | The linked record was deleted on the accounting system side |
| Retry sync to the accounting system | Sync failed — this is a clickable action button to re-attempt. Hover over the alert icon on the button to view the error returned from the accounting system. |
The customer page only shows these four states. The customer list has a fuller Accounting filter covering every sync state a record can be in: Never, Pending, Synced, Failed, Not Syncable, Delete, and Deleted. Deleted and Not Syncable are both real states, not error text — Not Syncable means the record can't go across as it stands (usually a missing required field), and Deleted means the linked record has been removed on the accounting side.
When sync fails: An error message is visible by hovering over the Retry sync button. Common fixes:
- Check if the integration is still live (Settings → Company → Integrations)
- Verify the customer has an email address (some accounting systems require it)
- Check the Integration Hub for the detailed error message
Customer Classification Fields and Groups
ServCraft provides classification fields such as Customer Type, Customer Status, Industry Type, Media Type, and Designation. These are configured in Settings → Customers (tabs for Types, Statuses, Industry Types, Media Types, and Designations).
Customer Groups also exist: a customer can belong to one or more groups, and groups can be used as filters — for example, to filter the customer list, the asset list, or reports by group. If you don't see group options in your account, ask your admin or support whether groups have been set up for your business.
Which of these you can filter by. The customer list filters on Customer Group, Customer Status, Customer Type, and accounting sync state, plus switches for inactive and archived customers. Industry Type, Media Type and Designation are recorded on the record but are not filters on the customer list — if you need to work from those, pull a report or export the list and filter in the spreadsheet.
If the Mobile Number column is showing in the customer list, each number carries the same green WhatsApp icon as the Contacts tab. Clicking it opens a WhatsApp chat with that number without opening the customer.
The Customer Zone
From the customer page's Options menu, choose Send Customer zone link. This opens the email screen pre-loaded with the Customer Zone email template, where you choose the recipient contact and send. Choose Copy Customer zone link instead to copy a fresh link to the clipboard and send it another way. If a customer's link has expired, they can ask for a new one themselves from the expired-link page. See The Customer Zone for what happens next.
Not all businesses use the Customer Zone. Customers see only their own data. See The Customer Zone for full detail.
Common Questions
"A customer's jobs are assigned to the wrong location"
Edit the job and change the location. To prevent this in future, make sure the correct location is selected when creating jobs for this customer. If the customer has many locations, consider naming them clearly (e.g., "CBD Office", "Durban Warehouse").
"The customer appears twice in search results"
Customers cannot be merged on ServCraft. If two records exist for the same customer, the only options are to deactivate the duplicate and manually move any outstanding work to the correct record, or keep both records and manage them separately.
"I need to reassign all jobs from one account manager to another"
Account Manager is set per customer and must be updated on each customer record individually. The customer list's only bulk action is Archive/Unarchive Selected — there is no bulk update for Account Manager. Filter the customer list to find the affected customers, then edit each one.
"Can a customer contact receive invoice notifications?"
Yes — on the contact record, ensure Send Email is enabled. When an invoice is sent, it goes to the email address of contacts with email notifications enabled.
Related Topics
- Creating Customers
- Importing Customers
- Accounting Integrations
- Invoicing & Payments