Accounting API Taxes

Update a shipping tax rule

POST https://api.tamio.com/v2/taxes/shipping-tax/update/{uuid}

Updates an existing shipping tax rule.

Path Parameters

uuid string*

UUID of the shipping tax rule to update.

Body Parameters

label string*

Human-readable name for the shipping tax rule.

rate number*

Percentage tax rate (0–100). When 0, a fixed amount is required. Mutually exclusive with amount.

amount number

Fixed tax amount in smallest currency unit. Mutually exclusive with rate.

active boolean

Whether the shipping tax rule is active.

applies_to string

all_shippings — applies to every shipping method; selected_shippings — requires shippings array.

all_shippingsselected_shippings

shippings array of string

Shipping method UUIDs (required when applies_to is selected_shippings).

Responses

200 Shipping tax rule updated

Shipping tax rule updated

status integer

tax Tax

400 Validation or business-logic error

401 Missing or invalid API key

Create a shipping tax rule

Duplicate a tax rule

/taxes/shipping-tax/update/{uuid}

1 const response = await fetch("https://api.tamio.com/v2/taxes/shipping-tax/update/{uuid}", {
2   method: "POST",
3   headers: {
4     "Authorization": "Bearer YOUR_API_KEY",
5     "Content-Type": "application/json"
6   },
7   body: JSON.stringify({
8     // ... request body
9   })
10 });
11 const data = await response.json();

1 require "uri"
2 require "net/http"
3 
4 url = URI("https://api.tamio.com/v2/taxes/shipping-tax/update/{uuid}")
5 
6 https = Net::HTTP.new(url.host, url.port)
7 https.use_ssl = true
8 
9 request = Net::HTTP::Post.new(url)
10 request["Accept"] = "application/json"
11 request["Authorization"] = "Bearer YOUR_API_KEY"
12 request["Content-Type"] = "application/json"
13 request.body = %Q{
14   // ... request body
15 }
16 
17 response = https.request(request)
18 puts response.read_body

Responses

{
  "status": 200,
  "tax": {
    "id": "string",
    "object": "tax",
    "rate": 0,
    "amount": 0,
    "label": "string",
    "active": false,
    "country": "string",
    "type": "product_tax",
    "applies_to": "string",
    "postcodes": [],
    "states": [],
    "payments": [],
    "categories": {},
    "products": []
  }
}

1	const response = await fetch("https://api.tamio.com/v2/taxes/shipping-tax/update/{uuid}", {
2	method: "POST",
3	headers: {
4	"Authorization": "Bearer YOUR_API_KEY",
5	"Content-Type": "application/json"
6	},
7	body: JSON.stringify({
8	// ... request body
9	})
10	});
11	const data = await response.json();

1	require "uri"
2	require "net/http"
3
4	url = URI("https://api.tamio.com/v2/taxes/shipping-tax/update/{uuid}")
5
6	https = Net::HTTP.new(url.host, url.port)
7	https.use_ssl = true
8
9	request = Net::HTTP::Post.new(url)
10	request["Accept"] = "application/json"
11	request["Authorization"] = "Bearer YOUR_API_KEY"
12	request["Content-Type"] = "application/json"
13	request.body = %Q{
14	// ... request body
15	}
16
17	response = https.request(request)
18	puts response.read_body