Customer

Contract Hub — Customer identity, financials, review, compliance, billing & invoice profiles
🎯 Purpose

The Customer module manages all customer (client) records for sell-side contracts. Each customer holds contact details, invoice profiles (with optional NDA generation), and a billing configuration tab where commodities, locations, users-to-bill, cost rates, and data collection schedules are defined. Customer billing data feeds directly into the Cost Tracker for cost monitoring and reporting.

👤 Roles & Access
RoleAccess
AdminFull access — create, edit, delete customers and billing configurations.
Super UserCreate and edit customers. Configure billing tabs.
End UserView-only access to customer records.
CustomerView their own record and invoice profiles via the portal.
SupplierNo access.
🔗 Dependencies
Upstream (requires)
Organisation must exist. Cost Center (Commodities, Locations, Users to Bill) for billing configuration. Regions in Catalogs.
Downstream (feeds into)
Contract — Sell-side contracts reference a Customer record.
Cost Tracker — Billing data feeds cost tracking.
Document Signature — Invoice Profile NDAs are tracked here.
🚀 Related Flows
Manual Contract — Customer selected for sell-side contracts.
Cost Tracking — Customer billing configuration is a key step.
Document Signatures — Customer NDA signature path.

1. Overview

The Customer module is where the Admin or authorised user creates and manages customer records. Each customer captures identity, financial, review, compliance, and billing information. Customers are a key part of the Sell-side contract flow — once a customer is created, contracts can be raised against it.

Customer Billing & Cost Tracking Flow

Cost Center items + rates Customer Billing Tab commodity + location + user + schedule Sell-side Contract Cost Tracker tracks spend

In edit mode, two additional tabs become available: Contracts (listing all contracts linked to this customer) and Invoice Profile (used during contract creation to manage NDA signing and billing identity).

Prerequisites

2. Opening the Customer List

  1. In the left navigation, under Contract Hub, click Customer.
  2. The Customer List page shows all customer records. Each row displays key details including Name, Reference, Region, Risk Rating, and Start Date.
  3. Use Show entries, the filters and Search to locate a customer.
Customer Listing

Customer Listing

Customer Filter Option

Customer Filter Option

3. Adding a Customer

The Add Customer form has a top section for core details and a lower panel with tabs for Financial, Review, Compliance, and Billing information.

Add Customer

Add Customer

Note: The banner at the top reads "Please add below fields before adding Customer: add Commodity, add Region, add Connector." Ensure these prerequisites are in place before proceeding.

3.1 Core Details

  1. Click Add New on the Customer List page.
  2. Organisation is pre-selected based on your login.
  3. Select a Region (required) — sourced from Organisation → Catalogs (Type = Region).
  4. Select one or more Departments (required) — sourced from the Department module.
  5. Enter the customer's Name (required).
  6. Optionally enter a Contact Number.
  7. Enter a Reference (required) — a unique short code to identify this customer.
  8. Optionally enter an Address.
  9. Enter the Customer Email (required).
  10. Select a Start Date (required).
  11. Select a Customer Risk Rating (required) — Low, Medium, or High.

3.2 Financial Tab

Captures the customer's financial year end and credit check details.

  1. Select the Financial Year End Date — Month and Day.
  2. Tick Existing Relationship if this is not a new customer.
  3. Under Credit Check, enter the Credit Check Company name.
  4. Enter the Total Spend amount.
  5. Click Save.

3.3 Review Tab

Configure periodic reviews for this customer. The system automatically schedules review dates based on the start date and frequency, and sends email notifications to the reviewer.

Customer Review Tab

Customer Review Tab

  1. Select a Review Start Date.
  2. Enter the Reviewer Email — the person who will receive the review notifications.
  3. Select a Review Frequency — 1 Month through to 12 Months. The system calculates the next review dates from the start date at this interval.
  4. Select a Notification Message — sourced from the Notification module. This is the email template sent to the reviewer.
  5. Optionally tick Automatic Report — when enabled, the system generates a customer performance report and attaches it to the review notification email. The reviewer receives both the notification and the report in a single email.
  6. Click Save.
Note: Once saved, the system schedules review dates in the background based on the Start Date and Frequency, and sends the selected notification template to the Reviewer Email at each scheduled date. If Automatic Report is ticked, a performance report is generated and included as an attachment with each review email.

3.4 Compliance Tab

Track compliance documents related to this customer (for example, certifications, insurance, regulatory approvals). Multiple documents can be added.

Customer Compliance Tab

Customer Compliance Tab

  1. Click + Add Document to add a compliance document row.
  2. Enter the Certificate name.
  3. Select the Expiry Date.
  4. Enter the Reviewer Email — the person who will be notified before expiry.
  5. Select a Notification Message — the email template used for the expiry notification.
  6. Repeat for additional documents as needed.
  7. To remove a document, click the red Remove button on its row.
  8. Click Save.

3.5 Billing Tab

Configure billing details for the customer. Items, locations, departments and users are sourced from the Cost Center and Department modules. Usage data is fetched from a Data Connector on a schedule and is further used in the Cost Tracker to generate costs.

Customer Billing Tab

Customer Billing Tab

Commodities (left panel):

  1. Select one or more items from the left panel. These are Commodities sourced from Cost Center → Commodity.
  2. Click Add to move them to the billing table on the right.
  3. For each commodity in the table, enter the Minimum Cost and Cost Per Unit.
  4. Select a Location — sourced from Cost Center → Location.
  5. Select a Department — sourced from the Department module.
  6. Select a User To Bill — sourced from Cost Center → User to Bill.
  7. To remove a commodity, select it and click Remove.

Billing Configuration:

  1. Select a Subscription Type.
  2. Enter the No. Of User(s).
  3. Select a Data Connector — a Data Connector configured in Platform Config → Connectors. This defines which external database and table to read usage data from. The connector must be created and tested in the Connectors module before it appears here.
  4. Click the Schedule button to configure the data fetch schedule — this determines how often the system pulls usage data from the connected database. The Schedule popup lets you choose interval-based (every X minutes/hours) or time-based (daily, weekly, monthly, yearly) scheduling. See the Schedule Configuration section for full details.
  5. Select a Billing Period and Billing Date.
  6. Click Save.
Note: Usage data is fetched from the selected Data Connector based on the configured schedule. This data is further used in the Cost Tracker module to generate cost reports for the customer.
Important — Customer Account Auto-Creation:

When a customer is created, the system automatically creates a user account for the customer using the Customer Email and Name, with the role set to Customer. The customer receives login credentials and can sign in to Contract intELIEgence to view their own contracts and a dashboard filtered to show only their data. No manual user creation is needed — this happens automatically on Save.

4. Editing a Customer

Click a customer name from the Customer List to open the Edit Customer screen. All core details and tab data can be updated. In edit mode, two additional tabs become available:

4.1 Contracts Tab (Edit Mode Only)

Lists all contracts that have been created for this customer. This is a read-only view from the customer's perspective.

Customer contract tab Only available in edit mode, It shows contract list for this customer

Customer contract tab Only available in edit mode, It shows contract list for this customer

The table shows:

ColumnDescription
RAGRisk indicator — Red (High), Amber (Medium), Green (Low).
NameContract name. Click to navigate directly to the contract record.
Contract #Contract number.
ValueContract value.
BR / CRBusiness Risk / Contract Risk indicators.
StatusCurrent contract status (e.g., Passive, Active, Draft).
SupplierAssociated supplier (if applicable).
Start DateContract start date.

4.2 Invoice Profile Tab (Edit Mode Only)

Manages the invoice profiles for this customer. Invoice profiles are used during contract creation — when you select a customer while creating a contract, the relevant invoice profiles are listed for selection. Multiple contracts can share the same customer but use different invoice profiles.

Customer Invoice profile tab, only available in edit mode

Customer Invoice profile tab, only available in edit mode

The table shows each profile's Name, Email, Client NDA (downloadable document), and Status.

4.3 Adding an Invoice Profile

Add Invoice Profile

Add Invoice Profile

  1. On the Invoice Profile tab, click Add New.
  2. Enter the invoice profile Name (required).
  3. Enter the Email (required).
  4. Under Client NDA, optionally click Choose file to attach an NDA document.
  5. Click Save.
Important — NDA Signing Flow:
  • If a file is attached during profile creation, the profile status is immediately set to "Profile Completed".
  • If no file is attached, the system triggers the NDA signing flow: an NDA is generated from the Organisation → Templates (NDA Template), and sent via Docusign to both the Organisation Admin and the Invoice Profile email for signing. Once all parties have signed, the status changes to "Profile Completed".

All documents sent for signature can be tracked in the Document Signature module.

Important — Impact on Contract Status:
  • If the invoice profile linked to a contract has status "Profile Completed", the contract becomes Live.
  • If the invoice profile is not yet completed (NDA still pending signatures), the contract remains in Draft mode. Once the profile is completed, the contract automatically moves to Live state.

5. Deleting a Customer

  1. On the Customer List page, tick the checkbox next to one or more customers.
  2. A Delete button appears.
  3. Click Delete and confirm.

6. Bulk Import

Contract intELIEgence allows you to import multiple customers at once using a pre-formatted Excel template. This is useful when migrating data from another system or when you need to create many customer records in a single operation.

6.1 How to Import

  1. On the Customer List page, click the grid icon in the top-right corner to reveal a dropdown menu with + Add and Import options.
  2. Click Import to open the Import dialog.
  3. Select an Organisation from the dropdown.
  4. Click Import Template to download the pre-formatted Excel template for customers.
  5. Fill in the Excel template with the customer data you wish to import (see the template columns below).
  6. Click Choose File to select the completed Excel file.
  7. Click Submit to import the records.
${img('Import', 'Screenshot 2026-05-31 at 9.27.14 PM.png')} ${img('Import', 'Screenshot 2026-05-31 at 9.27.22 PM.png')}

6.2 Import Template Columns

FieldDescription
nameCustomer name.
referenceUnique customer reference code.
addressCustomer address.
contactNumberContact phone number.
emailCustomer email address.
reviewStartDateReview start date.
reviewFrequencyReview frequency (e.g. 1 Month, 3 Months).
reviewerEmailReviewer email address.
notificationMessageNotification message template for reviews.
creditCheckCompanyCredit check company name.
riskCustomer risk rating (Low, Medium, High).
financialEndDayFinancial year end day.
financialEndMonthFinancial year end month.
relationshipNoteExisting relationship note.
startDateCustomer start date.
regionNameRegion name (must exist in Catalogs).
departmentDepartment name (must exist in Departments).
Note: Ensure that referenced entities (regions, departments) already exist in the system before importing. The import will match records by name. Download the template first to see the exact format and any example data.

7. Tips

8. Troubleshooting

IssueResolution
"Please add Commodity / Region / Connector" bannerAdd the required items: Regions in Organisation → Catalogs, Commodities in Cost Center, Connectors in the Connectors module.
Region dropdown is emptyAdd Region catalog items in Organisation → Catalogs (Type = Region).
Department dropdown is emptyCreate departments in the Department module first.
Billing commodities list is emptyAdd Commodities in Cost Center → Commodity.
Invoice Profile stuck on pendingCheck that eSignature is configured in Organisation → Settings and that all parties have signed the NDA via Docusign.
Contract remains in DraftThe linked Invoice Profile is not yet completed. Complete the NDA signing flow or attach a file directly to the profile.
Review notifications not being sentVerify Outgoing Mail is configured, the Notification Message template exists, and the Reviewer Email is correct.
Contracts tab not visibleThis tab only appears in Edit mode. Open an existing customer to see it.