Criar imposto
POST/taxes
Creates a tax kind. Requires scope finance.taxes.write. Workspace-scoped (no company). name is unique per workspace (duplicate → 409). default_rate is a percent string (0–100). Pass an X-Idempotency-Key header on retries.
Requisição
Respostas
- 201
- 400
- 401
- 403
- 409
- 422
- 429
- 500
Tax created. The Location header points at the new row.
Malformed JSON body.
Missing / invalid / expired / revoked token.
Token lacks the finance.taxes.write scope.
A tax with the same name already exists, or X-Idempotency-Key reuse with a different body.
Schema validation failure, or default_rate out of the 0–100 range.
Rate limit exceeded for this token. Reads and writes have separate budgets, both on a 1-hour sliding window. The response carries X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset and Retry-After — wait out Retry-After rather than retrying immediately.
Unhandled server error.