curl --request PUT \
--url https://api.exowpee.com/v1/catalog/vat-rates/{vat_rate} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "<string>",
"rate": 499.9999995,
"is_default": true,
"is_active": true
}
'import requests
url = "https://api.exowpee.com/v1/catalog/vat-rates/{vat_rate}"
payload = {
"name": "<string>",
"rate": 499.9999995,
"is_default": True,
"is_active": True
}
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({name: '<string>', rate: 499.9999995, is_default: true, is_active: true})
};
fetch('https://api.exowpee.com/v1/catalog/vat-rates/{vat_rate}', 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/vat-rates/{vat_rate}",
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([
'name' => '<string>',
'rate' => 499.9999995,
'is_default' => true,
'is_active' => true
]),
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/vat-rates/{vat_rate}"
payload := strings.NewReader("{\n \"name\": \"<string>\",\n \"rate\": 499.9999995,\n \"is_default\": true,\n \"is_active\": true\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/vat-rates/{vat_rate}")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"name\": \"<string>\",\n \"rate\": 499.9999995,\n \"is_default\": true,\n \"is_active\": true\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.exowpee.com/v1/catalog/vat-rates/{vat_rate}")
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 \"name\": \"<string>\",\n \"rate\": 499.9999995,\n \"is_default\": true,\n \"is_active\": true\n}"
response = http.request(request)
puts response.read_body{
"id": "<string>",
"country_code": "<string>",
"fiscal_status": "<string>",
"name": "<string>",
"code": "<string>",
"rate": "<string>",
"treatment": "<string>",
"is_default": true,
"is_active": true,
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z"
}{
"message": "<string>",
"errors": {}
}Edit a VAT rate
Changes the name, rate, treatment or active/default status of a VAT rate.
curl --request PUT \
--url https://api.exowpee.com/v1/catalog/vat-rates/{vat_rate} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "<string>",
"rate": 499.9999995,
"is_default": true,
"is_active": true
}
'import requests
url = "https://api.exowpee.com/v1/catalog/vat-rates/{vat_rate}"
payload = {
"name": "<string>",
"rate": 499.9999995,
"is_default": True,
"is_active": True
}
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({name: '<string>', rate: 499.9999995, is_default: true, is_active: true})
};
fetch('https://api.exowpee.com/v1/catalog/vat-rates/{vat_rate}', 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/vat-rates/{vat_rate}",
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([
'name' => '<string>',
'rate' => 499.9999995,
'is_default' => true,
'is_active' => true
]),
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/vat-rates/{vat_rate}"
payload := strings.NewReader("{\n \"name\": \"<string>\",\n \"rate\": 499.9999995,\n \"is_default\": true,\n \"is_active\": true\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/vat-rates/{vat_rate}")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"name\": \"<string>\",\n \"rate\": 499.9999995,\n \"is_default\": true,\n \"is_active\": true\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.exowpee.com/v1/catalog/vat-rates/{vat_rate}")
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 \"name\": \"<string>\",\n \"rate\": 499.9999995,\n \"is_default\": true,\n \"is_active\": true\n}"
response = http.request(request)
puts response.read_body{
"id": "<string>",
"country_code": "<string>",
"fiscal_status": "<string>",
"name": "<string>",
"code": "<string>",
"rate": "<string>",
"treatment": "<string>",
"is_default": true,
"is_active": true,
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z"
}{
"message": "<string>",
"errors": {}
}vat_rates.update
Conditions
- The current default rate cannot be un-defaulted: promote another active rate instead.
- A VAT rate cannot be both default and inactive.
- A rate used by a category or item configuration cannot be deactivated.
- The change is refused when it would make a stored price impossible to calculate.
- code cannot be changed.
- Promoting a rate to default clears the default flag of the previous default.
- Changes VAT for every item that uses the rate, directly or through its category or as the default.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
Identifier of the VAT rate (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, name, code, rate, treatment, is_default, is_active, 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
New name, up to 250 characters. Unchanged when omitted or null.
250New rate, 0 to 999.999999 with up to 6 decimals. Unchanged when omitted or null.
0 <= x <= 999.999999New treatment: standard, reduced, zero_rated or exempt.
standard, reduced, zero_rated, exempt true promotes this rate to default, replacing the current one. The current default cannot be set to false.
Activates or deactivates the rate. Deactivation is refused while a category or item uses it, and a default rate cannot be inactive.
Response
Resource (only with response=resource).
Identifier of the VAT rate (27-character KSUID string).
Country of the fiscal profile the rate belongs to.
Fiscal status of the profile the rate belongs to.
Name of the VAT rate.
Unique code of the rate within its fiscal profile.
VAT rate, up to 6 decimals, sent as a decimal string.
standard, reduced, zero_rated or exempt: how VAT is treated for goods using this rate.
True for the profile's fallback rate, used by taxable items without their own rate. At most one rate per profile is the default.
Whether the rate can be assigned.
Date and time the record was created (ISO 8601, UTC).
Date and time the record was last changed (ISO 8601, UTC).