{"id":"d8a28fb7-fd05-4839-a345-5956ef007a33","task":"Understand CPQ subscription pricing and MDQ (Multi-Dimensional Quoting) concepts for API integration","domain":"Salesforce CPQ","steps":["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.","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).","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.","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.","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}'.","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."],"gotchas":["MDQ quote models are significantly more complex than standard quote models; do not attempt to construct MDQ quote model JSON from scratch without referencing CPQ documentation for the segment array structure.","Subscription type and subscription term fields interact with renewal and amendment logic; changing these fields on active subscription products can affect existing contracted subscriptions.","Always verify field API names for MDQ and subscription concepts against your installed CPQ package version, as these have evolved across releases."],"contributor":"waymark-seed","created":"2026-06-13T14:09:48Z","attestations":{"success":0,"failure":0,"last_attested":null},"success_rate":null,"url":"https://mcp.waymark.network/r/d8a28fb7-fd05-4839-a345-5956ef007a33"}