Create a sales-tax code
Creates a new sales-tax code.
Authorizations
Your Conductor secret key using Bearer auth (e.g., "Authorization: Bearer {{YOUR_SECRET_KEY}}").
Headers
The ID of the EndUser to receive this request (e.g., "Conductor-End-User-Id: {{END_USER_ID}}").
Body
The case-insensitive unique name of this sales-tax code, unique across all sales-tax codes. Maximum length: 3 characters. This short name will appear on sales forms to identify the tax status of an item.
Indicates whether this sales-tax code is active. Inactive objects are typically hidden from views and reports in QuickBooks.
Indicates whether this sales-tax code is tracking taxable sales. This field cannot be modified once the sales-tax code has been used in a transaction.
A description of this sales-tax code.
The sales-tax item used to calculate the actual tax amount for this sales-tax code's transactions by applying a specific tax rate collected for a single tax agency. Unlike salesTaxCode, which only indicates general taxability, this field drives the actual tax calculation and reporting.
Response
The unique identifier assigned by QuickBooks to this sales-tax code. This ID is unique across all sales-tax codes but not across different QuickBooks object types.
The type of object. This value is always "qbd_sales_tax_code".
"qbd_sales_tax_code"The date and time when this sales-tax code was created, in ISO 8601 format (YYYY-MM-DDThh:mm:ss±hh:mm). The time zone is the same as the user's time zone in QuickBooks.
The date and time when this sales-tax code was last updated, in ISO 8601 format (YYYY-MM-DDThh:mm:ss±hh:mm). The time zone is the same as the user's time zone in QuickBooks.
The current revision number of this sales-tax code, which changes each time the object is modified. When updating this object, you must provide the most recent revisionNumber to ensure you're working with the latest data; otherwise, the update will return an error.
The case-insensitive unique name of this sales-tax code, unique across all sales-tax codes. Maximum length: 3 characters. This short name will appear on sales forms to identify the tax status of an item.
Indicates whether this sales-tax code is active. Inactive objects are typically hidden from views and reports in QuickBooks.
Indicates whether this sales-tax code is tracking taxable sales. This field cannot be modified once the sales-tax code has been used in a transaction.
A description of this sales-tax code.
The sales-tax item used to calculate the actual tax amount for this sales-tax code's transactions by applying a specific tax rate collected for a single tax agency. Unlike salesTaxCode, which only indicates general taxability, this field drives the actual tax calculation and reporting.