Your Contract Management Data Template

Icertis
Your Contract Management Data Template

Your Contract Management Data Template

This template provides a comprehensive guide to collecting the essential data needed for analyzing your contract management process. It outlines key attributes to gather, critical activities to track, and practical guidance for extracting this information from your source systems. Use this resource to ensure you capture all necessary data for effective process mining.
  • Recommended attributes to collect
  • Key activities to track
  • Extraction guidance for your source system
New to event logs? Learn how to create a process mining event log.

Contract Management Attributes

These are the essential data fields required to construct a robust event log for comprehensive analysis of your contract management process.
3 Required 6 Recommended 12 Optional
Name Description
Contract ID
ContractId
The unique identifier for each contract managed within the Icertis platform.
Description

The Contract ID serves as the definitive case identifier, uniquely linking all events and activities related to a specific contract. This allows for a comprehensive, end-to-end analysis of each contract's journey, from its inception to its resolution.

In process mining, this attribute is fundamental for reconstructing the lifecycle of every contract. It ensures that all related activities, such as drafting, reviews, approvals, and execution, are correctly associated with the appropriate contract, enabling accurate measurement of cycle times and identification of process variations.

Why it matters

This is the primary key for process analysis, enabling the tracking of a contract's complete journey and ensuring data integrity.

Where to get

This is a core attribute of the Contract Agreement object in Icertis.

Examples
CTR-2023-00123MSA-2024-589ANDA-FN-00451
Activity Name
ActivityName
The name of the specific event or task that occurred at a point in the contract lifecycle.
Description

The Activity Name describes a specific step or milestone in the contract management process. These events are ordered by their timestamps to build the process flow for each contract.

Analysis of this attribute reveals the sequence of operations, frequency of different activities, and the overall structure of the process. It is used to identify common process paths, deviations from the standard procedure, and activities that cause rework or delays, such as multiple revision cycles.

Why it matters

It defines the steps of the process, which is essential for visualizing the process map, analyzing process flow, and identifying bottlenecks.

Where to get

This information is typically generated from event logs or workflow history tables within Icertis, which track the status changes and tasks performed on a contract.

Examples
Contract DraftedLegal Review ConductedContract ExecutedAmendment Initiated
Event Time
EventTime
The timestamp indicating when a specific contract activity occurred.
Description

This attribute records the precise date and time that an activity was started or completed. It is the temporal foundation for process mining, providing the chronological order of events for each contract case.

The Event Time is crucial for all time-based analysis. It is used to calculate cycle times between activities, identify waiting periods, measure the duration of specific phases like negotiation or approval, and pinpoint bottlenecks where contracts stall for extended periods.

Why it matters

This timestamp is critical for calculating all performance metrics, such as cycle times and durations, and for understanding the sequence of events.

Where to get

This is a standard field in Icertis audit trail or workflow history logs, associated with every recorded event.

Examples
2023-05-15T10:22:00Z2023-06-02T14:05:30Z2024-01-10T11:00:00Z
Activity Owner
ActivityOwner
The user or resource responsible for executing a contract activity.
Description

This attribute identifies the individual, team, or automated user who performed a given activity. It can be a specific user name, an employee ID, or a system account.

Analyzing the Activity Owner is crucial for understanding resource allocation, workload distribution, and performance. It helps answer questions like which users or teams are bottlenecks, who are the most efficient reviewers, and how work is distributed. This directly supports the 'Reviewer Workload Distribution' dashboard.

Why it matters

It allows for performance analysis by user or team, helping to identify workload imbalances and training opportunities.

Where to get

This information is usually available in the workflow history or audit trail data within Icertis, linked to each event.

Examples
John SmithLegal.Review.QueueSystem.AutoApproveSarah Chen
Contract Status
ContractStatus
The current state or stage of the contract in its lifecycle.
Description

This attribute indicates the overall status of the contract case, for example 'Draft', 'In Review', 'Awaiting Signature', or 'Executed'. This is typically a case-level attribute that reflects the last major milestone reached.

It is vital for operational dashboards like 'Contract Status And Throughput', which provide a real-time snapshot of the contract pipeline. It helps managers understand the volume of contracts in each stage and identify where work is piling up, enabling proactive management of the contract portfolio.

Why it matters

Provides a high-level view of the contract pipeline, essential for operational monitoring and managing throughput.

Where to get

This is a primary status field on the Contract Agreement object in Icertis.

Examples
DraftIn Internal ReviewExecutedTerminated
Contract Type
ContractType
The classification of the contract, such as Master Services Agreement or Non-Disclosure Agreement.
Description

The Contract Type categorizes agreements based on their legal or business purpose. This is a fundamental attribute for segmenting and comparing contract lifecycles.

Different contract types often follow distinct process paths and have different complexity levels and SLAs. Analyzing the process by Contract Type allows for targeted improvements, such as creating optimized workflows for high-volume, low-risk agreements like NDAs versus complex, high-value MSAs. It is essential for the 'Contract Variant Analysis' and 'Policy Compliance Score' KPIs.

Why it matters

Allows for process segmentation to compare lifecycles and compliance across different kinds of agreements.

Where to get

This is a standard attribute configured on the Contract Agreement object in Icertis.

Examples
Master Services Agreement (MSA)Non-Disclosure Agreement (NDA)Statement of Work (SOW)
Contract Value
ContractValue
The total monetary value of the contract.
Description

This attribute represents the financial worth of the contract, such as the total contract amount or annualized value. It is a critical business metric for prioritizing contracts and understanding financial impact.

In process mining, Contract Value is used to segment analysis and focus on high-value agreements. For instance, one can analyze if high-value contracts take longer to approve or negotiate. It also helps in risk assessment, as delays in high-value contracts can have significant revenue implications.

Why it matters

Enables prioritization and value-based analysis, helping to focus improvement efforts on the most financially significant contracts.

Where to get

This is typically a standard currency field on the Contract Agreement object in Icertis.

Examples
50000.001250000.002500.00
End Time
EndTime
The timestamp indicating when a specific contract activity was completed.
Description

This attribute captures the completion time of an activity. While StartTime marks the beginning, EndTime marks the conclusion, defining the activity's discrete timespan.

Having both a start and end time is essential for accurately calculating the processing time or duration of each individual activity. This enables analysis of which steps consume the most time, distinguishing between active processing time and idle waiting time between steps. It is key for dashboards like 'Approval Process Bottlenecks' and 'Drafting And Revision Efficiency'.

Why it matters

Enables the precise calculation of activity durations, helping to differentiate between processing time and waiting time.

Where to get

Similar to StartTime, this is found in Icertis audit trail or workflow history logs. Some events may be instantaneous, where StartTime equals EndTime.

Examples
2023-05-15T18:30:00Z2023-06-03T09:00:15Z2024-01-10T11:00:00Z
Owner Department
OwnerDepartment
The department to which the activity owner belongs.
Description

This attribute specifies the business department, such as Legal, Sales, or Procurement, associated with the user who performed the activity. It provides an aggregated view of resource involvement in the process.

Analyzing by department is key to understanding inter-departmental collaboration and handoffs. It helps identify systemic delays between departments, such as long waits for legal review after a sales submission, which is the focus of the 'Departmental Handoff Delays' dashboard.

Why it matters

Facilitates analysis of departmental performance and handoff efficiency, highlighting cross-functional bottlenecks.

Where to get

This data may need to be enriched by joining with an HR system or user directory, using the Activity Owner as the key. It may also be stored directly in Icertis user profiles.

Examples
LegalSalesProcurementFinance
Business Unit
BusinessUnit
The internal business unit associated with the contract.
Description

This attribute identifies the internal division or business unit that owns or requested the contract, such as 'Enterprise Sales North America' or 'Global Procurement'.

Similar to Department, this allows for a higher-level aggregation of the process data. It helps in comparing process efficiency and compliance across different parts of the organization, providing valuable insights for senior management and supporting strategic resource allocation decisions.

Why it matters

Enables high-level process performance comparison across different organizational units.

Where to get

This is often a key metadata field on the contract agreement, linking it to the organizational structure.

Examples
BU-North AmericaGlobal ServicesProduct Development
Counterparty Name
CounterpartyName
The name of the external party, such as a customer or vendor, in the contract.
Description

This attribute identifies the other party involved in the agreement. It provides essential context for analyzing interactions and negotiations.

Analyzing the process by counterparty can reveal patterns in negotiation cycles. For example, it can show if contracts with certain vendors consistently take longer to negotiate or require more revisions. This insight is valuable for strategic relationship management and for tailoring negotiation strategies, directly supporting the 'Negotiation Cycle Time And Rework' dashboard.

Why it matters

Allows for analysis of negotiation patterns and relationship performance with specific external parties.

Where to get

This information is stored as part of the contract's metadata, typically linking to a counterparty or vendor master data object in Icertis.

Examples
Acme CorporationGlobal Tech Inc.Innovate Solutions LLC
Document Version
DocumentVersion
The version number of the contract document.
Description

This attribute tracks the iteration of the contract document as it goes through drafting, redlining, and revisions. It is typically an integer or a major.minor version number.

Document Version is a direct indicator of rework. A high number of versions for a contract suggests multiple rounds of changes, which can be investigated to understand the root causes. It is a key input for calculating the 'Contract Revision Rate' KPI and for the 'Drafting And Revision Efficiency' dashboard.

Why it matters

Directly measures the amount of rework and revision a contract undergoes, highlighting inefficiencies in drafting and negotiation.

Where to get

Icertis maintains version history for all contract documents. This attribute can be extracted from the document's metadata or event log.

Examples
1.02.34.00.5
Expiration Date
ExpirationDate
The date when the contract is set to expire.
Description

This attribute stores the end date of the contract term. It is a critical date for managing the contract's lifecycle post-execution, triggering renewal or termination activities.

This date is essential for monitoring the effectiveness of end-of-life management. It serves as the baseline for the 'On-Time Renewal/Termination Rate' KPI, which measures whether renewal or termination processes are initiated and completed in a timely manner, avoiding unwanted auto-renewals or lapses in service.

Why it matters

Crucial for managing contract renewals and terminations, ensuring that end-of-life processes are handled proactively.

Where to get

This is a standard date field on the Contract Agreement object in Icertis.

Examples
2025-12-312026-06-302024-08-15
Is Standard Template
IsStandardTemplate
A flag indicating if the contract was created from a standard company template.
Description

This boolean attribute signifies whether the contract originated from a pre-approved, standard template or was created as a non-standard, bespoke agreement. This is a key factor in assessing risk and compliance.

Contracts based on standard templates typically have faster cycle times and lower risk. This attribute is the basis for the 'Contract Template Adherence Rate' KPI and helps in analyzing the process impact of using non-standard paper. It can highlight departments or contract types that frequently deviate from standards, guiding efforts to improve template usage.

Why it matters

Measures adherence to company standards, which directly correlates with process efficiency and risk reduction.

Where to get

This could be a checkbox field on the contract or derived based on the document's origin or metadata within Icertis.

Examples
truefalse
Last Data Update
LastDataUpdate
The timestamp when the data for the process was last refreshed.
Description

This attribute indicates the freshness of the data being analyzed. It records the date and time of the last data extraction from the source system.

This information is crucial for users to understand the timeliness of the insights presented in the dashboards. It helps them know if they are looking at real-time information or data that is a few hours or days old, setting the right context for decision-making.

Why it matters

Provides context on data freshness, ensuring users understand how current the process analysis is.

Where to get

This timestamp is generated by the data pipeline or ETL tool at the end of each successful data refresh cycle.

Examples
2024-07-27T08:00:00Z2024-07-26T23:59:59Z
Obligation Due Date
ObligationDueDate
The deadline by which a specific contractual obligation must be met.
Description

This attribute tracks the due dates for key obligations, commitments, and deliverables defined within the contract after it has been executed. A single contract may have multiple obligations, each with its own due date.

Tracking these dates is critical for post-execution compliance and risk management. This attribute is the foundation for the 'Obligation Adherence Rate' KPI, allowing the organization to monitor whether it is meeting its commitments on time and to proactively address potential breaches.

Why it matters

Enables monitoring of post-execution compliance, which is crucial for avoiding penalties and maintaining good business relationships.

Where to get

Icertis has modules for obligation management. This data would come from the obligations associated with a contract.

Examples
2024-09-302025-01-152024-11-01
Processing Time
ProcessingTime
The duration of time spent actively working on an activity.
Description

Processing Time is the calculated duration from an activity's start time to its end time. It represents the actual time resources were engaged with a task, as opposed to the waiting time between tasks.

This metric is fundamental for performance analysis. It helps pinpoint which specific activities are the most time-consuming in the entire process. For example, it can show that while the overall legal review phase is long, the actual time spent reviewing documents is short, indicating that most of the time is spent in a queue. This is vital for almost all dashboards, especially those focused on cycle time and efficiency.

Why it matters

Separates active work time from idle wait time, providing a more accurate target for efficiency improvements.

Where to get

This is calculated from the 'EventTime' (StartTime) and 'EndTime' attributes in the dataset.

Examples
2 hours 15 minutes3 days 4 hours30 minutes
Region
Region
The geographical region relevant to the contract.
Description

This attribute specifies the geographic area, such as EMEA, APAC, or North America, to which the contract applies. This is important for global organizations with regional variations in their processes.

Analyzing by region can uncover differences in process performance, compliance requirements, or negotiation tactics driven by local laws and business cultures. It allows for region-specific benchmarking and the identification of best practices that could be shared globally.

Why it matters

Helps identify regional variations in process performance and compliance, which is crucial for global organizations.

Where to get

This is typically a metadata field on the contract object in Icertis, often part of the standard configuration.

Examples
EMEANorth AmericaAPACLATAM
Revision Count
RevisionCount
The total number of revisions a contract has undergone.
Description

This calculated metric provides a count of revision-related activities, such as 'Contract Redlined Or Revised', for each contract case. It serves as a simple, powerful indicator of process friction.

A high revision count signals potential issues in the drafting or negotiation phases, such as unclear requirements, poor initial drafts, or difficult negotiations. This metric is the direct input for the 'Contract Revision Rate' KPI and is used in dashboards to identify contracts and process variants with excessive rework.

Why it matters

Quantifies rework in the contract lifecycle, directly measuring the efficiency of the drafting and negotiation stages.

Where to get

This is calculated by counting the occurrences of specific revision activities for each 'ContractId' in the event log.

Examples
1503
SLA Status
SLAState
Indicates whether an activity or case is within its Service Level Agreement (SLA) terms.
Description

This attribute is derived by comparing the duration of certain process phases against predefined SLA targets. For example, it might flag a legal review as 'Late' if it exceeds the standard 48-hour turnaround time.

SLA Status is essential for compliance monitoring and performance management. It allows for the creation of alerts and dashboards, like the 'Contract Compliance Overview', that immediately highlight breaches. This helps teams prioritize overdue tasks and enables managers to track performance against key targets.

Why it matters

Provides immediate visibility into compliance with service level targets, helping to prioritize work and manage performance.

Where to get

This is calculated by defining business rules in the process mining tool that compare timestamps against predefined SLA thresholds (e.g., Legal Review duration > 2 days).

Examples
On TimeAt RiskLate
Source System
SourceSystem
The system from which the contract data was extracted.
Description

This attribute identifies the origin of the data, which is 'Icertis' for this process. It helps in data governance and traceability, especially in environments where data might be aggregated from multiple systems.

In analysis, it can be used to filter data to a specific source system or to compare processes across different systems if applicable. For this view, it serves as a constant identifier for all events.

Why it matters

Ensures data lineage and traceability, which is important for data validation and managing data from multiple sources.

Where to get

This is typically a static value added during the data extraction and transformation process to label the origin of the data.

Examples
IcertisIcertisCLM
Required Recommended Optional

Contract Management Activities

These are the key process steps and milestones to track within your event log for accurate discovery and analysis of your contract lifecycle.
6 Recommended 8 Optional
Activity Description
Contract Executed
This activity marks the formal execution of the contract, when all parties have signed. It is the primary success endpoint of the pre-signature process and is captured via integration with an e-signature platform.
Why it matters

As the main completion event, this is the endpoint for the 'Average Contract Cycle Time' KPI. It signifies the moment the contract becomes legally binding and active.

Where to get

An explicit event is received from the e-signature platform and logged in Icertis once the signing process is complete for all parties.

Capture

Callback event from the e-signature platform integration.

Event type explicit
Contract Request Initiated
This activity marks the official start of the contract lifecycle, where a business user formally requests a new contract. This is typically captured as an explicit event when a user submits a contract request form within the Icertis platform.
Why it matters

As the process start, this event is essential for measuring the overall contract cycle time. Analyzing the volume and type of requests helps in resource planning and demand management.

Where to get

This is an explicit event logged in Icertis when a 'Contract Request' object is created and submitted.

Capture

Event logged upon submission of a contract request form.

Event type explicit
Contract Terminated Or Expired
Marks the end of the contract's lifecycle, either through an active termination process or by reaching its expiration date. Termination is an explicit event, while expiration is a calculated event based on contract metadata.
Why it matters

This is a terminal event for the contract lifecycle. It is critical for analyzing renewal rates and measuring the 'On-Time Renewal/Termination Rate' KPI.

Where to get

A termination event is explicitly logged when a user performs a termination action. Expiration can be calculated by comparing the current date to the 'Expiration Date' attribute.

Capture

Calculated by comparing the system date to the contract's expiration date, or from a manual termination event.

Event type calculated
Counterparty Approval Received
This activity signifies that the external counterparty has agreed to the terms and approved the final version of the contract. This can be an explicit event from a collaboration portal or a manual status update by the contract owner.
Why it matters

This milestone concludes the negotiation phase. It serves as the endpoint for calculating the 'Average Negotiation Cycle Time' KPI, highlighting the efficiency of external interactions.

Where to get

This could be an explicit event if the counterparty uses an Icertis portal to approve. Otherwise, it is inferred from a manual status change to 'Counterparty Approved'.

Capture

Event logged from a counterparty portal or a manual status update by an internal user.

Event type explicit
Internal Approvals Obtained
Marks the milestone where all required internal stakeholders have approved the contract, making it ready for external negotiation or signature. This is inferred from the overall status of the approval workflow reaching a terminal 'Approved' state.
Why it matters

This is a key milestone that concludes the internal review cycle. It's the endpoint for measuring the 'Average Approval Phase Duration' KPI.

Where to get

Inferred from the workflow status changing to 'Fully Approved' or a similar state, indicating all approval tasks are complete.

Capture

Timestamp of the final internal approval task completion or an overall workflow status change.

Event type inferred
Legal Review Conducted
Indicates that the legal department has completed its review of the contract. This is typically an explicit event logged when a legal reviewer completes their assigned task in the approval workflow.
Why it matters

This activity is crucial for measuring legal review turnaround time and identifying potential capacity constraints within the legal team. It supports the 'Legal Review Wait Time' KPI.

Where to get

Explicitly logged when the legal review task is marked as 'Complete' in the Icertis workflow. It may also be inferred from a status change like 'Legal Approved'.

Capture

Event from the workflow engine indicating the completion of the 'Legal Review' task.

Event type explicit
Amendment Initiated
Represents the start of a formal process to amend an active contract. This is captured when a user creates an amendment record linked to the original executed agreement.
Why it matters

Amendments represent significant rework or changes in scope. Tracking their frequency and cycle time provides insights into contract stability and management efficiency.

Where to get

An explicit event is logged when an 'Amendment' object or a similar record is created and associated with an existing contract.

Capture

Creation of an amendment record in the Icertis system.

Event type explicit
Contract Drafted
Represents the creation of the initial contract document, either from a template or as a new file. This event is often inferred from the creation or first upload of the primary contract document associated with the contract workspace.
Why it matters

Tracking this activity helps measure the time taken to prepare the initial draft. It is a key step for analyzing drafting efficiency and adherence to template usage.

Where to get

Inferred from the creation timestamp of the primary contract document within the Icertis contract workspace or agreement object.

Capture

Identify the creation timestamp of the first version of the main contract document.

Event type inferred
Contract Redlined Or Revised
This activity occurs each time a contract document is modified during internal review or external negotiation. Icertis tracks document versions, so each new version checked in can be captured as a revision event.
Why it matters

Counting these events per contract allows for the calculation of the 'Contract Revision Rate' KPI. A high number of revisions can indicate ambiguous language, inefficient negotiations, or misalignment.

Where to get

Explicitly logged in the document management module of Icertis whenever a new version of the contract document is uploaded or checked in.

Capture

An event is created for each new document version number.

Event type explicit
Contract Renewed
Indicates that an existing contract has been successfully renewed for another term. This is an explicit action taken within the system, often initiating a new contract record or updating the existing one.
Why it matters

This activity is key to evaluating the effectiveness of the renewal management process. It is used to calculate the 'On-Time Renewal/Termination Rate' KPI.

Where to get

An explicit event generated when a user executes the 'Renew' action on a contract record within Icertis.

Capture

Event logged from a user-initiated 'Renew' transaction.

Event type explicit
Contract Sent For Signature
Indicates that the final, approved contract has been dispatched for electronic or wet signature. This is an explicit event captured through integration with e-signature platforms like DocuSign or Adobe Sign.
Why it matters

Tracking this event helps analyze the efficiency of the final execution step. Delays between approval and sending for signature can reveal administrative bottlenecks.

Where to get

Explicitly logged through API integration with an e-signature solution when the signature process is initiated from within Icertis.

Capture

Event from the e-signature connector when a signature request is sent.

Event type explicit
Counterparty Negotiation Started
Represents the point at which the contract is shared with the external counterparty for their review and negotiation. This is often inferred from the contract status changing to 'In Negotiation' or from an audit log of when the document was first sent externally.
Why it matters

This activity marks the start of the negotiation phase. It is the starting point for calculating the 'Average Negotiation Cycle Time' KPI.

Where to get

Inferred from a manual status change to 'In Negotiation' or by tracking the event when the document is shared via an external portal for the first time.

Capture

Timestamp of status change to 'In Negotiation' or 'Sent to Counterparty'.

Event type inferred
Internal Review Started
This activity signifies the beginning of the internal review and approval workflow. It is captured when the contract draft is formally submitted for review by internal stakeholders, such as department heads or finance.
Why it matters

This marks the start of the approval phase, which is often a source of bottlenecks. Analyzing the time from this event helps identify delays in initiating internal collaboration.

Where to get

Captured as an explicit event when the 'Submit for Review' action is triggered in an Icertis workflow, or inferred from a status change to 'In Internal Review'.

Capture

Logged when a user initiates the internal review workflow.

Event type explicit
Obligations Monitoring Activated
This post-execution activity signifies that contractual obligations and commitments are activated for tracking within the system. This is typically an explicit event triggered automatically upon execution or manually by a contract manager.
Why it matters

This event starts the clock for post-execution management. It is crucial for measuring and ensuring compliance via the 'Obligation Adherence Rate' KPI.

Where to get

Explicit event logged in the Icertis obligation management module when a contract's status becomes 'Active' or 'Executed'.

Capture

Automatic or manual activation of obligation records associated with the contract.

Event type explicit
Recommended Optional

Extraction Guides

How to get your data from Icertis