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
    }
  ]
}

Attribute	Description
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.