What an Order Line contains
How Order Lines are created
Order Lines are produced during promotion. Each Quote Line is transformed into an Order Line through a process that materializes the final commercial values:
The transformation is not a simple copy. The Quote Line’s pricing depends on the pricing engine — tier lookups, rule adjustments, data sheet references, and formula evaluations. The Order Line contains the resolved output of all that logic, flattened into fixed values.
After promotion, the Order Line is the authoritative record. If the price book is updated, if pricing rules change, if data sheets are modified — none of it affects existing Order Lines.
Immutability
Order Lines are designed to be immutable once the Order is activated. This is a deliberate architectural choice that preserves financial integrity:- Billing systems operate on the Order Line’s final net price. If that price could change retroactively, invoices would be unreliable.
- Revenue recognition depends on stable, committed values. Mutable Order Lines would make rev rec impossible to audit.
- Contract state is derived from Order Lines. If Order Lines could change, the Contract would be indeterminate.
Order Lines and Contract Lines
When an Order is activated, each Order Line produces a Contract Line on the associated Contract. The behavior depends on the Order’s commercial classification and the contract impact instructions on the line: New Business. The Order Line creates a new Contract Line defining the initial entitlement: active quantity, contracted price, service boundaries, billing cadence. Amendment — add product. The Order Line creates a new Contract Line for a product that wasn’t on the Contract before. Amendment — modify existing. The Order Line adjusts an existing Contract Line: increasing quantity, changing the price prospectively, or extending the service period. The contracted price from the prior commitment is preserved as the baseline. Renewal. The Order Line replaces an expiring Contract Line with a new one that may have updated pricing, quantity, or terms.Order Lines and billing
If Stripe is connected, activated Order Lines drive billing orchestration:- Recurring lines generate invoices according to their billing frequency (monthly, quarterly, annual).
- One-time lines generate a single invoice at activation.
- Transactional lines (flagged as transactional on the product) are billed in arrears based on actual usage.
Custom fields
Like other Veles objects, Order Lines can carry custom field values. Custom fields defined on Quote Lines propagate to Order Lines at promotion, and from Order Lines to Contract Lines at activation. This means deal-specific metadata (implementation priority, customer configuration notes, cost basis) flows through the entire lifecycle without manual re-entry.What’s next
Order Phases
The commitment intervals that Order Lines belong to.
Order Overview
The full Order object: classifications, activation, and creation.
Contract Management
How Order Lines create and mutate Contract Lines.
Quote Lines
The simulation-layer lines that Order Lines are promoted from.