docs(tax): TAX-1750 add store operations docs for tax customers and tax property type field #929
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
declankirk
force-pushed
the
TAX-1750-mdx
branch
2 times, most recently
from
5211351 to
5652d1e
Compare
![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?s=60&v=4){kind=small}
theromulans
reviewed
May 5, 2025
…ax property type field
theromulans
reviewed
May 6, 2025
|
|
||
| The Tax Properties API allows merchants to vary the tax information they send to tax providers for tax calculation. In some jurisdictions, tax rates for products vary by product composition. For example, accurate taxation of alcohol may require information about alcohol percentage. Using tax properties, providers can return more accurate tax quotes. The examples in this guide expand on this use case. | ||
| The Tax Properties API allows merchants to vary the tax information they send to tax providers for tax calculation. In some jurisdictions, tax rates for products vary by product composition. For example, accurate taxation of alcohol may require information about alcohol percentage. Using tax properties, providers can return more accurate tax quotes. The examples in this guide expand on this use case. | ||
|
|
||
| Tax providers may sometimes need multiple inputs that can vary between different types of product. For example, for products with alcohol, the alcohol percentage and the volume sold affect alcohol taxes. As shown in this guide, merchants can provide both pieces of information to tax providers. |
There was a problem hiding this comment.
As above, I think we can drop this paragraph - it's largely a repeat and seems to only be pointing out that users can have multiple product tax properties.
|
|
||
| The Tax Properties API allows merchants to vary the tax information they send to tax providers for tax calculation. In some jurisdictions, tax rates for products vary by product composition. For example, accurate taxation of alcohol may require information about alcohol percentage. Using tax properties, providers can return more accurate tax quotes. The examples in this guide expand on this use case. | ||
| The Tax Properties API allows merchants to vary the tax information they send to tax providers for tax calculation. In some jurisdictions, tax rates for products vary by product composition. For example, accurate taxation of alcohol may require information about alcohol percentage. Using tax properties, providers can return more accurate tax quotes. The examples in this guide expand on this use case. |
There was a problem hiding this comment.
🍻 Now that we're talking about two types of tax properties, I think it makes sense to shuffle some of this around and go even more high-level...
Suggested change
| The Tax Properties API allows merchants to vary the tax information they send to tax providers for tax calculation. In some jurisdictions, tax rates for products vary by product composition. For example, accurate taxation of alcohol may require information about alcohol percentage. Using tax properties, providers can return more accurate tax quotes. The examples in this guide expand on this use case. | |
| The Tax Properties API allows merchants to vary the tax information they send to tax providers for tax calculation. | |
| In some jurisdictions, tax rates for products vary by product composition. For example, accurate taxation of alcohol may require information about alcohol percentage. Using product tax properties, providers can return more accurate tax quotes. | |
| Tax calculation may also be influenced by customer data that sits outside the standard BigCommerce customer model. For example, a tax provider may provide a tax exemption based on exemption certificates associated with third party ERP customer ID. Using customer tax properties, providers can apply the relevant adjustments to the transacting customer's tax quote. | |
| The examples in this guide expand on these product and customer use cases. |
|
|
||
| Tax providers may sometimes need multiple inputs that can vary between different types of product. For example, for products with alcohol, the alcohol percentage and the volume sold affect alcohol taxes. As shown in this guide, merchants can provide both pieces of information to tax providers. | ||
|
|
||
| The API also supports **customer tax properties**, which allow merchants to provide customer-specific tax information to tax providers. These properties can influence how tax is calculated based on the customer making the purchase. |
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
TAX-1750
What changed?
/v3/tax/customersendpoint, for configuring customer tax data (currently justtax_properties)typefield to dictate whether property is associated toPRODUCTorCUSTOMERRelease notes draft
typefield to tax properties, allowing you to specify whether a property is associated with a product or a customer. If not set, it will default toPRODUCT./v3/tax/customersendpoint for managing customer tax data. Supports the following operations:GET: Retrieve tax data for one or more customers.PUT: Add or update tax properties for customers.DELETE: Remove tax data for specified customers.Anything else?
/v3/tax/customersendpoint #927ping @bigcommerce/team-tax