02 — Customers
In one sentence: The customer record is the foundation of everything — all jobs, quotes, invoices, contacts, and locations hang off a customer.
What's in This Section
| Document | What it covers |
|---|---|
| Creating Customers | The creation form, required fields, contacts, locations, individual vs company |
| Managing Customers | The customer page, lifecycle, activating/archiving, custom fields |
| Importing Customers | Bulk Excel import, importing from accounting systems |
| The Customer Zone | Self-service portal for end customers — what they can see and do |
What Is a Customer in ServCraft?
A customer in ServCraft is the business or individual that a service company works for. Every job, quote, invoice, and appointment must be linked to a customer — nothing floats in isolation.
A customer record holds:
- Contact details — trading name, phone, email, website
- One or more contacts — specific people at that company (e.g., the procurement manager, the site supervisor)
- One or more locations — physical addresses where work is performed
- Full history — every job, quote, invoice, appointment, and message linked to them
- Custom fields — additional information specific to the business's needs
- Customer Zone link — a unique link the business can send so the customer can view their own jobs, quotes, and invoices
Customer Types
ServCraft businesses can categorise their customers in different ways. Two common distinctions:
Residential vs Commercial
- Residential — an individual homeowner
- Commercial — a company or business
These are often set as a Customer Type in ServCraft and affect things like:
- How they are addressed in communications
- Which pricing tiers or discount structures apply
- Which reports they appear in
Customer Status
ServCraft does not have a built-in lifecycle or pipeline. Instead, each business defines its own Customer Status labels (in Settings → Customers → Statuses) to track where a customer is in the relationship. Common examples a business might set up:
| Status | What It Typically Means |
|---|---|
| Lead | Prospect — not yet a paying customer |
| Live | Active paying customer |
| On Hold | Temporarily paused |
| Cancelled | Relationship ended |
Because statuses are fully configurable, the labels you see will differ from business to business.
Customers, Contacts, and Locations — The Relationship
This is one of the most commonly misunderstood areas. Let's clarify:
CUSTOMER (the company or person)
│
├── CONTACT (a person at that company)
│ e.g., "Jane Smith, Procurement Manager"
│ e.g., "John Doe, Accounts Payable"
│
└── LOCATION (a physical address)
e.g., "Head Office — 123 Main St"
e.g., "Cape Town Branch — 45 Bree St"
When creating a job, you select:
- The Customer (which company)
- The Contact (who to deal with)
- The Location (where to go)
A customer with 10 branches might have 10 locations and 15 different contacts, all under one customer record. This prevents duplication and gives the business a single view of everything related to that client.
Customer Groups
Customers can belong to groups — a way of segmenting customers for filtering and reporting. Groups can be used as filters on the customer list, the asset list, and in reports. Examples:
- "Maintenance contract" group → filter reports to just those customers
- "VIP customers" group → filter the customer list for priority handling
Groups are flexible — a customer can be in multiple groups.
Customer Zone Access
Not all businesses use the Customer Zone. See The Customer Zone for full detail.
Common Scenarios
Scenario: "I can't find a customer"
Search by trading name, contact name, or phone number. The search bar at the top of the page also matches the customer code, the four custom text fields, a contact's email address and the name and address lines of every location, and it shows up to ten customers, newest first, hidden and archived ones included. Each result shows the customer name, the primary contact's name and mobile number, and the customer's status. Also check if the customer might have been archived (some businesses archive inactive customers to keep the list clean). Archived customers still have all their history but don't appear in the default list.
Scenario: "Two customer records for the same customer"
This happens when customers get created twice (usually because someone couldn't find the existing record). ServCraft blocks exact duplicates (same name or code) but records with slightly different spellings can both exist. There is no customer merge function. Deactivate or archive the duplicate and manually move any outstanding work to the correct record.
Scenario: "A customer's invoices are going to the wrong person"
Check the customer's contacts: the Accounting Contact flag marks who is synced to the accounting system, and each contact's Receive Emails setting controls whether they get emailed. The invoice email may need to be updated at the contact level, not just the customer level.
Scenario: "A technician went to the wrong address"
Check which location was selected on the job. A customer with multiple locations needs the correct one selected each time a job is created. Consider adding notes to locations (e.g., "After-hours access — call John first") to prevent this.