Microsoft NCE Growth Margins (Cost of Sale)

Microsoft NCE Growth Margins are partner-earned financial incentives offered by Microsoft on qualifying New Commerce Experience (NCE) transactions. Growth Margins are evaluated automatically by Microsoft in the background during order processing. Please note that CloudBlue does not participate in or influence Microsoft's eligibility decisions in any way.

These margins are designed specifically as partner benefits and do not alter customer or reseller pricing. Catalog prices, shopping cart totals, and end-customer invoices remain unchanged. Because indirect resellers and customers are completely unaware of Growth Margins during the order flow, the details are recorded on Connect through the parameters documented in this article, so Direct-Billed Provider Partners and Distributors can account for their adjusted Cost of Sale.

Microsoft Partners retain full responsibility for ensuring that orders are drafted and sequenced in the optimal manner to earn Growth Margins. If an order does not qualify, Microsoft will not cancel, reverse, combine, defer, or take any other steps to help a non-qualifying provisioned order earn a Growth Margin. Because of these strict Microsoft rules—and because indirect resellers cannot see margin eligibility during the order flow—CloudBlue cannot be held liable for any provisioned orders that fail to earn Growth Margins.

Scope and Program Rules

  • Supported Program and Platform: Microsoft Cloud Solution Provider (CSP) program under the New Commerce Experience (NCE).

  • Eligible Cloud Contexts: Microsoft Cloud International (MCI) and US Government Community Cloud (GCC).

  • Eligible Offers: Public Base Offers worldwide (excluding China and embargoed regions). Specialized offers are excluded. Product eligibility is determined by Microsoft.

  • Customer Segment Coverage:

    • Commercial: Fully supported at General Availability.

    • Education, Nonprofit, and US Government (GCC): Enabled in CloudBlue Connect, but Microsoft currently evaluates Growth Margins for Commercial segment offers only. Products for non-commercial segments should become active as Microsoft extends segment coverage in the Growth Margin Guide.

  • Product Coverage:

    • Microsoft 365: Supported.

    • Software Subscriptions and Perpetual Software: Provisionally enabled in CloudBlue Connect, pending final confirmation from Microsoft.

  • Excluded Scenarios:

    • Channel shifts (e.g., Enterprise Agreement to CSP transitions) do not qualify for Growth Margins unless the deal includes a meaningful net-new growth (e.g., moving a customer from EA to CSP while significantly expanding the seat count). In these cases, only the incremental seats earn Growth margin, and eligibility is evaluated at the time of transaction across all three growth scenarios. N-Tier Marketplace configurations will not see Growth Margins in Cost of Goods Sold.

    • Specialized Offers Precedence: When a Specialized Offer exists for a SKU, Specialized Offer pricing takes precedence and Growth Margins do not apply. Growth Margins and Specialized Offers cannot be combined.

    • Trial Offers: Trial licenses do not earn Growth Margins and are excluded from tenant-level eligibility evaluations and minimum seat count thresholds. Customers with active trial usage can still qualify for Growth Margins under New-to-Offer scenarios upon converting to paid subscriptions.

  • Partner-to-Partner Transfers: When an active subscription transfers between Direct-Billed Provider Partners mid-term, Growth Margin pricing persists. The receiving partner inherits the discounted rate for the remainder of the active commitment term.

  • Extended Service Term (EST) Exclusion: When a subscription is not renewed and enters the extended service term (EST) period, Growth margin no longer applies. EST seats may still count toward tenant-level seat totals for eligibility calculations, but no Growth margin is earned during the EST period.

Prerequisites and System Requirements

  • API Access Requirements: To resolve base margins and list prices, the CloudBlue connector calls Microsoft's Partner Price Sheet API on behalf of the direct-billed partner. The Partner Center user authorized in the connector must keep the Admin Agent or Sales Agent role, which is already required to place orders.

  • CloudBlue Component Availability:

    • CloudBlue Connect Integration: General Availability on 2026-October-01.

    • CloudBlue Commerce Cost of Sale End-to-End: Processing in CloudBlue Commerce requires CloudBlue Commerce BSS v21.29 and the updated Rating Engine component 2.8.4340 or later versions.

Key Principles and System Behavior

  • Partner-Side Economics Only (No Price Impact): Customer and reseller purchase prices remain identical whether a growth margin applies or not. The connector captures the margin applied by Microsoft and passes it to CloudBlue Commerce via the nce_growth_margin_final fulfillment parameter to compute the distributor's Cost of Sale.
  • Non-Blocking Operation: Order validation operates on a "fail-open" design. If CloudBlue cannot retrieve a Growth Margin response or encounters an API delay, order processing continues without delay, and the margin record is omitted.
  • Coexistence with Promotions: Growth margins coexist with NCE Commercial Promotions. Microsoft applies the Growth Margin calculation first, followed by promotional discounts.
  • Captured Order Contexts: Margins are captured on initial purchases, upgrades, trial-to-paid conversions, partial upgrades, migrations, and imports.
  • Commitment Term Alignment: Growth margins apply for the duration of the active commitment term and expire at the commitment end date.
  • Growth Margin Non-Stacking: Growth Margin discount types do not stack on top of each other. New-to-Offer and Seat Expansion are mutually exclusive for a given transaction. If a transaction qualifies for multiple Growth Margin scenarios (e.g., Seat Expansion and Strategic SKU Mix), Microsoft applies only one Growth Margin—the single highest applicable discount percentage.

  • No Retroactive Adjustments: Microsoft evaluates and locks in Growth Margin eligibility strictly at the time of order processing. If an order is structured incorrectly or fails to qualify, Microsoft provisions the order at standard pricing, and Growth Margins cannot be applied retroactively.

  • Co-termination of subscriptions:

    • Direct-Billed Partners can co-terminate proration-adjusted subscriptions to align end-dates with a customer's existing subscriptions while earning Growth Margins (provided eligibility criteria are met).

    • Growth margin applies only for the duration of the new subscription term so co-terminating with a shorter remaining period means earning Growth Margin for a shorter window.

  • Margin Calculation Structure: Growth Margin percentages represent the total margin rate earned on a transaction. Growth Margin already incorporates the standard Base Margin rate; it is not stacked on top of Base Margin. The effective partner price is calculated as ERP x (1 - Base Margin % - Growth Margin %) prior to applying any customer-facing promotional discounts.

  • Repeat Lifecycle Qualification: Partners can capture Growth Margins multiple times for the same customer over time. For example, a customer may first qualify under New-to-Offer for their initial subscription term, and later qualify again under Seat Expansion upon reaching renewal.

Growth Margin Scenarios and Qualification Behavior

Microsoft evaluates transactions across three distinct growth scenarios at the Customer AAD Tenant level across all Microsoft channels and partners:

  • New-to-Offer:

    • Applies when a customer purchases a product they have not held on their tenant within the configured lookback period (default: 3 years) and meets the minimum seat threshold.

    • Eligibility is determined across all Microsoft channels (CSP, Enterprise Agreement, Microsoft Web Direct) and prior partners over the lookback window (default: 3 years). If a customer previously owned the product through another channel or partner within the lookback window, the transaction will not qualify as New-to-Offer, even if it is your first time selling the SKU to that tenant.

  • Seat Expansion:

    • Mid-Term Expansion: Incremental seats added mid-term must be placed on a new subscription to earn a Growth Margin. Existing seats on the original subscription remain at Base Margin.

    • Scheduled Renewal Expansion: Seat expansions placed as part of a scheduled renewal do not require a separate subscription. If eligible, all seats (existing and new) earn the Growth Margin for the new term.

    • Expansion Dual Thresholds: To qualify as a Seat Expansion, the transaction must satisfy two conditions simultaneously: it must meet or exceed a configured seat-expansion multiplier relative to the existing seat footprint (e.g., a 1x increase of current seats) and meet an absolute minimum net-new seat threshold.

  • Strategic SKU Mix:

    • Rewards upselling a customer from a qualifying base product (e.g., Microsoft 365 E3) to a strategic target product (e.g., Microsoft 365 E5). To qualify, the transaction must meet a minimum target seat count and bring the strategic SKU footprint to or above a defined ratio (e.g., 80% strategic seats). Growth Margin applies only to the newly added strategic seats. Strategic SKU mix is a one-time motion per base target relationship.

    • Crossing the ratio threshold early with a small initial batch forfeits the opportunity to earn Growth Margins on future target SKU expansions. Because strategic SKU mix can typically only be leveraged once per customer, the priority is to make that single motion count. Partners should time the transaction to include the largest possible block of strategic target seats the customer is ready to commit to.

  • Prerequisite Product Ownership Rules: Microsoft's eligibility engine evaluates tenant history across configurable lookback windows using three prerequisite rules:

    • MustHaveAll: The tenant must own all specified qualifying products.

    • MustHaveAny: The tenant must own at least one product from the specified list.

    • MustHaveNone: The tenant must not own any of the specified products within the lookback window.

Important: Microsoft pre-evaluates scheduled renewals approximately 3 days prior to the auto-renewal date using policies in effect at that moment. The Growth Margin shown when a renewal is scheduled may change and no longer apply at renewal. Whether a subscription requalifies at renewal is governed by the criteria in the Microsoft's Growth Margin Guide. If a Growth Margin-qualifying subscription reaches its end date (termEndDate) between pre-evaluation and the actual renewal date, the Growth Margin will not apply when the subscription auto-renews. Partners should verify eligibility close to the renewal execution date.

Example: A Growth Margin-qualifying Subscription is provisioned on 2026-November-01 with a Monthly Term. There is a Growth Margin with termEndDate of 2027-March-31. Approaching the AutoRenew of 2027-April-01, Microsoft pre-evaluates the Renewal on 2027-March-28 and reports that the Renewal qualifies because it is not yet the Growth Margin's termEndDate. However, when the Active Subscription actually AutoRenews on 2027-April-01, the Growth Margin will not be applied as it is after the Growth Margin's termEndDate.

Growth Margin Ordering and Fulfillment Parameters

Parameter ID Scope Description Data Structure
nce_growth_margin_draft Ordering Parameter Captures internal validation tracking during draft order evaluation. Records eligible:true, eligible:false (along with Microsoft's reason message), or remains blank if no margin was available. This parameter is not consumed by CloudBlue Commerce.  
nce_growth_margin_final Fulfillment Parameter Contains the finalized growth margin evaluation returned by Microsoft alongside resolved price-sheet data. CloudBlue Commerce consumes this payload to calculate Cost of Sale.

Field

Type Description
mpn String Transacting Partner MPN ID.
product_code String Join key to the Microsoft invoice (formatted as ProductId:SkuId).
benefit_id String Unique identifier of the growth margin benefit granted by Microsoft.
margin_percent Number Fraction representing the extra growth margin (e.g., 0.185 for 18.5%).
end_date String ISO 8601 timestamp for the end of the current commitment term when the margin expires.
applied Boolean true if Microsoft applied the growth margin; false if ineligible or excluded.
predicted_eligible Boolean true if predicted as eligible during draft order validation.
base_margin Number Base margin fraction derived from the partner price sheet: base_margin = 1 - Unit Price ⁄ ERP Price.
list_price Number Estimated Retail Price (ERP Price) obtained from the partner price sheet.

Reconciliation and Operational Guidance for Direct-Billed Partners

  • Verify Product Eligibility: Review the Microsoft CSP Growth Margin Guide in your Microsoft Partner Center (MSPC) tenant to confirm eligible products, thresholds, and market rules.

  • Mid-Term Seat Expansions: To earn a Growth Margin on mid-term seat additions, place the incremental licenses on a new subscription. Adding licenses mid-term to an existing subscription will not grant a Growth Margin for those incremental licenses.

  • License Reductions: Avoid reducing seat quantities below a Growth Margin’s minimum seat threshold. If seat counts drop below the minimum threshold, Microsoft requires the entire subscription to be canceled within the allowable cancellation window.

  • Managing Indirect Channels (2-Tier): Indirect Resellers and end-customers do not have access to Growth Margin details. Because indirect reseller orders can inadvertently forfeit eligibility (such as adding seats to existing subscriptions or exceeding maximum seat thresholds), Direct-Billed Partners must establish operational guidance for their reseller network.

  • Baseline Footprint Risk on Mid-Term Additions: Placing a non-qualifying seat addition directly on an existing subscription not only forfeits Growth Margin for those new seats, but also increases the customer's recorded baseline seat count. This higher baseline permanently increases the minimum seat threshold needed to satisfy seat-expansion multipliers on future orders.

  • Seat Consolidation at Term End: When expanding mid-term via a separate subscription, the original seats remain at Base Margin until their term expires. When the original subscription reaches the end of its term, partners can consolidate those original seats onto the active Growth Margin subscription so all seats earn Growth Margin for the remaining duration of that term.

  • Cancellation Window for Below-Threshold Adjustments: If license reductions cause a subscription to fall below the Growth Margin's required minimum seat threshold, the entire subscription must be canceled within the standard NCE 7-day cancellation window (with prorated credit).

Reconciliation Data Attributes

Direct-Billed Partners can audit Growth Margin transactions in open and closed billing reconciliation files using three key fields:

Attribute Description
PriceBenefits

An attribute array containing the Growth Margin product code (in the upn field), type (product), and the availabilityId. Partners can use the Growth Margins API or get Growth Margins by ID API or to get more details about the growth margin.

For example, when a Growth Margin is applied, the PriceBenefits attribute contains:

Copy
"PriceBenefits": [ {
    "type": "product",
    "availabilityId": "084R5MQ9QF1K",
    "upn": "00093c3a-0000-0280-8969-084119667565"
  }
]
UnitPrice

The unit price after applying standard Base Margin to the Estimated Retail Price (ERP).

EffectiveUnitPrice

The final unit price charged to the partner. Calculated by applying Base Margin and Growth Margin to the ERP, then applying any customer-facing promotional discounts.

Diagnostic Error Codes

When Microsoft evaluates a draft order as ineligible, the nce_growth_margin_draft ordering parameter records one of the following error reasons returned by Microsoft:

  • NewToOfferGrowthMarginConstraintNotMet: The customer tenant does not satisfy new-to-offer seat minimums, maximums, or tenant lookback history rules.

  • SeatExpansionGrowthMarginConstraintsNotMet: The order fails required seat increase multipliers, minimum expansion counts, or mid-term separate subscription requirements.

  • InvalidDiscountConfiguration: The requested catalog item or discount configuration is invalid for the base offer.

  • InvalidCatalogItemId: The catalog item ID (baseCatalogItemId) does not resolve to a valid availability.