> 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

# UpsertTaxSettings

# Package: tax

# Namespace: TaxSettingsService

# Method link: https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/extensions/tax/tax-settings/upsert-tax-settings.md

## Introduction

Creates or updates the site's tax settings.

If the site's tax settings don't exist yet, this method creates them. Otherwise, it updates the existing settings.

Since these settings are shared across all Wix products on the site, changes take effect immediately for all integrated products.

---

## REST API

### Schema

```
 Method: upsertTaxSettings
 Description: Creates or updates the site's tax settings.  If the site's tax settings don't exist yet, this method creates them. Otherwise, it updates the existing settings.  Since these settings are shared across all Wix products on the site, changes take effect immediately for all integrated products.
 URL: https://www.wixapis.com/billing/v1/tax-settings
 Method: POST
 # Note: If the parameter `a.b` is listed under required parameters, `b` is only required if `a` is also present.
 Required parameters:  taxSettings
 Method parameters: 
   param name: taxSettings | type: TaxSettings | description: Site-level tax settings for a Wix site. Each site has a single tax settings resource.  These settings are shared across all Wix products on the site. | required: true 
        - name: taxIncludedInItemPrices | type: boolean | description: Whether tax is already included in catalog item prices.  When `true`, checkout treats catalog prices as tax-inclusive and doesn't add additional tax on top. When `false`, tax is calculated and added on top of catalog prices at checkout.  Default: `false`  
 Return type: UpsertTaxSettingsResponse
  - name: taxSettings | type: TaxSettings | description: Created or updated tax settings.  
     - name: taxIncludedInItemPrices | type: boolean | description: Whether tax is already included in catalog item prices.  When `true`, checkout treats catalog prices as tax-inclusive and doesn't add additional tax on top. When `false`, tax is calculated and added on top of catalog prices at checkout.  Default: `false`  
     - name: createdDate | type: string | description: Date and time the tax settings were created.  | validation: format date-time
     - name: updatedDate | type: string | description: Date and time the tax settings were last updated.  | validation: format date-time


```

### Examples

### Upsert Tax Settings
Updates the site's tax settings. The first update for a site creates the tax settings; subsequent updates modify them in place.

```curl
curl -X POST \
  'https://www.wixapis.com/ecom/v1/tax-settings' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: <AUTH>' \
  -d '{
    "taxSettings": {
      "taxIncludedInItemPrices": true
    }
  }'
```

---

## JavaScript SDK

### Schema

```
 Method: wixClientAdmin.ecom.taxSettings.upsertTaxSettings(taxSettings)
 Description: Creates or updates the site's tax settings.  If the site's tax settings don't exist yet, this method creates them. Otherwise, it updates the existing settings.  Since these settings are shared across all Wix products on the site, changes take effect immediately for all integrated products.
 # Note: If the parameter `a.b` is listed under required parameters, `b` is only required if `a` is also present.
 Required parameters:  taxSettings
 Method parameters: 
   param name: taxSettings | type: TaxSettings | description: Site-level tax settings for a Wix site. Each site has a single tax settings resource.  These settings are shared across all Wix products on the site. | required: true 
        - name: taxIncludedInItemPrices | type: boolean | description: Whether tax is already included in catalog item prices.  When `true`, checkout treats catalog prices as tax-inclusive and doesn't add additional tax on top. When `false`, tax is calculated and added on top of catalog prices at checkout.  Default: `false`  
 Return type: PROMISE<UpsertTaxSettingsResponse>
  - name: taxSettings | type: TaxSettings | description: Created or updated tax settings.  
     - name: taxIncludedInItemPrices | type: boolean | description: Whether tax is already included in catalog item prices.  When `true`, checkout treats catalog prices as tax-inclusive and doesn't add additional tax on top. When `false`, tax is calculated and added on top of catalog prices at checkout.  Default: `false`  
     - name: _createdDate | type: Date | description: Date and time the tax settings were created.  
     - name: _updatedDate | type: Date | description: Date and time the tax settings were last updated.  


```

---