Shahed Nasser
fa7c94b4cc
* docs: migrate ui docs to docs universe * created yarn workspace * added eslint and tsconfig configurations * fix eslint configurations * fixed eslint configurations * shared tailwind configurations * added shared ui package * added more shared components * migrating more components * made details components shared * move InlineCode component * moved InputText * moved Loading component * Moved Modal component * moved Select components * Moved Tooltip component * moved Search components * moved ColorMode provider * Moved Notification components and providers * used icons package * use UI colors in api-reference * moved Navbar component * used Navbar and Search in UI docs * added Feedback to UI docs * general enhancements * fix color mode * added copy colors file from ui-preset * added features and enhancements to UI docs * move Sidebar component and provider * general fixes and preparations for deployment * update docusaurus version * adjusted versions * fix output directory * remove rootDirectory property * fix yarn.lock * moved code component * added vale for all docs MD and MDX * fix tests * fix vale error * fix deployment errors * change ignore commands * add output directory * fix docs test * general fixes * content fixes * fix announcement script * added changeset * fix vale checks * added nofilter option * fix vale error
132 lines
6.1 KiB
Plaintext
132 lines
6.1 KiB
Plaintext
---
|
||
sidebar_position: 5
|
||
description: 'This user guide explains how to manage tax inclusive pricing on the Medusa admin.'
|
||
addHowToData: true
|
||
---
|
||
|
||
import UiIcon from '@site/src/components/UiIcon';
|
||
|
||
# Tax Inclusive Pricing Overview
|
||
|
||
In this document, you’ll learn how to change tax-inclusive settings, and how prices are applied based on whether tax-inclusive pricing is enabled or not.
|
||
|
||
:::note
|
||
|
||
Tax-inclusive pricing is currently in beta mode and need to be manually enabled in your store using [feature flags](../../development/feature-flags/toggle.md). If you’re unsure how that works, please contact your technical team.
|
||
|
||
:::
|
||
|
||
## Overview
|
||
|
||
If you sell in multiple countries or regions that share the same currency, you might run into an issue when specifying prices without taxes, as countries that have the same currency might have different tax rates.
|
||
|
||
In that case, if you want to show the same price for a currency regardless of what region the customer is browsing from, you’d have to manually run calculations to specify the correct price for all regions.
|
||
|
||
Tax-inclusive pricing saves you the manual work. When tax-inclusive pricing is enabled, you can just enter the price you want the customer to see on the storefront. Medusa then takes care of calculating the tax amount applied to the item based on the tax rate.
|
||
|
||
Tax-inclusive pricing can be managed for the following domains:
|
||
|
||
- Regions
|
||
- Currencies
|
||
- Price Lists
|
||
- Shipping Options
|
||
|
||
The settings for these domains can affect other domains associated with them.
|
||
|
||
:::info
|
||
|
||
Tax-Inclusive pricing is disabled by default for all these domains.
|
||
|
||
:::
|
||
|
||
---
|
||
|
||
## Tax-Inclusive Pricing for Regions
|
||
|
||
When tax-inclusive pricing is enabled for a region, it is subsequently enabled for product prices, the tax calculation on the line items in a cart, and the cart’s subtotal calculations.
|
||
|
||
### Change Tax-Inclusive Pricing for Existing Regions
|
||
|
||
To change the tax-inclusive pricing setting for an existing region:
|
||
|
||
1. Go to Settings → Regions.
|
||
2. Select a region to edit.
|
||
3. In the first section on the right, click on the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999308/Medusa%20Docs/UI%20Icons/1ordBC6_ssysel.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999326/Medusa%20Docs/UI%20Icons/dSwWYBH_stzgoi.png" alt="three dots" /> icon.
|
||
4. Click on Edit Region Details from the dropdown.
|
||
5. In the window that opens, find the Tax Inclusive Prices field and enable or disable it.
|
||
6. Click on the “Save and close” button.
|
||
|
||
### Set Tax-Inclusive Pricing for New Regions
|
||
|
||
To set the tax-inclusive pricing setting for a new region:
|
||
|
||
1. Go to Settings → Regions.
|
||
2. Click on the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999131/Medusa%20Docs/UI%20Icons/1hL8NiW_lqmjcq.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999150/Medusa%20Docs/UI%20Icons/8LtkPqW_jyqz5i.png" alt="plus" /> icon at the top right of the Regions section.
|
||
3. In the form that opens and among other Region details, find the Tax Inclusive Prices field and enable or disable it.
|
||
|
||
---
|
||
|
||
## Tax-Inclusive Pricing for Currencies
|
||
|
||
When tax-inclusive pricing is enabled for a currency, it is subsequently enabled for:
|
||
|
||
- Prices of product variants in this currency.
|
||
- Tax calculation on the line items or products in a cart using this currency.
|
||
- Prices in this currency of product variants in a price list.
|
||
|
||
### Change Tax-Inclusive Pricing for Currencies
|
||
|
||
To change the tax-inclusive pricing setting for a currency:
|
||
|
||
1. Go to Settings → Currencies.
|
||
2. Under Store Currencies, find the currency you’re making the change to.
|
||
3. On the right of the currency, enable or disable tax-inclusive pricing.
|
||
|
||
---
|
||
|
||
## Tax-Inclusive Pricing for Price Lists
|
||
|
||
When tax-inclusive pricing is enabled for a price list, it is subsequently enabled for all product variants in that price list.
|
||
|
||
:::info
|
||
|
||
If tax-inclusive pricing is not enabled for a price list, but a price for a product variant in the price list uses a currency that has tax-inclusive pricing enabled, then tax-inclusive pricing is subsequently enabled on that price.
|
||
|
||
:::
|
||
|
||
### Change Tax-Inclusive Pricing for Existing Price Lists
|
||
|
||
To change the tax-inclusive pricing setting for an existing price list:
|
||
|
||
1. Go to Pricing
|
||
2. Click on the price list you want to make the change to.
|
||
3. Click on the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999308/Medusa%20Docs/UI%20Icons/1ordBC6_ssysel.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999326/Medusa%20Docs/UI%20Icons/dSwWYBH_stzgoi.png" alt="three dots" /> icon at the top right of the first section.
|
||
4. Choose “Edit price list details” from the dropdown.
|
||
5. In the new form that opens, expand the General collapsible and find the “Tax inclusive prices” field and enable or disable it.
|
||
6. Click on the “Save and Close” button.
|
||
|
||
### Set Tax-Inclusive Pricing for New Price Lists
|
||
|
||
To set the tax-inclusive pricing setting for a new price list:
|
||
|
||
1. Go to Pricing.
|
||
2. Click on the “Add price list” button at the top right.
|
||
3. In the new form that opens, expand the General collapsible.
|
||
4. Find the “Tax inclusive prices” field and enable or disable it.
|
||
|
||
---
|
||
|
||
## Tax-Inclusive Pricing for Shipping Options
|
||
|
||
When tax-inclusivity is enabled for a shipping option, it is subsequently enabled for the shipping method a customer uses on checkout and for the cart’s shipping calculations.
|
||
|
||
Tax-inclusive pricing is enabled or disabled on creation based on whether the Region it is in has the tax-inclusive pricing enabled or not.
|
||
|
||
---
|
||
|
||
## Tax-Inclusive Pricing for Products
|
||
|
||
Tax-inclusivity for products’ pricing is affected by the tax-inclusive options of currencies, regions, or price lists.
|
||
|
||
When specifying the price of a product for a currency or a region, the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1668071655/Medusa%20Docs/UI%20Icons/taxes_hoogia.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1668071655/Medusa%20Docs/UI%20Icons/taxes-dark_mwu0us.png" alt="tax-inclusive" /> icon will be greyed out if it’s disabled for that currency/region. If it’s enabled, the icon will be colored.
|