> 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: Sample Flows

## Article: Sample Flows

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

## Article Content:

# Sample Use Cases and Flows

This article presents possible use cases and corresponding sample flows that you can support. This can be a helpful jumping off point as you plan your implementation.

## Set up custom tax rates for a new region

You need to configure tax rates for a business expanding into a new geographical region.

To set up custom tax rates for a new region:

1. Identify the tax groups that need custom rates in the new region. Call [Query Tax Groups](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/extensions/tax/tax-groups/query-tax-groups.md) to get the tax group IDs for products or services requiring different tax treatment.

1. Identify the tax region representing the new geographical area. Call [Query Tax Regions](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/extensions/tax/tax-regions/query-tax-regions.md) to get the tax region ID.

1. [Create the manual tax mapping](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/extensions/tax/manual-tax-mappings/create-manual-tax-mapping.md) with the custom rate.

1. Verify the mapping was created successfully by calling [Get Manual Tax Mapping](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/extensions/tax/manual-tax-mappings/get-manual-tax-mapping.md) with the returned ID.

## Import tax mappings from an external system

You need to migrate existing tax configuration from a legacy tax system or import rates from a spreadsheet.

To import multiple tax mappings:

1. Structure your data as an array of manual tax mapping objects. Ensure each mapping has valid tax group and region IDs.

1. Group the mappings into batches of up to 100 items to comply with bulk operation limits.

1. For each batch, call [Bulk Create Manual Tax Mappings](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/extensions/tax/manual-tax-mappings/bulk-create-manual-tax-mappings.md).

1. Process any failed mappings from the `results` array and retry them in a separate request if needed.

## Update tax rates after regulatory changes

Local tax authorities have announced rate changes that affect your existing manual tax mappings.

To update existing tax rates:

1. Query existing mappings that need updates. For example, to find all mappings for a specific region.

1. For each mapping that needs updating, call [Update Manual Tax Mapping](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/extensions/tax/manual-tax-mappings/update-manual-tax-mapping.md) with the new rate.

1. Verify the updates by querying the updated mappings to confirm the new rates are in effect.