> ## Documentation Index > Fetch the complete documentation index at: https://docs.getveles.com/llms.txt > Use this file to discover all available pages before exploring further. # Quote > Understand how quotes work in Veles: the block-based structure, pricing options, CRM sync, versioning, and the path from draft to buyer. A Quote in Veles is a pricing construct used to model a potential commercial agreement. It exists to simulate, optimize, and negotiate pricing structures without affecting operational or financial systems. Quotes combine pricing options, legal terms, and narrative content into a single proposal that can be shared with buyers. Every quote is tied to a **Customer** (company) in Veles and can be linked to a CRM opportunity or deal for bi-directional sync. Quotes are mutable by design -- they can undergo multiple revisions because no billing, provisioning, or revenue systems depend on them. When the buyer accepts, the quote is **promoted** to an Order, which is the boundary between modeling and execution. Quotes are simulation objects. They may reflect highly sophisticated pricing logic (tiered discounts, ramps, floors, bundled pricing), but they do not trigger billing, revenue recognition, provisioning, or contract mutation until promoted to an Order. *** ## Anatomy of a quote A quote is composed of two parts: the **Context Block** (fixed header) and one or more **content blocks** (the body). ### Context Block The Context Block sits at the top of every quote and provides the deal metadata. It ensures brand consistency and gives both the rep and buyer the essential context for the proposal. | Field | Description | | ----------------- | ------------------------------------------------------------------------------------------------- | | **Company logo** | Your branding, pulled from [Account Setup](/get-started/quickstart/account-setup#brand-identity). | | **Proposal name** | A descriptive title for the deal (e.g., "Acme Corp -- Enterprise Expansion Q3"). | | **Prepared By** | The sales rep or deal owner. | | **Prepared For** | The customer contact receiving the proposal. | | **Issued On** | The date the quote is sent. | | **Valid Through** | The expiration date, used to create urgency and track validity. | These fields can be populated manually or auto-filled from your CRM when the quote is linked to an opportunity. ### Content blocks Below the Context Block, quotes are built using a modular **block** system. You stack different block types to create a complete proposal. Blocks can be reordered, added, or removed at any time before publishing. Veles supports four block types: The core of every quote. A Pricing Option block opens the **Veles Calculator**, where you select products from your catalog, set quantities, configure deal terms (contract length, billing frequency, ramp schedules), and apply discounts. Every quote needs at least one Pricing Option. You can add multiple options to give the buyer choices on a single proposal (e.g., Option A: 1-year term, Option B: 3-year term, Option C: 3-year with premium support). [Full details →](/get-started/calculator/options) Insert predefined legal language directly into the proposal. Terms blocks bridge the gap between sales and legal during negotiations. **Example:** If a rep offers a significant discount, they might include a "Co-Marketing" term requiring the customer to participate in a case study, or a "Payment Terms" clause specifying net-30 payment. [Full details →](/get-started/calculator/terms) Flexible open-text fields with a title and body. Use these for narrative content that gives the buyer context around the pricing. **Common uses:** Executive summaries, statements of work (SOW), implementation scope and assumptions, customer success commitments, or any other content that helps the buyer understand the deal beyond the numbers. [Full details →](/get-started/calculator/blocks) Embed videos from **Loom** or **Vidyard** directly into the proposal. Video walkthroughs let reps personally explain the pricing and terms, which increases engagement in asynchronous sales cycles. Requires an active [Loom](/get-started/integrations/loom) or Vidyard integration. *** ## Building a Pricing Option When you add a Pricing Option block, the Veles Calculator opens. This is where the deal gets configured. ### Select products The product catalog appears on the left side. Click a product to add it as a line item. Products are filtered by your assigned [categories, regions, and segments](/get-started/pricing-and-packaging/product-filters), so you only see what's relevant to your deal. Once added, the line item prompts for required inputs -- typically a quantity or a [driver value](/get-started/pricing-and-packaging/units-of-measure#input-kind-quantity-vs-driver), depending on the product's unit of measure. ### Set terms and timeline At the top of the builder, configure the temporal structure: * **Start and end dates** for the agreement * **Term length** (e.g., 12 months, 24 months) * **Multi-year support** up to 5 years * **Billing frequency** from the options allowed by your admin configuration (monthly, quarterly, annual) ### Phases For deals with pricing that changes over time (ramps, step-ups, multi-year structures), quotes are organized into **Phases**. A Phase is a discrete commitment interval with an explicit start and end date, representing a contiguous period during which a defined set of commercial terms applies. Phases are strictly sequential and non-overlapping. Together they define the full schedule of the commercial commitment. Quote Lines are always associated with a specific Phase -- they inherit the Phase's date boundaries rather than defining their own service dates independently. **Example:** A 3-year ramp deal might have three Phases: Year 1 (50 seats at 45/user), Year 2 (75 seats at \$48), Year 3 (100 seats at \$50/user). Each Phase is a distinct commitment window with its own pricing, and the Quote Lines within each Phase define the product-level obligations for that window. When a quote is promoted to an Order, the Phase structure carries forward: each Quote Phase becomes an Order Phase, and each Quote Line becomes an Order Line associated with the corresponding Order Phase. The commitment schedule defined during quoting becomes binding at promotion. ### Real-time metrics As you build, Veles calculates and displays key metrics in real time: * **TCV** (Total Contract Value) * **Year 1 Recurring** (ARR) * **Year 1 Services** (one-time fees) ### Discounting The line item table shows the full pricing waterfall so you can see exactly how a price is reached: | Column | What it shows | | --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ | | **List Price** | The starting price from your price book. | | **System Adjustment** | Automated changes driven by [Pricing Rules](/get-started/rules-and-approval/pricing-rules) or [Data Sheets](/get-started/pricing-and-packaging/data-sheets). | | **System Price** | The price after automated adjustments, before any rep discount. | | **Rep Discount** | The discretionary discount applied by the rep. | Reps can apply discounts two ways: enter a discount percentage directly, or double-click the final price field and type a **target price** -- Veles back-calculates the required discount percentage automatically. ### Rules and approvals Veles monitors the deal configuration in real time. If a line item or the overall deal structure breaches a company policy (e.g., discount exceeds 20%, unauthorized billing frequency, missing required product), **rule alerts** appear at the line item or option level. Each alert explains why it was triggered and who needs to approve it. If you're an Admin, alerts include a direct link to the rule logic in the Admin Console. [Full Pricing Options reference →](/get-started/calculator/options) *** ## Multiple options on a single quote Veles supports multiple Pricing Options on one quote, allowing you to present the buyer with choices without creating separate proposals. **Common patterns:** * Good / Better / Best packages * Short-term vs. long-term commitment (1-year vs. 3-year) * Different product configurations at different price points The first option is marked **Primary** by default (the one you expect to close). You can reassign Primary status to any option. For each option, you can: * **Clone** it to duplicate a complex configuration and make small tweaks * **Hide** it from the buyer while keeping it for internal reference * **Delete** it entirely While Veles supports unlimited options, presenting 2-3 choices is generally most effective. More than that risks creating analysis paralysis for the buyer. *** ## Publishing and versioning Quotes move through a clear workflow from draft to buyer: Configure your pricing options, add terms and text blocks, and finalize the proposal content. Everything is in draft state -- the buyer sees nothing. If any pricing rules are breached (e.g., discount thresholds), the **Publish** button changes to **Request Approval**. The quote is routed to the appropriate approver based on your [approval configuration](/get-started/calculator/approvals) and org hierarchy. Once all approvals are met (or if none were required), click **Publish**. This creates a permanent **version snapshot** of the quote, locking the pricing and content at that point in time. The published version is what the buyer sees. Send the published quote to the buyer via the [Web Portal](/get-started/calculator/web-portal) (a branded link they can view in their browser) or generate a PDF document. You can continue editing the quote after publishing -- changes stay in draft until you publish again, creating a new version. Veles tracks every published version, so you have a full audit trail of what was sent to the buyer and when. *** ## From Quote to Order: Promotion When the buyer accepts and the deal is ready to execute, the quote is **promoted** to an Order. Promotion is not a clerical step -- it is the boundary between modeling and execution. During promotion, the system: 1. **Locks the Quote** to prevent further modification. The quote becomes a historical negotiation artifact. 2. **Creates an Order** linked to the originating account and, if applicable, to an existing Contract. 3. **Transforms Quote Lines into Order Lines**, materializing the final commercial values (quantities, net prices, discounts, service dates) into immutable execution fields. Pricing ceases to be dynamic and becomes authoritative. 4. **Carries the Phase structure forward.** Each Quote Phase becomes an Order Phase with the same service boundaries. 5. **Enables downstream processes** such as billing orchestration (Stripe), CRM sync, and contract mutation. Edits to a Quote after promotion do not cascade to the Order or Contract. Any changes to an executed deal require a new Order through the [amendment process](/get-started/contract-management/overview). ### Order creation vs. Order activation It's important to distinguish between these two events. Order creation may occur immediately upon quote acceptance, but activation can be gated by additional steps: signature confirmation, finance approval, payment confirmation, or compliance review. Contract mutation and billing typically occur only upon activation: * **Quote acceptance** → Order created (pending state) * **Order activation** → Contract updated + billing triggered See [Contract Management](/get-started/contract-management/overview) for details on how activated Orders affect the Contract. *** ## CRM sync When a quote is linked to a CRM opportunity or deal, data flows bi-directionally: * **CRM → Veles:** Opportunity data (account, contacts, deal metadata) populates the quote's Context Block. * **Veles → CRM:** Quote status, totals, and key metrics sync back to the CRM record as the deal progresses. Changes in either system are reflected in the other. When a quote is approved and converted to an order, the committed data is pushed to the CRM as well. [Connect your CRM →](/get-started/quickstart/connect-your-crm) *** ## Sharing via the Web Portal The [Web Portal](/get-started/calculator/web-portal) is a branded, interactive page where buyers view your proposal. It provides a modern buying experience with engagement tracking built in. Key capabilities: * **Draft vs. live views** -- reps edit in draft mode; buyers only see published versions * **Magic Link authentication** -- buyers enter their email and click a secure link to access the proposal * **Engagement analytics** -- see who viewed the proposal, when, which options they clicked, and how long they spent * **Display controls** -- toggle visibility of quantities, list prices, discounts, and other line item details * **Real-time updates** -- update a proposal during a live call and the buyer simply refreshes to see the new version [Web Portal reference →](/get-started/calculator/web-portal) *** ## What's next Deep dive into building options: products, terms, discounting, and approvals. Learn about the block types available for building proposals. Insert legal terms and deal-specific language into quotes. Configure and share interactive buyer-facing proposals. Set up approval workflows for discounts and deal structure. Configure the pricing guardrails that govern the quoting process.