Merge pull request #233354 from bandersmsft/mca-usage-terms-04042023

MCM - Udpated usage terms for Adam

Author: v-dirichards

articles/cost-management-billing/automate/understand-usage-details-fields.md

@@ -4,7 +4,7 @@ titleSuffix: Microsoft Cost Management
 description: This article describes the fields in the usage data files.
 author: bandersmsft
 ms.author: banders
-ms.date: 03/27/2023
+ms.date: 04/04/2023
 ms.topic: conceptual
 ms.service: cost-management-billing
 ms.subservice: cost-management
@@ -25,7 +25,9 @@ If you're using an older cost details solution and want to migrate to Exports or
 
 ## List of fields and descriptions
 
-The following table describes the important terms used in the latest version of the cost details file. The list covers pay-as-you-go (also called Microsoft Online Services Program), Enterprise Agreement (EA), and Microsoft Customer Agreement (MCA) accounts. To identify what account type you are, see [supported Microsoft Azure offers](../costs/understand-cost-mgt-data.md#supported-microsoft-azure-offers).
+The following table describes the important terms used in the latest version of the cost details file. The list covers pay-as-you-go (also called Microsoft Online Services Program), Enterprise Agreement (EA), Microsoft Customer Agreement (MCA), and Microsoft Partner Agreement (MPA) accounts. 
+
+MPA accounts have all MCA terms, in addition to the MPA terms, as described in the following table. To identify what account type you are, see [supported Microsoft Azure offers](../costs/understand-cost-mgt-data.md#supported-microsoft-azure-offers).
 
 | Term | Account type | Description |
 | --- | --- | --- |
@@ -48,6 +50,8 @@ The following table describes the important terms used in the latest version of
 | CostInBillingCurrency | MCA | Cost of the charge in the billing currency before credits or taxes. |
 | CostInPricingCurrency | MCA | Cost of the charge in the pricing currency before credits or taxes. |
 | Currency | EA, pay-as-you-go | See `BillingCurrency`. |
+| CustomerName | MPA | Name of the Azure Active Directory tenant for the customer's subscription. |
+| CustomerTenantId | MPA | Identifier of the Azure Active Directory tenant of the customer's subscription. |
 | Date¹ | All | The usage or purchase date of the charge. |
 | EffectivePrice | All | Blended unit price for the period. Blended prices average out any fluctuations in the unit price, like graduated tiering, which lowers the price as quantity increases over time. |
 | ExchangeRateDate | MCA | Date the exchange rate was established. |
@@ -58,14 +62,18 @@ The following table describes the important terms used in the latest version of
 | InvoiceSectionId¹ | EA, MCA | Unique identifier for the EA department or MCA invoice section. |
 | InvoiceSectionName | EA, MCA | Name of the EA department or MCA invoice section. |
 | IsAzureCreditEligible | All | Indicates if the charge is eligible to be paid for using Azure credits (Values: `True` or `False`). |
-| Location | MCA | Datacenter location where the resource is running. |
+| Location | MCA | Normalized location of the resource, if different resource locations are configured for the same regions. |
 | MeterCategory | All | Name of the classification category for the meter. For example, _Cloud services_ and _Networking_. |
 | MeterId¹ | All | The unique identifier for the meter. |
 | MeterName | All | The name of the meter. |
 | MeterRegion | All | Name of the datacenter location for services priced based on location. See Location. |
 | MeterSubCategory | All | Name of the meter subclassification category. |
 | OfferId¹ | All | Name of the offer purchased. |
 | pay-as-you-goPrice | All | Retail price for the resource. |
+| PartnerEarnedCreditApplied | MPA | Indicates whether the partner earned credit has been applied. |
+| PartnerEarnedCreditRate | MPA | Rate of discount applied if there's a partner earned credit (PEC), based on partner admin link access. |
+| PartnerName | MPA | Name of the partner Azure Active Directory tenant. |
+| PartnerTenantId | MPA | Identifier for the partner's Azure Active Directory tenant. |
 | PartNumber¹ | EA, pay-as-you-go | Identifier used to get specific meter pricing. |
 | PlanName | EA, pay-as-you-go | Marketplace plan name. |
 | PreviousInvoiceId | MCA | Reference to an original invoice if the line item is a refund. |
@@ -76,9 +84,12 @@ The following table describes the important terms used in the latest version of
 | ProductOrderId | All | Unique identifier for the product order. |
 | ProductOrderName | All | Unique name for the product order. |
 | Provider | All | Identifier for product category or Line of Business. For example, Azure, Microsoft 365, and AWS. |
+| PublisherId | MCA | The ID of the publisher. It's only available after the invoice is generated. |
 | PublisherName | All | Publisher for Marketplace services. |
-| PublisherType | All | Type of publisher (Values: **Azure**, **AWS**, **Marketplace**). |
+| PublisherType | All | Supported values: **Microsoft**, **Azure**, **AWS**, **Marketplace**. Values are `Microsoft` for MCA accounts and `Azure` for EA and pay-as-you-go accounts. |
 | Quantity | All | The number of units purchased or consumed. |
+| ResellerName | MPA | The name of the reseller associated with the subscription. |
+| ResellerMpnId | MPA | ID for the reseller associated with the subscription. |
 | ReservationId | EA, MCA | Unique identifier for the purchased reservation instance. |
 | ReservationName | EA, MCA | Name of the purchased reservation instance. |
 | ResourceGroup | All | Name of the [resource group](../../azure-resource-manager/management/overview.md) the resource is in. Not all charges come from resources deployed to resource groups. Charges that don't have a resource group will be shown as null or empty, **Others**, or **Not applicable**. |
@@ -106,6 +117,21 @@ The cost details file itself doesn’t uniquely identify individual records with
 
 Some fields might differ in casing and spacing between account types. Older versions of pay-as-you-go cost details files have separate sections for the statement and daily cost.
 
+### List of terms from older APIs
+
+The following table maps terms used in older APIs to the new terms. Refer to the above table for those descriptions.
+
+Old term | New term
+--- | ---
+ConsumedQuantity | Quantity
+IncludedQuantity | N/A
+InstanceId | ResourceId
+Rate | EffectivePrice
+Unit | UnitOfMeasure
+UsageDate | Date
+UsageEnd | Date
+UsageStart | Date
+
 ## Next steps
 
 - Get an overview of how to [ingest cost data](automation-ingest-usage-details-overview.md).

articles/cost-management-billing/understand/mca-understand-your-usage.md

@@ -7,7 +7,7 @@ tags: billing
 ms.service: cost-management-billing
 ms.subservice: billing
 ms.topic: conceptual
-ms.date: 01/13/2023
+ms.date: 04/04/2023
 ms.author: banders
 ---
 
@@ -21,9 +21,17 @@ To get your Azure usage and charges file, see [View and download Azure usage and
 
 Usage charges are the total **monthly** charges on a subscription. The usage charges don't take into account any credits or discounts.
 
+## Detailed terms and descriptions
+
+If you want to see a list of all available terms in the MCA usage file, see [Understand cost details data fields](../automate/understand-usage-details-fields.md).
+
+### Make sure that charges are correct
+
+If you want to make sure that the charges in your detailed usage file are correct, you can verify them. See [Understand the charges on your billing profile's invoice](review-customer-agreement-bill.md)
+
 ## Changes from Azure EA usage and charges
 
-If you're an EA customer, you'll notice that the terms in the Azure billing profile usage CSV file differ from the terms in the Azure EA usage CSV file. Here's a mapping of EA usage terms to billing profile usage terms:
+If you're an EA customer, notice that the terms in the Azure billing profile usage CSV file differ from the terms in the Azure EA usage CSV file. Here's a mapping of EA usage terms to billing profile usage terms:
 
 | Azure EA usage CSV | Microsoft Customer Agreement Azure usage and charges CSV | Description |
 | --- | --- | --- |
@@ -54,65 +62,6 @@ If you're an EA customer, you'll notice that the terms in the Azure billing prof
 | ResourceGroup | resourceGroup | Name of the resource group associated with the resource. |
 | ChargesBilledSeparately | isAzureCreditEligible | Indicates if the charge is eligible to be paid for using Azure credits. |
 
-## Detailed terms and descriptions
-
-The following  terms are shown in the Azure usage and charges file.
-
-Term | Description
---- | ---
-invoiceId | The unique document ID listed on the invoice PDF
-previousInvoiceId | Reference to an original invoice if this line item is a refund
-billingAccountName | Name of the Billing account
-billingAccountId | Unique identifier for the root billing account
-billingProfileId | Name of the billing profile that is accruing the charges that are invoiced
-billingProfileName | Unique identifier for the Billing Profile that is accruing the charges that are invoiced
-invoiceSectionId | Unique identifier for the Invoice section
-invoiceSectionName | Name of the invoice section
-costCenter | The cost center defined on the subscription for tracking costs (only available in open billing periods)
-billingPeriodStartDate | The start date of the billing period for which the invoice is generated
-billingPeriodEndDate | The end date of the billing period for which the invoice is generated
-servicePeriodStartDate | The start date of the rating period that has defined and locked pricing for the consumed or purchased service
-servicePeriodEndDate | The end date of the rating period that has defined and locked pricing for the consumed or purchased service
-date | For Azure and Marketplace usage-based charges, it's the rating date. For one-time purchases (Reservations, Marketplace) or fixed recurring charges (support offers), it's the purchase date.
-serviceFamily | Service family that the service belongs to
-productOrderId | Unique identifier for the product order
-productOrderName | Unique name for the product order
-consumedService | Name of the consumed service
-meterId | The unique identifier for the meter
-meterName | The name of the meter
-meterCategory | Name of the classification category for the meter. For example, *Cloud services*, *Networking*, etc.
-meterSubCategory | Name of the meter subclassification category
-meterRegion | Name of the region where the meter for the service is available. Identifies the location of the data center for certain services that are priced based on data center location.
-offer | Name of the offer purchased
-PayGPrice | Retail price for the resource.
-PricingModel | Identifier indicating how the meter is priced (Values: On Demand, Reservation, Spot)
-productId | Unique identifier for the product accruing the charges
-product | Name of the product accruing the charges
-subscription ID | Unique identifier for the subscription accruing the charges
-subscriptionName | Name of the subscription accruing the charges
-reservationId | Unique identifier for the purchased reservation instance
-reservationName | Name of the purchased reservation instance
-publisherType | Microsoft, Azure, Marketplace, and AWS costs.  Values are `Microsoft` for Microsoft Customer Agreement accounts and `Azure` for EA and pay-as-you-go accounts.
-publisherName | Publisher for Marketplace services
-resourceGroupId | Unique identifier for the resource group associated with the resource
-resourceGroupName | Name of the resource group associated with the resource
-resourceId | Unique identifier for the resource instance
-resourceType | Type of resource instance
-resourceLocation | Identifies the location of the data center where the resource is running.
-location | Normalized location of the resource if different resource locations are configured for the same regions
-quantity | The number of units purchased or consumed
-unitOfMeasure | The unit of measure for billing for the service. For example, compute services are billed per hour.
-chargeType | The type of charge. Values: <br><br>• AsCharged-Usage - Charges that are accrued based on usage of an Azure service. It includes usage against VMs that aren't charged because of reserved instances.<br><br>• AsCharged-PurchaseMarketplace - Either one-time or fixed recurring charges from Marketplace purchases<br><br>• AsCharged-UsageMarketplace - Charges for Marketplace services that are charged based on units of consumption
-isAzureCreditEligible | Flag that indicates if the charge against the service is eligible to be paid for using Azure credits (Values: True, False)
-serviceInfo1 | Service-specific metadata
-serviceInfo2 | Legacy field that captures optional service-specific metadata
-additionalInfo | Other service-specific metadata.
-tags | Tags you assign to the resource
-
-### Make sure that charges are correct
-
-If you want to make sure that the charges in your detailed usage file are correct, you can verify them. See [Understand the charges on your billing profile's invoice](review-customer-agreement-bill.md)
-
 ## Check access to a Microsoft Customer Agreement
 [!INCLUDE [billing-check-mca](../../../includes/billing-check-mca.md)]