Merge pull request #309179 from shrutis06/main

Clarify MACC definition and portal access details

Author: JillGrant615

articles/cost-management-billing/manage/media/track-consumption-commitment/macc-main-page-milestones.png

@@ -6,23 +6,23 @@ ms.reviewer: shrshett
 ms.service: cost-management-billing
 ms.subservice: billing
 ms.topic: how-to
-ms.date: 09/23/2025
+ms.date: 01/20/2025
 ms.author: shrshett
 ms.custom: sfi-image-nochange
 ---
 
 # Track your Microsoft Azure Consumption Commitment (MACC)
 
-The Microsoft Azure Consumption Commitment (MACC) is a contractual commitment that your organization may have made to Microsoft Azure spend over time. If your organization has a MACC for a Microsoft Customer Agreement (MCA) billing account or an Enterprise Agreement (EA) billing account you can check important aspects of your commitment, including start and end dates, remaining commitment, and eligible spend in the Azure portal or through REST APIs.
+A Microsoft Azure Consumption Commitment (MACC) is a contractual agreement in which your organization commits to a specified level of Azure spending over a defined period. If your organization has a MACC associated with a Microsoft Customer Agreement (MCA) or Enterprise Agreement (EA) billing account, you can track key details—including start and end dates, remaining balance, and eligible spend—through the Azure portal or REST APIs.
 
-MACC functionality in the Azure portal is only available for direct MCA and direct EA customers. A direct agreement is between Microsoft and a customer. An indirect agreement is one where a customer signs an agreement with a Microsoft partner.
+MACC functionality in the Azure portal is available only to direct MCA and direct EA customers. A direct agreement is one signed directly between Microsoft and the customer, whereas an indirect agreement involves a customer signing through a Microsoft partner.
 
-In the scenario that a MACC commitment has been transacted prior to the expiration or completion of a prior MACC (on the same enrollment/billing account), actual decrement of a commitment will begin upon completion or expiration of the prior commitment. In other words, if you have a new MACC following the expiration or completion of an older MACC on the same enrollment or billing account, use of the new commitment starts when the old commitment expires or is completed.
 
 ## Prerequisites
 
-- For an EA, the user needs to be an Enterprise administrator to view the MACC balance.
-- For an MCA, the user must be have the owner, contributor, or reader role on the billing account to view the MACC balance.
+- **Enterprise Agreement (EA):** The user must have the Enterprise Administrator role to view the MACC balance.
+- **Microsoft Customer Agreement (MCA):** The user must have the Owner, Contributor, or Reader role on the billing account to view the MACC balance.
+
 
 ## Track your MACC Commitment
 
@@ -34,8 +34,8 @@ In the scenario that a MACC commitment has been transacted prior to the expirati
 3. In the billing scopes page, select the billing account for which you want to track the commitment. The billing account type must be **Microsoft Customer Agreement** for Microsoft Customer Agreement (MCA) customers or **Enterprise Agreement** for EA customers.   
     :::image type="content" source="./media/track-consumption-commitment/list-of-scopes.png" alt-text="Screenshot that shows Billing Scopes." lightbox="./media/track-consumption-commitment/list-of-scopes.png" :::
     > [!NOTE]
-     > Azure portal remembers the last billing scope that you access and displays the scope the next time you come to Cost Management + Billing page. You won't see the billing scopes page if you have visited Cost Management + Billing earlier. If so, check that you are in the [right scope](#check-access-to-a-microsoft-customer-agreement). If not, [switch the scope](view-all-accounts.md#switch-billing-scope-in-the-azure-portal) to select the billing account for a Microsoft Customer Agreement.
-4. Depending on your agreement type, do one of the following:
+     > Azure portal remembers the last billing scope that you access and displays the scope the next time you come to Cost Management + Billing page. You don't see the billing scopes page if you visited Cost Management + Billing earlier. If so, check that you are in the [right scope](#check-access-to-a-microsoft-customer-agreement). If not, [switch the scope](view-all-accounts.md#switch-billing-scope-in-the-azure-portal) to select the billing account for a Microsoft Customer Agreement.
+4. Depending on your agreement type, do one of the following steps:
     - For MCA customers, select **Properties** from the left-hand side and then select **Microsoft Azure Consumption Commitment (MACC)**.  
         :::image type="content" source="./media/track-consumption-commitment/select-macc-tab.png" alt-text="Screenshot that shows selecting the MACC tab for MCA." lightbox="./media/track-consumption-commitment/select-macc-tab.png" :::
     - For EA customers, select **Credits + Commitments** in the left navigation menu, then select **Microsoft Azure Consumption Commitment (MACC)**.  
@@ -60,15 +60,15 @@ The Details section displays other important aspects of your commitment.
 | Purchase date | The date when you made the commitment. |
 | Start date | The date when the commitment became effective. |
 | End date | The date when the commitment expired. |
-| Commitment amount | The amount that you’ve committed to spend on MACC-eligible products/services. |
+| Commitment amount | The amount you commit to spend on MACC-eligible products/services. |
 | Status | The status of your commitment. |
 
-Your MACC can have one of the following statutes:
+Your MACC can have one of the following statuses:
 
-- Active: MACC is active. Any eligible spend will contribute towards your MACC commitment.
-- Completed: You’ve completed your MACC commitment. 
-- Expired: MACC is expired. Contact your Microsoft Account team for more information. 
-- Canceled: MACC is canceled. New Azure spend won't contribute towards your MACC commitment.
+- **Active:** The MACC is currently in effect. Eligible Azure spend contributes toward fulfilling your commitment.
+- **Completed:** The MACC commitment amount is fully met. No further action is required.
+- **Expired:** The MACC end date passes without the commitment being fully met. Contact your Microsoft Account team for more information.
+- **Canceled:** The MACC is terminated before the end date. New Azure spend does not contribute toward your MACC commitment. Contact your Microsoft Account team for more information.
 
 #### Events
 
@@ -88,7 +88,7 @@ The Events section displays events (invoiced spend) that decremented your MACC c
 
 You can use the [Azure Billing](/rest/api/billing/) and the [Consumption](/rest/api/consumption/) APIs to programmatically get Microsoft Azure Consumption Commitment (MACC) for your billing account.
 
-The examples shown below use REST APIs. Currently, PowerShell and Azure CLI aren't supported. Example output is for Microsoft Customer Agreements, so output for Enterprise Agreements will differ.
+The following examples use REST APIs. Currently, PowerShell and Azure CLI aren't supported. The response sample provided is for Microsoft Customer Agreements; response for Enterprise Agreements differs.
 
 ### Find billing accounts you have access to
 
@@ -194,16 +194,17 @@ The API response returns lists of MACCs for your billing account.
 | `status`  | The status of your commitment. |
 | `originalAmount` | The original commitment amount. |
 | `closedBalance`   | The remaining commitment since the last invoice.    |
-| `source`      | For MACC, the source will always be ConsumptionCommitment. |
+| `source`      | For MACC, the source is always ConsumptionCommitment. |
 | `startDate`      |  The date when the MACC became active.  |
 | `expirationDate`  | The date when the MACC expires.   |
 
-Your MACC can have one of the following statutes: 
+Your MACC can have one of the following statuses:
+
+- **Active:** The MACC is currently in effect. Eligible Azure spend contributes toward fulfilling your commitment.
+- **Completed:** The MACC commitment amount is fully met. No further action is required.
+- **Expired:** The MACC end date passes without the commitment being fully met. Contact your Microsoft Account team for more information.
+- **Canceled:** The MACC is terminated before the end date. New Azure spend doesn't contribute toward your MACC commitment. Contact your Microsoft Account team for more information.
 
-- Active: MACC is active. Any eligible spend will contribute towards your MACC commitment.
-- Completed: You’ve completed your MACC commitment. 
-- Expired: MACC is expired. Contact your Microsoft Account team for more information. 
-- Canceled: MACC is canceled. New Azure spend won't contribute towards your MACC commitment. 
 
 ### Get events that affected MACC commitment
 
@@ -275,13 +276,61 @@ The API response returns all events that affected your MACC commitment.
 | `billingProfileId` | The unique identifier for the billing profile for which the event happened. |
 | `billingProfileDisplayName` | The display name for the billing profile for which the event happened. |
 | `lotId`   | The unique identifier for the MACC.    |
-| `lotSource`      | It will be ConsumptionCommitment for MACC. |
-| `transactionDate`      |  The date when the event happened.  |
-| `description`  | The description of the event.   |
-| `charges`  | The amount of MACC decrement.   |
-| `closedBalance`  | The balance after the event.   |
+| `lotSource`      | Value is ConsumptionCommitment for MACC. |
+| `transactionDate`      |  The date when the event occurred.  |
+| `description`  | Description of the event.   |
+| `charges`  | The MACC decrement amount.   |
+| `closedBalance`  | The remaining balance after the event.   |
 | `eventType`  | Only SettledCharges events are supported for MACC.   |
-| `invoiceNumber`  | The unique ID of the invoice whose charges decremented MACC.   |
+| `invoiceNumber`  | The unique ID of the invoice whose charges decremented the MACC.   |
+
+---
+## MACC Milestones
+
+Milestones are predefined financial targets within the MACC framework that must be met within a specific timeframe. They help track progress against your MACC commitment and include both a due date and a milestone commitment amount.
+
+> [!NOTE]
+> Not every MACC includes milestones. If your MACC has milestones configured, you can see them in the Azure portal.
+
+:::image type="content" source="./media/track-consumption-commitment/macc-main-page-milestones.png" alt-text="Screenshot that shows MACC page with milestones." lightbox="./media/track-consumption-commitment/macc-main-page-milestones.png" :::
+
+:::image type="content" source="./media/track-consumption-commitment/macc-milestones-page.png" alt-text="Screenshot that shows MACC milestones details." lightbox="./media/track-consumption-commitment/macc-milestones-page.png" :::
+
+
+**Key points about MACC milestones:**
+
+- **Missed milestone:** If a milestone isn't met by its due date, a shortfall charge in the form of Azure prepayment credit is applied to your account to fulfill the milestone commitment.
+
+- **Missed MACC commitment:** If the total MACC commitment amount isn't met by the MACC end date, a shortfall charge in the form of Azure prepayment credit is applied to your account for the remaining balance.
+
+> [!IMPORTANT]
+> Consumption charges covered by shortfall credits don't accrue toward your MACC. For more information, see [Azure credits and MACC](#azure-credits-and-macc).
+
+---
+
+## MACC Shortfall and Alerts
+
+Microsoft emails Billing Account Admins to help meet MACC commitments and milestones on time. These alerts give advance notice so you can act before getting shortfall charges.
+
+### MACC expiry alerts
+
+If your MACC target isn't met, email notifications go to Billing Account Admins at the following intervals before the MACC end date:
+
+- 90 days before expiry
+- 60 days before expiry
+- 30 days before expiry
+
+### Milestone alerts
+
+If your MACC includes milestones, email alerts go to Billing Account Admins at the following intervals before each milestone end date if the milestone target isn't met:
+
+- 90 days before milestone end date
+- 60 days before milestone end date
+- 30 days before milestone end date
+
+### Shortfall charges
+
+If the MACC or MACC milestone target isn't met by the end date, an email alert is sent notifying you that a shortfall charge for the remaining balance is applied. This shortfall charge is an Azure prepayment credit that is applied to your account to fulfill your remaining commitment.
 
 ---
 
@@ -291,11 +340,12 @@ You can determine which Azure services and Marketplace offers are eligible for M
 
 ## Azure credits and MACC
 
-If your organization received Azure credits from Microsoft, the consumption or purchases that are covered by credits won't contribute towards your MACC commitment.
+If your organization receives Azure credits from Microsoft, consumption or purchases covered by those credits don't contribute toward your MACC commitment.
+
+If your organization purchased Azure Prepayment, consumption or purchases covered by the prepayment don't contribute toward your MACC commitment. However, the Azure Prepayment purchase itself decrements your MACC commitment.
 
-If your organization purchased Azure Prepayment, the consumption or purchases that are covered by credits won't contribute towards your MACC commitment.  However, the actual Prepayment purchase itself will decrement your MACC commitment.
+**Example:** Contoso makes a MACC commitment of $50,000 in May. In June, they purchase an Azure Prepayment of $10,000. This purchase decrements their MACC commitment, leaving a remaining balance of $40,000. During June, Contoso consumes $10,000 of Azure Prepayment-eligible services. These service charges are covered by their Azure Prepayment and don't decrement their MACC commitment. Once the Azure Prepayment is fully used, all Azure service consumption and other eligible purchases decrement their MACC commitment.
 
-For example, Contoso made a MACC commitment of $50,000 in May. In June, they purchased an Azure Prepayment of $10,000. The purchase will decrement their MACC commitment and the remaining commitment will be $40,000. In June, Contoso consumed $10,000 of Azure Prepayment-eligible services. The service charges will be covered by their Azure Prepayment; however, the service charges  won’t decrement their MACC commitment. Once the Azure Prepayment is fully used, all Azure service consumption and other eligible purchases will decrement their MACC commitment.
 
 ## Check access to a Microsoft Customer Agreement
 [!INCLUDE [billing-check-mca](../../../includes/billing-check-mca.md)]