Updated API from documentation release

ct-sdks[bot] · ct-sdks[bot] · commit db9aff026d30 · 2025-06-27T10:36:23.000Z
diff --git a/api-specs/api/examples/Cart/CartChangePriceRoundingModeAction.json b/api-specs/api/examples/Cart/CartChangePriceRoundingModeAction.json
@@ -0,0 +1,4 @@
+{
+  "action": "changePriceRoundingMode",
+  "priceRoundingMode": "HalfDown"
+}
diff --git a/api-specs/api/examples/OrderEdit/StagedOrderChangePriceRoundingModeAction.json b/api-specs/api/examples/OrderEdit/StagedOrderChangePriceRoundingModeAction.json
@@ -0,0 +1,4 @@
+{
+  "action": "changePriceRoundingMode",
+  "priceRoundingMode": "HalfUp"
+}
diff --git a/api-specs/api/examples/Project/ProjectChangePriceRoundingModeAction.json b/api-specs/api/examples/Project/ProjectChangePriceRoundingModeAction.json
@@ -0,0 +1,4 @@
+{
+  "action": "changePriceRoundingMode",
+  "priceRoundingMode": "HalfDown"
+}
diff --git a/api-specs/api/examples/Project/ProjectChangeTaxRoundingModeAction.json b/api-specs/api/examples/Project/ProjectChangeTaxRoundingModeAction.json
@@ -0,0 +1,4 @@
+{
+  "action": "changeTaxRoundingMode",
+  "taxRoundingMode": "HalfDown"
+}
diff --git a/api-specs/api/examples/b2b-cart.example.json b/api-specs/api/examples/b2b-cart.example.json
@@ -98,13 +98,14 @@
   "discountCodes": [],
   "inventoryMode": "None",
   "taxMode": "Platform",
+  "priceRoundingMode": "HalfEven",
   "taxRoundingMode": "HalfEven",
   "taxCalculationMode": "LineItemLevel",
   "refusedGifts": [],
   "totalLineItemQuantity": 2,
   "origin": "Customer",
   "shipping": [],
   "shippingMode": "Single",
-  "itemShippingAddresses" : [],
+  "itemShippingAddresses": [],
   "directDiscounts": []
 }
diff --git a/api-specs/api/examples/b2b-carts.example.json b/api-specs/api/examples/b2b-carts.example.json
@@ -104,16 +104,16 @@
       "discountCodes": [],
       "inventoryMode": "None",
       "taxMode": "Platform",
+      "priceRoundingMode": "HalfEven",
       "taxRoundingMode": "HalfEven",
       "taxCalculationMode": "LineItemLevel",
       "refusedGifts": [],
       "totalLineItemQuantity": 2,
       "origin": "Customer",
       "shipping": [],
       "shippingMode": "Single",
-      "itemShippingAddresses" : [],
+      "itemShippingAddresses": [],
       "directDiscounts": []
     }
-
   ]
 }
diff --git a/api-specs/api/examples/cart.example.json b/api-specs/api/examples/cart.example.json
@@ -25,6 +25,7 @@
   "directDiscounts": [],
   "inventoryMode": "None",
   "taxMode": "Platform",
+  "priceRoundingMode": "HalfEven",
   "taxRoundingMode": "HalfEven",
   "taxCalculationMode": "LineItemLevel",
   "refusedGifts": [],
diff --git a/api-specs/api/examples/carts.example.json b/api-specs/api/examples/carts.example.json
@@ -95,6 +95,7 @@
       "directDiscounts": [],
       "inventoryMode": "None",
       "taxMode": "Platform",
+      "priceRoundingMode": "HalfEven",
       "taxRoundingMode": "HalfEven",
       "taxCalculationMode": "LineItemLevel",
       "refusedGifts": [],
@@ -205,6 +206,7 @@
       "directDiscounts": [],
       "inventoryMode": "None",
       "taxMode": "Platform",
+      "priceRoundingMode": "HalfEven",
       "taxRoundingMode": "HalfEven",
       "taxCalculationMode": "LineItemLevel",
       "refusedGifts": [],
diff --git a/api-specs/api/examples/quote-request-update-response.example.json b/api-specs/api/examples/quote-request-update-response.example.json
@@ -92,6 +92,7 @@
   "directDiscounts": [],
   "inventoryMode": "None",
   "taxMode": "Platform",
+  "priceRoundingMode": "HalfEven",
   "taxRoundingMode": "HalfEven",
   "taxCalculationMode": "LineItemLevel"
 }
diff --git a/api-specs/api/examples/quote-request.example.json b/api-specs/api/examples/quote-request.example.json
@@ -96,6 +96,7 @@
   "directDiscounts": [],
   "inventoryMode": "None",
   "taxMode": "Platform",
+  "priceRoundingMode": "HalfEven",
   "taxRoundingMode": "HalfEven",
   "taxCalculationMode": "LineItemLevel"
 }
diff --git a/api-specs/api/examples/quote-requests.example.json b/api-specs/api/examples/quote-requests.example.json
@@ -102,6 +102,7 @@
       "directDiscounts": [],
       "inventoryMode": "None",
       "taxMode": "Platform",
+      "priceRoundingMode": "HalfEven",
       "taxRoundingMode": "HalfEven",
       "taxCalculationMode": "LineItemLevel"
     }
diff --git a/api-specs/api/examples/quote.example.json b/api-specs/api/examples/quote.example.json
@@ -103,6 +103,7 @@
   "directDiscounts": [],
   "inventoryMode": "None",
   "taxMode": "Platform",
+  "priceRoundingMode": "HalfEven",
   "taxRoundingMode": "HalfEven",
   "taxCalculationMode": "LineItemLevel"
 }
diff --git a/api-specs/api/examples/quotes.example.json b/api-specs/api/examples/quotes.example.json
@@ -109,6 +109,7 @@
       "directDiscounts": [],
       "inventoryMode": "None",
       "taxMode": "Platform",
+      "priceRoundingMode": "HalfEven",
       "taxRoundingMode": "HalfEven",
       "taxCalculationMode": "LineItemLevel"
     }
diff --git a/api-specs/api/types/cart/Cart.raml b/api-specs/api/types/cart/Cart.raml
@@ -86,10 +86,15 @@ properties:
     description: |
       Indicates how Tax Rates are set.
     default: Platform
+  priceRoundingMode:
+    type: RoundingMode
+    description: |
+      Indicates how the total prices on [LineItems](ctp:api:type:LineItem) and [CustomLineItems](ctp:api:type:CustomLineItem) are rounded when calculated. Configured in [Project settings](ctp:api:type:CartsConfiguration).
+    default: HalfEven
   taxRoundingMode:
     type: RoundingMode
     description: |
-      Indicates how monetary values are rounded when calculating taxes for `taxedPrice`.
+      Indicates how monetary values are rounded when calculating taxes for `taxedPrice`. Configured in [Project settings](ctp:api:type:CartsConfiguration).
     default: HalfEven
   taxCalculationMode:
     type: TaxCalculationMode
diff --git a/api-specs/api/types/cart/CartDraft.raml b/api-specs/api/types/cart/CartDraft.raml
@@ -58,10 +58,14 @@ properties:
     type: ExternalTaxRateDraft
     description: |
       External Tax Rate for the `shippingMethod` if the Cart has `External` [TaxMode](ctp:api:type:TaxMode).
+  priceRoundingMode?:
+    type: RoundingMode
+    description: |
+      Determines how the total prices on [LineItems](ctp:api:type:LineItem) and [CustomLineItems](ctp:api:type:CustomLineItem) are rounded when calculated. If not set, the [default value](ctp:api:type:CartsConfiguration) configured in the [Project](ctp:api:type:Project) is used.
   taxRoundingMode?:
     type: RoundingMode
     description: |
-      Determines how monetary values are rounded when calculating taxes for `taxedPrice`.
+      Determines how monetary values are rounded when calculating taxes for `taxedPrice`. If not set, the [default value](ctp:api:type:CartsConfiguration) configured in the [Project](ctp:api:type:Project) is used.
     default: HalfEven
   taxCalculationMode?:
     type: TaxCalculationMode
diff --git a/api-specs/api/types/cart/updates/CartChangePriceRoundingModeAction.raml b/api-specs/api/types/cart/updates/CartChangePriceRoundingModeAction.raml
@@ -0,0 +1,13 @@
+#%RAML 1.0 DataType
+(package): Cart
+type: CartUpdateAction
+displayName: CartChangePriceRoundingModeAction
+discriminatorValue: changePriceRoundingMode
+example: !include ../../../examples/Cart/CartChangePriceRoundingModeAction.json
+description: |
+  Changing the price rounding mode leads to [recalculation of taxes](/../api/carts-orders-overview#taxes).
+properties:
+  priceRoundingMode:
+    type: RoundingMode
+    description: |
+      New value to set.
diff --git a/api-specs/api/types/order-edit/updates/StagedOrderChangePriceRoundingModeAction.raml b/api-specs/api/types/order-edit/updates/StagedOrderChangePriceRoundingModeAction.raml
@@ -0,0 +1,13 @@
+#%RAML 1.0 DataType
+(package): OrderEdit
+example: !include ../../../examples/OrderEdit/StagedOrderChangePriceRoundingModeAction.json
+type: StagedOrderUpdateAction
+displayName: StagedOrderChangePriceRoundingModeAction
+description: |
+  Changing the price rounding mode leads to [recalculation of taxes](/../api/carts-orders-overview#taxes).
+discriminatorValue: changePriceRoundingMode
+properties:
+  priceRoundingMode:
+    type: RoundingMode
+    description: |
+      New value to set.
diff --git a/api-specs/api/types/order/Order.raml b/api-specs/api/types/order/Order.raml
@@ -80,6 +80,10 @@ properties:
     type: DiscountOnTotalPrice
     description: |-
       Discounts that apply on the total price of the Order.
+  priceRoundingMode?:
+    type: RoundingMode
+    description: Indicates how the total prices on [LineItems](ctp:api:type:LineItem) and [CustomLineItems](ctp:api:type:CustomLineItem) are rounded when calculated.
+    default: HalfEven
   taxMode?:
     type: TaxMode
     description: |
diff --git a/api-specs/api/types/order/OrderImportDraft.raml b/api-specs/api/types/order/OrderImportDraft.raml
@@ -59,6 +59,11 @@ properties:
     type: TaxedPriceDraft
     description: |
       Include TaxedPrice information for the Order. If not included, and if you have Tax Rates set for Line Items and Custom Line Items, the Order total will not be recalculated.
+  priceRoundingMode?:
+    type: RoundingMode
+    default: HalfEven
+    description: |
+      Determines how the total prices on [LineItems](ctp:api:type:LineItem) and [CustomLineItems](ctp:api:type:CustomLineItem) are rounded when calculated.
   taxRoundingMode?:
     type: RoundingMode
     default: HalfEven
diff --git a/api-specs/api/types/project/CartsConfiguration.raml b/api-specs/api/types/project/CartsConfiguration.raml
@@ -18,3 +18,15 @@ properties:
     default: false
     description: |
       Indicates if country _- no state_ Tax Rate fallback should be used when a shipping address state is not explicitly covered in the rates lists of all Tax Categories of a Cart Line Items. This field may not be present on Projects created before June 2020.
+  priceRoundingMode?:
+    type: RoundingMode
+    description: |
+      Default value for the `priceRoundingMode` parameter of the [CartDraft](ctp:api:type:CartDraft).
+      Indicates how the total prices on [LineItems](ctp:api:type:LineItem) and [CustomLineItems](ctp:api:type:CustomLineItem) are rounded when calculated.
+    default: HalfEven
+  taxRoundingMode?:
+    type: RoundingMode
+    description: |
+      Default value for the `taxRoundingMode` parameter of the [CartDraft](ctp:api:type:CartDraft).
+      Indicates how monetary values are rounded when calculating taxes for `taxedPrice`.
+    default: HalfEven
diff --git a/api-specs/api/types/project/updates/ProjectChangePriceRoundingModeAction.raml b/api-specs/api/types/project/updates/ProjectChangePriceRoundingModeAction.raml
@@ -0,0 +1,10 @@
+#%RAML 1.0 DataType
+(package): Project
+type: ProjectUpdateAction
+displayName: ProjectChangePriceRoundingModeAction
+discriminatorValue: changePriceRoundingMode
+example: !include ../../../examples/Project/ProjectChangePriceRoundingModeAction.json
+properties:
+  priceRoundingMode:
+    type: RoundingMode
+    description: Project-level default rounding mode for calculating the total prices on [LineItems](ctp:api:type:LineItem) and [CustomLineItems](ctp:api:type:CustomLineItem). See [CartsConfiguration](ctp:api:type:CartsConfiguration).
diff --git a/api-specs/api/types/project/updates/ProjectChangeTaxRoundingModeAction.raml b/api-specs/api/types/project/updates/ProjectChangeTaxRoundingModeAction.raml
@@ -0,0 +1,10 @@
+#%RAML 1.0 DataType
+(package): Project
+type: ProjectUpdateAction
+displayName: ProjectChangeTaxRoundingModeAction
+discriminatorValue: changeTaxRoundingMode
+example: !include ../../../examples/Project/ProjectChangeTaxRoundingModeAction.json
+properties:
+  taxRoundingMode:
+    type: RoundingMode
+    description: Project-level default rounding mode for tax calculation. See [CartsConfiguration](ctp:api:type:CartsConfiguration).
diff --git a/api-specs/api/types/quote-request/QuoteRequest.raml b/api-specs/api/types/quote-request/QuoteRequest.raml
@@ -97,6 +97,10 @@ properties:
     type: TaxMode
     description: |
       Tax mode of the Cart referenced in the [QuoteRequestDraft](ctp:api:type:QuoteRequestDraft).
+  priceRoundingMode:
+    type: RoundingMode
+    description: |
+      When calculating total prices on [LineItems](ctp:api:type:LineItem) and [CustomLineItems](ctp:api:type:CustomLineItem), the selected mode is used for rounding.
   taxRoundingMode:
     type: RoundingMode
     description: |
diff --git a/api-specs/api/types/quote/Quote.raml b/api-specs/api/types/quote/Quote.raml
@@ -109,6 +109,10 @@ properties:
     type: TaxMode
     description: |
       Tax mode of the Cart referenced in the [QuoteRequestDraft](ctp:api:type:QuoteRequestDraft).
+  priceRoundingMode:
+    type: RoundingMode
+    description: |
+      When calculating total prices on [LineItems](ctp:api:type:LineItem) and [CustomLineItems](ctp:api:type:CustomLineItem), the selected mode is used for rounding.
   taxRoundingMode:
     type: RoundingMode
     description: |
diff --git a/api-specs/api/types/types.raml b/api-specs/api/types/types.raml
@@ -261,6 +261,7 @@ CartChangeCustomLineItemPriceModeAction: !include cart/updates/CartChangeCustomL
 CartChangeCustomLineItemQuantityAction: !include cart/updates/CartChangeCustomLineItemQuantityAction.raml
 CartChangeLineItemQuantityAction: !include cart/updates/CartChangeLineItemQuantityAction.raml
 CartChangeLineItemsOrderAction: !include cart/updates/CartChangeLineItemsOrderAction.raml
+CartChangePriceRoundingModeAction: !include cart/updates/CartChangePriceRoundingModeAction.raml
 CartChangeTaxCalculationModeAction: !include cart/updates/CartChangeTaxCalculationModeAction.raml
 CartChangeTaxModeAction: !include cart/updates/CartChangeTaxModeAction.raml
 CartChangeTaxRoundingModeAction: !include cart/updates/CartChangeTaxRoundingModeAction.raml
@@ -1480,6 +1481,7 @@ StagedOrderChangeCustomLineItemQuantityAction: !include order-edit/updates/Stage
 StagedOrderChangeLineItemQuantityAction: !include order-edit/updates/StagedOrderChangeLineItemQuantityAction.raml
 StagedOrderChangeOrderStateAction: !include order-edit/updates/StagedOrderChangeOrderStateAction.raml
 StagedOrderChangePaymentStateAction: !include order-edit/updates/StagedOrderChangePaymentStateAction.raml
+StagedOrderChangePriceRoundingModeAction: !include order-edit/updates/StagedOrderChangePriceRoundingModeAction.raml
 StagedOrderChangeShipmentStateAction: !include order-edit/updates/StagedOrderChangeShipmentStateAction.raml
 StagedOrderChangeTaxCalculationModeAction: !include order-edit/updates/StagedOrderChangeTaxCalculationModeAction.raml
 StagedOrderChangeTaxModeAction: !include order-edit/updates/StagedOrderChangeTaxModeAction.raml
@@ -2051,10 +2053,12 @@ ProjectChangeMessagesConfigurationAction: !include project/updates/ProjectChange
 ProjectChangeMessagesEnabledAction: !include project/updates/ProjectChangeMessagesEnabledAction.raml
 ProjectChangeNameAction: !include project/updates/ProjectChangeNameAction.raml
 ProjectChangeOrderSearchStatusAction: !include project/updates/ProjectChangeOrderSearchStatusAction.raml
+ProjectChangePriceRoundingModeAction: !include project/updates/ProjectChangePriceRoundingModeAction.raml
 # yamllint disable-line rule:line-length
 ProjectChangeProductSearchIndexingEnabledAction: !include project/updates/ProjectChangeProductSearchIndexingEnabledAction.raml
 # yamllint disable-line rule:line-length
 ProjectChangeShoppingListsConfigurationAction: !include project/updates/ProjectChangeShoppingListsConfigurationAction.raml
+ProjectChangeTaxRoundingModeAction: !include project/updates/ProjectChangeTaxRoundingModeAction.raml
 # yamllint disable-line rule:line-length
 ProjectSetBusinessUnitAssociateRoleOnCreationAction: !include project/updates/ProjectSetBusinessUnitAssociateRoleOnCreationAction.raml
 ProjectSetExternalOAuthAction: !include project/updates/ProjectSetExternalOAuthAction.raml
diff --git a/api-specs/graphql/schema.sdl b/api-specs/graphql/schema.sdl
diff --git a/api-specs/import/types/order-import.raml b/api-specs/import/types/order-import.raml

-Original file line number
+Diff line change
@@ @@ -0,0 +1,4 @@ @@
 +{
 +  "action": "changePriceRoundingMode",
 +  "priceRoundingMode": "HalfDown"
 +}
Original file line number	Diff line number	Diff line change
`@@ -104,16 +104,16 @@`
`104`	`104`	`"discountCodes": [],`
`105`	`105`	`"inventoryMode": "None",`
`106`	`106`	`"taxMode": "Platform",`
	`107`	`+ "priceRoundingMode": "HalfEven",`
`107`	`108`	`"taxRoundingMode": "HalfEven",`
`108`	`109`	`"taxCalculationMode": "LineItemLevel",`
`109`	`110`	`"refusedGifts": [],`
`110`	`111`	`"totalLineItemQuantity": 2,`
`111`	`112`	`"origin": "Customer",`
`112`	`113`	`"shipping": [],`
`113`	`114`	`"shippingMode": "Single",`
`114`		`- "itemShippingAddresses" : [],`
	`115`	`+ "itemShippingAddresses": [],`
`115`	`116`	`"directDiscounts": []`
`116`	`117`	`}`
`117`		`-`
`118`	`118`	`]`
`119`	`119`	`}`
Original file line number	Diff line number	Diff line change
`@@ -92,6 +92,7 @@`
`92`	`92`	`"directDiscounts": [],`
`93`	`93`	`"inventoryMode": "None",`
`94`	`94`	`"taxMode": "Platform",`
	`95`	`+ "priceRoundingMode": "HalfEven",`
`95`	`96`	`"taxRoundingMode": "HalfEven",`
`96`	`97`	`"taxCalculationMode": "LineItemLevel"`
`97`	`98`	`}`
Original file line number	Diff line number	Diff line change
`@@ -96,6 +96,7 @@`
`96`	`96`	`"directDiscounts": [],`
`97`	`97`	`"inventoryMode": "None",`
`98`	`98`	`"taxMode": "Platform",`
	`99`	`+ "priceRoundingMode": "HalfEven",`
`99`	`100`	`"taxRoundingMode": "HalfEven",`
`100`	`101`	`"taxCalculationMode": "LineItemLevel"`
`101`	`102`	`}`