New billing report fields

Change category

Description

Statistical dimensions

Before the upgrade: The billing details page supported grouping by billable item and instance, with statistical periods of month, day, and details.

After the upgrade: The new billing details page provides a line-item view of billable items. The options to group by billable item or instance and to set the statistical period to month, day, or details are not yet available.

Feature upgrades

• Bill fields are grouped to make the reconciliation process clearer.

• Granular reconciliation: For tiered pricing scenarios, the billing details page breaks down costs by each tier, allowing you to check fees by verifying usage and list price.

For more information, see Billing details.

New fields

Service entity

For example, "Alibaba Cloud Computing Co., Ltd."

Transaction type

Renamed from the legacy "Fee Type" field. Some transaction type names are also adjusted for clarity, such as "Upgrade" and "Downgrade".

Resource ID

A unique identifier for the resource, added in the new version.

Region code

A standardized region code, such as cn-beijing.

Duration details

Extended information about the duration.

Usage details

Extended information about usage.

List price usage tier

Information about tiered pricing.

Usage tier accumulation rule

An explanation of the tier accumulation rule.

List price conversion information

Information about pricing conversion.

Subscription deduction details

Detailed information about deductions.

Coupon deduction details

Detailed information about coupon deductions.

Removed fields

public IP, private IP, resource group, instance tag

These fields are no longer displayed in billing details but are available on the new split bill details page.

Associated Order/Bill Number

This field is no longer displayed separately. You can find related information by searching for the order number.

billing period

This field is no longer displayed separately. You can determine the period from the service start and end times.

Remarks

This field, which previously contained information such as refund descriptions and disk types, is no longer displayed. If you need this information, submit a ticket.

List Price Pricing Type

This field is no longer displayed. In historical data, this field was always empty, so its removal has no practical impact.

Generalized Usage

This field is no longer displayed. Use the "Usage" field in the bill instead.

Change category

Main changes

Statistical dimension adjustments

Before the upgrade: Supported statistical periods of month, day, and details.

After the upgrade: The new split bill details page provides a line-item view by billable item. The options to view data by day or in detail are not yet available. For more information, see Split bill details.

Field updates in split bill details

• New fields: The new version adds the resource ID, region code, service entity, and Post-discount Amount fields.

• Removed fields: This upgrade removes the following fields from split bill details: Instance Configuration, Instance Specification, Peak Time, Usage Duration, Associated Order/Bill Number, Usage, Usage Unit, Remarks, Billing Period, Savings Plan Instance ID, and Discount Name.

• Field adjustments: The Order/Bill Number field is renamed to Order Number. This field is displayed only for prepaid scenarios and is not available for pay-as-you-go bills.

Change category

Main changes

New feature

The cost details report breaks down costs to the individual cloud resource level and amortizes these costs daily based on allocation rules. This helps you analyze your cost composition.

Change category

Main changes

New feature

After enabling the new version, you can subscribe to bills generated after the activation date through OSS or MaxCompute. For more information, see Export and subscribe to bills.

Parameter (Console)

Parameter (OSS subscription)

Description

order ID

LineItemDetails/OrderId

A unique identifier assigned to an order by Alibaba Cloud.

• For fees such as prepayment, post-payment, cancellation, and coverage, this field contains the purchase order ID for the relevant subscription, resource pack, or Savings Plans.

• For other fees such as pay-as-you-go charges, rounding adjustments, and commissions, this field is empty.

Parameter

(Console)

Parameter (OSS subscription)

Description

ResourcePurchaseAccountId

IdentityDetails/ResourcePurchaseAccountId

The ID of the account that purchased the Alibaba Cloud resource instance.

ResourcePurchaseAccount

IdentityDetails/ResourcePurchaseAccount

The name of the account that purchased the Alibaba Cloud resource instance.

ResourceOwnerAccountId

IdentityDetails/ResourceOwnerAccountId

The ID of the account that owns the resource instance, which can differ from the purchaser's ID.

ResourceOwnerAccount

IdentityDetails/ResourceOwnerAccount

The name of the account that owns the resource instance, which can differ from the purchaser's name.

Parameter

(Console)

Parameter name (OSS subscription)

Description

service entity

BillingDetails/ServiceEntity

The name of the company that provides the product or service. Different Alibaba Cloud products may be sold by different service entities.

billing month

BillingDetails/BillingMonth

The month covered by the bill.

billing date

BillingDetails/BillingDate

The date when costs for the cloud product were incurred.

line item type

BillingDetails/LineItemType

The type of charge for the line item. Possible values are:

• Subscription prepayment: The amount paid for a subscription, resource pack, or Savings Plans order.

• Subscription postpaid charge: The postpaid charge for a resource pack or Savings Plans order with a zero or partial upfront payment.

• Subscription cancellation refund: The refund amount for a canceled subscription, resource pack, or Savings Plans order.

• Subscription coverage: The daily amortized amount of a prepaid subscription order.

• Subscription unused cost: The remaining unamortized cost of a canceled prepaid subscription order, which is recognized immediately.

• Subscription cancellation unused credit: The credit for the unused portion of a canceled prepaid subscription, recognized immediately.

• Pay-as-you-go resource cost: The cost for pay-as-you-go resources based on actual usage during a billing cycle.

• Adjustment cost: A cost resulting from an adjustment (credit or debit) to correct a billing error from a previous billing period.

• Rounding adjustment: The amount discarded during settlement. Alibaba Cloud discards the portion of a charge from the 3rd to the 10th decimal place.

• Committed spend: Costs incurred under a contract with a minimum or maximum spending commitment.

• Commission fee: The fee collected by Alibaba Cloud from an Independent Software Vendor (ISV) on the Alibaba Cloud Marketplace.

transaction type

BillingDetails/ConsumeType

The transaction type for the bill. Possible values are:

• New purchase: A bill for a new subscription, resource pack, or Savings Plans order.

• Renewal: A bill for renewing a subscription, resource pack, or Savings Plans.

• Downgrade: A bill for downgrading a subscription, resource pack, or Savings Plans.

• Upgrade: A bill for upgrading a subscription, resource pack, or Savings Plans.

• Cancellation: A refund for a canceled paid order.

• Trade-in: A bill for a trade-in transaction.

• Fixed-fee installment: A bill for a fixed-fee installment plan.

• Pay-as-you-go: A bill for pay-as-you-go cloud products.

• Adjustment: A bill for an adjustment (credit or debit) to correct a billing error from a previous billing period.

consumption time

BillingDetails/ConsumedTime

The time when the charge was incurred for a usage record:

• For prepaid products, such as subscriptions, this is when the order payment was completed.

• For pay-as-you-go products, this is the start time of each billing cycle.

service start time

BillingDetails/ServiceStartTime

The start time of the service period for the charge.

• For prepaid products, such as subscriptions, this is the start time of the instance validity period.

• For pay-as-you-go products, this is the start time of each billing cycle.

service end time

BillingDetails/ServiceEndTime

The end time of the service period for the charge.

• For prepaid products, such as subscriptions, this is the end time of the instance validity period.

• For pay-as-you-go products, this is the end time of each billing cycle.

amortization start time

BillingDetails/AmortizationStartTime

The start time of cost amortization for the cloud product.

amortization end time

BillingDetails/AmortizationEndTime

The end time of cost amortization for the cloud product.

Parameter

(Console)

Parameter (OSS subscription)

Description

Product code

ProductDetails/ProductCode

The unique identifier for an Alibaba Cloud product.

Product name

ProductDetails/ProductName

The name of the cloud product.

Commodity code

ProductDetails/CommodityCode

The unique identifier for a commodity associated with an Alibaba Cloud product.

Commodity name

ProductDetails/CommodityName

The name of a commodity associated with a cloud product.

Billable item code

ProductDetails/BillingItemCode

The code of the billable item associated with a cloud resource.

Billable item name

ProductDetails/BillingItemName

The name of the billable item associated with a cloud resource.

Parameter (Console)

Parameter (OSS subscription)

Description

resource ID

ResourceDetails/ResourceId

A unique identifier for a resource within an Alibaba Cloud service.

instance ID (billing granularity)

ResourceDetails/InstanceId

The dimension used to calculate, aggregate, and summarize charges for billing. Different cloud products and services may have different billing granularities, which affects the level of detail in the bill and how charges are calculated.

When a cloud product's billing granularity differs from its resource management granularity, additional cost allocation is necessary to meet internal management needs.

resource name

ResourceDetails/ResourceName

The user-defined name of the resource.

region code

ResourceDetails/RegionCode

The code for the resource's region.

region

ResourceDetails/Region

For region-specific products, this is the region selected at purchase.

availability zone

ResourceDetails/Zone

The availability zone where the resource is located.

resource group

ResourceDetails/ResourceGroup

The resource's resource group, as configured in the Resource Management console.

resource tag

ResourceDetails/ResourceTag

A user-defined tag applied to the resource.

public IP address

ResourceDetails/PublicIpAddress

The public IP address of the resource.

private IP address

ResourceDetails/PrivateIpAddress

The private IP address of the resource.

Field name (Console)

Field name (OSS subscription)

Description

Duration before deduction

DurationDetails/ChargeDurationBeforeDeduction

The usage duration before any deductions are applied. This field contains a value only when a deduction is made.

Deducted duration

DurationDetails/DeductChargeDuration

The duration deducted from a pay-as-you-go instance, typically covered by a Reserved Instance Coupon.

Duration

DurationDetails/ChargeDuration

The billed duration for an Alibaba Cloud product or service.

If deductions are applied, the value is calculated as follows: Duration = Duration before deduction - Deducted duration.

Duration unit

DurationDetails/ChargeDurationUnit

The unit of measurement for the duration.

Duration details

DurationDetails/ChargeDurationConversionInformation

Additional details about the duration. Click Details to view them in a dialog box.

Parameter (Console)

Parameter (OSS subscription)

Description

Usage before deduction

UsageDetails/UsageBeforeDeduction

The total usage before deductions.

Deducted usage

UsageDetails/DeductedUsage

The usage for pay-as-you-go instances covered by a resource plan or free tier.

Usage

UsageDetails/Usage

The final billable usage for a product or service.

With deductions, the formula is: Usage = Usage before deduction - Deducted usage.

Usage unit

UsageDetails/UsageUnit

The unit in which usage is measured.

Usage details

UsageDetails/UsageConversionInformation

Contains a detailed usage breakdown. Click Details to view the breakdown in a dialog box.

Parameter (Console)

Parameter (OSS subscription)

Description

list price

PricingDetails/ListPrice

The list price of the product.

price unit

PricingDetails/ListPriceUnit

The unit of the list price.

pricing tiers

PricingDetails/ListPriceTiers

Specifies the pricing tier range for the list price in tiered pricing scenarios.

tiered pricing rules

PricingDetails/TieredPricingRules

Specifies the usage accumulation rules for the list price in tiered pricing scenarios.

list price conversion information

PricingDetails/ListPriceConversionInformation

Rules for converting the list price between annual, monthly, and daily rates.

list price factor

PricingDetails/ListPriceFactor

Factors that affect the list price. Click Details to view all factors in a dialog box.

currency

PricingDetails/Currency

The currency of the list price.

Parameter (Console)

Field name (OSS subscription)

Description

Gross amount

FeeDetails/GrossAmount

The list price of the selected configuration for an Alibaba Cloud resource.

Billing formula

FeeDetails/BillingFormula

The formula used to calculate the gross amount.

Auxiliary billing information

FeeDetails/BillingAuxiliaryInformation

Provides supplementary information for the billing formula, detailing calculation factors other than usage, duration, and list price.

Pricing rule

FeeDetails/PricingRule

A link to the pricing rule for the cloud product. Click Billing Rule to view the rule details for this line item.

Parameter (Console)

Parameter (OSS subscription)

Description

Subscription Deduct Gross Amount

SubscriptionDetails/SubscriptionDeductGrossAmount

The gross pay-as-you-go cost of cloud resources covered by a subscription (such as a Savings Plan).

Amount After Subscription Deduction

SubscriptionDetails/AmountAfterSubscriptionDeduction

The amount payable after applying a deduction from a subscription (such as a Savings Plan). Amount After Subscription Deduction = Gross Amount - Subscription Deduct Gross Amount.

Subscription Deduct Amount

SubscriptionDetails/SubscriptionDeductAmount

The portion of the commitment from a subscription (such as a Savings Plan) that is consumed to cover costs.

Subscription Deduct Details

SubscriptionDetails/SubscriptionDeductDetails

Details of the deduction from a subscription (such as a Savings Plan). Includes the Savings Plan discount, Savings Plan instance ID, type, and commitment.

Parameter (console)

Parameter (OSS subscription)

Description

discount amount

DiscountDetails/DiscountAmount

The total discount amount applied to the bill, including official promotions and contract discounts.

amount after discount

DiscountDetails/AmountAfterDiscount

The amount after all discounts (such as subscription-based deductions, official promotions, and contract discounts) are applied, excluding coupon deductions.

discount details

DiscountDetails/DiscountDetails

Details of the discounts applied to the bill, such as official promotions and contract discounts. This includes the discount name, coupon amount, discount type, and discount source.

Parameter (Console)

API name

Description

Coupon deduction amount

CouponDeductionDetails/CouponDeductionAmount

The amount deducted by a coupon. This amount is not eligible for an invoice.

Coupon deduction details

CouponDeductionDetails/CouponDeductionDetails

Provides details for each applied coupon, including its coupon number, coupon type, and coupon deduction amount.

Parameter (Console)

Parameter (OSS subscription)

Description

Tax-inclusive payable amount

PayableDetails/TaxInclusivePayableAmount

The amount payable after applying promotions such as subscriptions (e.g., savings plans), discounts, and coupons.

Tax-inclusive payable amount = list price - subscription deduction - discount - coupon deduction.

Parameter (Console)

Parameter (OSS subscription)

Description

Cost Center

SplitLineItemDetails/CostCenter

A user-defined unit for grouping or categorizing costs.

Split Item Name

SplitLineItemDetails/SplitItemName

The name of the item used to split costs. For example, if OSS costs are split by bucket, this field contains the bucket name.

Split Item ID

SplitLineItemDetails/SplitItemId

The ID of the item used to split costs. For example, if OSS costs are split by bucket, this field contains the bucket ID.

Split Ratio

SplitLineItemDetails/SplitRatio

The percentage of usage allocated to the split item.

Console

API

Description

subscription deduction coefficient

SubscriptionUsage/SubscriptionDeductionCoefficient

The deduction coefficient for a Pay-As-You-Go instance covered by a subscription (resource plan).

subscription usage

SubscriptionUsage/SubscriptionUsage

The usage amount of a Pay-As-You-Go instance covered by a subscription (resource plan).

subscription usage unit

SubscriptionUsage/SubscriptionUsageUnit

The unit of measurement for usage covered by a subscription (resource plan).

subscription period capacity

SubscriptionUsage/SubscriptionPeriodCapacity

The capacity per period for periodic, capacity-based subscriptions, such as a resource plan with a fixed hourly quota.

Parameter (console)

Parameter (OSS subscription)

Description

Subscription Deduct Gross Amount

SubscriptionDetails/SubscriptionDeductGrossAmount

Specifies the gross list price for a pay-as-you-go instance covered by a Savings Plan.

Subscription Deduct Discount

SubscriptionDetail/SubscriptionDeductDiscount

The pricing multiplier from the Savings Plan. For example, a value of 0.4 means the final price is 40% of the list price.

Parameter (Console)

Parameter (OSS)

Description

subscription type

Subscription/SubscriptionType

The category of the subscription. Possible values:

• Subscription

• Resource Plan

• Savings Plans

subscription gross amount

Subscription/SubscriptionGrossAmount

• If the subscription type is Subscription:

  • When the charge type is subscription covered charge, this field shows the amortized gross amount. For example, under linear amortization, this is the gross amount from the original bill divided by the number of service periods.

  • When the charge type is subscription unsubscribe coverage fee, this field shows the gross amount from the original cancellation bill.

  • When the charge type is subscription unused fee, this field shows the gross amount of the remaining value, which is fully amortized when the original purchase is canceled.

• If the subscription type is Resource Plan, this field is empty.

• If the subscription type is Savings Plans:

  • When the charge type is subscription covered charge, this field shows the gross amount of the Savings Plans commitment used to cover the cost of a Pay-As-You-Go instance.

  • When the charge type is subscription unsubscribe coverage fee, this field shows the gross amount from the Savings Plans cancellation bill.

  • When the charge type is subscription unused fee, this field shows the gross amount of the remaining value, which is fully amortized when the original Savings Plans order is canceled.

subscription discount

Subscription/SubscriptionDiscount

• If the subscription type is Subscription:

  • When the charge type is subscription covered charge, this field shows the amortized discount amount. For example, under linear amortization, this is the discount amount from the original bill divided by the number of service periods.

  • When the charge type is subscription unsubscribe coverage fee, this field shows the discount amount from the Subscription cancellation bill.

  • When the charge type is subscription unused fee, this field shows the discount amount of the remaining value, which is fully amortized when the original Subscription order is canceled.

• If the subscription type is Resource Plan or Savings Plans, this field is empty.

subscription coupon deduction amount

SubscriptionCouponDeductionAmount

• If the subscription type is Subscription:

  • When the charge type is subscription covered charge, this field shows the amortized coupon deduction amount. For example, under linear amortization, this is the coupon deduction amount from the original bill divided by the number of service periods.

  • When the charge type is subscription unsubscribe coverage fee, this field shows the coupon deduction amount from the Subscription cancellation bill.

  • When the charge type is subscription unused fee, this field shows the coupon deduction amount of the remaining value, which is fully amortized when the original Subscription order is canceled.

• If the subscription type is Resource Plan or Savings Plans, this field is empty.

subscription payable amount

Subscription/SubscriptionPayable

• If the subscription type is Subscription:

  • When the charge type is subscription covered charge, this field shows the amortized payable amount. For example, under linear amortization, this is the payable amount from the original bill divided by the number of service periods.

  • When the charge type is subscription unsubscribe coverage fee, this field shows the payable amount from the Subscription cancellation bill.

  • When the charge type is subscription unused fee, this field shows the payable amount of the remaining value, which is fully amortized when the original Subscription order is canceled.

• If the subscription type is Resource Plan or Savings Plans:

  • When the charge type is subscription covered charge, this field shows the payable amount of the Resource Plan or Savings Plans commitment used to cover the cost of a Pay-As-You-Go instance.

  • When the charge type is subscription unsubscribe coverage fee, this field shows the payable amount from the Resource Plan or Savings Plans cancellation bill.

  • When the charge type is subscription unused fee, this field shows the payable amount of the remaining value, which is fully amortized when the original Resource Plan or Savings Plans order is canceled.

subscription instance ID

Subscription/SubscriptionInstanceId

The ID of the Subscription, Resource Plan, or Savings Plans instance.

Field name (console)

API name

Description

Cost Amount

CostDetails/CostAmount

• For fee types related to a subscription (such as subscription coverage fee, subscription unused fee, or subscription unsubscribe coverage fee), this amount is the subscription's payable amount.

• For all other fee types, the cost amount is the Pay-As-You-Go payable amount (tax inclusive).

Cost Amount (including coupons)

CostDetails/CostAmount(CouponDeductionAmountIncluded)

This amount includes coupon deductions and is calculated as follows: Cost Amount (including coupons) = Cost Amount + subscription coupon deduction amount + Pay-As-You-Go coupon deduction amount.