Skip to main content
The TaxRate Data Model represents tax rates applicable to products and services in different jurisdictions. Tax rates are used to calculate tax amounts on invoices and transactions.
  • Jurisdiction-based: Tax rates are tied to specific geographic areas
  • Rate management: Track tax rates as decimal values for accurate calculations
  • Status tracking: Monitor active vs archived tax rates
  • Multiple rate support: Support for different tax types (VAT, sales tax, GST)

​
Attributes

​
TaxRate Attributes

PropertyTypeDescription
rootfi_idintegerUnique identifier for this tax rate
rootfi_created_atstringWhen this tax rate was created in Commenda’s system (ISO 8601)
rootfi_updated_atstringWhen this tax rate was last updated (ISO 8601)
rootfi_company_idintegerCompany identifier this tax rate belongs to
platform_idstringPlatform-specific tax rate identifier
namestringDisplay name (e.g., “California Sales Tax”)
ratenumberTax rate as a decimal (e.g., 0.0725 for 7.25%)
jurisdictionstringGeographic area where tax applies (e.g., “CA”, “NY”)
statusenumCurrent status of this tax rate
created_atstringOriginal creation timestamp (ISO 8601)
updated_atstringLast update timestamp (ISO 8601)

​
Status Enum Values

ValueDescription
activeTax rate is currently active
archivedTax rate is no longer used
unknownStatus cannot be determined
{
  "rootfi_id": 11001,
  "rootfi_created_at": "2025-01-01T00:00:00Z",
  "rootfi_updated_at": "2025-01-01T00:00:00Z",
  "rootfi_company_id": 999,
  "platform_id": "txr_stripe_001",
  "name": "California Sales Tax",
  "rate": 0.0725,
  "jurisdiction": "CA",
  "status": "active",
  "created_at": "2025-01-01T00:00:00Z",
  "updated_at": "2025-01-01T00:00:00Z"
}