@propeller-commerce/propeller-sdk-v2 0.18.1 → 0.19.0

package/CHANGELOG.md

@@ -2,6 +2,36 @@
 
 All notable changes to `@propeller-commerce/propeller-sdk-v2` are documented here.
 
+---
+## [0.19.0] - 2026-11-12
+
+VAT rates now come with their decimals: Swiss VAT reads 8.1, not 8.
+
+### Added
+
+- **The exact VAT rate on carts, orders and quotes.** The API rounds the old
+  tax percentage fields to a whole number, so a shop showed "8% VAT" while it
+  charged 8.1%. Each of those fields now has a decimal counterpart, and every
+  `cart*`, `order*` and `tender*` operation requests it:
+
+  | Type | Rounded (deprecated) | Exact |
+  |---|---|---|
+  | `CartTaxLevel`, `CartPostageData`, `CartPaymentData`, `CartItemSurcharge` | `taxPercentage` | `taxPercentageDecimal` |
+  | `OrderItem`, `TenderBaseItem`, `TenderMainItem` | `taxPercentage` | `taxPercentageDecimal` |
+  | `OrderTotalTaxPercentage` (`order.total.taxPercentages`) | `percentage` | `percentageDecimal` |
+
+  Show the decimal field. A whole-number rate arrives as `21`, so it still
+  reads 21%. (PWP-1065)
+
+### Deprecated
+
+- **The rounded `taxPercentage` / `percentage` fields listed above.** They are
+  still requested and typed, so existing code keeps working, and they are marked
+  `@deprecated` to match the API. They will be removed in a later breaking
+  release. `OrderPostageData`, `OrderPaymentData`, `TenderPostage`,
+  `TenderPayment`, `TenderItemSurcharge` and `TenderTaxLevel` already return
+  the exact rate and are unchanged.
+
 ---
 ## [0.18.1] - 2026-11-03
 

package/dist/cjs/generated/operations/cart.js

@@ -104,6 +104,7 @@ fragment CartPaymentDataFields on CartPaymentData {
   priceMode
   tax
   taxPercentage
+  taxPercentageDecimal
   status
   statusDate
 }
@@ -111,6 +112,7 @@ fragment CartPaymentDataFields on CartPaymentData {
 fragment CartPostageDataFields on CartPostageData {
   method
   taxPercentage
+  taxPercentageDecimal
   requestDate
   price
   priceNet
@@ -367,6 +369,7 @@ fragment CartItemSurchargeFields on CartItemSurcharge {
   value
   taxCode
   taxPercentage
+  taxPercentageDecimal
   quantity
   price
   totalPrice
@@ -426,6 +429,7 @@ fragment CartAddressFields on CartAddress {
 
 fragment CartTaxLevelFields on CartTaxLevel {
   taxPercentage
+  taxPercentageDecimal
   price
   discount
 }

package/dist/cjs/generated/operations/cartAcceptPurchaseAuthorizationRequest.js

@@ -104,6 +104,7 @@ fragment CartPaymentDataFields on CartPaymentData {
   priceMode
   tax
   taxPercentage
+  taxPercentageDecimal
   status
   statusDate
 }
@@ -111,6 +112,7 @@ fragment CartPaymentDataFields on CartPaymentData {
 fragment CartPostageDataFields on CartPostageData {
   method
   taxPercentage
+  taxPercentageDecimal
   requestDate
   price
   priceNet
@@ -367,6 +369,7 @@ fragment CartItemSurchargeFields on CartItemSurcharge {
   value
   taxCode
   taxPercentage
+  taxPercentageDecimal
   quantity
   price
   totalPrice
@@ -426,6 +429,7 @@ fragment CartAddressFields on CartAddress {
 
 fragment CartTaxLevelFields on CartTaxLevel {
   taxPercentage
+  taxPercentageDecimal
   price
   discount
 }

package/dist/cjs/generated/operations/cartAddActionCode.js

@@ -104,6 +104,7 @@ fragment CartPaymentDataFields on CartPaymentData {
   priceMode
   tax
   taxPercentage
+  taxPercentageDecimal
   status
   statusDate
 }
@@ -111,6 +112,7 @@ fragment CartPaymentDataFields on CartPaymentData {
 fragment CartPostageDataFields on CartPostageData {
   method
   taxPercentage
+  taxPercentageDecimal
   requestDate
   price
   priceNet
@@ -367,6 +369,7 @@ fragment CartItemSurchargeFields on CartItemSurcharge {
   value
   taxCode
   taxPercentage
+  taxPercentageDecimal
   quantity
   price
   totalPrice
@@ -426,6 +429,7 @@ fragment CartAddressFields on CartAddress {
 
 fragment CartTaxLevelFields on CartTaxLevel {
   taxPercentage
+  taxPercentageDecimal
   price
   discount
 }

package/dist/cjs/generated/operations/cartAddBundle.js

@@ -104,6 +104,7 @@ fragment CartPaymentDataFields on CartPaymentData {
   priceMode
   tax
   taxPercentage
+  taxPercentageDecimal
   status
   statusDate
 }
@@ -111,6 +112,7 @@ fragment CartPaymentDataFields on CartPaymentData {
 fragment CartPostageDataFields on CartPostageData {
   method
   taxPercentage
+  taxPercentageDecimal
   requestDate
   price
   priceNet
@@ -367,6 +369,7 @@ fragment CartItemSurchargeFields on CartItemSurcharge {
   value
   taxCode
   taxPercentage
+  taxPercentageDecimal
   quantity
   price
   totalPrice
@@ -426,6 +429,7 @@ fragment CartAddressFields on CartAddress {
 
 fragment CartTaxLevelFields on CartTaxLevel {
   taxPercentage
+  taxPercentageDecimal
   price
   discount
 }

package/dist/cjs/generated/operations/cartAddItem.js

@@ -104,6 +104,7 @@ fragment CartPaymentDataFields on CartPaymentData {
   priceMode
   tax
   taxPercentage
+  taxPercentageDecimal
   status
   statusDate
 }
@@ -111,6 +112,7 @@ fragment CartPaymentDataFields on CartPaymentData {
 fragment CartPostageDataFields on CartPostageData {
   method
   taxPercentage
+  taxPercentageDecimal
   requestDate
   price
   priceNet
@@ -367,6 +369,7 @@ fragment CartItemSurchargeFields on CartItemSurcharge {
   value
   taxCode
   taxPercentage
+  taxPercentageDecimal
   quantity
   price
   totalPrice
@@ -426,6 +429,7 @@ fragment CartAddressFields on CartAddress {
 
 fragment CartTaxLevelFields on CartTaxLevel {
   taxPercentage
+  taxPercentageDecimal
   price
   discount
 }

package/dist/cjs/generated/operations/cartDeleteItem.js

@@ -104,6 +104,7 @@ fragment CartPaymentDataFields on CartPaymentData {
   priceMode
   tax
   taxPercentage
+  taxPercentageDecimal
   status
   statusDate
 }
@@ -111,6 +112,7 @@ fragment CartPaymentDataFields on CartPaymentData {
 fragment CartPostageDataFields on CartPostageData {
   method
   taxPercentage
+  taxPercentageDecimal
   requestDate
   price
   priceNet
@@ -367,6 +369,7 @@ fragment CartItemSurchargeFields on CartItemSurcharge {
   value
   taxCode
   taxPercentage
+  taxPercentageDecimal
   quantity
   price
   totalPrice
@@ -426,6 +429,7 @@ fragment CartAddressFields on CartAddress {
 
 fragment CartTaxLevelFields on CartTaxLevel {
   taxPercentage
+  taxPercentageDecimal
   price
   discount
 }

package/dist/cjs/generated/operations/cartRemoveActionCode.js

@@ -104,6 +104,7 @@ fragment CartPaymentDataFields on CartPaymentData {
   priceMode
   tax
   taxPercentage
+  taxPercentageDecimal
   status
   statusDate
 }
@@ -111,6 +112,7 @@ fragment CartPaymentDataFields on CartPaymentData {
 fragment CartPostageDataFields on CartPostageData {
   method
   taxPercentage
+  taxPercentageDecimal
   requestDate
   price
   priceNet
@@ -367,6 +369,7 @@ fragment CartItemSurchargeFields on CartItemSurcharge {
   value
   taxCode
   taxPercentage
+  taxPercentageDecimal
   quantity
   price
   totalPrice
@@ -426,6 +429,7 @@ fragment CartAddressFields on CartAddress {
 
 fragment CartTaxLevelFields on CartTaxLevel {
   taxPercentage
+  taxPercentageDecimal
   price
   discount
 }

package/dist/cjs/generated/operations/cartSetContact.js

@@ -104,6 +104,7 @@ fragment CartPaymentDataFields on CartPaymentData {
   priceMode
   tax
   taxPercentage
+  taxPercentageDecimal
   status
   statusDate
 }
@@ -111,6 +112,7 @@ fragment CartPaymentDataFields on CartPaymentData {
 fragment CartPostageDataFields on CartPostageData {
   method
   taxPercentage
+  taxPercentageDecimal
   requestDate
   price
   priceNet
@@ -367,6 +369,7 @@ fragment CartItemSurchargeFields on CartItemSurcharge {
   value
   taxCode
   taxPercentage
+  taxPercentageDecimal
   quantity
   price
   totalPrice
@@ -426,6 +429,7 @@ fragment CartAddressFields on CartAddress {
 
 fragment CartTaxLevelFields on CartTaxLevel {
   taxPercentage
+  taxPercentageDecimal
   price
   discount
 }

package/dist/cjs/generated/operations/cartSetCustomer.js

@@ -104,6 +104,7 @@ fragment CartPaymentDataFields on CartPaymentData {
   priceMode
   tax
   taxPercentage
+  taxPercentageDecimal
   status
   statusDate
 }
@@ -111,6 +112,7 @@ fragment CartPaymentDataFields on CartPaymentData {
 fragment CartPostageDataFields on CartPostageData {
   method
   taxPercentage
+  taxPercentageDecimal
   requestDate
   price
   priceNet
@@ -367,6 +369,7 @@ fragment CartItemSurchargeFields on CartItemSurcharge {
   value
   taxCode
   taxPercentage
+  taxPercentageDecimal
   quantity
   price
   totalPrice
@@ -426,6 +429,7 @@ fragment CartAddressFields on CartAddress {
 
 fragment CartTaxLevelFields on CartTaxLevel {
   taxPercentage
+  taxPercentageDecimal
   price
   discount
 }

package/dist/cjs/generated/operations/cartStart.js

@@ -104,6 +104,7 @@ fragment CartPaymentDataFields on CartPaymentData {
   priceMode
   tax
   taxPercentage
+  taxPercentageDecimal
   status
   statusDate
 }
@@ -111,6 +112,7 @@ fragment CartPaymentDataFields on CartPaymentData {
 fragment CartPostageDataFields on CartPostageData {
   method
   taxPercentage
+  taxPercentageDecimal
   requestDate
   price
   priceNet
@@ -367,6 +369,7 @@ fragment CartItemSurchargeFields on CartItemSurcharge {
   value
   taxCode
   taxPercentage
+  taxPercentageDecimal
   quantity
   price
   totalPrice
@@ -426,6 +429,7 @@ fragment CartAddressFields on CartAddress {
 
 fragment CartTaxLevelFields on CartTaxLevel {
   taxPercentage
+  taxPercentageDecimal
   price
   discount
 }

package/dist/cjs/generated/operations/cartUpdate.js

@@ -104,6 +104,7 @@ fragment CartPaymentDataFields on CartPaymentData {
   priceMode
   tax
   taxPercentage
+  taxPercentageDecimal
   status
   statusDate
 }
@@ -111,6 +112,7 @@ fragment CartPaymentDataFields on CartPaymentData {
 fragment CartPostageDataFields on CartPostageData {
   method
   taxPercentage
+  taxPercentageDecimal
   requestDate
   price
   priceNet
@@ -367,6 +369,7 @@ fragment CartItemSurchargeFields on CartItemSurcharge {
   value
   taxCode
   taxPercentage
+  taxPercentageDecimal
   quantity
   price
   totalPrice
@@ -426,6 +429,7 @@ fragment CartAddressFields on CartAddress {
 
 fragment CartTaxLevelFields on CartTaxLevel {
   taxPercentage
+  taxPercentageDecimal
   price
   discount
 }

package/dist/cjs/generated/operations/cartUpdateAddress.js

@@ -104,6 +104,7 @@ fragment CartPaymentDataFields on CartPaymentData {
   priceMode
   tax
   taxPercentage
+  taxPercentageDecimal
   status
   statusDate
 }
@@ -111,6 +112,7 @@ fragment CartPaymentDataFields on CartPaymentData {
 fragment CartPostageDataFields on CartPostageData {
   method
   taxPercentage
+  taxPercentageDecimal
   requestDate
   price
   priceNet
@@ -367,6 +369,7 @@ fragment CartItemSurchargeFields on CartItemSurcharge {
   value
   taxCode
   taxPercentage
+  taxPercentageDecimal
   quantity
   price
   totalPrice
@@ -426,6 +429,7 @@ fragment CartAddressFields on CartAddress {
 
 fragment CartTaxLevelFields on CartTaxLevel {
   taxPercentage
+  taxPercentageDecimal
   price
   discount
 }

package/dist/cjs/generated/operations/cartUpdateItem.js

@@ -104,6 +104,7 @@ fragment CartPaymentDataFields on CartPaymentData {
   priceMode
   tax
   taxPercentage
+  taxPercentageDecimal
   status
   statusDate
 }
@@ -111,6 +112,7 @@ fragment CartPaymentDataFields on CartPaymentData {
 fragment CartPostageDataFields on CartPostageData {
   method
   taxPercentage
+  taxPercentageDecimal
   requestDate
   price
   priceNet
@@ -367,6 +369,7 @@ fragment CartItemSurchargeFields on CartItemSurcharge {
   value
   taxCode
   taxPercentage
+  taxPercentageDecimal
   quantity
   price
   totalPrice
@@ -426,6 +429,7 @@ fragment CartAddressFields on CartAddress {
 
 fragment CartTaxLevelFields on CartTaxLevel {
   taxPercentage
+  taxPercentageDecimal
   price
   discount
 }

package/dist/cjs/generated/operations/order.js

@@ -188,6 +188,7 @@ fragment OrderTotalsFields on OrderTotals {
   discountValue
   taxPercentages {
     percentage
+    percentageDecimal
     total
   }
 }
@@ -218,6 +219,7 @@ fragment OrderItemFields on OrderItem {
   discount
   tax
   taxPercentage
+  taxPercentageDecimal
   taxCode
   isBonus
   minimumQuantity

package/dist/cjs/generated/operations/orderCreate.js

@@ -188,6 +188,7 @@ fragment OrderTotalsFields on OrderTotals {
   discountValue
   taxPercentages {
     percentage
+    percentageDecimal
     total
   }
 }
@@ -218,6 +219,7 @@ fragment OrderItemFields on OrderItem {
   discount
   tax
   taxPercentage
+  taxPercentageDecimal
   taxCode
   isBonus
   minimumQuantity

package/dist/cjs/generated/operations/orderItemCreate.js

@@ -28,6 +28,7 @@ exports.document = `fragment OrderItemFields on OrderItem {
   discount
   tax
   taxPercentage
+  taxPercentageDecimal
   taxCode
   isBonus
   minimumQuantity

package/dist/cjs/generated/operations/orderItemUpdate.js

@@ -28,6 +28,7 @@ exports.document = `fragment OrderItemFields on OrderItem {
   discount
   tax
   taxPercentage
+  taxPercentageDecimal
   taxCode
   isBonus
   minimumQuantity

package/dist/cjs/generated/operations/orderRevision.js

@@ -188,6 +188,7 @@ fragment OrderTotalsFields on OrderTotals {
   discountValue
   taxPercentages {
     percentage
+    percentageDecimal
     total
   }
 }
@@ -218,6 +219,7 @@ fragment OrderItemFields on OrderItem {
   discount
   tax
   taxPercentage
+  taxPercentageDecimal
   taxCode
   isBonus
   minimumQuantity

package/dist/cjs/generated/operations/orderRevisionRestore.js

@@ -188,6 +188,7 @@ fragment OrderTotalsFields on OrderTotals {
   discountValue
   taxPercentages {
     percentage
+    percentageDecimal
     total
   }
 }
@@ -218,6 +219,7 @@ fragment OrderItemFields on OrderItem {
   discount
   tax
   taxPercentage
+  taxPercentageDecimal
   taxCode
   isBonus
   minimumQuantity

package/dist/cjs/generated/operations/orderRevisions.js

@@ -188,6 +188,7 @@ fragment OrderTotalsFields on OrderTotals {
   discountValue
   taxPercentages {
     percentage
+    percentageDecimal
     total
   }
 }
@@ -218,6 +219,7 @@ fragment OrderItemFields on OrderItem {
   discount
   tax
   taxPercentage
+  taxPercentageDecimal
   taxCode
   isBonus
   minimumQuantity

package/dist/cjs/generated/operations/orderUpdate.js

@@ -188,6 +188,7 @@ fragment OrderTotalsFields on OrderTotals {
   discountValue
   taxPercentages {
     percentage
+    percentageDecimal
     total
   }
 }
@@ -218,6 +219,7 @@ fragment OrderItemFields on OrderItem {
   discount
   tax
   taxPercentage
+  taxPercentageDecimal
   taxCode
   isBonus
   minimumQuantity

package/dist/cjs/generated/operations/orders.js

@@ -68,6 +68,7 @@ fragment OrderTotalsFields on OrderTotals {
   discountValue
   taxPercentages {
     percentage
+    percentageDecimal
     total
   }
 }

package/dist/cjs/generated/operations/tender.js

@@ -92,6 +92,7 @@ exports.document = `fragment TenderFields on Tender {
     totalPriceNet
     taxCode
     taxPercentage
+    taxPercentageDecimal
     customerDiscountPercentage
     discountPercentage
     totalDiscountPercentage
@@ -138,6 +139,7 @@ exports.document = `fragment TenderFields on Tender {
     totalPriceNet
     taxCode
     taxPercentage
+    taxPercentageDecimal
     customerDiscountPercentage
     discountPercentage
     totalDiscountPercentage

package/dist/cjs/generated/operations/tenderAddItems.js

@@ -103,6 +103,7 @@ fragment TenderFields on Tender {
     totalPriceNet
     taxCode
     taxPercentage
+    taxPercentageDecimal
     customerDiscountPercentage
     discountPercentage
     totalDiscountPercentage
@@ -149,6 +150,7 @@ fragment TenderFields on Tender {
     totalPriceNet
     taxCode
     taxPercentage
+    taxPercentageDecimal
     customerDiscountPercentage
     discountPercentage
     totalDiscountPercentage

package/dist/cjs/generated/operations/tenderApplyIncentives.js

@@ -92,6 +92,7 @@ exports.document = `fragment TenderFields on Tender {
     totalPriceNet
     taxCode
     taxPercentage
+    taxPercentageDecimal
     customerDiscountPercentage
     discountPercentage
     totalDiscountPercentage
@@ -138,6 +139,7 @@ exports.document = `fragment TenderFields on Tender {
     totalPriceNet
     taxCode
     taxPercentage
+    taxPercentageDecimal
     customerDiscountPercentage
     discountPercentage
     totalDiscountPercentage

package/dist/cjs/generated/operations/tenderDeleteBonusItem.js

@@ -92,6 +92,7 @@ exports.document = `fragment TenderFields on Tender {
     totalPriceNet
     taxCode
     taxPercentage
+    taxPercentageDecimal
     customerDiscountPercentage
     discountPercentage
     totalDiscountPercentage
@@ -138,6 +139,7 @@ exports.document = `fragment TenderFields on Tender {
     totalPriceNet
     taxCode
     taxPercentage
+    taxPercentageDecimal
     customerDiscountPercentage
     discountPercentage
     totalDiscountPercentage

package/dist/cjs/generated/operations/tenderDeleteItem.js

@@ -92,6 +92,7 @@ exports.document = `fragment TenderFields on Tender {
     totalPriceNet
     taxCode
     taxPercentage
+    taxPercentageDecimal
     customerDiscountPercentage
     discountPercentage
     totalDiscountPercentage
@@ -138,6 +139,7 @@ exports.document = `fragment TenderFields on Tender {
     totalPriceNet
     taxCode
     taxPercentage
+    taxPercentageDecimal
     customerDiscountPercentage
     discountPercentage
     totalDiscountPercentage

package/dist/cjs/generated/operations/tenderStart.js

@@ -92,6 +92,7 @@ exports.document = `fragment TenderFields on Tender {
     totalPriceNet
     taxCode
     taxPercentage
+    taxPercentageDecimal
     customerDiscountPercentage
     discountPercentage
     totalDiscountPercentage
@@ -138,6 +139,7 @@ exports.document = `fragment TenderFields on Tender {
     totalPriceNet
     taxCode
     taxPercentage
+    taxPercentageDecimal
     customerDiscountPercentage
     discountPercentage
     totalDiscountPercentage

package/dist/cjs/generated/operations/tenderUpdate.js

@@ -92,6 +92,7 @@ exports.document = `fragment TenderFields on Tender {
     totalPriceNet
     taxCode
     taxPercentage
+    taxPercentageDecimal
     customerDiscountPercentage
     discountPercentage
     totalDiscountPercentage
@@ -138,6 +139,7 @@ exports.document = `fragment TenderFields on Tender {
     totalPriceNet
     taxCode
     taxPercentage
+    taxPercentageDecimal
     customerDiscountPercentage
     discountPercentage
     totalDiscountPercentage