> To build a Wix site agentically, or add Wix features like bookings or a store to a site you already have, follow https://www.wix.com/headless/skill.md
> 
> Portal Navigation:
> 
> - Append `.md` to any URL under `https://dev.wix.com/docs/` to get its markdown version.
> - Pages are either content pages (article or reference text) or menu pages (a list of links to child pages).
> - To get a menu page, truncate any URL to a parent path and append `.md` (e.g. `https://dev.wix.com/docs/sdk.md`, `https://dev.wix.com/docs/sdk/core-modules.md`).
> - If a reference page seems to be missing its schema (parameters, return types, or type definitions), append `?schema=true` to its `.md` URL (e.g. `https://dev.wix.com/docs/contexts/contexts/stores/category-info/use-category-info-context.md?schema=true`).
> - Top-level index of all portals: https://dev.wix.com/docs/llms.txt
> - Full concatenated docs: https://dev.wix.com/docs/llms-full.txt

## Resource: Sample Flows

## Article: Sample Flows

## Article Link: https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/settings/tax-settings/sample-flows.md

## Article Content:

# Tax Settings API: Sample Flows

This article presents possible use cases and corresponding sample flows that you can support. It provides a useful starting point as you plan your implementation.

## Display prices correctly based on tax settings

An app that displays product prices needs to know whether catalog prices already include tax, so it can present totals correctly to customers. If prices are tax-exclusive, the app needs to calculate and add the applicable tax before displaying them.

To display prices correctly based on tax settings:

1. Call [Get Tax Settings](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/settings/tax-settings/get-tax-settings.md) to retrieve the site's tax settings.
2. Check the value of `taxIncludedInItemPrices` in the response.
3. If `taxIncludedInItemPrices` is `true`, display catalog prices as tax-inclusive. If `false`, calculate and add the applicable tax to catalog prices before displaying them.

## Update tax settings when a merchant configures their pricing

A merchant uses a settings page in the dashboard to specify whether their catalog prices already include tax. When the merchant saves their preference, your app updates the site's tax settings accordingly.

To update tax settings when a merchant configures their pricing:

1. Collect the merchant's preference for whether catalog prices include tax.
2. Call [Get Tax Settings](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/settings/tax-settings/get-tax-settings.md) to read the current settings first, then call [Upsert Tax Settings](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/settings/tax-settings/upsert-tax-settings.md) with `taxIncludedInItemPrices` set to the merchant's chosen value. Upsert creates the settings if they don't exist yet, or replaces them otherwise, so reading first lets you preserve any values you aren't changing.
3. Confirm to the merchant that the settings have been saved. The updated settings take effect immediately for all Wix products on the site.