Add, Change, and Delete values of various Kompass fields
Table of Contents
Abandoned Reasons, Categories, Confirmations and Sources
Introduction
If you spend some time in Kompass BMS, you will find several fields with drop-down menus. Many of the values in these menus are pre-filled when your Kompass account is created. You can add, change, and delete these values in Kompass Admin. Only users with the appropriate permissions can access Kompass Admin for your organization, and you can do so by adding "/admin" after your Kompass webpage. For instance, the link will appear as follows: (your-Kompass-server-name).kompassbms.com/admin. In this article, we will show all the main sections of Kompass Admin and demonstrate how you can modify your choices.
The Kompass Admin home page includes the following items:

- Groups: each group collects related categories.
- Categories: select a category to view and change its entries.
- Recent actions: the latest changes made in Kompass Admin.
- Log out and the light/dark theme switch.
Upon selecting a category, you will be taken to its list page.

- The sidebar gives quick access to the other groups and categories.
- The list shows all existing entries. Some entries have an end date. Even though they remain in the database, they are not shown in Kompass after the end date. This is useful for items that cannot be deleted because they are already assigned to Kompass entries. If a category has an end date, some existing clients/organizations might still be listed under it.
- Each category has an action menu at the top of the list. Most frequently, this is where the delete option is located. Select the tick-box next to the items that need to be edited, choose the relevant action, and click "Run".
- If you need to add a new item, click the Add button at the top right of the page.
Please note that this article is relevant if you need to add and/or change a few values. If you need to add/change more than ~15 entries, please contact the Kompass BMS helpdesk, and we will be able to batch change them for you.
If you try to create new entries for some of the categories, you will be asked to assign an organization. Most companies have just one organization, but if your company has more than one, you might have to assign the categories to all of them (if needed).
Please note that attempting to delete any of the items below will usually affect other entries that are already linked to them. Kompass Admin will not allow you to delete those items before deleting the linked entries. In general, it is better to set an end date for most of the items rather than deleting them.
Calendar
Holidays
Under the Calendars group, Holidays is the only category we will have to visit. This is where we add any bank holidays or vacations. Add them manually at the beginning of each year. You can find how to add these holidays in this article https://support.kompassbms.com/article/118-add-public-bank-holidays. It is important to set your bank holidays/vacations in Kompass to assist with payroll calculations.
Clients
Clients are called "Organizations" in Kompass when your organization uses the US locale.
Client Categories
Client/Organization categories are a required field on the organization form.

To add a new client/organization category, click the "Add" button in the top right.

Enter the name and, if needed, a start and end date. Under Assigned Orgs, click "Add another Org" and select your organization from the drop-down menu.
You can also edit existing client categories by clicking on their link.
Clients
There is no need to add new clients in this category since you can do so in Kompass. However, you will need to access this page for merging clients.

If you have the merge permission, select the clients that need to be merged, choose "Merge clients" from the actions drop-down menu, and click "Run". On the following page, select the target client and click "Merge".

When merging clients, all contacts, projects, comments, invoices, payments, and purchase orders will be merged into the target client.
IMPORTANT: The data on the target client (address, category, etc) will not be changed. Therefore, any custom data on the other clients will be lost.
VERY IMPORTANT: Clients will not be merged in SugarCRM/QuickBooks/Sage. This can lead to inconsistencies between these systems and Kompass which might need to be addressed manually.
Types
Client/organization types can be added to help on grouping clients/organizations.

Use this page to add, edit, and delete a type. When adding a new client type, you can select the color it will appear as.

Company
This group has some of the most important categories in Kompass Admin.
Departments and Services
You can add, change, and deactivate departments and services. Be extra careful before deleting a department or service. You can find departments and services in nearly every screen of Kompass, from setting them in proposal/quote items to the employees' page, filters, in the dashboard, and many more.
When creating a new department, add the name, dates, and the organizations it is available for, then set whether it is billable, a predefined gross margin, and a color for the dashboard charts. Services have the same billable, gross margin, and color fields, but take their organizations from their department. A service with no gross margin inherits the department's; a department with none inherits the organization's.

Orgs
You should not need to add or delete an org. To change settings, select your org. There are numerous items that can be changed within this page. Treat with caution! Most of these changes will not just add or remove a value from a drop-down menu, but they have the ability to greatly impact the way your Kompass account works.
We will go through a list of the items that you could change on your org page.
General

- Gross Margin for your entire company.
- VAT/Tax number. It can then be called and shown on your invoice templates.
- Payment days.
- Location of your office. Helpful for calculating distances from your office to projects and/or to employees' home addresses (if added). Distance can be calculated "as the crow flies".
- Map bounds. Kompass uses these bounds as the starting view of the map on a proposal.
- External links. You can add a link to an external page and it will appear at the bottom of your main navigation in Kompass.
Additional Configuration

- Set the default VAT/tax rate.
Contacts Configuration

- Contact source is normally an optional field. You can make it mandatory by ticking this checkbox.
- Equally for the title of the contact person.
Diary Configuration

- Define the week start date. It can either be Sunday or Monday.
-
Decide whether you want to record travel and/or breaks on your timesheets. Also, select whether users will have to add their hours or pick the exact times they start and end their work. Finally, show or hide the non-billable extra field.

- Depending on your timesheet policies, traveling and breaks can be included in or left out of recorded, paid, and billable hours. Select the ones to include in each field. To select more than one, hold Ctrl (or Cmd on a Mac) while clicking.
- You can define variable hours for each day of the week in each schedule, and set different schedules for users. Here you are defining the default schedule.
- Your Kompass account might have several schedules for different orgs. In here, you are selecting those which are relevant for the current org.
- When employees start their timesheet timer, Kompass can record their location and keep track of them while working and traveling to and from site. You can deactivate this option. Kompass will not record any location until the user allows permission.
- You can allow users to record timesheets into the future (never, end times only, or both start and end times). We generally advise against it.
- You have the ability to set your own overtime rules in Kompass. For example, if your employees are earning double rates for hours recorded during the night, Kompass can run these calculations. Please reach out to us for additional assistance.
Leave Configuration

- Select whether time off will be shown in days or hours.
- For customers who use days as their time off unit, this sets the number of hours in a day.
- Define the rounding of days. The default is set to half days.
- Calculate allowance accrual until year-end or from the start of the year until today.
Project Configuration

- Project source could be either a mandatory or an optional field. You can define that in here.
- Confirmation Warning: If you do not have a confirmation received for your projects, like a PO, a contract etc, Kompass will raise a warning. You can deactivate it if you want to.
- Let's think of a rate project (T&M) where you have some hours of work that you have not yet invoiced. You are on the overview of the project and want to mark it as fully invoiced. If this checkbox is ticked, Kompass will not allow that until you raise an invoice to charge your client for the pending worked hours.
- Lock Days: by locking a project after a set number of days, users cannot edit it anymore. Locking occurs the set number of days after the fully invoiced date.
In case you need to unlock a project, go to the Projects group and the Projects category, open the project and find the "Project phase entries" table. Clear the date in the "Completed" column of the "Invoiced" row. It is good practice to leave a note in the "Notes" column of that row for future reference. You need permission to override locked projects to edit a locked project.

Contacts
Sources
You can set a source for each contact to assist you with CRM analysis. As in many category entries, when adding a new entry, select the name, start and end dates, and organizations. In this case, you can also select whether source details are required.

If ticked and selected in Kompass, "Source Details" becomes a mandatory field.

Equipment
Categories
The equipment schedule view has a category filter that lists all equipment categories.

To add, change, or delete categories, please go to the Equipment, Categories page.

As always, add the name, a color for the schedule, and the dates. To make the category available to an organization, add it under Equipment Configuration on the Org page.
Owners
Add, change, and remove equipment owners from this page.

Expenses
Payment methods and Types
Add, change, and remove payment methods and expense types through these pages.

Note that you will have to allocate these types and payment methods under your organization.

Click "Orgs" under Company and select your Org.

Scroll down until you find the "Expenses Configuration" section. If it has no configuration yet, click "Add another Expenses Configuration".

Move the types and payment methods you want this organization to offer into the "Chosen types" and "Chosen payment methods" boxes: select them in the available boxes and click the right arrow.
Leave/Time Off
Types
This is the page you will visit to change the available leave types in your Kompass account.

Projects
Abandoned reasons, Categories, Confirmations, and Sources

Similar to other categories seen above, select any of them and then add, edit, or delete any options. All of these categories appear on the Overview tab of a proposal/project.

Quote Items
Cost options
This is the category where you add the cost options that appear under Staff Costs, Equipment Costs, and Subcontractors / Other when you edit a proposal item.

You can find how to add, edit, and deactivate such costs in this article: https://support.kompassbms.com/article/120-change-quote-item-cost-rates
Quote item Templates
Each employee might have their own proposal item templates when they are creating their proposals.

Occasionally, some of these templates may need to be made available to the entire organization. To do this, go to this category, search for the template you wish to display across your organization, and under "Template shared", choose "Org".

A template can also be shared with the creator's department only, or with everyone.
Users
Users
There are numerous options that can be edited under each user's account. This article explains the time off allowance and other selected user settings: https://support.kompassbms.com/article/119-add-time-off-allowance-and-other-api-fields-for-users. Additionally, if you need to reset a user's password, you can do so from this page as well. Details on how to reset it can be found in this article: https://support.kompassbms.com/article/121-reset-users-password
