curl --request PUT \
--url https://api.exowpee.com/v1/catalog/taxes/{tax}/dependencies \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"dependencies": [
{
"tax_id": "<string>"
}
]
}
'import requests
url = "https://api.exowpee.com/v1/catalog/taxes/{tax}/dependencies"
payload = { "dependencies": [{ "tax_id": "<string>" }] }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PUT',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({dependencies: [{tax_id: '<string>'}]})
};
fetch('https://api.exowpee.com/v1/catalog/taxes/{tax}/dependencies', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.exowpee.com/v1/catalog/taxes/{tax}/dependencies",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_POSTFIELDS => json_encode([
'dependencies' => [
[
'tax_id' => '<string>'
]
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.exowpee.com/v1/catalog/taxes/{tax}/dependencies"
payload := strings.NewReader("{\n \"dependencies\": [\n {\n \"tax_id\": \"<string>\"\n }\n ]\n}")
req, _ := http.NewRequest("PUT", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.put("https://api.exowpee.com/v1/catalog/taxes/{tax}/dependencies")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"dependencies\": [\n {\n \"tax_id\": \"<string>\"\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.exowpee.com/v1/catalog/taxes/{tax}/dependencies")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Put.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"dependencies\": [\n {\n \"tax_id\": \"<string>\"\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"id": "<string>",
"country_code": "<string>",
"fiscal_status": "<string>",
"kind": "<string>",
"is_builtin": true,
"name": "<string>",
"code": "<string>",
"amount_type": "<string>",
"rate": "<string>",
"fixed_amount": 123,
"default_stockable_price_inclusion_policy": "<string>",
"default_order_calculation_base": "<string>",
"application_scope": "<string>",
"is_active": true,
"dependencies": [
"<unknown>"
],
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z"
}{
"message": "<string>",
"errors": {}
}Set tax dependencies
Chooses which other taxes a tax is calculated on top of.
curl --request PUT \
--url https://api.exowpee.com/v1/catalog/taxes/{tax}/dependencies \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"dependencies": [
{
"tax_id": "<string>"
}
]
}
'import requests
url = "https://api.exowpee.com/v1/catalog/taxes/{tax}/dependencies"
payload = { "dependencies": [{ "tax_id": "<string>" }] }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PUT',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({dependencies: [{tax_id: '<string>'}]})
};
fetch('https://api.exowpee.com/v1/catalog/taxes/{tax}/dependencies', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.exowpee.com/v1/catalog/taxes/{tax}/dependencies",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_POSTFIELDS => json_encode([
'dependencies' => [
[
'tax_id' => '<string>'
]
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.exowpee.com/v1/catalog/taxes/{tax}/dependencies"
payload := strings.NewReader("{\n \"dependencies\": [\n {\n \"tax_id\": \"<string>\"\n }\n ]\n}")
req, _ := http.NewRequest("PUT", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.put("https://api.exowpee.com/v1/catalog/taxes/{tax}/dependencies")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"dependencies\": [\n {\n \"tax_id\": \"<string>\"\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.exowpee.com/v1/catalog/taxes/{tax}/dependencies")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Put.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"dependencies\": [\n {\n \"tax_id\": \"<string>\"\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"id": "<string>",
"country_code": "<string>",
"fiscal_status": "<string>",
"kind": "<string>",
"is_builtin": true,
"name": "<string>",
"code": "<string>",
"amount_type": "<string>",
"rate": "<string>",
"fixed_amount": 123,
"default_stockable_price_inclusion_policy": "<string>",
"default_order_calculation_base": "<string>",
"application_scope": "<string>",
"is_active": true,
"dependencies": [
"<unknown>"
],
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z"
}{
"message": "<string>",
"errors": {}
}taxes.update
Conditions
- Built-in taxes cannot be changed.
- dependencies must be present (an empty list removes all links); each tax_id must be listed once and exist in the profile.
- Each dependency must be an active tax of the same profile and the same application scope as the tax.
- The resulting graph of the profile must be valid: no cycle, a valid inclusion chain, and effective assignments must not depend on an inactive tax.
- The change is refused when it would make a stored price impossible to calculate.
- Replaces all dependency links of the tax with the list sent.
- Changes how totals are computed for every price and order that uses the tax.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
Identifier of the tax (27-character KSUID string), within the current company's fiscal profile.
Query Parameters
Response mode. Default none; none answers 204 No Content.
none, resource Comma-separated JSON keys of the root resource (id is always rendered). Available: id, country_code, fiscal_status, kind, is_builtin, name, code, amount_type, rate, fixed_amount, default_stockable_price_inclusion_policy, default_order_calculation_base, application_scope, is_active, dependencies, created_at, updated_at.
Comma-separated include paths, each optionally followed by its fields in parentheses: units(id,sku),units.uomUnit(id,name). Max depth 6, max 40 paths. Available: .
Body
Complete list of the taxes this tax depends on. It replaces the existing links; an empty list removes them all.
Show child attributes
Show child attributes
Response
Resource (only with response=resource).
Identifier of the tax (27-character KSUID string).
Country of the fiscal profile the tax belongs to (the company's country).
Fiscal status of the profile the tax belongs to.
vat: the system VAT node of the profile. standard: any other tax.
True for taxes created by the system; they cannot be changed or deleted.
Name of the tax.
Unique code of the tax within its fiscal profile.
percentage: the tax is a rate applied on a base. fixed: the tax is a fixed amount.
Rate of a percentage tax, up to 6 decimals, sent as a decimal string; null for a fixed tax and for the VAT node, whose rates are VAT rates.
Amount of a fixed tax, in minor units (divide by 10 to the power currency_exponent); null for a percentage tax.
For item-scope taxes: whether prices include the tax by default (inclusive) or add it on top (exclusive). Null for order-scope taxes.
For order-scope taxes: the order amount the tax is computed on (items_net_total, items_tax_total or items_gross_total). Null for item-scope taxes.
stockable: applied to item prices. order: applied to the whole order.
Whether the tax can still be used; an inactive tax is not applied to new assignments.
Taxes this tax is calculated on top of: a list of tax_id and operator (add or substract). Present when the dependency links are loaded.
Date and time the record was created (ISO 8601, UTC).
Date and time the record was last changed (ISO 8601, UTC).