📍 What is CPQ?

CPQ stands for Configure, Price, Quote. It is a Salesforce product that helps sales teams generate accurate and professional quotes quickly by automating the configuration of products, pricing rules and quote generation.

📍 What is a Bundle?

A Bundle is a parent product that contains child products called Options. Bundles allow you to group related products together and configure them as a single unit in a quote.

📍 Bundle Components

📍 Product Options

Product Options are child products inside a bundle. They define which products can be selected when configuring a bundle and control behavior like whether they are required, optional or hidden.

📍 Key Product Option Fields

📍 What is a Price Rule?

A Price Rule is an automated pricing action that fires when certain conditions are met on a quote. It allows you to automatically update prices, quantities or custom fields on Quote Lines based on logic.

📍 Price Rule Components

📍 Discount Schedule

A Discount Schedule automatically applies tiered discounts based on quantity or term. The more a customer buys or the longer the contract, the bigger the discount applied automatically.

📍 Two Types

📍 Quote Line Editor

The Quote Line Editor is the main UI in CPQ where sales reps configure products, set quantities, apply discounts and manage quote lines. It replaces the standard Opportunity Products page with a richer, more powerful interface.

📍 Key QLE Features

• Add products and bundles to the quote
• Set quantities, discounts and start/end dates
• View price waterfall — list price to net price breakdown
• Apply manual discounts with approval triggers
• Drag and drop product ordering
• Group products into quote line groups

📍 Price Waterfall

The Price Waterfall is the sequence of pricing steps CPQ applies to calculate the final net price on a quote line. Each step can reduce or modify the price.

List Price
    ↓ (minus) Partner Discount
    ↓ = Partner Price
    ↓ (minus) Customer Discount
    ↓ = Customer Price
    ↓ (minus) Additional Discount
    ↓ = Net Price
    ↓ (plus) Markup
    ↓ = Quote Line Price

📍 Product Feature

A Product Feature is a grouping mechanism inside a bundle that organizes related Product Options together. It also allows you to set selection rules like minimum and maximum number of options a rep can choose from that group.

📍 Configuration Rule

Configuration Rules control the logic of product selection inside bundles. They automatically add, remove, enable or disable options based on what other options have been selected.

📍 Quote Template

A Quote Template defines the visual layout and content of the PDF quote document generated by CPQ. It controls what sections appear, what data shows, and how the document looks.

• Built using a drag-and-drop template editor
• Supports rich HTML and custom branding
• Can include dynamic fields from Quote and Quote Lines
• Multiple templates can exist for different use cases
• Template is selected on the Quote record before generating

📍 Product Rule

Product Rules are validation and automation rules that control which products can or cannot be added together on a quote. They fire in the Quote Line Editor when products are added or configured.

📍 Primary Quote

An Opportunity can have multiple CPQ Quotes but only one can be marked as Primary. The Primary Quote syncs its products back to the Opportunity as Opportunity Line Items.

• Only one quote per opportunity can be Primary at a time
• Marking a quote as Primary automatically un-marks the previous one
• Primary Quote drives the Opportunity Amount
• When a Quote is Contracted, it is typically the Primary Quote

📍 Price Variable

A Price Variable is a dynamic value used inside Price Actions. Instead of hardcoding a price, you reference a Price Variable that calculates a value from a field, lookup table or formula at runtime.

📍 Price Variable Sources

📍 Lookup Object

A Lookup Object is a custom Salesforce object used as a pricing matrix. CPQ can query it during pricing to find the correct price or discount based on multiple dimensions like customer segment, region, product type and quantity.

📍 Real World Example

Custom Object: CPQ_Discount_Matrix__c
Fields:
- Customer_Segment__c (Enterprise, SMB, Startup)
- Region__c (North, South, East, West)
- Product_Family__c (Hardware, Software)
- Discount_Percent__c

CPQ Price Rule queries this object based on
Quote fields to find the correct discount.

📍 Summary Variable

A Summary Variable aggregates values across multiple quote lines into a single number. It can calculate totals, counts, minimums or maximums across quote lines and use that aggregated value in Price Rules or Product Rules.

Example: Count how many software products are on the quote — if more than 5, apply a 10% bundle discount.

📍 Block Pricing

Block Pricing allows you to define flat prices for ranges of quantities instead of a per-unit price. The customer pays one fixed price for any quantity within a defined block.

Example: A SaaS company charges $500 for up to 10 users. Whether you buy 1 or 10 users — you pay $500.

Example: Product list price is $1,000. Enterprise customer negotiated $750. The Contracted Price of $750 is used instead of $1,000 when quoting for that account.

📍 Amendment

An Amendment is a mid-term change to an active contract. It creates a new quote and order to reflect changes like adding products, removing products or changing quantities during the contract period.

📍 What Happens During Amendment

• CPQ creates a new Amendment Opportunity and Quote
• Existing subscription products are loaded as read-only
• Rep adds new products or modifies quantities
• CPQ calculates prorated amounts for mid-term changes
• Amendment Quote is contracted to update the active contract

📍 Renewal

A Renewal is the process of extending a contract when it is about to expire. CPQ can automatically create a Renewal Opportunity and Quote before the contract end date.

📍 Renewal Flow

Active Contract nearing end date
          ↓
CPQ auto-creates Renewal Opportunity
          ↓
Renewal Quote created with same products
          ↓
Rep can modify quantities/pricing
          ↓
Quote contracted → New Contract created

📍 Key Renewal Settings

📍 Proration

Proration calculates the partial period charge when a subscription product is added or changed mid-term. Instead of charging the full period price, CPQ charges only for the remaining portion of the billing period.

Annual Subscription = $12,000 per year
Customer adds product on July 1 (mid-year)
Remaining months = 6 out of 12

Prorated Amount = $12,000 × (6/12) = $6,000

📍 Proration Methods

📍 Quote Line Group

Quote Line Groups organize quote lines into logical sections in the Quote Line Editor. Each group can have its own start date, end date, and discount — useful for multi-phase or multi-location deals.

📍 Use Cases

• Multi-year deals with different products per year
• Multi-location quotes with different pricing per site
• Separating hardware and software on one quote
• Applying group-level discounts to sections

📍 Multi-Currency in CPQ

CPQ supports Salesforce's standard multi-currency feature. When a quote is created in a non-default currency, CPQ automatically converts prices using the exchange rates defined in Salesforce.

• Quote currency is set on the Quote record
• Pricebook entries can have currency-specific prices
• CPQ uses active exchange rates for conversion
• Advanced Multi-Currency (Dated Exchange Rates) is also supported
• Net Total is displayed in the quote currency

📍 CPQ Order

A CPQ Order is created from a contracted quote and represents the customer's commitment to purchase. It drives fulfillment and billing downstream.

📍 Quote to Order Flow

Quote created and configured
          ↓
Quote approved (if approval rules trigger)
          ↓
Quote contracted → Contract created
          ↓
Order generated from Contract
          ↓
Order Products created
          ↓
Order activated → Billing/Fulfillment triggered

📍 CPQ Pricing Calculation Order

Step 1: Original Price (from Pricebook Entry)
Step 2: Block Pricing applied (if configured)
Step 3: Price Rules evaluated in order
Step 4: Contracted Prices applied (if exists for account)
Step 5: Discount Schedules applied
Step 6: Option-level discounts applied (for bundles)
Step 7: Partner Discounts applied
Step 8: Customer Discounts applied
Step 9: Additional Discounts applied
Step 10: Markup Rates applied (if any)
Step 11: Net Price calculated

Price Rules fire in the order of their Evaluation Order field. Lower numbers fire first. This order is critical — changing it can produce different results.

📍 Twin Fields

Twin Fields are matching fields on related CPQ objects that automatically sync values between them. When a field value changes on one object, CPQ automatically updates the corresponding field on the paired object.

📍 Common Twin Field Pairs

Twin Fields must have identical API names and compatible field types on both objects.

📍 Solution — Lookup Object + Price Variable + Price Rule

Step 1: Create Custom Object — Pricing_Matrix__c
Fields:
  - Customer_Tier__c (Gold, Silver, Bronze)
  - Region__c (North, South, East, West)
  - Min_Deal_Size__c (Number)
  - Max_Deal_Size__c (Number)
  - Discount_Percent__c (Number)

Step 2: Create Lookup Object in CPQ
Configure to match on:
  - Customer_Tier__c = Quote.Customer_Tier__c
  - Region__c = Quote.Region__c
  - Min_Deal_Size__c <= Quote.Net_Amount
  - Max_Deal_Size__c >= Quote.Net_Amount

Step 3: Create Price Variable
Source: Lookup Object
Field: Discount_Percent__c

Step 4: Create Price Rule
Condition: Always true (fires on all lines)
Action: Set Additional_Discount__c = Price Variable value

📍 SBQQ.QuoteModel API

The SBQQ.QuoteModel API is CPQ's JavaScript and Apex API that allows developers to programmatically interact with the Quote Line Editor — reading quote data, modifying line items and triggering pricing calculations.

📍 Key API Methods

// Trigger CPQ pricing calculation via API
String quoteJSON = SBQQ.ServiceRouter.read('SBQQ.QuoteAPI.QuoteReader', quoteId);
Map<String,Object> quoteData = (Map<String,Object>)JSON.deserializeUntyped(quoteJSON);
// Modify quote data
String savedQuote = SBQQ.ServiceRouter.save('SBQQ.QuoteAPI.QuoteSaver', JSON.serialize(quoteData));

📍 CPQ Plugins

CPQ Plugins are Apex interfaces that allow developers to inject custom logic into specific points of the CPQ process — like pricing, product search, document generation and quote calculations.

// Example Pricing Plugin
global class CustomPricingPlugin implements SBQQ.PricingPlugin {
    global void onBeforeCalculate(SBQQ.SBQuote quote, List<SBQQ.SBQuoteLine> lines) {
        // Custom logic before CPQ pricing runs
        for(SBQQ.SBQuoteLine line : lines) {
            // Modify line prices
        }
    }
}

📍 Solution — CPQ Approval Rule + Margin Field

Step 1: Create Custom Formula Field on Quote
Margin_Percent__c = (Net_Amount - Cost_Amount) / Net_Amount * 100

Step 2: Create CPQ Approval Rule
Condition: Margin_Percent__c < 20
Action: Require approval from Finance Manager

Step 3: Approval Rule settings
- Lock Quote = TRUE (prevents editing during review)
- Prevent Contracting = TRUE (blocks Contract button)

Result:
- Rep submits quote with 15% margin
- CPQ triggers approval automatically
- Quote is locked, Contract button disabled
- Finance Manager approves or rejects
- If rejected — rep must revise pricing

📍 CPQ to Billing Handoff

CPQ Quote created and configured
          ↓
Quote contracted → Contract + Subscriptions created
          ↓
Order generated from Contract
          ↓
Order activated in CPQ
          ↓
Salesforce Billing picks up activated Order
          ↓
Billing Schedule created per Order Product
          ↓
Invoice generated on billing date
          ↓
Payment processed

📍 Key Integration Points

📍 Debugging Price Rules Step by Step

Step 1: Check Price Rule Active flag
Ensure SBQQ__Active__c = true on the rule

Step 2: Check Evaluation Event
Should match when you expect it to fire:
- On Initialize, On Calculate, On Save, Always

Step 3: Verify Price Conditions
Open rule → check conditions are correct
Test condition logic manually with real data

Step 4: Check Evaluation Order
Lower number = fires first
Ensure dependent rules fire in correct sequence

Step 5: Enable CPQ Debug Logs
URL parameter: ?sbqq.debug=true
Open browser console to see pricing log

Step 6: Use CPQ Calculator API
Force calculation and inspect JSON payload
Check if conditions evaluate to true

Step 7: Check Price Variable source
Ensure lookup object has matching records
Verify field API names match exactly

📍 Solution — Product Rule with Selection Type

Rule 1: Auto-Add Product B when Product A added
Type: Selection
Conditions: 
  - Product A is selected on quote (Quote Line field check)
Actions:
  - Add Product B to quote
  - Set Quantity = 1

Rule 2: Auto-Remove Product C when Product A added
Type: Selection
Conditions:
  - Product A is selected on quote
  - Product C is on the quote
Actions:
  - Remove Product C from quote

Rule Scope:
  - Set scope to "Quote" level (not Line level)
  - Evaluation Event: On Initialization and On Save

📍 CPQ Data Model

Opportunity (Standard Object)
  └── SBQQ__Quote__c (1 to Many — multiple quotes per opp)
        └── SBQQ__QuoteLine__c (1 to Many — quote line items)
              └── SBQQ__QuoteLineGroup__c (optional grouping)

Contract (Standard Object)
  └── SBQQ__Subscription__c (per subscription product)
  └── SBQQ__ContractedPrice__c (negotiated prices)
  └── Asset (per asset product)

Order (Standard Object)
  └── OrderItem (Order Products)
        └── SBQQ__OrderItemConsumptionSchedule__c

📍 Key Relationships

📍 Common Causes and Fixes

📍 Nested Bundle

A Nested Bundle is a bundle within a bundle — a child product option that itself is a configurable bundle. This creates a hierarchy of configurable products for complex product offerings.

Parent Bundle: Enterprise Suite
  └── Feature: Core Products
        └── CRM Bundle (Nested Bundle)
              └── Option: Sales Cloud
              └── Option: Service Cloud
        └── Analytics Bundle (Nested Bundle)
              └── Option: Tableau
              └── Option: Einstein Analytics

📍 When to Use

• Complex enterprise products with multiple configurable sub-components
• Products with deeply nested option hierarchies
• When flat bundles become too large to manage

📍 CPQ Migration Approach

Step 1: Use CPQ's built-in export/import
Setup → Installed Packages → CPQ Settings
→ Use Data Export/Import for CPQ metadata

Step 2: Use Salesforce Change Sets
For standard metadata (profiles, fields, page layouts)
CPQ custom objects are included automatically

Step 3: Use Data Loader or SFDX for data records
Export: Products, Pricebooks, Price Rules, Product Rules
Maintain record relationships using External IDs
Import in correct dependency order

Deployment Order:
1. Products and Pricebooks
2. Product Features and Options
3. Price Rules and Actions
4. Product Rules
5. Discount Schedules
6. Quote Templates
7. Approval Rules

📍 CPQ Package Settings

The CPQ Package Settings object (SBQQ__PackageProductsSettings__c) controls global CPQ behavior across the entire org.

📍 Customization Options

For deep UI customization, use the SBQQ.ProductSearchPlugin or inject custom components using the CPQ Lightning Plugin framework.

📍 Amendment + Proration Flow

Active Contract: Jan 1 - Dec 31, Annual $12,000
Amendment initiated: July 1 (6 months remaining)

Scenario A: Add new product at $6,000/year
Prorated charge = $6,000 × (6/12) = $3,000 for remainder

Scenario B: Increase existing product quantity from 10 to 15
Original per unit = $100/month
Additional 5 units × $100 × 6 months = $3,000 prorated

Scenario C: Remove a product mid-term
Credit calculated for remaining period
= Product price × remaining months/total months

📍 Key Amendment Rules

• Existing subscription lines are locked — cannot be deleted
• Quantity can be increased or decreased
• New products can be added
• All changes are prorated to contract end date

📍 Architecture Design

Product Setup:
  Hardware Products:
    - Subscription Type: One-Time
    - No subscription records created
    - No proration
    - Excluded from renewals

  SaaS Products:
    - Subscription Type: Renewable
    - Creates Subscription records on contracting
    - Prorated on amendment
    - Included in renewal quotes

Quote Line Groups:
  Group 1: Hardware (one-time)
    - Start date = today
    - No end date needed

  Group 2: SaaS Licenses (subscription)
    - Start date = go-live date
    - End date = contract term end

Pricing:
  Hardware: Block pricing or list price
  SaaS: Discount Schedules based on seat count

Renewal Behavior:
  Hardware lines: excluded from renewal quote
  SaaS lines: auto-included in renewal quote