Skip to content
On this page

Customers and suppliers

Last updated: 6 November 2026 · 5 min read

Contacts are the people and shops you buy from and sell to. Keep every customer and supplier here so sales, purchases, payments and balances all land on the right name.

Before you start: You need permission to add customers or suppliers. To bring in many contacts at once, see Import contacts.

Add a customer or supplier#

  1. Go to Contacts > Customers (1) to see your customers, or Contacts > Suppliers to see your suppliers. Use the Customers and Suppliers switch (2) at the top of the list to move between them.
  2. Select Add (3).

Customers list with the Customers menu item, the Suppliers switch and the Add button marked

  1. Choose the Contact type (1): Customers, Suppliers or Both.
  2. Choose Individual or Business. For an individual, enter the Prefix (such as Mrs), First Name and Last Name. For a business, enter the Business Name and the contact person.
  3. If this is a customer, you can choose a Customer Group (2). See Customer groups and group pricing.
  4. Enter the Mobile number (3). It is required. Add an Alternate contact number, Landline or Email if you have them.
  5. Leave Contact ID empty to let BillBook number it for you (for example CO0030, then CO0031), then select Save.

Add a new contact form with Contact type, Customer Group and Mobile marked

BillBook shows Contact added successfully and the contact appears in the list.

If the mobile number already belongs to another contact, BillBook asks Are you sure ? and shows Already registered for that contact's name before it saves. Select Cancel (1) to go back and fix the number, or OK (2) if two contacts really share a number. The same check runs for a Tax number that is already in use.

Are you sure warning that the mobile number is already registered, with Cancel and OK marked

Key contact fields#

These fields are on the main form:

  • Assigned to (1): the staff who look after this contact. See the next section.
  • Opening Balance (2): the amount the contact already owes you (or you owe them) from before BillBook. See Opening balances for contacts.

Add a new contact form with the Assigned to and Opening Balance fields marked

Select More Informations to open the rest of the form:

  • Tax number: appears on invoices. For a customer who is registered for VAT, tick VAT-registered (1) as well. BillBook then needs a 9-digit Tax number and Address line 1 before it saves the contact, because the Sri Lanka VAT tax invoice prints the purchaser's TIN and address. The box is offered to Sri Lankan rupee (LKR) businesses only. See Invoice layouts.
  • Pay term (2): how many days or months a contact has to pay. It fills in the pay term on new sales and purchases for that contact.
  • Credit Limit (3): the most a customer can owe you. See below.
  • Address fields (Address line 1, City, State, Country, Zip Code) and more detail such as Landmark and Street name.
  • Custom Field 1 to Custom Field 10: extra boxes you can use for anything you want to keep with the contact. You can rename them, see Custom fields.

More Informations section with VAT-registered, Pay term and Credit Limit marked

Assign contacts to users#

Use Assigned to (1 on the earlier picture) to link a customer or supplier to one or more of your staff, for example the sales rep who looks after that shop. Choose the users from the list. Later you can filter the contact lists by Assigned to.

Set a credit limit#

Set Credit Limit (3) under More Informations, either when you add the contact or later with Edit.

  • Leave it blank for no limit.
  • Enter an amount, for example Rs. 200,000.00, and BillBook stops a sale that would take the customer's unpaid total above it, with the message Customer Credit Limit Exceeded. A sale that is paid in full is not checked.
  • Enter 0 if the customer must never buy on credit.

On the customer's page, the Credit Limit card shows the limit and how much is still Available.

To give every new customer a starting limit, enter a Default credit limit under Settings > Business Settings, on the Contact tab.

Change the walk-in customer name#

BillBook creates one Walk-In Customer for quick sales where you do not take a name. It cannot be deactivated or deleted, and the screens have no setting to rename it. If you need a different name, ask BillBook support to change it for you.

Activate or deactivate a contact#

Deactivate a contact you no longer deal with. They are hidden from the pick lists on new sales and purchases, but their history stays.

  1. On the list, open the arrow next to View on the contact's row.
  2. Select Edit (1) to change details, or Deactivate (2) to switch the contact off.
  3. To bring the contact back, open the same menu and select Activate.

Customer row menu with Edit and Deactivate marked

The same menu has Pay, View, Ledger, Sales, Documents & Note and Delete. Suppliers work the same way, and their list shows Total purchase due instead of sale due.

Suppliers list with the Suppliers menu item and the Add button marked

Watch the video

Tutorial 4: Customer credit, dues and returns in BillBook (3:17)