Your Contract Management Data Template
Your Contract Management Data Template
- Recommended attributes to collect
- Key activities to track
- Extraction guidance for your source system
Contract Management Attributes
| 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
|
|||
Contract Management Activities
| 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
|
|||