Merge pull request #293914 from bandersmsft/cm-fields-sync2

MCM - Sync data fields for JoJo

Author: prmerger-automator[bot]

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: 01/07/2025
+ms.date: 01/31/2025
 ms.topic: conceptual
 ms.service: cost-management-billing
 ms.subservice: cost-management
@@ -57,6 +57,7 @@ MPA accounts have all MCA terms, in addition to the MPA terms, as described in t
 | CostAllocationRuleName | EA, MCA | Name of the Cost Allocation rule that's applicable to the record. |
 | CostInBillingCurrency | EA, 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. |
+| costInUsd | MCA | Cost of the charge in USD currency before credits or taxes. |
 | Currency | EA, pay-as-you-go | See `BillingCurrency`. |
 | CustomerName | MPA | Name of the Microsoft Entra tenant for the customer's subscription. |
 | CustomerTenantId | MPA | Identifier of the Microsoft Entra tenant of the customer's subscription. |
@@ -65,6 +66,7 @@ MPA accounts have all MCA terms, in addition to the MPA terms, as described in t
 | ExchangeRateDate | MCA | Date the exchange rate was established. |
 | ExchangeRatePricingToBilling | MCA | Exchange rate used to convert the cost in the pricing currency to the billing currency. |
 | Frequency | All | Indicates whether a charge is expected to repeat. Charges can either happen once (**OneTime**), repeat on a monthly or yearly basis (**Recurring**), or be based on usage (**UsageBased**). |
+| InstanceId | EA, pay-as-you-go | Unique identifier of the [Azure Resource Manager](/rest/api/resources/resources) resource. |
 | InvoiceId | pay-as-you-go, MCA | The unique document ID listed on the invoice PDF. |
 | InvoiceSection | MCA | See `InvoiceSectionName`. |
 | InvoiceSectionId¹ | EA, MCA | Unique identifier for the EA department or MCA invoice section. |
@@ -83,11 +85,14 @@ MPA accounts have all MCA terms, in addition to the MPA terms, as described in t
 | PartnerName | MPA | Name of the partner Microsoft Entra tenant. |
 | PartnerTenantId | MPA | Identifier for the partner's Microsoft Entra tenant. |
 | PartNumber¹ | EA, pay-as-you-go | Identifier used to get specific meter pricing. |
+| paygCostInBillingCurrency | MCA | The amount of Pay-As-You-Go (PayG) cost before tax in billing currency. You can compute `paygCostInBillingCurrency` by multiplying `PayGPrice`, `quantity` and `exchangeRatePricingToBilling`.  |
+| paygCostInUsd | MCA | The amount of Pay-As-You-Go (PayG) cost before tax in USD currency. |
 | PlanName | EA, pay-as-you-go | Marketplace plan name. |
+| PreTaxCost| EA, pay-as-you-go | Cost of the charge before credits or taxes. You can compute `PreTaxCost` by multiplying `ResourceRate` with `UsageQuantity`. |
 | PreviousInvoiceId | MCA | Reference to an original invoice if the line item is a refund. |
 | PricingCurrency | MCA | Currency used when rating based on negotiated prices. |
 | PricingModel | All | Identifier that indicates how the meter is priced. (Values: `OnDemand`, `Reservation`, `Spot`, and `SavingsPlan`) |
-| Product | All | Name of the product. |
+| ProductName | All | Name of the product. |
 | ProductId¹ | MCA | Unique identifier for the product. |
 | ProductOrderId | All | Unique identifier for the product order. |
 | ProductOrderName | All | Unique name for the product order. |
@@ -103,21 +108,25 @@ MPA accounts have all MCA terms, in addition to the MPA terms, as described in t
 | 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 are shown as null or empty, **Others**, or **Not applicable**. |
 | ResourceId¹ | All | Unique identifier of the [Azure Resource Manager](/rest/api/resources/resources) resource. |
 | ResourceLocation¹  | All | The Azure region where the resource is deployed, also referred to as the datacenter location where the resource is running. For an example using Virtual Machines, see [What's the difference between MeterRegion and ResourceLocation](/azure/virtual-machines/vm-usage#what-is-the-difference-between-meter-region-and-resource-location). |
-| ResourceLocationNormalized  | All | Standardized format of the Azure region where the resource is deployed, also referred to as the datacenter location where the resource is running. The normalized location is used to resolve inconsistencies in region names sent by different Azure Resource Providers (RPs). |
+| ResourceLocationNormalized  | EA | Standardized format of the Azure region where the resource is deployed, also referred to as the datacenter location where the resource is running. The normalized location is used to resolve inconsistencies in region names sent by different Azure Resource Providers (RPs). |
 | ResourceName | EA, pay-as-you-go | Name of the resource. Not all charges come from deployed resources. Charges that don't have a resource type are shown as null/empty, **Others** , or **Not applicable**. |
+| ResourceRate | pay-as-you-go | The price for a given product or service that represents the actual rate that you end up paying per unit. |
 | ResourceType | MCA | Type of resource instance. Not all charges come from deployed resources. Charges that don't have a resource type are shown as null/empty, **Others** , or **Not applicable**. |
-| RoundingAdjustment | EA, MCA | Rounding adjustment represents the quantization that occurs during cost calculation. When the calculated costs are converted to the invoiced total, small rounding errors can occur. The rounding errors are represented as `rounding adjustment` to ensure that the costs shown in Cost Management align to the invoice. For more information, see [Rounding adjustment details](#rounding-adjustment-details).  |
 | ServiceFamily | MCA | Service family that the service belongs to. |
 | ServiceInfo1 | All | Service-specific metadata. |
 | ServiceInfo2 | All | Legacy field with optional service-specific metadata. |
+| ServiceName | pay-as-you-go | The service family that the service belongs to. |
 | ServicePeriodEndDate | MCA | The end date of the rating period that defined and locked pricing for the consumed or purchased service. |
 | ServicePeriodStartDate | MCA | The start date of the rating period that defined and locked pricing for the consumed or purchased service. |
+| ServiceTier | pay-as-you-go | Name of the service subclassification category. |
 | SubscriptionId¹ | All | Unique identifier for the Azure subscription. |
 | SubscriptionName | All | Name of the Azure subscription. |
 | Tags¹ | All | Tags assigned to the resource. Doesn't include resource group tags. Can be used to group or distribute costs for internal chargeback. For more information, see [Organize your Azure resources with tags](https://azure.microsoft.com/updates/organize-your-azure-resources-with-tags/). |
 | Term | All | Displays the term for the validity of the offer. For example: For reserved instances, it displays 12 months as the Term. For one-time purchases or recurring purchases, Term is one month (SaaS, Marketplace Support). Not applicable for Azure consumption. |
 | UnitOfMeasure | All | The unit of measure for billing for the service. For example, compute services are billed per hour. |
 | UnitPrice² ³| All | The price for a given product or service inclusive of any negotiated discount that you might have on top of the market price (`PayG` price column) for your contract. For more information, see [Pricing behavior in cost details](automation-ingest-usage-details-overview.md#pricing-behavior-in-cost-and-usage-details). |
+| UsageDateTime | EA, pay-as-you-go | The usage date of the charge in yyyy-mm-dd format. |
+| UsageQuantity | pay-as-you-go | The number of units used by the given product or service for a given day. |
 
 ¹ Fields used to build a unique ID for a single cost record. Every record in your cost details file should be considered unique. 
 
@@ -191,6 +200,8 @@ Meter characteristics - Meters associated with IQ exhibit specific traits in the
 
 ## Rounding adjustment details
 
+A rounding adjustment represents the quantization that occurs during cost calculation. When the calculated costs are converted to the invoiced total, small rounding errors can occur. The rounding errors are represented as `rounding adjustment` to ensure that the costs shown in Cost Management align to the invoice.
+
 ### Why do we have rounding adjustment?
 
 Every financial system involves rounding logic, which can cause some variance. Invoices aggregate monthly costs at the meter level, with costs rounded depending on the currency. In contrast, the cost file contains costs at the resource instance level with higher precision. This difference results in a variance in the total cost between the invoice and the cost file. The rounding adjustment is provided in the cost file at an aggregated level whenever the invoice is ready, ensuring that the total costs in both files match.

articles/cost-management-billing/dataset-schema/cost-usage-details-ea.md

@@ -69,7 +69,7 @@ The following information lists the cost and usage details (formerly known as us
 | 47 |InvoiceSectionId|Unique identifier for the EA department or MCA invoice section.|
 | 48 |IsAzureCreditEligible|Indicates if the charge is eligible to be paid for using Azure credits (Values: `True` or `False`).|
 | 49 |PartNumber|Identifier used to get specific meter pricing.|
-| 50 |PayGPrice|Retail price for the resource.|
+| 50 |PayGPrice|The market price, also referred to as retail or list price, for a given product or service. For more information, see [Pricing behavior in cost details](../automate/automation-ingest-usage-details-overview.md#pricing-behavior-in-cost-and-usage-details).|
 | 51 |PlanName|Marketplace plan name.|
 | 52 |ServiceFamily|Service family that the service belongs to.|
 | 53 |CostAllocationRuleName|Name of the Cost Allocation rule that's applicable to the record.|
@@ -131,7 +131,7 @@ The following information lists the cost and usage details (formerly known as us
 | 47 |InvoiceSectionId|Unique identifier for the EA department or MCA invoice section.|
 | 48 |IsAzureCreditEligible|Indicates if the charge is eligible to be paid for using Azure credits (Values: `True` or `False`).|
 | 49 |PartNumber|Identifier used to get specific meter pricing.|
-| 50 |PayGPrice|Retail price for the resource.|
+| 50 |PayGPrice|The market price, also referred to as retail or list price, for a given product or service. For more information, see [Pricing behavior in cost details](../automate/automation-ingest-usage-details-overview.md#pricing-behavior-in-cost-and-usage-details).|
 | 51 |PlanName|Marketplace plan name.|
 | 52 |ServiceFamily|Service family that the service belongs to.|
 | 53 |CostAllocationRuleName|Name of the Cost Allocation rule that's applicable to the record.|
@@ -188,7 +188,7 @@ The following information lists the cost and usage details (formerly known as us
 | 44 |ServiceFamily|Service family that the service belongs to.|
 | 45 |Frequency|Indicates whether a charge is expected to repeat. Charges can either happen once (OneTime), repeat on a monthly or yearly basis (Recurring), or be based on usage (UsageBased).|
 | 46 |IsAzureCreditEligible|Indicates if the charge is eligible to be paid for using Azure credits (Values: `True` or `False`).|
-| 47 |PayGPrice|Retail price for the resource.|
+| 47 |PayGPrice|The market price, also referred to as retail or list price, for a given product or service. For more information, see [Pricing behavior in cost details](../automate/automation-ingest-usage-details-overview.md#pricing-behavior-in-cost-and-usage-details).|
 | 48 |PricingModel|Identifier that indicates how the meter is priced. (Values: `On Demand`, `Reservation`, `Spot`, and `SavingsPlan`)|
 | 49 |BillingPeriodStartDate|The start date of the billing period.|
 | 50 |BillingPeriodEndDate|The end date of the billing period.|
@@ -210,7 +210,7 @@ The following information lists the cost and usage details (formerly known as us
 | 6 |ResourceGroup|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 are shown as null or empty, `Others`, or `Not applicable`.|
 | 7 |ResourceLocation|The Azure region where the resource is deployed, also referred to as the datacenter location where the resource is running. For an example using Virtual Machines, see [What's the difference between MeterRegion and ResourceLocation](/azure/virtual-machines/vm-usage#what-is-the-difference-between-meter-region-and-resource-location).|
 | 8 |Date|The usage or purchase date of the charge.|
-| 9 |ProductName|  .|
+| 9 |ProductName| Name of the product.|
 | 10 |MeterCategory|Name of the classification category for the meter. For example, `Cloud services` and `Networking`. Purchases and Marketplace usage might be shown as blank or unassigned.|
 | 11 |MeterSubCategory|Name of the meter subclassification category. Purchases and Marketplace usage might be shown as blank or unassigned.|
 | 12 |MeterId|The unique identifier for the meter.|
@@ -251,7 +251,7 @@ The following information lists the cost and usage details (formerly known as us
 | 47 |InvoiceSectionId|Unique identifier for the EA department or MCA invoice section.|
 | 48 |IsAzureCreditEligible|Indicates if the charge is eligible to be paid for using Azure credits (Values: `True` or `False`).|
 | 49 |PartNumber|Identifier used to get specific meter pricing.|
-| 50 |PayGPrice|Retail price for the resource.|
+| 50 |PayGPrice|The market price, also referred to as retail or list price, for a given product or service. For more information, see [Pricing behavior in cost details](../automate/automation-ingest-usage-details-overview.md#pricing-behavior-in-cost-and-usage-details).|
 | 51 |PlanName|Marketplace plan name.|
 | 52 |ServiceFamily|Service family that the service belongs to.|
 | 53 |CostAllocationRuleName|Name of the Cost Allocation rule that's applicable to the record.|
@@ -268,7 +268,7 @@ The following information lists the cost and usage details (formerly known as us
 | 6 |ResourceGroup|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 are shown as null or empty, `Others`, or `Not applicable`.|
 | 7 |ResourceLocation|The Azure region where the resource is deployed, also referred to as the datacenter location where the resource is running. For an example using Virtual Machines, see [What's the difference between MeterRegion and ResourceLocation](/azure/virtual-machines/vm-usage#what-is-the-difference-between-meter-region-and-resource-location).|
 | 8 |Date|The usage or purchase date of the charge.|
-| 9 |ProductName|  .|
+| 9 |ProductName| Name of the product. |
 | 10 |MeterCategory|Name of the classification category for the meter. For example, `Cloud services` and `Networking`. Purchases and Marketplace usage might be shown as blank or unassigned.|
 | 11 |MeterSubCategory|Name of the meter subclassification category. Purchases and Marketplace usage might be shown as blank or unassigned.|
 | 12 |MeterId|The unique identifier for the meter.|
@@ -309,7 +309,7 @@ The following information lists the cost and usage details (formerly known as us
 | 47 |InvoiceSectionId|Unique identifier for the EA department or MCA invoice section.|
 | 48 |IsAzureCreditEligible|Indicates if the charge is eligible to be paid for using Azure credits (Values: `True` or `False`).|
 | 49 |PartNumber|Identifier used to get specific meter pricing.|
-| 50 |PayGPrice|Retail price for the resource.|
+| 50 |PayGPrice|The market price, also referred to as retail or list price, for a given product or service. For more information, see [Pricing behavior in cost details](../automate/automation-ingest-usage-details-overview.md#pricing-behavior-in-cost-and-usage-details).|
 | 51 |PlanName|Marketplace plan name.|
 | 52 |ServiceFamily|Service family that the service belongs to.|
 
@@ -324,7 +324,7 @@ The following information lists the cost and usage details (formerly known as us
 | 5 |SubscriptionName|Name of the Azure subscription.|
 | 6 |ResourceGroup|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 are shown as null or empty, `Others`, or `Not applicable`.|
 | 7 |ResourceLocation|The Azure region where the resource is deployed, also referred to as the datacenter location where the resource is running. For an example using Virtual Machines, see [What's the difference between MeterRegion and ResourceLocation](/azure/virtual-machines/vm-usage#what-is-the-difference-between-meter-region-and-resource-location).|
-| 8 |UsageDateTime|  .|
+| 8 |UsageDateTime| The usage date of the charge in yyyy-mm-dd format.|
 | 9 |ProductName|Name of the product.|
 | 10 |MeterCategory|Name of the classification category for the meter. For example, `Cloud services` and `Networking`. Purchases and Marketplace usage might be shown as blank or unassigned.|
 | 11 |MeterSubcategory|Name of the meter subclassification category. Purchases and Marketplace usage might be shown as blank or unassigned.|
@@ -334,11 +334,11 @@ The following information lists the cost and usage details (formerly known as us
 | 15 |UnitOfMeasure|The unit of measure for billing for the service. For example, compute services are billed per hour.|
 | 16 |UsageQuantity|The number of units used by the given product or service for a given day.|
 | 17 |ResourceRate|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.|
-| 18 |PreTaxCost|  .|
+| 18 |PreTaxCost| Cost of the charge before credits or taxes. You can compute `PreTaxCost` by multiplying `ResourceRate` with `UsageQuantity`.|
 | 19 |CostCenter|The cost center defined for the subscription for tracking costs (only available in open billing periods for MCA accounts).|
 | 20 |ConsumedService|Name of the service the charge is associated with.|
 | 21 |ResourceType| Type of resource instance. Not all charges come from deployed resources. Charges that don't have a resource type are shown as null or empty, `Others` , or `Not applicable`.|
-| 22 |InstanceId|  .|
+| 22 |InstanceId| Unique identifier of the [Azure Resource Manager](/rest/api/resources/resources) resource.|
 | 23 |Tags|Tags assigned to the resource. Doesn't include resource group tags. Can be used to group or distribute costs for internal chargeback. For more information, see [Organize your Azure resources with tags](../../azure-resource-manager/management/tag-resources.md).|
 | 24 |OfferId|Name of the Azure offer, which is the type of Azure subscription that you have. For more information, see supported [Microsoft Azure offer details](https://azure.microsoft.com/support/legal/offer-details/).|
 | 25 |AdditionalInfo|Service-specific metadata. For example, an image type for a virtual machine.|