docs: create docs workspace (#5174)

* 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
2023-09-21 20:57:15 +03:00
parent 19c5d5ba36
commit fa7c94b4cc
3209 changed files with 32188 additions and 31018 deletions
@@ -0,0 +1,80 @@
+---
+sidebar_position: 2
+description: 'This user guide explains how to manage taxes on the Medusa admin. Learn how to edit their configurations.'
+addHowToData: true
+---
+
+# Manage Taxes
+
+In this document, you’ll learn how to view and manage taxes in your Medusa Admin.
+
+## View Taxes
+
+To view taxes:
+
+1. Click on Settings in the sidebar.
+2. Choose Taxes from the list of settings.
+
+This opens the Taxes page where you can find a list of regions. This is because every time you create a region, a default tax rate is associated with that region.
+
+---
+
+## Edit a Region’s Taxes
+
+To edit a region’s taxes:
+
+1. Go to Settings → Taxes.
+2. Click on the region you want to edit the taxes for in the Regions section.
+
+This opens a Details form to the right where you can edit the taxes calculation settings and [manage the tax rates](./tax-rates.mdx).
+
+---
+
+## Change Tax Calculation Settings
+
+:::tip
+
+The save button only appears when you make changes to the settings.
+
+:::
+
+### Change Tax Provider
+
+The tax provider that you choose defines how taxes are calculated for products and shipping options on checkout. Medusa provides a default tax provider with the name “System Tax Provider”.
+
+If you have integrated a custom tax provider and want to use it to calculate taxes in a region:
+
+1. Go to Settings → Taxes.
+2. Select a region whose taxes you want to edit.
+3. Change the selected tax provider in the Tax Provider field.
+4. Click Save at the bottom right.
+
+### Disable Automatic Taxes Calculation
+
+By default, taxes are calculated automatically by Medusa. They’re calculated in different places during checkout, such as when a shipping method is chosen or when a new product is added to the cart.
+
+If you use a third-party tax provider and you want to avoid sending too many requests to the tax provider, you can disable this behavior.
+
+:::caution
+
+If you switch off automatic taxes calculation, the taxes must be calculated manually on checkout. If you’re unsure how that works, please contact your technical team.
+
+:::
+
+To disable automatic taxes calculation:
+
+1. Go to Settings → Taxes.
+2. Select a region whose tax you want to edit.
+3. Check off the “Calculate taxes automatically” input.
+4. Click Save at the bottom right.
+
+### Disable Taxes for Gift Cards
+
+To disable applying taxes for Gift Cards:
+
+1. Go to Settings → Taxes.
+2. Select a region whose tax you want to edit.
+3. Check off the “Apply tax to gift cards” input.
+4. Click Save at the bottom right.
+
+Enabling taxes for Gift Cards follows the same process, except you check the input.