Skip to main content
A Contract Phase is a commitment interval on the Contract that represents a contiguous time period during which a defined set of commercial terms is (or was) in effect. Contract Phases are the durable-state counterpart of Quote Phases and Order Phases — they carry the same structure but represent what has actually been committed, not what was modeled or executed. The Contract is not a snapshot of a single deal. It is the accumulated result of every Order activated over time. Contract Phases reflect that history: some are active (the current commitment window), some are historical (past commitment windows preserved for audit), and some are future (upcoming commitment windows from ramp or multi-year deals).

How Contract Phases are created

Contract Phases are produced when an Order is activated. Each Order Phase creates or modifies a Contract Phase on the associated Contract.
The behavior depends on the Order’s commercial classification:

New Business

Each Order Phase creates a new Contract Phase from scratch. For a 3-year ramp deal with three Order Phases, the Contract will have three Contract Phases — one for each year of the commitment.

Amendment

The amendment Order restates every Phase of the Contract, and Veles updates the Contract to match it from the amendment’s effective date forward. Phases are matched in order. New Phases are appended, and a Phase missing from the Order is removed. Phases that ended before the effective date remain intact. For example, if a customer on a 3-year deal amends their Year 2 commitment partway through Year 2, the Year 2 change is prorated from the effective date and Year 3 changes in full. The Year 1 Phase (already over) is untouched.

Renewal

A renewal creates a new successor Contract with its own Phases. The renewal quote starts from the last Phase of the original Contract, as a single one-year Phase. The rep can change pricing (including uplift), quantities, or terms before it’s sent. The original Contract and its Phases aren’t changed, so they remain the record of the prior term.

What a Contract Phase contains


Phase lifecycle

Contract Phases move through a natural lifecycle as time passes:
1

Future

The Phase exists on the Contract but its start date hasn’t arrived yet. Common in multi-year and ramp deals where future commitment windows are defined upfront. Future Phases can be modified by amendment Orders.
2

Active

The current date falls within the Phase’s start and end dates. This Phase defines the customer’s current entitlements. The Contract Lines within this Phase are what the customer is paying for and entitled to receive right now.
3

Historical

The Phase’s end date has passed. It is no longer active but is preserved on the Contract as a permanent record. Historical Phases cannot be modified — they represent what was committed during that period. Finance can reference historical Phases to reconstruct the state of any account at any point in time.

Contract Phases and amendments

When an amendment Order is activated, the Contract mutation engine evaluates which Phases are affected: Historical Phases are never modified. They represent executed commitments and are preserved for audit integrity. The active Phase may be modified if the amendment takes effect during the current commitment window (e.g., adding seats mid-term). The change is valued only for the rest of the Phase, from the amendment’s effective date. See Proration Logic. Future Phases can be modified, replaced, or extended. An amendment might adjust pricing in a future Phase, add new products to an upcoming commitment window, or extend the Contract by appending additional Phases.
Amendments always operate as a forward-looking delta against the current Contract state. They modify active and future Phases prospectively. They never rewrite historical Phases or recompute past pricing.

Contract Phases and renewals

At renewal, a new Contract is created with its own Phases, starting from the last Phase of the original. The original Contract and its Phases are preserved in full. To add years to an existing Contract instead, amend it. Either way, the historical Phases from prior commitment periods remain intact. The complete pricing history — every rate, every quantity, every Phase boundary — is preserved across the full lifespan of the customer relationship.

Example: full lifecycle

A customer signs a 2-year deal, then amends mid-way through Year 1, then renews: Initial deal (New Business Order activated): Amendment in June 2026 (adds Analytics): After Year 1 completes: Renewal for 2028 with 5% uplift (new successor Contract): Every Phase is preserved on its own Contract, and the renewal links back to the original. Finance can reconstruct the exact commercial state at any point in the relationship.

What’s next

Contract Lines

The product-level entitlements within each Contract Phase.

Contract Management

The full Contract object model and mutation logic.

Proration Logic

How mid-Phase changes are prorated.

Order Phases

The execution-layer Phases that produce Contract Phases.