@behio/storefront-sdk 2.10.0 → 2.12.0

package/dist/{client-GId6Qj64.d.mts → client-D1nNDDVw.d.mts}

@@ -1205,6 +1205,13 @@ interface CheckoutPreview {
     giftCardDeducted: number;
     roundingAdjustment: number;
     grandTotal: number;
+    /** VAT contained in `grandTotal` split by rate: order discounts (always
+     *  VAT-inclusive) reduce base and VAT per rate, shipping and the payment fee
+     *  carry the goods rates. Same numbers as the invoice. SDK 2.12.0. */
+    taxBreakdown?: TaxBreakdownLine[];
+    /** VAT contained in `grandTotal`, the sum of `taxBreakdown[].taxAmount`.
+     *  `taxTotal` is the goods VAT before order discounts. SDK 2.12.0. */
+    vatTotal?: number;
     previewToken: string;
     expiresAt: number;
 }
@@ -1362,8 +1369,11 @@ interface Cart {
      *  `INCL_VAT`, VAT excluded when it runs `EXCL_VAT`. Not the payable amount,
      *  that is `grandTotal`. */
     subtotal: number;
-    /** Discount from the applied code. Always based on `subtotal`, i.e. on the
-     *  prices the customer sees, so "10 % off 200" is 20 in both price modes. */
+    /** Discount from the applied code, VAT-inclusive. The base is always the
+     *  VAT-inclusive amount, also when the shop shows prices without VAT: a
+     *  discount is never taken from the net base (SDK 2.12.0; before, "10 % off
+     *  200 net" was 20, now it is 24.20 at 21 %). It lowers base and VAT, see
+     *  `taxBreakdown` and `vatTotal`. */
     discountTotal: number;
     discount?: CartDiscount;
     /** Auto-apply promotion discount lines (sale/BOGO). */
@@ -1380,11 +1390,16 @@ interface Cart {
      *  back to the catalog price), under `EXCL_VAT` it is added on top. Render
      *  this as the cart total; do not add `taxTotal` to it. */
     grandTotal: number;
-    /** VAT contained in the prices (`INCL_VAT`) or added on top of them
-     *  (`EXCL_VAT`), across all lines (GAP-30). An estimate finalized at checkout
-     *  once the shipping country is known. */
+    /** Goods VAT BEFORE order discounts: contained in the prices (`INCL_VAT`) or
+     *  added on top (`EXCL_VAT`). Use it for the goods subtotal
+     *  (`subtotal` net + `taxTotal`); the VAT the customer pays is `vatTotal`. */
     taxTotal: number;
-    /** VAT split by rate for "DPH 21 %: X Kč" summary rows. Empty for a
+    /** VAT contained in `grandTotal`, after the order discount, as on the
+     *  invoice. Sum of `taxBreakdown[].taxAmount`. SDK 2.12.0. */
+    vatTotal?: number;
+    /** VAT of the payable amount split by rate for "DPH 21 %: X Kč" rows. The
+     *  order discount reduces base and VAT per rate (since SDK 2.12.0; before it
+     *  showed the VAT of the goods before the discount). Empty for a
      *  non-VAT-payer shop. */
     taxBreakdown: TaxBreakdownLine[];
     /** Delivery country set via `cart.setDestination()`, null until known. SDK 1.17.0. */
@@ -1610,6 +1625,8 @@ interface OrderTracking {
     paymentFee?: number | null;
     discountTotal?: number;
     taxTotal?: number;
+    /** VAT contained in `grandTotal`, as on the invoice. SDK 2.12.0. */
+    vatTotal?: number;
     taxBreakdown?: TaxBreakdownLine[];
     /** Shipping method as the customer chose it (SDK 2.8.0). */
     shippingMethodName?: string | null;
@@ -1662,9 +1679,15 @@ interface OrderDetail extends OrderListItem {
     phone?: string;
     customerNote?: string;
     subtotal: number;
+    /** Goods VAT before order discounts (goods subtotal = `subtotal` + `taxTotal`). */
     taxTotal: number;
-    /** VAT split by rate (GAP-30), summed from the order lines. Render
-     *  "DPH 21 %: X Kč" rows. Empty for a non-VAT order. */
+    /** VAT contained in `grandTotal` (after discounts, incl. shipping), the same
+     *  as on the invoice. Sum of `taxBreakdown[].taxAmount`. SDK 2.12.0. */
+    vatTotal?: number;
+    /** VAT of the amount paid split by rate (GAP-30) for "DPH 21 %: X Kč" rows.
+     *  Order discounts reduce base and VAT, shipping and the payment fee carry
+     *  the goods rates (since SDK 2.12.0, matching the invoice). Empty for a
+     *  non-VAT order. */
     taxBreakdown: TaxBreakdownLine[];
     /** DOMESTIC, OSS, REVERSE_CHARGE (no VAT, buyer accounts for it) or EXPORT (no VAT, outside EU). SDK 1.17.0. */
     vatMode?: "DOMESTIC" | "OSS" | "REVERSE_CHARGE" | "EXPORT" | null;
@@ -2642,6 +2665,13 @@ interface CrossSellItem {
     compareAtPrice: number | null;
     /** Currency code the `price` / `compareAtPrice` are expressed in. */
     currency: string;
+    /**
+     * true when `price` was FX-converted from the shop's default currency (no
+     * price row for `currency`). Show it as approximate (for example with "≈");
+     * the cart charges only real price rows. Same meaning as
+     * `ProductPrice.isApproximate`. Backend 2026-10-02+, absent on older APIs.
+     */
+    priceIsApproximate?: boolean;
     imageUrl: string | null;
     /** Selected-warehouse quantity; null when the merchant hides exact stock. */
     stockCached: number | null;

package/dist/{client-GId6Qj64.d.ts → client-D1nNDDVw.d.ts}

@@ -1205,6 +1205,13 @@ interface CheckoutPreview {
     giftCardDeducted: number;
     roundingAdjustment: number;
     grandTotal: number;
+    /** VAT contained in `grandTotal` split by rate: order discounts (always
+     *  VAT-inclusive) reduce base and VAT per rate, shipping and the payment fee
+     *  carry the goods rates. Same numbers as the invoice. SDK 2.12.0. */
+    taxBreakdown?: TaxBreakdownLine[];
+    /** VAT contained in `grandTotal`, the sum of `taxBreakdown[].taxAmount`.
+     *  `taxTotal` is the goods VAT before order discounts. SDK 2.12.0. */
+    vatTotal?: number;
     previewToken: string;
     expiresAt: number;
 }
@@ -1362,8 +1369,11 @@ interface Cart {
      *  `INCL_VAT`, VAT excluded when it runs `EXCL_VAT`. Not the payable amount,
      *  that is `grandTotal`. */
     subtotal: number;
-    /** Discount from the applied code. Always based on `subtotal`, i.e. on the
-     *  prices the customer sees, so "10 % off 200" is 20 in both price modes. */
+    /** Discount from the applied code, VAT-inclusive. The base is always the
+     *  VAT-inclusive amount, also when the shop shows prices without VAT: a
+     *  discount is never taken from the net base (SDK 2.12.0; before, "10 % off
+     *  200 net" was 20, now it is 24.20 at 21 %). It lowers base and VAT, see
+     *  `taxBreakdown` and `vatTotal`. */
     discountTotal: number;
     discount?: CartDiscount;
     /** Auto-apply promotion discount lines (sale/BOGO). */
@@ -1380,11 +1390,16 @@ interface Cart {
      *  back to the catalog price), under `EXCL_VAT` it is added on top. Render
      *  this as the cart total; do not add `taxTotal` to it. */
     grandTotal: number;
-    /** VAT contained in the prices (`INCL_VAT`) or added on top of them
-     *  (`EXCL_VAT`), across all lines (GAP-30). An estimate finalized at checkout
-     *  once the shipping country is known. */
+    /** Goods VAT BEFORE order discounts: contained in the prices (`INCL_VAT`) or
+     *  added on top (`EXCL_VAT`). Use it for the goods subtotal
+     *  (`subtotal` net + `taxTotal`); the VAT the customer pays is `vatTotal`. */
     taxTotal: number;
-    /** VAT split by rate for "DPH 21 %: X Kč" summary rows. Empty for a
+    /** VAT contained in `grandTotal`, after the order discount, as on the
+     *  invoice. Sum of `taxBreakdown[].taxAmount`. SDK 2.12.0. */
+    vatTotal?: number;
+    /** VAT of the payable amount split by rate for "DPH 21 %: X Kč" rows. The
+     *  order discount reduces base and VAT per rate (since SDK 2.12.0; before it
+     *  showed the VAT of the goods before the discount). Empty for a
      *  non-VAT-payer shop. */
     taxBreakdown: TaxBreakdownLine[];
     /** Delivery country set via `cart.setDestination()`, null until known. SDK 1.17.0. */
@@ -1610,6 +1625,8 @@ interface OrderTracking {
     paymentFee?: number | null;
     discountTotal?: number;
     taxTotal?: number;
+    /** VAT contained in `grandTotal`, as on the invoice. SDK 2.12.0. */
+    vatTotal?: number;
     taxBreakdown?: TaxBreakdownLine[];
     /** Shipping method as the customer chose it (SDK 2.8.0). */
     shippingMethodName?: string | null;
@@ -1662,9 +1679,15 @@ interface OrderDetail extends OrderListItem {
     phone?: string;
     customerNote?: string;
     subtotal: number;
+    /** Goods VAT before order discounts (goods subtotal = `subtotal` + `taxTotal`). */
     taxTotal: number;
-    /** VAT split by rate (GAP-30), summed from the order lines. Render
-     *  "DPH 21 %: X Kč" rows. Empty for a non-VAT order. */
+    /** VAT contained in `grandTotal` (after discounts, incl. shipping), the same
+     *  as on the invoice. Sum of `taxBreakdown[].taxAmount`. SDK 2.12.0. */
+    vatTotal?: number;
+    /** VAT of the amount paid split by rate (GAP-30) for "DPH 21 %: X Kč" rows.
+     *  Order discounts reduce base and VAT, shipping and the payment fee carry
+     *  the goods rates (since SDK 2.12.0, matching the invoice). Empty for a
+     *  non-VAT order. */
     taxBreakdown: TaxBreakdownLine[];
     /** DOMESTIC, OSS, REVERSE_CHARGE (no VAT, buyer accounts for it) or EXPORT (no VAT, outside EU). SDK 1.17.0. */
     vatMode?: "DOMESTIC" | "OSS" | "REVERSE_CHARGE" | "EXPORT" | null;
@@ -2642,6 +2665,13 @@ interface CrossSellItem {
     compareAtPrice: number | null;
     /** Currency code the `price` / `compareAtPrice` are expressed in. */
     currency: string;
+    /**
+     * true when `price` was FX-converted from the shop's default currency (no
+     * price row for `currency`). Show it as approximate (for example with "≈");
+     * the cart charges only real price rows. Same meaning as
+     * `ProductPrice.isApproximate`. Backend 2026-10-02+, absent on older APIs.
+     */
+    priceIsApproximate?: boolean;
     imageUrl: string | null;
     /** Selected-warehouse quantity; null when the merchant hides exact stock. */
     stockCached: number | null;

package/dist/index.d.mts

@@ -1,5 +1,5 @@
-import { P as ProductDetail, a as ProductVariant, B as BehioStorefront, S as SdkResult, C as CookieConsent, b as StorefrontFormFieldError } from './client-GId6Qj64.mjs';
-export { A as ActivePromotion, c as AddToCartInput, d as AddressDetail, e as AddressSuggestion, f as AddressType, g as AddressTypes, h as AuthTokens, i as BackInStockSubscription, j as BadgeTone, k as BehioApiError, l as BehioErrorCode, m as BehioEventHandler, n as BehioEventType, o as BehioNetworkError, p as BehioStorefrontConfig, q as Blog, r as BlogPostDetail, s as BlogPostListItem, t as BlogPostsPage, u as BlogPostsQuery, v as BlogSettings, w as BlogTag, x as Bundle, y as BundleCatalogQuery, z as BundleItem, D as Cart, E as CartBundleLine, F as CartBundleLineItem, G as CartDiscount, H as CartItem, I as CartItemProduct, J as CartLinkClaimed, K as CartPromotion, L as CartSummaryEvent, M as Category, N as CategoryDetail, O as CertificateVerification, Q as CheckoutAddress, R as CheckoutInput, T as CheckoutPaymentMethod, U as CheckoutPreview, V as CheckoutResult, W as CheckoutSettings, X as CookieConsentInput, Y as CourseAttachment, Z as CourseCertificate, _ as CourseComment, $ as CourseCommentReply, a0 as CourseCommentsList, a1 as CourseDetail, a2 as CourseLesson, a3 as CourseListItem, a4 as CourseModule, a5 as CoursePostedComment, a6 as CourseProgress, a7 as CourseTutorMessage, a8 as CourseTutorThread, a9 as CrossSellItem, aa as CurrencyDisplayFormat, ab as CustomerAddress, ac as CustomerBadge, ad as CustomerChallenge, ae as CustomerGamification, af as CustomerGamificationQuery, ag as CustomerProfile, ah as DigitalDownload, ai as DownloadUrl, aj as Facet, ak as FacetAvailability, al as FacetCategory, am as FacetLabel, an as FacetPriceRange, ao as FacetRange, ap as FacetRatingBucket, aq as FacetValue, ar as FacetsResponse, as as FilterField, at as FulfillmentStatus, au as FulfillmentStatuses, av as GamificationRefreshResult, aw as GiftCardBalance, ax as GiftCardPurchaseInput, ay as GiftCardPurchaseResult, az as GiftCardSummary, aA as LessonNote, aB as LessonQuiz, aC as LoginInput, aD as LoyaltyBalance, aE as LoyaltyNextTier, aF as LoyaltyProgram, aG as LoyaltyQuery, aH as LoyaltyReferralResult, aI as LoyaltySummary, aJ as LoyaltyTier, aK as LoyaltyTierPerks, aL as LoyaltyTransaction, aM as Menu, aN as MenuItem, aO as MenuItemRef, aP as MenuItemType, aQ as MessageResponse, aR as NewsletterOptInDefault, aS as NewsletterSubscribeInput, aT as NewsletterSubscribeResult, aU as NewsletterUnsubscribeResult, aV as OrderAccessRequestResponse, aW as OrderAccessVerifyResponse, aX as OrderDetail, aY as OrderItem, aZ as OrderListItem, a_ as OrderPickupPoint, a$ as OrderShipment, b0 as OrderStatus, b1 as OrderStatusHistory, b2 as OrderStatuses, b3 as OrderTracking, b4 as Page, b5 as PageAttachment, b6 as PageDetail, b7 as PaginatedResponse, b8 as PaymentInstrument, b9 as PaymentStatus, ba as PaymentStatuses, bb as PaymentSwift, bc as PickupPoint, bd as PickupPointHours, be as PickupPointsInput, bf as PickupWidgetConfig, bg as PriceDisplay, bh as ProductAssetGroup, bi as ProductAssetItem, bj as ProductAvailability, bk as ProductGroup, bl as ProductLabel, bm as ProductListItem, bn as ProductMedia, bo as ProductMediaVariant, bp as ProductParameter, bq as ProductParameterGroup, br as ProductParametersResponse, bs as ProductPrice, bt as ProductPromotionSummary, bu as ProductReview, bv as ProductReviewsResponse, bw as ProductSibling, bx as ProductSort, by as ProductSortValue, bz as ProductVolumePrice, bA as ProductsQuery, bB as QuizAnswerInput, bC as QuizAnswerResult, bD as QuizQuestion, bE as QuizResult, bF as QuoteItem, bG as QuoteRequest, bH as RegisterInput, bI as RegisterResult, bJ as RequestInterceptor, bK as RequestInterceptorConfig, bL as ResponseInterceptor, bM as ResponseInterceptorData, bN as ReturnRequest, bO as ReturnRequestItem, bP as ReturnStatus, bQ as ReturnStatusItem, bR as ReturnableOrder, bS as ReturnableOrderItem, bT as SdkError, bU as ShippingMethodSummary, bV as ShippingQuote, bW as ShippingQuoteInput, bX as ShopAppearance, bY as ShopInfo, bZ as ShopScript, b_ as ShopScriptPlacement, b$ as ShopScriptType, c0 as ShopScripts, c1 as ShopSeo, c2 as ShopSeoIdentity, c3 as SiteFormField, c4 as SiteFormFieldOption, c5 as SiteFormFieldType, c6 as Sitemap, c7 as SitemapEntry, c8 as StockBehavior, c9 as StockMode, ca as StorefrontForm, cb as StorefrontFormFieldErrorCode, cc as StorefrontFormFile, cd as StorefrontFormSettings, ce as StorefrontFormSubmitInput, cf as StorefrontFormSubmitResult, cg as StorefrontFormUpload, ch as SubmitQuoteInput, ci as SubmitReturnInput, cj as SubmitReviewInput, ck as Subscription, cl as SubscriptionAction, cm as SubscriptionFrequency, cn as SubscriptionItem, co as SubscriptionStatus, cp as TaxBreakdownLine, cq as VariantAxis, cr as VariantAxisValue, cs as WishlistItem, ct as clearCartSummary, cu as err, cv as ok, cw as publishCartSummary, cx as toSdkError } from './client-GId6Qj64.mjs';
+import { P as ProductDetail, a as ProductVariant, B as BehioStorefront, S as SdkResult, C as CookieConsent, b as StorefrontFormFieldError } from './client-D1nNDDVw.mjs';
+export { A as ActivePromotion, c as AddToCartInput, d as AddressDetail, e as AddressSuggestion, f as AddressType, g as AddressTypes, h as AuthTokens, i as BackInStockSubscription, j as BadgeTone, k as BehioApiError, l as BehioErrorCode, m as BehioEventHandler, n as BehioEventType, o as BehioNetworkError, p as BehioStorefrontConfig, q as Blog, r as BlogPostDetail, s as BlogPostListItem, t as BlogPostsPage, u as BlogPostsQuery, v as BlogSettings, w as BlogTag, x as Bundle, y as BundleCatalogQuery, z as BundleItem, D as Cart, E as CartBundleLine, F as CartBundleLineItem, G as CartDiscount, H as CartItem, I as CartItemProduct, J as CartLinkClaimed, K as CartPromotion, L as CartSummaryEvent, M as Category, N as CategoryDetail, O as CertificateVerification, Q as CheckoutAddress, R as CheckoutInput, T as CheckoutPaymentMethod, U as CheckoutPreview, V as CheckoutResult, W as CheckoutSettings, X as CookieConsentInput, Y as CourseAttachment, Z as CourseCertificate, _ as CourseComment, $ as CourseCommentReply, a0 as CourseCommentsList, a1 as CourseDetail, a2 as CourseLesson, a3 as CourseListItem, a4 as CourseModule, a5 as CoursePostedComment, a6 as CourseProgress, a7 as CourseTutorMessage, a8 as CourseTutorThread, a9 as CrossSellItem, aa as CurrencyDisplayFormat, ab as CustomerAddress, ac as CustomerBadge, ad as CustomerChallenge, ae as CustomerGamification, af as CustomerGamificationQuery, ag as CustomerProfile, ah as DigitalDownload, ai as DownloadUrl, aj as Facet, ak as FacetAvailability, al as FacetCategory, am as FacetLabel, an as FacetPriceRange, ao as FacetRange, ap as FacetRatingBucket, aq as FacetValue, ar as FacetsResponse, as as FilterField, at as FulfillmentStatus, au as FulfillmentStatuses, av as GamificationRefreshResult, aw as GiftCardBalance, ax as GiftCardPurchaseInput, ay as GiftCardPurchaseResult, az as GiftCardSummary, aA as LessonNote, aB as LessonQuiz, aC as LoginInput, aD as LoyaltyBalance, aE as LoyaltyNextTier, aF as LoyaltyProgram, aG as LoyaltyQuery, aH as LoyaltyReferralResult, aI as LoyaltySummary, aJ as LoyaltyTier, aK as LoyaltyTierPerks, aL as LoyaltyTransaction, aM as Menu, aN as MenuItem, aO as MenuItemRef, aP as MenuItemType, aQ as MessageResponse, aR as NewsletterOptInDefault, aS as NewsletterSubscribeInput, aT as NewsletterSubscribeResult, aU as NewsletterUnsubscribeResult, aV as OrderAccessRequestResponse, aW as OrderAccessVerifyResponse, aX as OrderDetail, aY as OrderItem, aZ as OrderListItem, a_ as OrderPickupPoint, a$ as OrderShipment, b0 as OrderStatus, b1 as OrderStatusHistory, b2 as OrderStatuses, b3 as OrderTracking, b4 as Page, b5 as PageAttachment, b6 as PageDetail, b7 as PaginatedResponse, b8 as PaymentInstrument, b9 as PaymentStatus, ba as PaymentStatuses, bb as PaymentSwift, bc as PickupPoint, bd as PickupPointHours, be as PickupPointsInput, bf as PickupWidgetConfig, bg as PriceDisplay, bh as ProductAssetGroup, bi as ProductAssetItem, bj as ProductAvailability, bk as ProductGroup, bl as ProductLabel, bm as ProductListItem, bn as ProductMedia, bo as ProductMediaVariant, bp as ProductParameter, bq as ProductParameterGroup, br as ProductParametersResponse, bs as ProductPrice, bt as ProductPromotionSummary, bu as ProductReview, bv as ProductReviewsResponse, bw as ProductSibling, bx as ProductSort, by as ProductSortValue, bz as ProductVolumePrice, bA as ProductsQuery, bB as QuizAnswerInput, bC as QuizAnswerResult, bD as QuizQuestion, bE as QuizResult, bF as QuoteItem, bG as QuoteRequest, bH as RegisterInput, bI as RegisterResult, bJ as RequestInterceptor, bK as RequestInterceptorConfig, bL as ResponseInterceptor, bM as ResponseInterceptorData, bN as ReturnRequest, bO as ReturnRequestItem, bP as ReturnStatus, bQ as ReturnStatusItem, bR as ReturnableOrder, bS as ReturnableOrderItem, bT as SdkError, bU as ShippingMethodSummary, bV as ShippingQuote, bW as ShippingQuoteInput, bX as ShopAppearance, bY as ShopInfo, bZ as ShopScript, b_ as ShopScriptPlacement, b$ as ShopScriptType, c0 as ShopScripts, c1 as ShopSeo, c2 as ShopSeoIdentity, c3 as SiteFormField, c4 as SiteFormFieldOption, c5 as SiteFormFieldType, c6 as Sitemap, c7 as SitemapEntry, c8 as StockBehavior, c9 as StockMode, ca as StorefrontForm, cb as StorefrontFormFieldErrorCode, cc as StorefrontFormFile, cd as StorefrontFormSettings, ce as StorefrontFormSubmitInput, cf as StorefrontFormSubmitResult, cg as StorefrontFormUpload, ch as SubmitQuoteInput, ci as SubmitReturnInput, cj as SubmitReviewInput, ck as Subscription, cl as SubscriptionAction, cm as SubscriptionFrequency, cn as SubscriptionItem, co as SubscriptionStatus, cp as TaxBreakdownLine, cq as VariantAxis, cr as VariantAxisValue, cs as WishlistItem, ct as clearCartSummary, cu as err, cv as ok, cw as publishCartSummary, cx as toSdkError } from './client-D1nNDDVw.mjs';
 
 /**
  * Format a price amount with currency using Intl.NumberFormat.

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { P as ProductDetail, a as ProductVariant, B as BehioStorefront, S as SdkResult, C as CookieConsent, b as StorefrontFormFieldError } from './client-GId6Qj64.js';
-export { A as ActivePromotion, c as AddToCartInput, d as AddressDetail, e as AddressSuggestion, f as AddressType, g as AddressTypes, h as AuthTokens, i as BackInStockSubscription, j as BadgeTone, k as BehioApiError, l as BehioErrorCode, m as BehioEventHandler, n as BehioEventType, o as BehioNetworkError, p as BehioStorefrontConfig, q as Blog, r as BlogPostDetail, s as BlogPostListItem, t as BlogPostsPage, u as BlogPostsQuery, v as BlogSettings, w as BlogTag, x as Bundle, y as BundleCatalogQuery, z as BundleItem, D as Cart, E as CartBundleLine, F as CartBundleLineItem, G as CartDiscount, H as CartItem, I as CartItemProduct, J as CartLinkClaimed, K as CartPromotion, L as CartSummaryEvent, M as Category, N as CategoryDetail, O as CertificateVerification, Q as CheckoutAddress, R as CheckoutInput, T as CheckoutPaymentMethod, U as CheckoutPreview, V as CheckoutResult, W as CheckoutSettings, X as CookieConsentInput, Y as CourseAttachment, Z as CourseCertificate, _ as CourseComment, $ as CourseCommentReply, a0 as CourseCommentsList, a1 as CourseDetail, a2 as CourseLesson, a3 as CourseListItem, a4 as CourseModule, a5 as CoursePostedComment, a6 as CourseProgress, a7 as CourseTutorMessage, a8 as CourseTutorThread, a9 as CrossSellItem, aa as CurrencyDisplayFormat, ab as CustomerAddress, ac as CustomerBadge, ad as CustomerChallenge, ae as CustomerGamification, af as CustomerGamificationQuery, ag as CustomerProfile, ah as DigitalDownload, ai as DownloadUrl, aj as Facet, ak as FacetAvailability, al as FacetCategory, am as FacetLabel, an as FacetPriceRange, ao as FacetRange, ap as FacetRatingBucket, aq as FacetValue, ar as FacetsResponse, as as FilterField, at as FulfillmentStatus, au as FulfillmentStatuses, av as GamificationRefreshResult, aw as GiftCardBalance, ax as GiftCardPurchaseInput, ay as GiftCardPurchaseResult, az as GiftCardSummary, aA as LessonNote, aB as LessonQuiz, aC as LoginInput, aD as LoyaltyBalance, aE as LoyaltyNextTier, aF as LoyaltyProgram, aG as LoyaltyQuery, aH as LoyaltyReferralResult, aI as LoyaltySummary, aJ as LoyaltyTier, aK as LoyaltyTierPerks, aL as LoyaltyTransaction, aM as Menu, aN as MenuItem, aO as MenuItemRef, aP as MenuItemType, aQ as MessageResponse, aR as NewsletterOptInDefault, aS as NewsletterSubscribeInput, aT as NewsletterSubscribeResult, aU as NewsletterUnsubscribeResult, aV as OrderAccessRequestResponse, aW as OrderAccessVerifyResponse, aX as OrderDetail, aY as OrderItem, aZ as OrderListItem, a_ as OrderPickupPoint, a$ as OrderShipment, b0 as OrderStatus, b1 as OrderStatusHistory, b2 as OrderStatuses, b3 as OrderTracking, b4 as Page, b5 as PageAttachment, b6 as PageDetail, b7 as PaginatedResponse, b8 as PaymentInstrument, b9 as PaymentStatus, ba as PaymentStatuses, bb as PaymentSwift, bc as PickupPoint, bd as PickupPointHours, be as PickupPointsInput, bf as PickupWidgetConfig, bg as PriceDisplay, bh as ProductAssetGroup, bi as ProductAssetItem, bj as ProductAvailability, bk as ProductGroup, bl as ProductLabel, bm as ProductListItem, bn as ProductMedia, bo as ProductMediaVariant, bp as ProductParameter, bq as ProductParameterGroup, br as ProductParametersResponse, bs as ProductPrice, bt as ProductPromotionSummary, bu as ProductReview, bv as ProductReviewsResponse, bw as ProductSibling, bx as ProductSort, by as ProductSortValue, bz as ProductVolumePrice, bA as ProductsQuery, bB as QuizAnswerInput, bC as QuizAnswerResult, bD as QuizQuestion, bE as QuizResult, bF as QuoteItem, bG as QuoteRequest, bH as RegisterInput, bI as RegisterResult, bJ as RequestInterceptor, bK as RequestInterceptorConfig, bL as ResponseInterceptor, bM as ResponseInterceptorData, bN as ReturnRequest, bO as ReturnRequestItem, bP as ReturnStatus, bQ as ReturnStatusItem, bR as ReturnableOrder, bS as ReturnableOrderItem, bT as SdkError, bU as ShippingMethodSummary, bV as ShippingQuote, bW as ShippingQuoteInput, bX as ShopAppearance, bY as ShopInfo, bZ as ShopScript, b_ as ShopScriptPlacement, b$ as ShopScriptType, c0 as ShopScripts, c1 as ShopSeo, c2 as ShopSeoIdentity, c3 as SiteFormField, c4 as SiteFormFieldOption, c5 as SiteFormFieldType, c6 as Sitemap, c7 as SitemapEntry, c8 as StockBehavior, c9 as StockMode, ca as StorefrontForm, cb as StorefrontFormFieldErrorCode, cc as StorefrontFormFile, cd as StorefrontFormSettings, ce as StorefrontFormSubmitInput, cf as StorefrontFormSubmitResult, cg as StorefrontFormUpload, ch as SubmitQuoteInput, ci as SubmitReturnInput, cj as SubmitReviewInput, ck as Subscription, cl as SubscriptionAction, cm as SubscriptionFrequency, cn as SubscriptionItem, co as SubscriptionStatus, cp as TaxBreakdownLine, cq as VariantAxis, cr as VariantAxisValue, cs as WishlistItem, ct as clearCartSummary, cu as err, cv as ok, cw as publishCartSummary, cx as toSdkError } from './client-GId6Qj64.js';
+import { P as ProductDetail, a as ProductVariant, B as BehioStorefront, S as SdkResult, C as CookieConsent, b as StorefrontFormFieldError } from './client-D1nNDDVw.js';
+export { A as ActivePromotion, c as AddToCartInput, d as AddressDetail, e as AddressSuggestion, f as AddressType, g as AddressTypes, h as AuthTokens, i as BackInStockSubscription, j as BadgeTone, k as BehioApiError, l as BehioErrorCode, m as BehioEventHandler, n as BehioEventType, o as BehioNetworkError, p as BehioStorefrontConfig, q as Blog, r as BlogPostDetail, s as BlogPostListItem, t as BlogPostsPage, u as BlogPostsQuery, v as BlogSettings, w as BlogTag, x as Bundle, y as BundleCatalogQuery, z as BundleItem, D as Cart, E as CartBundleLine, F as CartBundleLineItem, G as CartDiscount, H as CartItem, I as CartItemProduct, J as CartLinkClaimed, K as CartPromotion, L as CartSummaryEvent, M as Category, N as CategoryDetail, O as CertificateVerification, Q as CheckoutAddress, R as CheckoutInput, T as CheckoutPaymentMethod, U as CheckoutPreview, V as CheckoutResult, W as CheckoutSettings, X as CookieConsentInput, Y as CourseAttachment, Z as CourseCertificate, _ as CourseComment, $ as CourseCommentReply, a0 as CourseCommentsList, a1 as CourseDetail, a2 as CourseLesson, a3 as CourseListItem, a4 as CourseModule, a5 as CoursePostedComment, a6 as CourseProgress, a7 as CourseTutorMessage, a8 as CourseTutorThread, a9 as CrossSellItem, aa as CurrencyDisplayFormat, ab as CustomerAddress, ac as CustomerBadge, ad as CustomerChallenge, ae as CustomerGamification, af as CustomerGamificationQuery, ag as CustomerProfile, ah as DigitalDownload, ai as DownloadUrl, aj as Facet, ak as FacetAvailability, al as FacetCategory, am as FacetLabel, an as FacetPriceRange, ao as FacetRange, ap as FacetRatingBucket, aq as FacetValue, ar as FacetsResponse, as as FilterField, at as FulfillmentStatus, au as FulfillmentStatuses, av as GamificationRefreshResult, aw as GiftCardBalance, ax as GiftCardPurchaseInput, ay as GiftCardPurchaseResult, az as GiftCardSummary, aA as LessonNote, aB as LessonQuiz, aC as LoginInput, aD as LoyaltyBalance, aE as LoyaltyNextTier, aF as LoyaltyProgram, aG as LoyaltyQuery, aH as LoyaltyReferralResult, aI as LoyaltySummary, aJ as LoyaltyTier, aK as LoyaltyTierPerks, aL as LoyaltyTransaction, aM as Menu, aN as MenuItem, aO as MenuItemRef, aP as MenuItemType, aQ as MessageResponse, aR as NewsletterOptInDefault, aS as NewsletterSubscribeInput, aT as NewsletterSubscribeResult, aU as NewsletterUnsubscribeResult, aV as OrderAccessRequestResponse, aW as OrderAccessVerifyResponse, aX as OrderDetail, aY as OrderItem, aZ as OrderListItem, a_ as OrderPickupPoint, a$ as OrderShipment, b0 as OrderStatus, b1 as OrderStatusHistory, b2 as OrderStatuses, b3 as OrderTracking, b4 as Page, b5 as PageAttachment, b6 as PageDetail, b7 as PaginatedResponse, b8 as PaymentInstrument, b9 as PaymentStatus, ba as PaymentStatuses, bb as PaymentSwift, bc as PickupPoint, bd as PickupPointHours, be as PickupPointsInput, bf as PickupWidgetConfig, bg as PriceDisplay, bh as ProductAssetGroup, bi as ProductAssetItem, bj as ProductAvailability, bk as ProductGroup, bl as ProductLabel, bm as ProductListItem, bn as ProductMedia, bo as ProductMediaVariant, bp as ProductParameter, bq as ProductParameterGroup, br as ProductParametersResponse, bs as ProductPrice, bt as ProductPromotionSummary, bu as ProductReview, bv as ProductReviewsResponse, bw as ProductSibling, bx as ProductSort, by as ProductSortValue, bz as ProductVolumePrice, bA as ProductsQuery, bB as QuizAnswerInput, bC as QuizAnswerResult, bD as QuizQuestion, bE as QuizResult, bF as QuoteItem, bG as QuoteRequest, bH as RegisterInput, bI as RegisterResult, bJ as RequestInterceptor, bK as RequestInterceptorConfig, bL as ResponseInterceptor, bM as ResponseInterceptorData, bN as ReturnRequest, bO as ReturnRequestItem, bP as ReturnStatus, bQ as ReturnStatusItem, bR as ReturnableOrder, bS as ReturnableOrderItem, bT as SdkError, bU as ShippingMethodSummary, bV as ShippingQuote, bW as ShippingQuoteInput, bX as ShopAppearance, bY as ShopInfo, bZ as ShopScript, b_ as ShopScriptPlacement, b$ as ShopScriptType, c0 as ShopScripts, c1 as ShopSeo, c2 as ShopSeoIdentity, c3 as SiteFormField, c4 as SiteFormFieldOption, c5 as SiteFormFieldType, c6 as Sitemap, c7 as SitemapEntry, c8 as StockBehavior, c9 as StockMode, ca as StorefrontForm, cb as StorefrontFormFieldErrorCode, cc as StorefrontFormFile, cd as StorefrontFormSettings, ce as StorefrontFormSubmitInput, cf as StorefrontFormSubmitResult, cg as StorefrontFormUpload, ch as SubmitQuoteInput, ci as SubmitReturnInput, cj as SubmitReviewInput, ck as Subscription, cl as SubscriptionAction, cm as SubscriptionFrequency, cn as SubscriptionItem, co as SubscriptionStatus, cp as TaxBreakdownLine, cq as VariantAxis, cr as VariantAxisValue, cs as WishlistItem, ct as clearCartSummary, cu as err, cv as ok, cw as publishCartSummary, cx as toSdkError } from './client-D1nNDDVw.js';
 
 /**
  * Format a price amount with currency using Intl.NumberFormat.

package/dist/next.d.mts

@@ -1,4 +1,4 @@
-import { p as BehioStorefrontConfig, B as BehioStorefront } from './client-GId6Qj64.mjs';
+import { p as BehioStorefrontConfig, B as BehioStorefront } from './client-D1nNDDVw.mjs';
 
 interface GetBehioOptions extends Partial<BehioStorefrontConfig> {
     /** Override the cart session cookie name (default: "behio_cart_session"). */

package/dist/next.d.ts

@@ -1,4 +1,4 @@
-import { p as BehioStorefrontConfig, B as BehioStorefront } from './client-GId6Qj64.js';
+import { p as BehioStorefrontConfig, B as BehioStorefront } from './client-D1nNDDVw.js';
 
 interface GetBehioOptions extends Partial<BehioStorefrontConfig> {
     /** Override the cart session cookie name (default: "behio_cart_session"). */

package/dist/react.d.mts

@@ -1261,6 +1261,13 @@ interface CheckoutPreview {
     giftCardDeducted: number;
     roundingAdjustment: number;
     grandTotal: number;
+    /** VAT contained in `grandTotal` split by rate: order discounts (always
+     *  VAT-inclusive) reduce base and VAT per rate, shipping and the payment fee
+     *  carry the goods rates. Same numbers as the invoice. SDK 2.12.0. */
+    taxBreakdown?: TaxBreakdownLine[];
+    /** VAT contained in `grandTotal`, the sum of `taxBreakdown[].taxAmount`.
+     *  `taxTotal` is the goods VAT before order discounts. SDK 2.12.0. */
+    vatTotal?: number;
     previewToken: string;
     expiresAt: number;
 }
@@ -1418,8 +1425,11 @@ interface Cart {
      *  `INCL_VAT`, VAT excluded when it runs `EXCL_VAT`. Not the payable amount,
      *  that is `grandTotal`. */
     subtotal: number;
-    /** Discount from the applied code. Always based on `subtotal`, i.e. on the
-     *  prices the customer sees, so "10 % off 200" is 20 in both price modes. */
+    /** Discount from the applied code, VAT-inclusive. The base is always the
+     *  VAT-inclusive amount, also when the shop shows prices without VAT: a
+     *  discount is never taken from the net base (SDK 2.12.0; before, "10 % off
+     *  200 net" was 20, now it is 24.20 at 21 %). It lowers base and VAT, see
+     *  `taxBreakdown` and `vatTotal`. */
     discountTotal: number;
     discount?: CartDiscount;
     /** Auto-apply promotion discount lines (sale/BOGO). */
@@ -1436,11 +1446,16 @@ interface Cart {
      *  back to the catalog price), under `EXCL_VAT` it is added on top. Render
      *  this as the cart total; do not add `taxTotal` to it. */
     grandTotal: number;
-    /** VAT contained in the prices (`INCL_VAT`) or added on top of them
-     *  (`EXCL_VAT`), across all lines (GAP-30). An estimate finalized at checkout
-     *  once the shipping country is known. */
+    /** Goods VAT BEFORE order discounts: contained in the prices (`INCL_VAT`) or
+     *  added on top (`EXCL_VAT`). Use it for the goods subtotal
+     *  (`subtotal` net + `taxTotal`); the VAT the customer pays is `vatTotal`. */
     taxTotal: number;
-    /** VAT split by rate for "DPH 21 %: X Kč" summary rows. Empty for a
+    /** VAT contained in `grandTotal`, after the order discount, as on the
+     *  invoice. Sum of `taxBreakdown[].taxAmount`. SDK 2.12.0. */
+    vatTotal?: number;
+    /** VAT of the payable amount split by rate for "DPH 21 %: X Kč" rows. The
+     *  order discount reduces base and VAT per rate (since SDK 2.12.0; before it
+     *  showed the VAT of the goods before the discount). Empty for a
      *  non-VAT-payer shop. */
     taxBreakdown: TaxBreakdownLine[];
     /** Delivery country set via `cart.setDestination()`, null until known. SDK 1.17.0. */
@@ -1666,6 +1681,8 @@ interface OrderTracking {
     paymentFee?: number | null;
     discountTotal?: number;
     taxTotal?: number;
+    /** VAT contained in `grandTotal`, as on the invoice. SDK 2.12.0. */
+    vatTotal?: number;
     taxBreakdown?: TaxBreakdownLine[];
     /** Shipping method as the customer chose it (SDK 2.8.0). */
     shippingMethodName?: string | null;
@@ -1718,9 +1735,15 @@ interface OrderDetail extends OrderListItem {
     phone?: string;
     customerNote?: string;
     subtotal: number;
+    /** Goods VAT before order discounts (goods subtotal = `subtotal` + `taxTotal`). */
     taxTotal: number;
-    /** VAT split by rate (GAP-30), summed from the order lines. Render
-     *  "DPH 21 %: X Kč" rows. Empty for a non-VAT order. */
+    /** VAT contained in `grandTotal` (after discounts, incl. shipping), the same
+     *  as on the invoice. Sum of `taxBreakdown[].taxAmount`. SDK 2.12.0. */
+    vatTotal?: number;
+    /** VAT of the amount paid split by rate (GAP-30) for "DPH 21 %: X Kč" rows.
+     *  Order discounts reduce base and VAT, shipping and the payment fee carry
+     *  the goods rates (since SDK 2.12.0, matching the invoice). Empty for a
+     *  non-VAT order. */
     taxBreakdown: TaxBreakdownLine[];
     /** DOMESTIC, OSS, REVERSE_CHARGE (no VAT, buyer accounts for it) or EXPORT (no VAT, outside EU). SDK 1.17.0. */
     vatMode?: "DOMESTIC" | "OSS" | "REVERSE_CHARGE" | "EXPORT" | null;
@@ -2652,6 +2675,13 @@ interface CrossSellItem {
     compareAtPrice: number | null;
     /** Currency code the `price` / `compareAtPrice` are expressed in. */
     currency: string;
+    /**
+     * true when `price` was FX-converted from the shop's default currency (no
+     * price row for `currency`). Show it as approximate (for example with "≈");
+     * the cart charges only real price rows. Same meaning as
+     * `ProductPrice.isApproximate`. Backend 2026-10-02+, absent on older APIs.
+     */
+    priceIsApproximate?: boolean;
     imageUrl: string | null;
     /** Selected-warehouse quantity; null when the merchant hides exact stock. */
     stockCached: number | null;

package/dist/react.d.ts

@@ -1261,6 +1261,13 @@ interface CheckoutPreview {
     giftCardDeducted: number;
     roundingAdjustment: number;
     grandTotal: number;
+    /** VAT contained in `grandTotal` split by rate: order discounts (always
+     *  VAT-inclusive) reduce base and VAT per rate, shipping and the payment fee
+     *  carry the goods rates. Same numbers as the invoice. SDK 2.12.0. */
+    taxBreakdown?: TaxBreakdownLine[];
+    /** VAT contained in `grandTotal`, the sum of `taxBreakdown[].taxAmount`.
+     *  `taxTotal` is the goods VAT before order discounts. SDK 2.12.0. */
+    vatTotal?: number;
     previewToken: string;
     expiresAt: number;
 }
@@ -1418,8 +1425,11 @@ interface Cart {
      *  `INCL_VAT`, VAT excluded when it runs `EXCL_VAT`. Not the payable amount,
      *  that is `grandTotal`. */
     subtotal: number;
-    /** Discount from the applied code. Always based on `subtotal`, i.e. on the
-     *  prices the customer sees, so "10 % off 200" is 20 in both price modes. */
+    /** Discount from the applied code, VAT-inclusive. The base is always the
+     *  VAT-inclusive amount, also when the shop shows prices without VAT: a
+     *  discount is never taken from the net base (SDK 2.12.0; before, "10 % off
+     *  200 net" was 20, now it is 24.20 at 21 %). It lowers base and VAT, see
+     *  `taxBreakdown` and `vatTotal`. */
     discountTotal: number;
     discount?: CartDiscount;
     /** Auto-apply promotion discount lines (sale/BOGO). */
@@ -1436,11 +1446,16 @@ interface Cart {
      *  back to the catalog price), under `EXCL_VAT` it is added on top. Render
      *  this as the cart total; do not add `taxTotal` to it. */
     grandTotal: number;
-    /** VAT contained in the prices (`INCL_VAT`) or added on top of them
-     *  (`EXCL_VAT`), across all lines (GAP-30). An estimate finalized at checkout
-     *  once the shipping country is known. */
+    /** Goods VAT BEFORE order discounts: contained in the prices (`INCL_VAT`) or
+     *  added on top (`EXCL_VAT`). Use it for the goods subtotal
+     *  (`subtotal` net + `taxTotal`); the VAT the customer pays is `vatTotal`. */
     taxTotal: number;
-    /** VAT split by rate for "DPH 21 %: X Kč" summary rows. Empty for a
+    /** VAT contained in `grandTotal`, after the order discount, as on the
+     *  invoice. Sum of `taxBreakdown[].taxAmount`. SDK 2.12.0. */
+    vatTotal?: number;
+    /** VAT of the payable amount split by rate for "DPH 21 %: X Kč" rows. The
+     *  order discount reduces base and VAT per rate (since SDK 2.12.0; before it
+     *  showed the VAT of the goods before the discount). Empty for a
      *  non-VAT-payer shop. */
     taxBreakdown: TaxBreakdownLine[];
     /** Delivery country set via `cart.setDestination()`, null until known. SDK 1.17.0. */
@@ -1666,6 +1681,8 @@ interface OrderTracking {
     paymentFee?: number | null;
     discountTotal?: number;
     taxTotal?: number;
+    /** VAT contained in `grandTotal`, as on the invoice. SDK 2.12.0. */
+    vatTotal?: number;
     taxBreakdown?: TaxBreakdownLine[];
     /** Shipping method as the customer chose it (SDK 2.8.0). */
     shippingMethodName?: string | null;
@@ -1718,9 +1735,15 @@ interface OrderDetail extends OrderListItem {
     phone?: string;
     customerNote?: string;
     subtotal: number;
+    /** Goods VAT before order discounts (goods subtotal = `subtotal` + `taxTotal`). */
     taxTotal: number;
-    /** VAT split by rate (GAP-30), summed from the order lines. Render
-     *  "DPH 21 %: X Kč" rows. Empty for a non-VAT order. */
+    /** VAT contained in `grandTotal` (after discounts, incl. shipping), the same
+     *  as on the invoice. Sum of `taxBreakdown[].taxAmount`. SDK 2.12.0. */
+    vatTotal?: number;
+    /** VAT of the amount paid split by rate (GAP-30) for "DPH 21 %: X Kč" rows.
+     *  Order discounts reduce base and VAT, shipping and the payment fee carry
+     *  the goods rates (since SDK 2.12.0, matching the invoice). Empty for a
+     *  non-VAT order. */
     taxBreakdown: TaxBreakdownLine[];
     /** DOMESTIC, OSS, REVERSE_CHARGE (no VAT, buyer accounts for it) or EXPORT (no VAT, outside EU). SDK 1.17.0. */
     vatMode?: "DOMESTIC" | "OSS" | "REVERSE_CHARGE" | "EXPORT" | null;
@@ -2652,6 +2675,13 @@ interface CrossSellItem {
     compareAtPrice: number | null;
     /** Currency code the `price` / `compareAtPrice` are expressed in. */
     currency: string;
+    /**
+     * true when `price` was FX-converted from the shop's default currency (no
+     * price row for `currency`). Show it as approximate (for example with "≈");
+     * the cart charges only real price rows. Same meaning as
+     * `ProductPrice.isApproximate`. Backend 2026-10-02+, absent on older APIs.
+     */
+    priceIsApproximate?: boolean;
     imageUrl: string | null;
     /** Selected-warehouse quantity; null when the merchant hides exact stock. */
     stockCached: number | null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@behio/storefront-sdk",
-  "version": "2.10.0",
+  "version": "2.12.0",
   "description": "TypeScript SDK for Behio headless e-commerce: core client + React hooks",
   "author": "Behio",
   "license": "MIT",