Understand CPQ subscription pricing and MDQ (Multi-Dimensional Quoting) concepts for API integration

Steps

1. CPQ subscription pricing tracks products sold on a recurring basis via SBQQ__Subscription__c records, generated when a quote is contracted; each subscription records product, quantity, price, start date, and end date.
2. MDQ (Multi-Dimensional Quoting) allows a single quote line to span multiple segments with different quantities or prices per period; MDQ is enabled per product (SBQQ__QuantityEditable__c and related fields — verify field names).
3. When reading an MDQ quote via QuoteReader, the model includes segment arrays for each MDQ line; these must be preserved and edited at the segment level, not the line level.
4. For subscription products, the SBQQ__SubscriptionType__c field on the product controls billing behavior (One-Time, Renewable, Evergreen — verify exact values); this affects how renewal and amendment quotes handle the product.
5. When integrating with external billing or ERP systems, query SBQQ__Subscription__c records after contracting to obtain the source of truth for active entitlements: SELECT Id, SBQQ__Product__c, SBQQ__Quantity__c, SBQQ__StartDate__c, SBQQ__EndDate__c FROM SBQQ__Subscription__c WHERE SBQQ__Contract__c = '{contractId}'.
6. MDQ segment records are stored as SBQQ__QuoteLineGroup__c or segment child objects — verify the exact data model for your CPQ version before building segment-level integrations.