Documentation
All Release Notes
Configurable price rounding modes for Carts
27 June 2025
Composable Commerce
HTTP API
Enhancement
CartsQuotesProject configurationGraphQL
You can now configure the price rounding mode for individual Carts using the new priceRoundingMode field. This affects the calculation and rounding of the total price on Line Items and Custom Line Items. The field is available on Cart, CartDraft, and related resources: Order, OrderImportDraft, Quote, and QuoteRequest.
At the Project level, you can now also set the priceRoundingMode and taxRoundingMode fields within CartsConfiguration which overrides the global default (HalfEven).
Related update actions have been added to the Carts API and Project API.

Changes:

  • [API] Added the priceRoundingMode field to Cart.
  • [API] Added the priceRoundingMode field to CartDraft.
  • [API] Added the priceRoundingMode field to Order.
  • [API] Added the priceRoundingMode field to OrderImportDraft.
  • [API] Added the priceRoundingMode field to Quote.
  • [API] Added the priceRoundingMode field to QuoteRequest.
  • [API] Added the taxRoundingMode and priceRoundingMode fields to CartsConfiguration.
  • [API] Added the ChangePriceRoundingModeAction update action to the Carts API.
  • [API] Added the ProjectChangePriceRoundingModeAction update action to the Projects API.
  • [API] Added the ProjectChangeTaxRoundingModeAction update action to the Projects API.
  • [GraphQL API] Added the priceRoundingMode field to the Cart type.
  • [GraphQL API] Added the priceRoundingMode field to the CartDraft type.
  • [GraphQL API] Added the priceRoundingMode field to the Order type.
  • [GraphQL API] Added the priceRoundingMode field to the Quote type.
  • [GraphQL API] Added the priceRoundingMode field to the QuoteRequest type.
  • [GraphQL API] Added the priceRoundingMode and taxRoundingMode fields to the CartsConfiguration type.
  • [GraphQL API] Added the priceRoundingMode and taxRoundingMode fields to the CartsConfigurationInput type.
  • [GraphQL API] Added the changePriceRoundingMode input field to the CartUpdateAction type.
  • [GraphQL API] Added the changePriceRoundingMode and changeTaxRoundingMode input fields to the ProjectSettingsUpdateAction type.
  • [GraphQL API] Added the ChangeStagedOrderPriceRoundingModeOutput type.
  • [GraphQL API] Added the ChangeProjectSettingsPriceRoundingMode type.
  • [GraphQL API] Added the ChangeProjectSettingsTaxRoundingMode type.
extend type Cart {
  priceRoundingMode: RoundingMode!
}

extend type CartDraft {
  priceRoundingMode: RoundingMode
}

extend type Order {
  priceRoundingMode: RoundingMode!
}

extend type Quote {
  priceRoundingMode: RoundingMode!
}

extend type QuoteRequest {
  priceRoundingMode: RoundingMode!
}

extend type CartsConfiguration {
  taxRoundingMode: RoundingMode!
  priceRoundingMode: RoundingMode!
}

extend type CartsConfigurationInput {
  taxRoundingMode: RoundingMode
  priceRoundingMode: RoundingMode
}

extend input CartUpdateAction {
  changePriceRoundingMode: ChangeCartPriceRoundingMode
}

input ChangeCartPriceRoundingMode {
  priceRoundingMode: RoundingMode!
}

extend input ProjectSettingsUpdateAction {
  changePriceRoundingMode: ChangeProjectSettingsPriceRoundingMode
  changeTaxRoundingMode: ChangeProjectSettingsTaxRoundingMode
}

input ChangeProjectSettingsPriceRoundingMode {
  priceRoundingMode: RoundingMode!
}

input ChangeProjectSettingsTaxRoundingMode {
  taxRoundingMode: RoundingMode!
}

extend input StagedOrderUpdateAction {
  changePriceRoundingMode: ChangeStagedOrderPriceRoundingMode
}

input ChangeStagedOrderPriceRoundingMode {
  priceRoundingMode: RoundingMode!
}

type ChangeStagedOrderPriceRoundingModeOutput implements StagedOrderUpdateActionOutput {
  type: String!
  priceRoundingMode: RoundingMode!
}