Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.commenda.io/llms.txt

Use this file to discover all available pages before exploring further.

​
Overview

Commenda helps you calculate sales tax on transactions using our APIs. This guide walks you through the complete workflow for US sales tax calculation, from initial setup to calculating taxes on your transactions.

​
Prerequisites

Before you can calculate sales tax, you need:
  1. Organization: Contact Commenda to set up your organization.
  2. Corporation: Create a corporation that reflects one real-world business entity.
  3. API Token: Use your API token for authentication.

​
Understanding US sales tax registration thresholds

In the US, you are not required to collect sales tax from customers unless you exceed a physical or economic registration threshold in a state. Once you exceed a threshold (setting aside grace periods), you must:
  1. Register in the state where you have exceeded the threshold
  2. Collect sales tax from customers in that state
  3. File and remit the collected taxes

​
Workflow

​
1. Create a corporation

Create a corporation using the Create Corporation API. A corporation represents a real-world business entity (e.g., Commenda Technologies Inc.) that will be collecting and remitting taxes.
  • Provide your organization ID and corporation details
  • Save the corporation ID returned in the response for subsequent API calls
  • Each corporation should map to one legal entity in your business

​
2. Monitor registration threshold exposure

Use the Registration Thresholds API to track your latest threshold exposure across states:
  • Monitor your transaction volume and revenue by state
  • Identify states where you are approaching or have exceeded registration thresholds
  • Determine which states require registration

​
3. Ingest transactions

Use the Transactions API to submit your transaction data:
  • Submit completed transactions to track registration threshold progress
  • Include transaction details such as amounts, locations, and dates
  • Use bulk import for large transaction volumes

​
4. Register in exposed states

Once you have exceeded the registration threshold in a state, create a registration using the Create Registration API:
  • Provide your API token and corporation ID
  • Specify the state where you need to register
  • Include registration details such as effective date and tax ID
If you attempt to calculate sales tax without a registration in a state, the calculation results will return zero. You must have an active registration to collect tax in that state.For sandbox environment testing, feel free to create a registration using the Create Registration endpoint rather than requesting a new one to perform tests.

​
5. Calculate sales tax

After creating registrations in exposed states, use the Calculate API to calculate taxes on your transactions.

​
Minimum required fields

To calculate US sales tax, you must provide:
  • Destination address: The ship-to address of the invoice. The address is validated against the destination country’s address requirements.
  • Calculation date: The date of the transaction
  • Invoice information: Basic invoice details including:
    • Invoice total or subtotal
    • Line items with amounts and descriptions
    • Product tax codes (if applicable)
See the Calculate endpoint documentation for complete field requirements and examples.
Commenda also supports tax calculations for other countries beyond the US. Some countries require additional fields — for example, UK (GB) calculations require a ship-from address. See the tax calculations overview for the full list of supported countries and their requirements.