Skip to main content
The Contract in Veles represents the durable commercial state of a customer relationship. It is not a transaction and it is not a document. It is the accumulated result of every executed Order applied over time — the authoritative record of what a customer is entitled to right now. When a New Business Order activates, the Contract is created. When an Amendment Order changes it, the same Contract is updated and the change is recorded as a numbered amendment. When a Renewal Order activates, a new successor Contract is created and linked to the original. Past periods are never rewritten, so the history of every prior commitment is preserved. This page covers the Contract object model, how Orders affect Contracts, and the rules that govern amendments and renewals.

The object model

The Contract mirrors the same three-level structure as Quotes and Orders: This structural parity is intentional. Every commitment interval and line item is tracked from the moment it’s modeled on a quote, through its execution as an order, to its durable state on the contract. Nothing is lost in translation between layers.

Contract

The top-level record representing the full commercial relationship with a customer. It stores the account association, overall term, activation state, and references to all Orders that have affected it.

Contract Phases

Each Contract Phase represents a contiguous time period during which a specific set of commercial terms applies. Phases are sequential and non-overlapping. They correspond to the Phases defined on the originating Quotes and Orders. For a simple annual deal, there may be a single Phase. For a multi-year ramp deal, there will be one Phase per commitment interval (e.g., Year 1, Year 2, Year 3), each with its own pricing and quantity structure.

Contract Lines

Contract Lines define the product-level entitlements within each Phase: the active quantity, contracted price, billing cadence, and service boundaries for each SKU. Contract Lines are the system of record for what the customer is paying for and what they’re entitled to receive.

How Orders affect Contracts

When an Order is activated, the system evaluates how each Order Line should affect the associated Contract. The behavior depends on the Order’s commercial classification.

New Business

If no prior Contract exists for the customer, Order activation creates a new Contract. Each Order Line produces one or more Contract Lines that define the initial entitlement: active quantity, contracted price, service start and end, billing cadence, and renewal behavior. The Contract becomes the system of record for this customer’s commercial relationship from this point forward.

Amendment

If the Order references an existing Contract, the system applies mutation logic rather than creating a new baseline. The Contract is incrementally modified to reflect the change. Amendment Orders can instruct the system to:
  • Increase or decrease quantity of an existing Contract Line
  • Add new products as new Contract Lines
  • Adjust service periods
  • Extend the term
  • Introduce new Phases for future commitment windows
The amendment Order restates the whole Contract. Veles compares it with the current Contract, and each line is marked Added, Modified, Removed, or Unchanged. Changes that take effect partway through the active Phase are prorated from the amendment’s effective date.
Amendments modify the Contract from their effective date forward. They do not rewrite history. Phases that ended before the effective date are untouched; the active Phase changes from the effective date; future Phases change in full.

Renewal

A Renewal Order always creates a new successor Contract, linked to the one it renews. The renewal quote starts from the last Phase of the original Contract, with the same products, quantities, and contracted prices, and the rep adjusts it from there. The original Contract isn’t changed, so its Phases and pricing remain intact as the record of the prior term. See Renewals and Amendments.

Contracted price preservation

This is one of the most important concepts in contract management: amendments do not reprice history. When an amendment Quote is created, it references the active Contract. That Contract contains the authoritative commercial state from all prior Orders: active quantities, service intervals, contracted unit prices, and any negotiated discounts or uplifts. The amendment quote is copied from the Contract, so every line starts at its contracted price — not the current list price and not the pricing rules that were in effect during the original negotiation. Example: A product was originally contracted at $4.25/unit (after negotiation and discounting). If the customer adds seats mid-term via an amendment, the line stays at that $4.25 contracted rate unless the rep changes it. The system does not recompute pricing from the current price book or reapply the discount logic from the original deal. This preserves three critical properties:
  1. Commercial integrity — negotiated pricing remains stable and enforceable across the life of the contract.
  2. Auditability — historical pricing logic does not need to be re-derived. The contracted price is authoritative.
  3. Predictability — amendments modify state; they do not reinterpret it. Both the customer and the finance team know what to expect.
When the amendment Order is executed, Veles updates the Contract to match it from the effective date forward. Phases that have already ended remain untouched. In practical terms, an amendment changes the Contract going forward; it does not recalculate what was already committed.

Activation vs. creation

It’s important to distinguish between when an Order is created and when it’s activated, because these are different events with different downstream effects. Order creation may happen immediately when a quote is accepted. But the Order can remain in a pending state while additional steps are completed: signature confirmation. Order activation is what actually triggers contract mutation. Until the Order is activated, the Contract is unchanged.
This separation ensures that commercial commitments are not recorded in the Contract until all required approvals and confirmations are complete.

What each layer is authoritative for

After a deal moves through the full lifecycle, each object serves a specific purpose: Edits to a Quote after promotion do not cascade to Orders or Contracts. Any changes to an executed deal require a new Order through the amendment process. This separation preserves auditability and financial integrity.

System integrity

The architecture enforces a deliberate separation of concerns:
  • Quotes are mutable and computational. The pricing engine operates here.
  • Orders are authoritative and transactional. They contain fully resolved commercial values independent of future pricing model changes.
  • Contracts are stateful and cumulative. They reflect the current reality of the customer relationship.
This design ensures that pricing experimentation on quotes never affects entitlements, that financial systems operate on immutable commitments, that amendments preserve historical integrity, and that revenue recognition aligns with executed Orders rather than draft Quotes.

What’s next

Quote Overview

Understand how quotes are built, including Phases and the Promotion workflow.

Renewals and Amendments

Deep dive into amendment logic, renewal workflows, and price preservation.

Proration Logic

How Veles calculates prorated charges for mid-term changes.

Rules & Approvals

Configure the guardrails that govern amendments and renewals.