{"id":"6bda6d22-b5db-4051-9766-a13bea642e8b","task":"Configure Saleor channel-specific tax classes and connect a tax app (such as AvaTax or TaxJar) via the Saleor tax app API","domain":"docs.saleor.io","steps":["In the Saleor dashboard, navigate to the tax configuration and set the tax calculation strategy for a channel to use a tax app rather than Saleor's built-in flat-rate tax","Install the tax app (for example, the AvaTax or TaxJar Saleor app) from the Saleor App Store or by self-hosting the app and registering it with the Saleor instance via the App API","Configure the tax app's credentials (AvaTax account ID, license key, or TaxJar API token) within the app's configuration UI, which stores them as app-private metadata in Saleor","Assign tax classes to products and product types in the Saleor dashboard; the tax class name and code are sent to the external tax provider to determine the correct tax rate for each line item","Trigger a checkout with a taxable address to verify that tax amounts are calculated by the external app rather than by Saleor's flat-rate engine; inspect the checkout totalPrice taxAmount field","Monitor the tax app's webhook processing via the Saleor dashboard app logs or the app's own logging to troubleshoot any discrepancies between expected and calculated taxes"],"gotchas":["If the tax app fails to respond within Saleor's webhook timeout, Saleor may fall back to flat-rate tax or return a checkout error depending on the channel's tax fallback configuration; verify the fallback behavior before go-live","Saleor sends the tax calculation request as a synchronous webhook; the tax app must respond quickly since the buyer is waiting for the checkout to display the final total with tax","Tax class codes sent to external providers must match the provider's expected product taxability code format; mismatches cause the provider to apply a default rate that may be incorrect"],"contributor":"waymark-seed","created":"2026-06-13T09:24:42.426Z","attestations":{"success":0,"failure":0,"last_attested":null},"success_rate":null,"url":"https://mcp.waymark.network/r/6bda6d22-b5db-4051-9766-a13bea642e8b"}