The tax election object

A Tax Election is a relationship between a Tax and a specific Company or Employee. It represents a choice about the applicability of that tax.

{
  "id": "txe_abc",
  "tax": "tax_12345",
  "company": "com_12345",
  "employee": "emp_12345", // Only for Employee Tax Elections
  "description": "New York State Tax",
  "payer": "company",
  "jurisdiction": "jur_12345",
  "jurisdiction_abbreviation": "NY",
  "exemptible": true,
  "setting": {
    "exempt": true,
    "effective_start": "2024-01-01",
    "effective_end": "2024-12-31"
  },
  "setting_timeline": [
    {
      "exempt": false,
      "effective_start": "1900-01-01",
      "effective_end": "2023-12-31"
    },
    {
      "exempt": true,
      "effective_start": "2024-01-01",
      "effective_end": "2024-12-31"
    },
    {
      "exempt": false,
      "effective_start": "2025-01-01",
      "effective_end": null
    }
  ]
}
AttributeDescription
id
string
Unique identifier for the Tax Election.
tax
string
Unique identifier for the Tax.
company
string
Unique identifier for the Company.
employee
string
Unique identifier for the Employee (only for Employee Tax Elections).
description
string
Human-readable description for the Tax.
payer
string
The payer of the tax (company or employee).
jurisdiction
string
Unique identifier for the tax's Jurisdiction.
jurisdiction_abbreviation
string
The abbreviation for the Jurisdiction.
exemptible
boolean
Indicates whether the Tax is exemptible.
setting
object
The effective setting for the Tax Election.
setting_timeline
list
The effective dated history of setting objects.