Skip to main content

Creating Customers

Creating a customer is the first step before any job, quote, or invoice can be raised. This page covers everything on the creation form and how to get it right the first time.


Before You Create​

Check if the customer already exists. Duplicate customer records are one of the most common problems in ServCraft. Before creating, search for the customer by:

  • Company name (or trading name)
  • Contact first and last name
  • Phone number
  • Email address

If you find them, use the existing record. If not, proceed.

Built-in duplicate protection: ServCraft refuses to create a customer whose name or customer code exactly matches an existing record (including inactive or archived ones) — you'll see a "Duplicate Customer Exists" error. This only catches exact matches, though: "ABC Plumbing" and "ABC Plumbing (Pty) Ltd" would both be allowed, so searching first still matters.


Individual vs Company​

The first decision when creating a customer is Individual or Company:

TypeUse WhenCustomer Name
Individual (toggle OFF)A person — homeowner, sole proprietor, one-person customerAuto-generated from the contact's first + last name
Company (toggle ON)A registered company, business, or organisationEntered explicitly as the company/trading name

Individual customers: You enter the primary contact's name (First Name + Last Name), and ServCraft uses that as the customer name. There is no separate company name field.

Company customers: You enter the company name separately, then add at least one contact person for that company.


The Customer Creation Form​

Core Fields​

FieldRequired?Notes
Customer NameYes (for companies)The trading/company name
Customer CodeNoAn optional short reference code. Auto-generated if left blank
VAT NumberConfigurableVAT registration number
Company Reg NumberConfigurableCompany registration number
Email AddressNoCustomer-level email (separate from contact emails)
Default DiscountNo (defaults to 0)A discount percentage field on the customer record. Note: default discounts do not automatically apply to quotes or invoices in ServCraft — this field exists for reference but does not auto-populate discounts on new documents.

Classification Fields​

FieldRequired?Notes
Customer TypeConfigurablee.g., Residential, Commercial, Government — configured in Settings
Industry TypeConfigurableThe customer's business sector
Media TypeConfigurableHow they heard about you (marketing source)
Customer StatusConfigurableLifecycle stage (e.g., Live, Lead, On Hold)
Account ManagerConfigurableThe tenant's own employee (user) responsible for managing this customer. This is an internal staff member of the service business — not a ServCraft employee.

Configurable means the field may be shown, hidden, or required depending on how the business has set up their Field Settings. What you see may differ from the defaults above.

Custom Fields​

Each customer record has additional fields whose names are set by the business:

FieldTypeExample Uses
Custom Field 1–4TextLease reference, Building name, Contract number
Custom Number 1–2NumberFloor area, Number of units
Custom Date 1–2DateContract start date, Last service date
Custom Filter 1–2On/Off toggleMaintenance contract: Yes/No, Priority client: Yes/No

These only appear if configured to be visible in Settings → Customers → Settings tab.


Adding the Primary Contact​

Every customer must have at least one contact — a person associated with the customer account.

For individual customers, the primary contact IS the customer. For company customers, this is the key person (e.g., the procurement manager, the owner, the accounts contact).

Contact fields:

FieldRequired?
First NameYes
Last NameYes
Email AddressEither Email OR Mobile required (the form groups them under one label, "Email or mobile number")
Mobile NumberEither Email OR Mobile required. Numbers are read as South African unless you include the country code, and a line under the box says so: "Defaults to South Africa. For international numbers, include the country code."

The new customer form has no Designation field. To record the contact's role, save the customer, then edit the contact on the customer's Contacts tab and pick a Designation. Designations are picked from a list set up in Settings → Customers, Designations tab; see Managing Customers for the steps.

At least one of email or mobile is required. Both can be entered, but one must be provided.


Adding a Location (Service Address)​

Locations are the physical addresses where work is performed. Adding a location on creation is optional — but best practice is to add at least one so jobs can be created immediately.

To add a location during creation: Turn on the Add Location switch on the creation form. Hovering over it shows "Optionally specify customer location (can be added later)".

Location fields:

FieldRequired?Notes
NameYesA descriptive label: "Head Office", "Cape Town Branch", "Site A"
AddressYesOne box with room for five lines. The first line is the street address, and each further line is extra address detail
Address TypeYesDelivery (service address) or Postal (mailing address)
CountryYesDefaults to South Africa

The location added on the creation form becomes the customer's primary address of its type automatically. The first delivery or postal location always defaults to primary.

GPS coordinates can also be set with the Use latitude / longitude tick box (useful for routing and mapping features).

Note: You can add locations after creation from the customer page. You don't have to do it during creation — but you'll need a location before you can create most jobs.


Step-by-Step: Creating a Company Customer​

  1. Customers → + New Customer
  2. Toggle "My customer is a company" ON
  3. Enter Company Name
  4. Enter Customer Code (or leave blank to auto-generate)
  5. Fill in classification fields: Customer Type, Industry, Status (as required)
  6. Enter the primary Contact: first name, last name, email or mobile
  7. Optionally: turn on Add Location and fill in the service address
  8. Fill in any required custom fields
  9. Click Create

The customer is created and you'll land on the customer detail page.


Step-by-Step: Creating an Individual Customer​

  1. Customers → + New Customer
  2. Leave the company toggle OFF
  3. Enter the contact's First Name and Last Name
  4. Enter Email Address or Mobile Number (one required)
  5. Fill classification fields as required
  6. Optionally add a location
  7. Click Create

The customer name will be auto-set to "First Last".


After Creating​

Once created, you can:

  • Add more contacts (Contacts tab, or Add contact in the Primary Contact picker on the Details tab)
  • Add more locations (Locations tab, or Add delivery address and Add postal address in the pickers on the Details tab)
  • Create a job directly from the customer page (Options → Create Job). The job opens with this customer locked in, and only the contact and location can be changed
  • Choose which contact and addresses are the primary ones with the pickers on the Details tab (see Managing Customers)
  • Trigger a sync to the accounting system (if integration is live)

Common Mistakes​

  • Check if "Include Inactive Customers" is toggled OFF in the list filter — newly created customers are active, but the filter may exclude them if there's an issue
  • Check the customer list isn't filtered by a Customer Type or Status that excludes them
  • Try searching by customer code or email instead of name

"The customer was created twice"​

ServCraft blocks exact duplicates (same name or same code), but records with slightly different spellings can still both exist. Customers cannot be merged on ServCraft. Deactivate or archive the duplicate record to hide it from searches. Manually reassign any active jobs, quotes, or invoices from the duplicate to the correct record.

"I need to change the customer from Individual to Company"​

This isn't directly supported after creation. You'd need to create a new company customer record and move any existing jobs/invoices there, or contact support. Plan for this during creation.

"The Customer Type I need isn't in the list"​

Customer Types are configured in Settings → Customers → Types. You need admin access to add new ones.