19 User Guide

Company Directory

The Company Directory is the single list of the subcontractor and supplier companies your company works with across all projects.

1. What it is for

The Company Directory is the single list of the subcontractor and supplier companies your company works with across all projects. A company's details (name, tax ID, address, phone, contacts, payment terms) are written once in the directory; when the company is added to a project, the details are copied to that project's subcontractor or supplier record. When the address changes, it is corrected once in the directory and reaches every project the company is linked to.

The directory also keeps the company-level information: bank accounts and company documents (tax registration certificate, quality certificate, general insurance, licences). These too are entered once and appear in every project the company is linked to.

The directory carries no amounts. Progress payments, deliveries, account entries and payments stay in each project's own subcontractor, supplier and account records, as they do today; a payment to Demirci in one project does not settle the balance in another.

2. How to open it, who can see it

The directory has two entry points, and both open the same list:

  • In the sidebar: Management & Finance › Company Directory. Whichever project it is opened from, the list shows all of the company's firms; the top of the page reads Company-wide · all projects.
  • On the Projects screen, the Company Directory button above the project cards. It opens without choosing a project; Back to projects returns.
AccountWhat it sees and does
Company administratorSees the directory; adds companies, edits their details, deactivates them and deletes a company that is not linked anywhere. Sees bank accounts and is the only one who adds, changes and deletes them. Creates the "In-house team" company
Anyone with view permission for Subcontractors, Suppliers or Accounts in any projectSees the directory. Edits a company's details if they have edit permission for the matching module (subcontractor or supplier) in a project the company is linked to. Adds and edits company documents. Sees bank accounts only for a company linked to a project where they can view Accounts, read only
ViewerWith view permission, reads the directory and company documents; the bank tab is not drawn
Subcontractor accountDoes not see the directory at all (neither in the menu nor on the Projects screen)
NoteIf the server has not enabled the directory yet, the menu item and the Projects button are not drawn at all; the subcontractor and supplier forms work as they do today.

3. Anatomy of the screen

Top bar. The page title and, below it, the number of companies (4 companies · 0 inactive). On the right Refresh, for an administrator Add in-house team (if the company does not have one yet) and New company.

Search and filter. The Search the directory box searches names, tax IDs and contacts. Show inactive too adds deactivated companies to the list. Clients only (shown when a company is the client of a project) narrows the list to client companies; this filter replaces the old Customers page.

Table. One row per company: Company, Roles, Projects, Tax ID, Phone. The Roles column shows the company's role in projects as badges: Client · 1 project where it is the client of a project, Supplier · 2 projects, Subcontractor · 1 project, and Concrete for a subcontractor with concrete pours. The same company can be both supplier and subcontractor; roles come from the linked project records. If one of the company documents has expired or expires within 30 days, the row shows a Document expired or Document expiring badge.

Company panel. Opens when you click a company name. Badges at the top, then three tabs:

TabWhat it contains
DetailsTax ID, tax office, country, phone, email, website, default payment term, category, address, payment terms, notes, Contacts and Linked project records (which project as subcontractor, which as supplier)
DocumentsThe company's documents that apply in every project, with their expiry status
BankBank accounts; drawn only for someone who may see them

The "In-house team" company has no Documents or Bank tab; no bank accounts or documents are kept for it.

4. Fields

Company form (New company, or Edit company in the panel):

FieldMeaningRequired
Company name / titleLegal name; copied as is to project recordsyes
Short nameShown in lists instead of the legal nameno
Tax ID · Tax office · CountryA second company with the same tax ID in the same country cannot be createdno
Address · Phone · Email · WebsiteDetailsno
Default payment term (days)Written to the account when the company is linked to a new project; each project then keeps its own termno
Payment termsFree text, e.g. 30% advance, balance on deliveryno
Category · NotesFree textno
ContactsUp to 20 people: full name, role, phone, email, noteno

Bank account form (administrator only):

FieldMeaningRequired
Bank · BranchName of the bank and branchbank yes
IBAN / account no.Spaces are fine; a value starting with two letters is treated as an IBAN and its country length and check digits are verified. In countries that do not use IBAN, enter the account numberyes
Account holderThe account holder; the company name shows in the box as an exampleno
SWIFT / BIC8 or 11 charactersno
CurrencyDefaults to the company currencyno
Default accountShown at the top of the list with a Default badge; making another account default clears the previous one. The company's first account comes tickedno
NoteFree textno

Company document form (Add document):

FieldMeaningRequired
Document typeTax registration certificate · Quality certificate · Insurance · Licence / qualification · Health & safety · Otheryes
Sub-typeFree text; suggestions such as ISO 9001 for quality and Employer’s liability for insuranceno
Document no. · Issued byFor insurance the labels read Policy no. and Insurerno
Validity: Start · EndWith no end date the document does not expire and raises no warningno
Note · Document filesUp to 5 files (PDF or image)no

5. Step by step

5.1 Adding a company to the directory

  1. Click New company.
  2. Enter the name and whatever details you know; add contacts with Add contact if needed.
  3. Press Save. The panel opens with the new company.

If the same tax ID is already registered to another company in the directory, nothing is saved and an Open … in the directory button appears in the form; use the existing company instead of creating it a second time.

5.2 Adding a company to a project from the directory ("Pick from directory")

  1. In the project, on the Subcontractors or Suppliers page, click New subcontractor / New supplier.
  2. Type the company name in the Pick from directory box at the top of the form; the list shows rows such as Demirci A.Ş. · in 1 project.
  3. Pick the company. The record is created in the project and the form opens with the details filled in; complete the project-specific fields (contact, scope of work, rates) and save.

If you create a company that is not in the directory with the form, it is also added to the directory when saved ("… was also added to the directory."). If the tax ID belongs to another company in the directory, the record is not linked and the strip shows a Use … from the directory button.

NoteOnly an administrator can open accounts. When a site manager adds a company from the directory, the project record is created, no account is opened, and the strip says so.

5.3 Linking a project record to the directory, or unlinking it

The directory strip sits at the top of the subcontractor or supplier panel:

  • If the record is linked, it reads In directory: Demirci A.Ş.; Open in directory opens the company panel and Unlink removes the link. After unlinking, the copied details, the account and all records stay in place; changes in the directory no longer reach that record.
  • If the record is not linked, it reads This record is not linked to the company directory.; a company with a similar name or the same tax ID in the directory is shown as a suggestion. In the Link to directory window the fields that differ appear side by side and you are asked Which details to keep: with Directory this record's details are replaced by the directory's; with This record the record's filled-in fields are written to the directory and reach the company's other projects too.

5.4 The "Different in this project" band

If a linked record's details differ from the directory (they may have been changed with an older version or on the Accounts page), the panel shows a Different in this project band listing each field as directory … · this project …. There are two buttons:

  • Apply to directory — this project's value is written to the directory and reaches every project the company is linked to (requires permission to edit the directory).
  • Restore from directory — the directory's value is written to this project's record.

5.5 Adding, changing and deleting a bank account

Administrator only Only a company administrator adds, changes and deletes bank accounts.
  1. Open the Bank tab in the company panel and click Add account.
  2. Enter the bank, the IBAN and, if needed, the SWIFT code and currency. If the IBAN check digits do not match, nothing is saved and the warning "The IBAN check digits do not match; a digit may be mistyped." appears.
  3. Press Save. Use the pencil on a row to change it and the bin to delete it.

Every addition, change and deletion is written to the activity log with the last four digits of the IBAN. For 30 days a Bank details changed warning stays at the top of the company panel, e.g. "Bank details were changed 3 days ago by Ali Yılmaz. Confirm the account with the company by phone before making a payment."

5.6 Adding a company document

  1. Open the Documents tab in the company panel and click Add document.
  2. Choose the document type, enter the document number, issuer and validity dates, and attach the file.
  3. Press Save.

Each row in the list has a status badge: Valid, 12 days left, Expires today, Expired · 6 days ago, No expiry and Renewed. A document within 30 days of expiry raises a warning; if a document of the same type and sub-type with a later end date has been entered, the older one counts as Renewed and raises no warning. For an inactive company the documents are shown but no warnings are raised.

5.7 Company documents in project panels

  • The Documents tab of the Subcontractors panel shows the project-specific documents (insurance policy, health and safety papers) together with the company's directory documents; company documents carry a Company document badge. The expiry warning, the badge in the list and the document summary at the top of the page count both. A company document is read only there; open the company in the directory to add or correct one.
  • In the Suppliers panel, the Documents tab of a company linked to the directory shows the company documents only (suppliers have no project-specific documents).

5.8 Deactivating or deleting a company

Deactivate removes the company from the list (it shows with Show inactive too) and stops it being added to new projects; linked project records stay in place. Delete appears only for an administrator and only on a company that is not linked to any project; a deleted company can be restored from the deleted records archive in Settings.

5.9 Linking the project's client to the directory

The project's client is also a company in the directory; there is no separate customer list.

  1. Open Overview in the project and press Edit details.
  2. In the Contract section type at least two letters of the company name into Pick the client from the directory and choose the company from the list. If it is not in the directory, add it first (5.1); inactive companies and the In-house team do not appear.
  3. Press Save. The client name is written from the directory and the company shows in the directory with a Client · 1 project badge.

On a linked project the box is replaced by an In directory: company name line: Open in directory opens the company panel, Change lets you pick another company, Unlink removes the link when you save (the client name stays as text). When the company's name changes in the directory, the client name of the linked projects changes too. If the client name was changed in the project with an older version, the Different in this project band appears; Restore from directory writes the directory name again when you save. An administrator can also pick the client with the same box when creating a new project. The company panel has a Projects where it is the client list.

Linking and unlinking the client is open to administrators and to people with edit permission for Overview in that project; viewer and subcontractor accounts cannot link.

6. Things to know

  • Details are written from the directory; projects keep a copy. A correction made in the directory reaches every linked project together. A correction made in one project (with an older version or on the Accounts page) stays in that project only and shows up in the Different in this project band.
  • Payment term, account code, rates and contact person are project-specific. The directory's payment term is written to the account only when the company is linked to a new project.
  • The company's bank details are not copied to project accounts. The account's own bank field keeps whatever is written there; statements and confirmation letters use that.
  • Confirm an IBAN change by phone. A "our account number has changed" email is a well-known way of payment fraud; that is why bank changes are administrator only and stay visible at the top of the panel for 30 days.
  • No amounts move to the directory. The company's balance, purchases and payments in each project stay in that project's own account.
  • Customers. The old Customers menu item has been removed; a customer joins the directory through the project it is the client of (5.9) and is listed with the Clients only filter. The customer account is still opened on the Accounts page by choosing Customer as the type.
  • The client link does not touch any amounts. Linking and unlinking only change the project's client name and link; account, interim payment and collection records stay as they are.
  • Subcontractors and Suppliers — "Pick from directory", the directory strip, the difference band and the Documents tab.
  • Accounts — the company's ledger, payments and bank field in each project.
  • Projects — opening the directory without choosing a project.
  • Settings — the deleted records archive.