New billing report fields
If you already use the new bills, use this topic to understand how the new bill UI differs from the old one and what each field means in reports such as Bill Details, Split Bill, and Cost Details.
Differences between the new and old bills
Alibaba Cloud has fully upgraded bills to the new version and is gradually closing the entry points to the old bills. Current status:
The new bills are the default version and cover all bill data.
The entry points to the old bills are being phased out. If the old entry point is already closed for your account and you still need historical bill data in the old format, export the data through bill subscription to OSS. For more information, see Export and subscribe to bills.
|
Bill version |
Description |
UI of each version |
|
New bills |
The new bills are available in the new (blue) edition of the Expenses and Costs console. Key changes:
Other bill types, such as Overview of Monthly Bill and Allocated Cost, remain the same as the old version. |
New Bill Details page: The filter area supports filtering by billing month, enterprise/organization/account, product name, commodity name, cost type, resource name/instance ID, and order number. The structured bill table below includes columns such as identifiers (order number), account information (resource purchaser account ID, resource purchaser account, resource owner account ID, and resource owner account), service entity, billing month, bill date, and cost type. |
|
Old bills |
The old bill version provided in the old (orange) edition of the Expenses and Costs console |
The filter area of the old Bill Details page includes statistic item (billable item, instance, product, account, or financial unit), statistic period (billing month, day, or detail), billing month, product name, commodity name, resource group, and instance name/ID. The result table shows columns such as resource purchaser account, resource owner account, billing month, and product and commodity information. |
Bill details
|
Change category |
Description |
|
|
Statistic dimensions |
Before the upgrade: Bill details support the billable item, instance, product, account, and financial unit dimensions, and the billing month, day, and detail statistic periods. After the upgrade: Bill details support the billable item, resource (formerly instance), product, and account dimensions, and the billing month, day, and detail statistic periods. |
|
|
Feature upgrades |
For more information, see Bill details. |
|
|
New fields |
Service entity |
For example, "Alibaba Cloud Computing Co., Ltd." |
|
Cost type |
For example, "subscription upfront fee". This field differs from the transaction type in the old bills. |
|
|
Resource ID |
A unique resource identifier added in the new bills |
|
|
Region code |
A standardized region code, such as |
|
|
Duration details |
Extended duration information |
|
|
Usage details |
Extended usage information |
|
|
List price usage tier |
Tiered pricing information |
|
|
Usage tier accumulation rule |
How tiered usage is accumulated |
|
|
List price conversion information |
Pricing conversion information |
|
|
Subscription credit details |
Details of subscription credits |
|
|
Coupon credit details |
Details of coupon credits |
|
|
Unsupported fields |
Public IP, private IP, resource group, instance tags, financial unit |
No longer displayed in bill details. Use the new "Split Bill" report instead. |
|
Associated order/bill number |
No longer displayed separately. Query the associated information by order number. |
|
|
Business type |
No longer displayed |
|
|
Service duration |
No longer displayed separately. Use the Duration field to get the billed duration. |
|
|
Billing cycle |
No longer displayed separately. Check the service start and end times instead. |
|
|
Remarks |
No longer displayed (including refund descriptions and disk types). If you need this information, contact customer service or submit a ticket. |
|
|
List price pricing type |
No longer displayed. This field was always empty in historical data, so there's no actual impact. |
|
|
Generalized usage |
No longer displayed. Use the Usage field on the bill instead. |
|
Field format changes
|
Change |
Old bills |
New bills |
Affected channel |
Description |
|
Unique identifier of bill line items |
Primary key (such as |
Bill detail ID (such as |
Online Excel bill download |
The identifier rule has changed. If you have automated reconciliation logic based on the primary key, adapt it to the new format. |
|
Billing month format |
Text (such as |
Numeric (such as |
Online Excel bill download |
Standardized format for easier system processing |
|
Bill date format |
|
|
Online Excel bill download |
Standardized date format |
Field name and definition changes
|
Change |
Old field name |
New field name |
Description |
|
Billing month |
Billing cycle |
Billing month |
Name change only. Values remain unchanged. |
|
Start/end time of consumption |
Bill start time/Bill end time |
Service start time/Service end time |
Name change only. Values remain unchanged. |
|
Specific commodity under a cloud service |
Product detail/Product detail code |
Commodity name/Commodity code |
Name change only. Values remain unchanged. |
|
Account that purchases and pays for resources |
Account/Account ID |
Resource purchaser account/Resource purchaser account ID |
Name change only. Values remain unchanged. |
|
Account that actually uses resources |
Owner account/Owner account ID |
Resource owner account/Resource owner account ID |
Name change only. Values remain unchanged. |
|
Order number/Bill number |
Order number/Bill number |
Order number |
Bill numbers for pay-as-you-go are no longer displayed separately after monthly settlement. |
|
Instance configuration |
Instance configuration |
Configuration |
Name change with partially adjusted values. Describes the configuration of a billable item. |
|
Instance specification |
Instance specification |
Specification |
Name change with partially adjusted values. Describes the specification of a billable item. |
|
Consumption type |
Consumption type (such as "subscription" or "pay-as-you-go") |
Cost type |
The information is consolidated into cost fields. |
|
Bill type |
Bill type (such as "new purchase", "renewal", or "pay-as-you-go bill") |
Transaction type (such as "new purchase") |
Some transaction type names are adjusted. For example, "upgrade" and "downgrade" are now listed separately. |
|
Resource instance ID |
Instance ID |
Instance ID (billing granularity) |
Name change only. Values remain unchanged. |
|
Resource instance name |
Asset/Instance name |
Resource name |
Name change only. Values remain unchanged. |
|
Usage duration |
Usage duration |
Duration |
Name change with optimized values. The field has a value only when duration is part of the billing formula. |
|
List price |
Unit price/Unit price unit |
Official list price/Price unit |
Name change only. Values remain unchanged. |
|
Total list price |
Official price |
Total list price |
Name change only. Values remain unchanged. |
|
Factors that affect the list price |
Unit price factor |
List price factor |
Name change only. Values remain unchanged. |
|
Information related to cost calculation |
Billing factor |
Auxiliary billing information |
Name change only. Values remain unchanged. |
|
Discount details |
Separate fields such as discount ID, discount name, discount type, item discount, and combination discount |
Consolidated into the "Discount details" field |
Discount information is consolidated into a details field. |
|
Savings plan deduction |
Savings plan deduction amount, savings plan instance ID, and other fields |
Consolidated into the "Subscription credit amount" and "Subscription credit details" fields |
Subscription credit information is consolidated. |
|
Resource plan deduction |
Resource plan deduction volume/Resource plan deduction/Deducting resource plan ID/Deducting resource plan name |
Consolidated into the "Deducted usage" and "Usage details" fields |
Subscription resource plan deduction information is consolidated. |
|
Billing rule description |
Billing rule description |
Billing rules |
Name change only. Values remain unchanged. |
|
Some product codes/billable items |
Old product codes and billable item names |
New product codes and billable item names |
The mappings between products and billable items are adjusted for some commodities. For more information, see Product and billing item changes. |
Split bills
|
Change category |
Description |
|
Split bill field updates |
For more information, see Split bill details. |
Cost details
|
Change category |
Description |
|
New feature |
Cost details show cost data split to the cloud resource level and amortized to the day level based on allocation rules, which helps you analyze your cost composition. For more information, see Cost details. |
Bill subscription
|
Change category |
Description |
|
New feature |
After you switch to the new bills, you can subscribe through OSS or MaxCompute to the bills generated after the switch. For more information, see Export and subscribe to bills. |
Detailed field descriptions for the new bills
Identifiers (LineItemDetails)
|
Field name (console) |
Field name (OSS subscription) |
Description |
|
Order number |
LineItemDetails/OrderId |
The unique number that Alibaba Cloud assigns to an order based on specific rules.
|
Account information (IdentityDetails)
|
Field name (console) |
Field name (OSS subscription) |
Description |
|
Resource purchaser account ID |
IdentityDetails/ResourcePurchaseAccountId |
The ID of the account that purchases the Alibaba Cloud resource instance. |
|
Resource purchaser account |
IdentityDetails/ResourcePurchaseAccount |
The name of the account that purchases the Alibaba Cloud resource instance. |
|
Resource owner account ID |
IdentityDetails/ResourceOwnerAccountId |
The ID of the account that actually uses the resource instance. It sometimes differs from the resource purchaser account ID. |
|
Resource owner account |
IdentityDetails/ResourceOwnerAccount |
The name of the account that actually uses the resource instance. It sometimes differs from the resource purchaser account. |
Billing information (BillingDetails)
|
Field name (console) |
Field name (OSS subscription) |
Description |
|
Service entity |
BillingDetails/ServiceEntity |
The name of the company that provides the product or service. Alibaba Cloud sells a wide range of products, and some products may be provided by different companies. |
|
Billing month |
BillingDetails/BillingMonth |
The bill period displayed in contract documents, that is, the billing month. |
|
Bill date |
BillingDetails/BillingDate |
The date on which you consume the cloud service. |
|
Cost type |
BillingDetails/LineItemType |
Identifies the type of fee that the bill records, including:
|
|
Transaction type |
BillingDetails/ConsumeType |
The transaction type of the bill, including the following types:
|
|
Consumed time |
BillingDetails/ConsumedTime |
The payment time or fee occurrence time of the consumption record:
|
|
Service start time |
BillingDetails/ServiceStartTime |
The time when the consumption starts.
|
|
Service end time |
BillingDetails/ServiceEndTime |
The time when the consumption ends.
|
|
Amortization start time |
BillingDetails/ServiceStartTime |
The time when cost amortization for the cloud service starts. |
|
Amortization end time |
BillingDetails/EndTimeOfService |
The time when cost amortization for the cloud service ends. |
Product information (ProductDetails)
|
Field name (console) |
Field name (OSS subscription) |
Description |
|
Product code |
ProductDetails/ProductCode |
The unique code that identifies a specific cloud service on Alibaba Cloud. |
|
Product name |
ProductDetails/ProductName |
The name that describes the cloud service. |
|
Commodity code |
ProductDetails/CommodityCode |
The unique code that Alibaba Cloud uses to identify a specific commodity under a cloud service. |
|
Commodity name |
ProductDetails/CommodityName |
The name of the specific commodity under a cloud service. |
|
Billable item code |
ProductDetails/BillingItemCode |
The code of the billable item to which the cloud resource fee belongs. |
|
Billable item name |
ProductDetails/BillingItemName |
The name of the billable item to which the cloud resource fee belongs. |
Resource information (ResourceDetails)
|
Field name (console) |
Field name (OSS subscription) |
Description |
|
Resource ID |
ResourceDetails/ResourceId |
The identifier that uniquely identifies a resource in each Alibaba Cloud product or service. |
|
Instance ID (billing granularity) |
ResourceDetails/InstanceId |
The dimension at which each Alibaba Cloud product or service calculates and aggregates fees when it generates bills. Different cloud products and services may bill at different granularities, which affects how detailed the bills are and how fees are calculated. For cloud products whose billing granularity differs from their resource management granularity, additional splitting is required to meet internal management needs. |
|
Resource name |
ResourceDetails/ResourceName |
The custom name that you give to a cloud resource on Alibaba Cloud. |
|
Region code |
ResourceDetails/RegionCode |
The logical region code of the cloud resource. |
|
Region |
ResourceDetails/Region |
Some Alibaba Cloud products are deployed by region. This field indicates the region selected at order placement. |
|
Zone |
ResourceDetails/Zone |
The zone of the cloud resource. |
|
Resource group |
ResourceDetails/ResourceGroup |
The group to which the cloud resource belongs, as configured in the Resource Management console. |
|
Resource tag |
ResourceDetails/ResourceTag |
The custom tags that you attach to Alibaba Cloud resources. |
|
Public IP |
ResourceDetails/PublicIpAddress |
The public IP address of the cloud resource. |
|
Private IP |
ResourceDetails/PrivateIpAddress |
The private IP address of the cloud resource. |
Duration information (DurationDetails)
|
Field name (console) |
Field name (OSS subscription) |
Description |
|
Duration before deduction |
DurationDetails/ChargeDurationBeforeDeduction |
The duration before any deduction in scenarios where duration deductions apply. |
|
Deducted duration |
DurationDetails/DeductChargeDuration |
The duration of a pay-as-you-go instance that is offset by reserved instances or similar credits. |
|
Duration |
DurationDetails/ChargeDuration |
The duration for which you purchase or use the Alibaba Cloud product or service. When duration deductions apply, Duration = Duration before deduction - Deducted duration. |
|
Duration unit |
DurationDetails/ChargeDurationUnit |
The unit of the duration. |
|
Duration details |
DurationDetails/ChargeDurationConversionInformation |
Detailed duration information. Click Details to view the duration details in the dialog box. |
Usage information (UsageDetails)
|
Field name (console) |
Field name (OSS subscription) |
Description |
|
Usage before deduction |
UsageDetails/UsageBeforeDeduction |
The usage before any deduction in scenarios where usage deductions apply. |
|
Deducted usage |
UsageDetails/DeductedUsage |
The usage of a pay-as-you-go instance that is offset by resource plans, free quotas, or similar credits. |
|
Usage |
UsageDetails/Usage |
The usage that is ultimately billed for the Alibaba Cloud product or service. When usage deductions apply, Usage = Usage before deduction - Deducted usage. |
|
Usage unit |
UsageDetails/UsageUnit |
The unit of the usage. |
|
Usage details |
UsageDetails/UsageConversionInformation |
Detailed usage information. Click Details to view the usage details in the dialog box. |
Pricing information (PricingDetails)
|
Field name (console) |
Field name (OSS subscription) |
Description |
|
Official list price |
PricingDetails/ListPrice |
The list price of the commodity. |
|
Price unit |
PricingDetails/ListPriceUnit |
The price unit of the list price. |
|
List price usage tier |
PricingDetails/ListPriceTiers |
In tiered pricing scenarios, the pricing tier range that the current list price applies to. |
|
Usage tier accumulation rule |
PricingDetails/TieredPricingRules |
In tiered pricing scenarios, the usage accumulation rule that the current list price applies to. |
|
List price conversion information |
PricingDetails/ListPriceConversionInformation |
The list price conversion rule shown when the list price is converted between yearly, monthly, and daily prices. |
|
List price factor |
PricingDetails/ListPriceFactor |
The factors that affect the list price. Click Details to view all list price factors in the dialog box. |
|
Pricing currency |
PricingDetails/Currency |
The currency in which the list price is set. |
Fee information (FeeDetails)
|
Field name (console) |
Field name (OSS subscription) |
Description |
|
Total list price |
FeeDetails/GrossAmount |
The total list price of the configuration that you select when you purchase Alibaba Cloud resources. |
|
Billing formula |
FeeDetails/BillingFormula |
The formula used to calculate the total list price. |
|
Auxiliary billing information |
FeeDetails/BillingAuxiliaryInformation |
Supplementary information for the billing formula. When the formula involves factors other than Usage, Duration, and Official list price, this field shows the values of those factors. |
|
Billing rules |
FeeDetails/PricingRule |
A link to the document that explains the pricing rules of the commodity in detail. Click Billing Rule to view the billing rules that apply to this bill line item. |
Subscription credit information (SubscriptionDetails)
|
Field name (console) |
Field name (OSS subscription) |
Description |
|
Subscription credit total list price |
SubscriptionDetails/SubscriptionDeductGrossAmount |
When a bill has fees offset by a subscription (savings plan), the total list price of the pay-as-you-go cloud resources that the credit offsets. |
|
Amount after subscription credit |
SubscriptionDetails/AmountAfterSubscriptionDeduction |
When a bill has fees offset by a subscription (savings plan), the amount after the subscription (savings plan) credit is applied. Amount after subscription credit = Total list price - Subscription credit total list price. |
|
Subscription credit amount |
SubscriptionDetails/SubscriptionDeductAmount |
When a bill has fees offset by a subscription (savings plan), the commitment amount consumed by the subscription (savings plan) itself. |
|
Subscription credit details |
SubscriptionDetails/SubscriptionDeductDetails |
When a bill has fees offset by a subscription (savings plan), the credit details, including the savings plan credit discount, savings plan instance ID, type, and commitment amount. |
Example: Assume that a subscription (savings plan) has an hourly commitment of 2 CNY per hour and can offset ecs.g6.xlarge instances. The regular pay-as-you-go unit price is 1 CNY per instance per hour, and the savings plan discount for the ecs.g6 instance family in the China (Shanghai) region is 60% off. The discounted unit price is 1 × 0.4 = 0.4 CNY per instance per hour. Each hour, this savings plan can offset the pay-as-you-go bills of at most 2/0.4 = 5 ecs.g6.xlarge instances.
Assume that 5 instances run in a given hour. In that cycle:
[Subscription credit total list price] = 1/instance/hour × 5 instances × 1 hour = 5 CNY.
Because the fee is fully offset by the savings plan, [Amount after subscription credit] = 0 CNY.
[Subscription credit amount], the commitment amount consumed by the subscription (savings plan) itself, = 2 CNY.
Discount information (DiscountDetails)
|
Field name (console) |
Field name (OSS subscription) |
Description |
|
Discount amount |
DiscountDetails/DiscountAmount |
The total discounted amount on the bill, including official website discounts, contract discounts, and other discounts. |
|
Amount after discount |
DiscountDetails/AmountAfterDiscount |
The amount after official website discounts, contract discounts, and other discounts are applied, that is, the payable amount including coupon credits. Amount after discount = Total list price - Subscription credit total list price - Discount amount. |
|
Discount details |
DiscountDetails/DiscountDetails |
The details of the official website discounts, contract discounts, and other discounts applied to the bill, including the discount name, coupon amount, discount type, and discount source. |
Coupon credit information (CouponDeductionDetails)
|
Field name (console) |
Field name (OSS subscription) |
Description |
|
Coupon credit amount |
CouponDeductionDetails/CouponDeductionAmount |
The amount offset by coupons. This amount cannot be invoiced. |
|
Coupon credit details |
CouponDeductionDetails/CouponDeductionDetails |
The details of the coupon credits on the bill, including the number, type, and credit amount of each coupon applied. |
Payable information (PayableDetails)
|
Field name (console) |
Field name (OSS subscription) |
Description |
|
Payable amount (tax inclusive) |
PayableDetails/TaxInclusivePayableAmount |
The amount that you actually need to pay after all discounts, subscription (savings plan) credits, coupons, and other benefits are applied. Payable amount = Total list price - Subscription credit total list price - Discount amount - Coupon credit amount. |
Split information (SplitLineItemDetails)
These field values appear on the Expenses and Costs console Split Bill page.
|
Field name (console) |
Field name (OSS subscription) |
Description |
|
Financial unit |
SplitLineItemDetails/CostCenter |
The unit used to group or categorize costs. You maintain financial units yourself. |
|
Split item name |
SplitLineItemDetails/SplitItemName |
The name that corresponds to the specific split granularity of the bill. For example, if OSS bills are split by bucket, the split item name is the name of the bucket. |
|
Split item ID |
SplitLineItemDetails/SplitItemId |
The code that corresponds to the specific split granularity of the bill. For example, if OSS bills are split by bucket, the split item ID is the code of the bucket. |
|
Split ratio |
SplitLineItemDetails/SplitRatio |
The usage share of the specific split item of the bill. |
Pay-as-you-go information (PayAsYouGo)
These fields appear only on the Expenses and Costs console Cost Details page and have values when the cost type is pay-as-you-go fee for cloud resources, rounding fee, minimum guarantee and cap fee, commission fee, adjustment fee, or SLA compensation fee.
|
Field name (console) |
Field name (OSS subscription) |
Description |
|
Pay-as-you-go total list price |
PayAsYouGo/GrossAmount |
The total list price generated by the consumed pay-as-you-go cloud resources. It is consistent with the fee. |
|
Pay-as-you-go discount amount |
PayAsYouGo/DiscountAmount |
The discount amount generated by the consumed pay-as-you-go cloud resources. It is consistent with the fee. |
|
Pay-as-you-go coupon credit amount |
PayAsYouGo/CouponDeductionAmount |
The coupon credit amount generated by the consumed pay-as-you-go cloud resources. It is consistent with the fee. |
|
Pay-as-you-go payable amount (tax inclusive) |
PayAsYouGo/TaxInclusivePayableAmount |
The payable amount generated by the consumed pay-as-you-go cloud resources. It is consistent with the fee. |
Subscription credit usage (SubscriptionUsage)
These fields appear only on the Expenses and Costs console Cost Details page and have values when the cost type is subscription coverage fee and the subscription type is resource plan.
|
Field name (console) |
Field name (OSS subscription) |
Description |
|
Subscription credit coefficient |
SubscriptionUsage/SubscriptionDeductionCoefficient |
The coefficient at which the subscription (resource plan) offsets pay-as-you-go instance usage. |
|
Subscription credit usage |
SubscriptionUsage/SubscriptionUsage |
The pay-as-you-go instance usage offset by the subscription (resource plan). |
|
Subscription credit usage unit |
SubscriptionUsage/SubscriptionUsageUnit |
The unit of the usage offset by the subscription (resource plan). |
|
Subscription period capacity |
SubscriptionUsage/SubscriptionPeriodCapacity |
When a pay-as-you-go instance is offset by a subscription (resource plan) of the periodic capacity type (for example, a fixed quota per hour), this field shows the capacity of each period. |
Subscription credit fee (SubscriptionDetail)
These fields appear only on the Expenses and Costs console Cost Details page and have values when the cost type is subscription coverage fee and the subscription type is savings plan.
|
Field name (console) |
Field name (OSS subscription) |
Description |
|
Subscription credit total list price |
SubscriptionDetails/SubscriptionDeductGrossAmount |
The total list price of pay-as-you-go instances offset by the subscription (savings plan). |
|
Subscription credit discount |
SubscriptionDetail/SubscriptionDeductDiscount |
The discount at which the subscription (savings plan) offsets pay-as-you-go instances. Credit discount = Credit amount / Total list price of the offset portion. |
Example: Assume that a subscription (savings plan) has an hourly commitment of 2 CNY per hour and can offset ecs.g6.xlarge instances. The regular pay-as-you-go unit price is 1 CNY per instance per hour, and the savings plan discount for the ecs.g6 instance family in the China (Shanghai) region is 60% off. The discounted unit price is 1 × 0.4 = 0.4 CNY per instance per hour. Each hour, this savings plan can offset the pay-as-you-go bills of at most 2/0.4 = 5 ecs.g6.xlarge instances.
Assume that 5 instances run in a given hour. In that cycle:
[Subscription credit discount] = 0.4 (60% off).
[Subscription credit total list price] = 1 CNY/instance/hour × 5 instances × 1 hour = 5 CNY.
Subscription information (Subscription)
These fields appear only on the Expenses and Costs console Cost Details page and have values when the cost type is subscription coverage fee, subscription refund coverage fee, or subscription unused fee.
|
Field name (console) |
Field name (OSS subscription) |
Description |
|
Subscription type |
Subscription/SubscriptionType |
The subscription category, which includes:
|
|
Subscription total list price |
Subscription/SubscriptionGrossAmount |
|
|
Subscription discount amount |
Subscription/SubscriptionDiscount |
|
|
Subscription coupon credit amount |
SubscriptionCouponDeductionAmount |
|
|
Subscription payable amount |
Subscription/SubscriptionPayable |
|
|
Subscription instance ID |
Subscription/SubscriptionInstanceId |
The instance ID of the subscription (monthly/annual subscription), subscription (resource plan), or subscription (savings plan) in use. |
Cost information (CostDetails)
These fields appear only on the Expenses and Costs console Cost Details page.
|
Field name (console) |
Field name (OSS subscription) |
Description |
|
Cost amount |
CostDetails/CostAmount |
|
|
Cost amount (coupon included) |
CostDetails/CostAmount(CouponDeductionAmountIncluded) |
The cost amount including coupon credits. Cost amount (coupon included) = Cost amount + Subscription coupon credit amount + Pay-as-you-go coupon credit amount. |