> 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`).
> - 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: Introduction

## Article: Introduction

## Article Link: https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/extensions/tax/manual-tax-mappings/introduction.md

## Article Content:

# About the Manual Tax Mappings API

The Manual Tax Mappings API allows you to enhance [Wix's manual tax calculator](https://support.wix.com/en/article/setting-up-tax-calculation-using-the-manual-method) by defining custom tax rates for specific combinations of [tax groups](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/extensions/tax/tax-groups/introduction.md) and [tax regions](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/extensions/tax/tax-regions/introduction.md). This API is designed for businesses that need to define and manage custom tax rates and mappings for calculating taxes with [Wix's manual tax calculator](https://support.wix.com/en/article/setting-up-tax-calculation-using-the-manual-method).

With the Manual Tax Mappings API, you can:
+ [Create](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/extensions/tax/manual-tax-mappings/create-manual-tax-mapping.md) custom tax rate mappings for specific tax group and region combinations.
+ [Bulk create multiple tax mappings](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/extensions/tax/manual-tax-mappings/bulk-create-manual-tax-mappings.md) for efficient setup and data imports.
+ [Retrieve](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/extensions/tax/manual-tax-mappings/get-manual-tax-mapping.md) and [query](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/extensions/tax/manual-tax-mappings/query-manual-tax-mappings.md) existing tax mappings by various criteria.
+ [Update](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/extensions/tax/manual-tax-mappings/update-manual-tax-mapping.md) tax rates and associated details as regulations change.

This API is particularly useful for:
+ Businesses operating across multiple jurisdictions with complex tax requirements.
+ Companies importing tax rate data from external tax systems or spreadsheets.
+ Organizations that need to set custom rates.
+ Merchants with special tax arrangements or exemptions in certain regions.

## Before you begin

It's important to note the following before starting to code:

+ Prerequisites: Manual tax mappings require existing [tax groups](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/extensions/tax/tax-groups/introduction.md) and [tax regions](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/extensions/tax/tax-regions/introduction.md). You must create these entities in the [dashboard](https://support.wix.com/en/article/setting-up-tax-groups-using-manual-tax-calculation) or by using their respective APIs before creating mappings.
+ Tax group and region dependencies: Each manual tax mapping must reference existing tax group and tax region IDs. These entities define the scope where your custom tax rates will apply.
+ Decimal precision: Tax rates are specified as decimal values with up to 6 decimal places precision (for example, `0.085000` for 8.5%).
+ Bulk operations: Use bulk operations when setting up multiple mappings at once, such as during initial configuration or data imports. You can create up to 100 mappings in a single request.

## Use cases

Common scenarios for using the Manual Tax Mappings API include:

+ [Set up custom tax rates for a new region](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/extensions/tax/manual-tax-mappings/sample-flows.md).
+ [Import tax mappings from an external system](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/extensions/tax/manual-tax-mappings/sample-flows.md).
+ [Update tax rates after regulatory changes](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/extensions/tax/manual-tax-mappings/sample-flows.md).

## Terminology

+ **Manual tax mapping**: A custom configuration for a specific tax group and region combination. Contains the custom tax rate and jurisdiction details.
+ **Tax group**: A collection of products or services that share the same tax treatment. Must be created using the [Tax Groups API](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/extensions/tax/tax-groups/introduction.md) before referencing in mappings.
+ **Tax region**: A geographical area where specific tax rules apply. Must be created using the [Tax Regions API](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/extensions/tax/tax-regions/introduction.md) before referencing in mappings.
+ **Tax rate**: The custom tax rate specified as a decimal value (for example, `0.080000` for 8%). Supports up to 6 decimal places for precision.
+ **Jurisdiction**: The governmental entity responsible for collecting the tax, such as a country, state, county, city, or special district.
+ **Tax type**: The category of tax being applied, such as VAT, GST, or Sales Tax, which depends on the jurisdiction's tax laws.

@sdk_package_setup