Sales Tax API
Core Concepts
Corporations
Calculate
Transactions
- Tax Transactions
- POSTCreate a transaction
- GETGet transaction
- GETList transactions
- DELDelete transaction
- Refund Transactions
- Bulk Transaction Import
Nexus
Registrations
Products
Customers
Exemption Certificates
Update registration
Allows customers to provide additional information about states where they are already registered for sales tax.
curl --request POST \
--url https://base_url/api/v1/registrations/{id} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"registered_at": "2023-12-25",
"country_options": {
"US": {
"state": "CA",
"legal_name": "Example Inc.",
"state_options": {
"CA": {
"payment_interval": "ANNUAL_CALENDAR_YEAR",
"sales_tax_id": "<string>",
"username": "<string>",
"password": "<string>",
"pin": "<string>",
"web_file_number": "<string>"
}
}
}
}
}'
{
"message": "Successfully updated registration."
}
Authorizations
Bearer authentication header of the form Bearer <token>
, where <token>
is your auth token.
Path Parameters
The unique identifier of the registration to update.
Body
ISO 8601 date only string, identifying the date when the state registration occurred.
2-letter code for each state. Suffix of the ISO 3166-2 code. Ex: CA, NY, TX. This can't be changed once set.
"CA"
The legal name of the entity being registered.
"Example Inc."
Once a merchant is registered in a state for sales tax, they need to pay the collected tax to the state government. This payment happens at a fixed interval. The interval is generally decided by the state government and differ from state to state as well as for each merchant.
ANNUAL_CALENDAR_YEAR
, QUARTERLY
, MONTHLY
, ANNUAL_FISCAL_YEAR_START_JULY
, SEMI_ANNUALLY
, QUARTERLY_PREPAY_MONTHLY
, ANNUAL_FISCAL_YEAR_MARCH
, BIMONTHLY
The unique identifier assigned to the merchant by the state government during registration.
Merchant's username for the state sales tax portal.
Merchant's password for the state sales tax portal.
Some sales tax state portal require a pin to access them. If the state requires it, this will need to be passed before validating this registration.
Some state like Texas provides a webfile number that is required by Commenda to perform accurate filings.
Response
"Successfully updated registration."
curl --request POST \
--url https://base_url/api/v1/registrations/{id} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"registered_at": "2023-12-25",
"country_options": {
"US": {
"state": "CA",
"legal_name": "Example Inc.",
"state_options": {
"CA": {
"payment_interval": "ANNUAL_CALENDAR_YEAR",
"sales_tax_id": "<string>",
"username": "<string>",
"password": "<string>",
"pin": "<string>",
"web_file_number": "<string>"
}
}
}
}
}'
{
"message": "Successfully updated registration."
}