# Replace taxrate

Fully replaces an existing Taxrate. All fields must be provided.

Endpoint: PUT /site/{siteId}/ahds/v1/taxrate/{taxrateId}
Version: 1.0
Security: bearer

## Path parameters:

  - `siteId` (number, required)
    Site identifier

  - `taxrateId` (string, required)
    Taxrate unique identifier (UUID)

## Request fields (application/json):

  - `code` (string, required)
    Human-readable tax code or label (e.g., 'GST', 'VAT15').

  - `extensions` (object, required)
    Vendor- or practice-specific extensions.

  - `isActive` (boolean, required)
    Whether this tax rate is currently active and can be used for billing.

  - `rate` (number, required)
    Tax rate as a decimal fraction (e.g., 0.15 for 15%).

  - `jurisdiction` (string, required)
    Human-readable description of the tax jurisdiction or authority this rate applies to (e.g., 'NZ national', 'CA-ON provincial').

## Response 200 fields (application/json):

  - `code` (string, required)
    Human-readable tax code or label (e.g., 'GST', 'VAT15').

  - `createdAt` (string, required)
    Timestamp when the tax rate record was created.
    Example: "2025-01-01T00:00:00.000Z"

  - `extensions` (object, required)
    Vendor- or practice-specific extensions.

  - `isActive` (boolean, required)
    Whether this tax rate is currently active and can be used for billing.

  - `rate` (number, required)
    Tax rate as a decimal fraction (e.g., 0.15 for 15%).

  - `taxrateId` (string, required)
    Canonical unique identifier for the tax rate.
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `updatedAt` (string, required)
    Timestamp when the tax rate record was last updated.
    Example: "2025-01-01T00:00:00.000Z"

  - `jurisdiction` (string, required)
    Human-readable description of the tax jurisdiction or authority this rate applies to (e.g., 'NZ national', 'CA-ON provincial').


## Response 400 fields

## Response 401 fields

## Response 404 fields