Skip to content

Commit 8e3076e

Browse files
Carolyn135Carolyn135
authored
Merge pull request #312157 from shrutis06/main
Adding CACO track and manage documentation
2 parents b764b47 + 5a8fcf7 commit 8e3076e

10 files changed

Lines changed: 271 additions & 0 deletions

‎articles/cost-management-billing/benefits/caco/manage-conditional-credit-offer.md‎

Lines changed: 68 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,68 @@
1+
---
2+
title: Manage a Conditional Azure Credit Offer (CACO) resource
3+
description: Learn how to manage your Conditional Azure Credit Offer (CACO) resource, including moving it across resource groups or subscriptions.
4+
author: dekadays
5+
ms.reviewer: liuyizhu
6+
ms.service: cost-management-billing
7+
ms.subservice: billing
8+
ms.topic: how-to
9+
ms.date: 2/23/2026
10+
ms.author: liuyizhu
11+
#customer intent: As a Microsoft Customer Agreement billing owner, I want learn about managing a CACO so that I move it when needed.
12+
13+
service.tree.id: b69a7832-2929-4f60-bf9d-c6784a865ed8
14+
---
15+
16+
# Manage a Conditional Azure Credit Offer (CACO) resource under a subscription
17+
18+
When you accept a Conditional Azure Credit Offer (CACO) in a Microsoft Customer Agreement, it creates a CACO commitment and 1 or more provisional (not spendable) credit resources. The CACO commitment and provisional (not spendable) credit resources get placed in a subscription and resource group, and follow the same setup as the other credit resource as mentioned in [Manage a Microsoft Azure credit resource under a subscription](../credits/manage-azure-credits.md). The provisional credit resources turn into awarded credits if the spending target and other conditions in the CACO are met. Moving a CACO resource doesn't move any provisional or awarded credits. Those credit resources have to be moved separately as needed.
19+
20+
On Azure portal, you can view metadata related to the CACO. Including: status of the CACO, CACO start/end date, spend target, currency, target end date, award credit, award start date, award end date, and System ID. You can view the metadata under the Conditional Credit resource.
21+
22+
:::image type="content" source="../../manage/media/conditional-credit-offer/view-conditional-credit-offer.png" border="true" alt-text="Screenshot showing the CACO overview page." lightbox="../../manage/media/conditional-credit-offer/view-conditional-credit-offer.png" :::
23+
24+
## Move CACO across resource groups or subscriptions
25+
26+
You can move the CACO to another resource group or subscription just like other Azure resources. This move only changes metadata and doesn't impact the credit or commitment.
27+
28+
The new resource group or subscription must remain within the same billing profile as the original billing profile where the CACO is currently located.
29+
30+
Moving a CACO resource doesn't move any provisional or awarded credits. Those credit resources have to be moved separately as needed.
31+
32+
### To move a CACO
33+
34+
Here are the high-level steps to move a CACO resource. For more information about moving an Azure resource, see [Move Azure resources to a new resource group or subscription](../../../azure-resource-manager/management/move-resource-group-and-subscription.md).
35+
36+
1. In the [Azure portal](https://portal.azure.com), navigate to **Resource groups**.
37+
2. Select the resource group that contains the CACO resource.
38+
3. Select the CACO resource.
39+
4. At top of the page select **Move** and then select **Move to another subscription** or **Move to another resource group**.
40+
5. Follow the instructions to move the CACO resource.
41+
6. After the move is complete, verify that the CACO resource is in the new resource group or subscription.
42+
43+
Moving a CACO changes its resource URI.
44+
45+
### To view the CACO resource URI
46+
47+
1. In the [Azure portal](https://portal.azure.com), search for **Conditional Azure Credit Offer**.
48+
2. Select the CACO resource.
49+
3. On the Overview page, in the left navigation menu, expand **Settings**, and then select **Properties**.
50+
4. The CACO resource URI is the **ID** value.
51+
52+
Here's an example image:
53+
54+
:::image type="content" source="../../manage/media/conditional-credit-offer/conditional-credit-offer-uri.png" border="true" alt-text="Screenshot showing the CACO properties page URI." lightbox="../../manage/media/conditional-credit-offer/conditional-credit-offer-uri.png" :::
55+
56+
57+
## Rename CACO
58+
The CACO's resource name is a part of its Uniform Resource Identifier (URI) and can't be changed. However, you can use [tags](../../../azure-resource-manager/management/tag-resources.md) to help identify the CACO resource based on a nomenclature relevant to your organization.
59+
60+
## Delete CACO
61+
A CACO resource may only be deleted if its status is _failed_, _canceled_, or _expired_. Deletion of a CACO resource is a permanent action and can't be undone.
62+
63+
## Cancel CACO
64+
Contact your Microsoft account team if you have questions about canceling your CACO.
65+
66+
## Related content
67+
- [Move Azure resources to a new resource group or subscription](../../../azure-resource-manager/management/move-resource-group-and-subscription.md)
68+

‎articles/cost-management-billing/benefits/caco/track-conditional-credit-offer.md‎

Lines changed: 197 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,197 @@
1+
---
2+
title: Track your Conditional Azure Credit Offer (CACO)
3+
description: Learn how to track your Conditional Azure Credit Offer (CACO) for a Microsoft Customer Agreement.
4+
author: shrutis06
5+
ms.reviewer: shrshett
6+
ms.service: cost-management-billing
7+
ms.subservice: billing
8+
ms.topic: how-to
9+
ms.date: 02/23/2026
10+
ms.author: shrshett
11+
ms.custom: sfi-image-nochange
12+
---
13+
14+
# Track your Conditional Azure Credit Offer (CACO)
15+
16+
A Conditional Azure Credit Offer (CACO) is a contractual agreement in which your organization commits to specific, predefined spend targets within set time periods and receives Azure credits for meeting these targets. A CACO is composed of multiple milestones with specific spend targets and an associated ACO award at the end of each milestone, allowing your organization to align rewards with your consumption patterns and business goals.
17+
18+
19+
## Prerequisites
20+
21+
To view CACO details, you must have any of the following roles:
22+
23+
**Billing Account Access**
24+
- Owner, Contributor, or Reader role on the Microsoft Customer Agreement (MCA) billing account
25+
26+
**Subscription Access**
27+
- Owner, Contributor, or Reader role on the subscription where the CACO resource is created
28+
29+
> [!NOTE]
30+
> You only need permissions at one of these levels to view CACO details and track milestone progress.
31+
32+
## Track your CACO Commitment
33+
34+
### [Azure portal](#tab/portal)
35+
36+
1. Sign in to the [Azure portal](https://portal.azure.com).
37+
2. Search for **Cost Management + Billing**.
38+
:::image type="content" source="../../manage/media/conditional-credit-offer/cost-management-billing-search.png" alt-text="Screenshot showing search in portal for Cost Management + Billing." lightbox="../../manage/media/conditional-credit-offer/cost-management-billing-search.png" :::
39+
3. In the billing scopes page, select the billing account for which you want to track the commitment.
40+
:::image type="content" source="../../manage/media/conditional-credit-offer/billing-scopes-list.png" alt-text="Screenshot that shows Billing Scopes." lightbox="../../manage/media/conditional-credit-offer/billing-scopes-list.png" :::
41+
4. Select **Benefits** from the left-hand side and then select the **Conditional Azure Credit Offer (CACO)** tile.
42+
:::image type="content" source="../../manage/media/conditional-credit-offer/benefits-page.png" alt-text="Screenshot that shows selecting the CACO tab for MCA." lightbox="../../manage/media/conditional-credit-offer/benefits-page.png" :::
43+
44+
## CACO page overview
45+
46+
The Conditional Azure Credit Offer (CACO) tab has the following sections.
47+
48+
#### Overall commitment
49+
50+
:::image type="content" source="../../manage/media/conditional-credit-offer/conditional-credit-offer-page.png" alt-text="Screenshot of CACO page." lightbox="../../manage/media/conditional-credit-offer/conditional-credit-offer-page.png" :::
51+
52+
The overall commitment displays the total commitment amount for your CACO, across milestones.
53+
54+
#### Details
55+
56+
The Details section displays other important aspects of your commitment.
57+
58+
| Term | Definition |
59+
|---|---|
60+
| ID | An identifier that uniquely identifies your CACO. |
61+
| Start date | The date when the commitment becomes effective. |
62+
| End date | The date when the commitment expires, which is the end date of the last milestone. |
63+
| Commitment amount | The aggregated amount you commit to spend on CACO-eligible products/services across milestones. |
64+
| Status | The status of your commitment. |
65+
66+
Your CACO can have one of the following statuses:
67+
68+
- **Scheduled:** The CACO has a future start date and isn't yet active. No eligible Azure spend contributes toward your commitment until the start date is reached.
69+
- **Active:** The CACO is currently in effect. Eligible Azure spend contributes toward fulfilling your commitment.
70+
- **Completed:** The CACO commitment amount is fully met. No further action is required.
71+
- **Expired:** The CACO end date passes without the commitment being fully met. Contact your Microsoft Account team for more information.
72+
- **Canceled:** The CACO is terminated before the end date. New Azure spend doesn't contribute toward your CACO commitment. Contact your Microsoft Account team for more information.
73+
74+
#### Upcoming Milestone
75+
76+
The Upcoming Milestone section displays the next milestone that needs to be achieved to earn the associated ACO award.
77+
78+
| Term | Definition |
79+
|---|---|
80+
| Start Date | The date when the milestone period begins |
81+
| End Date | The date by which the milestone must be met |
82+
| Consumption target | The spending amount required to achieve this milestone |
83+
| Target ACO | The Azure Credit Offer award amount you receive for meeting this milestone |
84+
| Status | Whether the milestone is active, pending, met, or missed |
85+
86+
You can select **Show all Milestones** to view the complete list of milestones for your CACO commitment.
87+
88+
#### Transactions
89+
90+
This section displays transactions that decremented your CACO commitment.
91+
92+
| Term | Definition |
93+
|---|---|
94+
| Date | The date when the event happened |
95+
| Description | A description of the event |
96+
| Billing profile | The billing profile for which the event happened. The billing profile only applies to Microsoft Customer Agreements. |
97+
| CACO decrement | The amount of CACO decrement from the event |
98+
| Remaining commitment | The remaining CACO commitment after the event |
99+
100+
## CACO Milestones
101+
102+
Every CACO offer consists of one or many milestones with a target amount, date, and corresponding credit award for meeting the milestone amount.
103+
104+
- **Met milestone:** If you meet a milestone by its due date, you receive the corresponding ACO (Azure Credit Offer) award associated with that milestone.
105+
106+
- **Missed milestone:** If you don't meet a milestone by its due date, the system forfeits the ACO award corresponding to that milestone.
107+
108+
#### All Milestones
109+
110+
When you select **Show all Milestones**, you can view a comprehensive list of all milestones associated with your CACO commitment. This view provides detailed information about each milestone's progress and status.
111+
112+
:::image type="content" source="../../manage/media/conditional-credit-offer/conditional-credit-offer-milestones.png" alt-text="Screenshot of all CACO milestones." lightbox="../../manage/media/conditional-credit-offer/conditional-credit-offer-milestones.png" :::
113+
114+
| Column | Definition |
115+
|---|---|
116+
| ID | The unique identifier for each milestone (for example, Milestone1, Milestone2, Milestone3) |
117+
| End Date | The deadline by which the milestone must be achieved |
118+
| Consumption target | The total spending amount required to meet this milestone |
119+
| Progress% | The current progress percentage toward achieving the milestone consumption target |
120+
| ACO award | The Azure Credit Offer amount you receive if the milestone is met |
121+
| Status | The current status of the milestone |
122+
123+
**Milestone statuses:**
124+
125+
| Status | Description |
126+
|--------|-------------|
127+
| Scheduled | The milestone has a future start date and isn't yet active. |
128+
| Active | The milestone is currently in progress and eligible Azure spend contributes toward fulfilling the milestone target. |
129+
| Pending | The milestone is pending evaluation. |
130+
| Completed | The milestone target is successfully met within the specified timeframe and the system grants the associated ACO award. |
131+
| Missed | The milestone deadline passes without meeting the consumption target. The system forfeits the ACO award corresponding to this milestone. |
132+
| Canceled | The system cancels the milestone before completion. This situation may occur when you modify or terminate the overall CACO commitment. |
133+
| Removed | The system removes the milestone from the CACO commitment. This status typically occurs when you renegotiate commitment terms. |
134+
135+
136+
## CACO Alerts
137+
138+
Microsoft sends email notifications to Billing Account Admins to help ensure CACO commitments and milestones are met on time to receive ACO awards. These alerts provide advance notice so you can take action before forfeiting ACO awards.
139+
140+
### CACO expiry alerts
141+
142+
If your CACO target isn't reached, email notifications are sent to Billing Account Admins at the following intervals before the CACO end date:
143+
144+
- 90 days before expiry
145+
- 60 days before expiry
146+
- 30 days before expiry
147+
148+
### Milestone alerts
149+
150+
Email alerts are sent to Billing Account Admins at the following intervals before each milestone due date if the milestone target isn't met:
151+
152+
- 90 days before milestone due date
153+
- 60 days before milestone due date
154+
- 30 days before milestone due date
155+
156+
---
157+
158+
## Azure Services eligible for CACO
159+
160+
CACO spend eligibility differs from traditional MACC (Microsoft Azure Consumption Commitment) in several key areas. The following table outlines which Azure services and purchases are eligible for CACO spend tracking:
161+
162+
| Service/Purchase Type | CACO Eligibility | MACC Eligibility | Notes |
163+
|----------------------|------------------|-------------------|--------|
164+
| **All consumption pay-as-you-go charges** | ✅ | ✅ | Standard consumption charges count toward CACO milestones |
165+
| **Azure 1st party entitlement purchases (Reserved Instances/Azure Savings Plans)** | | | |
166+
| - Upfront/Monthly Billing | ✅ | ✅ | Initial purchase or monthly payments count toward milestones |
167+
| - Monthly Usage | ❌ | ❌ | Usage covered by these purchases doesn't count |
168+
| **Azure Pre-payments (Monetary Credits)** | | | |
169+
| - Purchase | ❌ | ✅ | **Key Difference**: CACO doesn't count prepayment purchases |
170+
| - Prepayment Spend | ✅ | ❌ | **Key Difference**: CACO counts spending of prepayment credits |
171+
| **MACC Milestone Shortfall Credit** | | | |
172+
| - Purchase | ❌ | ✅ | Milestone shortfall credit purchase doesn't count toward CACO |
173+
| - Credit Applied | ✅ | ❌ | Milestone shortfall credit use goes towards CACO |
174+
| **MACC Shortfall Charge (Credit)** | | | |
175+
| - Purchase | ❌ | ✅ | MACC shortfall credit purchase doesn't count toward CACO |
176+
| - Credit Applied | ❌ | ❌ | MACC shortfall credit use doesn't go towards CACO as it's the penalty charge for not fulfilling MACC commitment |
177+
| **Awarded Credits (ACO, Outage, Goodwill)** | | | |
178+
| - Awarded Amount | ❌ | ❌ | Any credits that aren't purchased don't count towards commitments |
179+
| - Credit Applied | ❌ | ❌ | Consumption covered by awarded credits doesn't count |
180+
| **Azure Marketplace** | ❌ | ✅ | **Key Difference**: Marketplace purchases don't count toward CACO milestones |
181+
182+
### Key Differences from MACC
183+
184+
**CACO focuses on actual consumption rather than purchases:**
185+
- **Azure Prepayments**: Unlike MACC where prepayment purchases count toward commitment but prepayment spending doesn't, CACO operates on the opposite principle - prepayment purchases don't count toward milestones, but spending those prepayment credits does count toward your CACO commitment
186+
- **Marketplace purchases**: Not eligible for CACO milestone tracking (unlike MACC)
187+
188+
This consumption-focused approach ensures that ACO awards are based on genuine Azure service consumption rather than upfront credit purchases, regardless of the payment method used to cover that consumption.
189+
190+
191+
## Need help? Contact support
192+
193+
If you need help, [contact support](https://portal.azure.com/?#blade/Microsoft_Azure_Support/HelpAndSupportBlade) to get your issue resolved quickly.
194+
195+
196+
197+

‎articles/cost-management-billing/manage/media/conditional-credit-offer/benefits-page.png‎

748 KB
Loading

‎articles/cost-management-billing/manage/media/conditional-credit-offer/billing-scopes-list.png‎

188 KB
Loading

‎articles/cost-management-billing/manage/media/conditional-credit-offer/conditional-credit-offer-milestones.png‎

508 KB
Loading

‎articles/cost-management-billing/manage/media/conditional-credit-offer/conditional-credit-offer-page.png‎

536 KB
Loading

‎articles/cost-management-billing/manage/media/conditional-credit-offer/conditional-credit-offer-uri.png‎

73.1 KB
Loading

‎articles/cost-management-billing/manage/media/conditional-credit-offer/cost-management-billing-search.png‎

153 KB
Loading

‎articles/cost-management-billing/manage/media/conditional-credit-offer/view-conditional-credit-offer.png‎

131 KB
Loading

‎articles/cost-management-billing/toc.yml‎

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -265,6 +265,12 @@
265265
href: benefits/macc/track-consumption-commitment.md
266266
- name: Manage a Microsoft Azure Consumption Commitment
267267
href: benefits/macc/manage-consumption-commitment.md
268+
- name: Manage Conditional Azure Credit Offer
269+
items:
270+
- name: Track your Conditional Azure Credit Offer
271+
href: benefits/caco/track-conditional-credit-offer.md
272+
- name: Manage a Conditional Azure Credit Offer
273+
href: benefits/caco/manage-conditional-credit-offer.md
268274
- name: Troubleshoot billing
269275
items:
270276
- name: Can't view or find invoices

0 commit comments

Comments
 (0)