Pyle

Tax Rates ​

What This Is ​

Tax Rates are the records Pyle uses to decide how much tax should be applied in a given country or state. For an operator, this is the place to manage the numbers and rules that affect order totals, invoices, and refund calculations.

In the packaged product, this lives under Settings > Taxes. In the admin sidebar, the broader section label is Taxes and duties, but the inspected shared page itself is a tax-rate table and form workflow.

When You Would Use It ​

Use Tax Rates when you need to:

  • create a new rate for a territory
  • edit a rate that is calculating incorrectly
  • turn a rate off so it no longer applies to new orders
  • add a special or custom tax rate for a specific setup

Do not use this page for product pricing or shipping charges. It only affects tax behavior.

Before You Start ​

Make sure you know:

  • which country and state the rate should apply to
  • whether your project uses the built-in database tax logic or a TaxJar-backed setup
  • whether the rate should be active right away
  • whether the rate should be treated as inclusive or exclusive

If your project uses TaxJar, some tax outcomes can also depend on nexus and customer exemption setup.

How To Use It In The Admin ​

  1. Open Settings > Taxes.
  2. Review the current list of tax rates.
  3. Create a new rate or edit an existing one.
  4. Enter the tax name and description that your team will recognize.
  5. Set the percentage.
  6. Choose whether the rate is inclusive.
  7. Choose whether the rate should be active.
  8. Mark it as custom if this rate is meant for a special business rule.
  9. Select the country and state that define where the rate applies.
  10. Add a registration number if your business uses one for that jurisdiction.
  11. Save the rate and re-check the order or quote that should use it.

What It Changes In The Storefront ​

Shoppers do not edit tax rates directly, but tax rates can change:

  • the tax amount shown during checkout
  • the final order total
  • invoice totals
  • refund and return calculations

If taxes look wrong in the storefront, the issue is usually in the configured rate, the shipping address, or the tax provider setup rather than in the storefront itself.

Common Tasks ​

  • create a new tax rate for a country or state
  • update a percentage after a tax change
  • disable a rate that should no longer apply
  • review whether a custom rate is being used
  • verify the jurisdiction before publishing the rate

Rules, Limits, And Things To Watch ​

  • The packaged admin surface is settings-based, not a general tax workspace.
  • The packaged form requires both a country and a state. This first pass did not find a global fallback tax-rate form.
  • Tax rates can affect new calculations, but existing orders may not update until they are recalculated by the related workflow.
  • Inclusive and exclusive rates can produce different totals even when the percentage looks the same.
  • Custom rates may be applied automatically in some order or customer scenarios.

Troubleshooting ​

  • If a tax amount looks wrong, check the order shipping address first.
  • If the rate is missing, confirm that it is active and assigned to the right country and state.
  • If a customer seems exempt, check whether the order is using a custom tax setup.
  • If your project uses TaxJar, also confirm that nexus and exemption settings are correct.
  • Regions
  • Orders
  • Invoices
  • Returns

Sources:

  • packages/admin/src/Livewire/Admin/Settings/Taxes/Page.php
  • packages/admin/src/Livewire/Admin/Settings/Taxes/DataTable.php
  • packages/admin/src/Livewire/Admin/Settings/Taxes/DataTable/CreateDialog.php
  • packages/admin/src/Livewire/Admin/Settings/Taxes/DataTable/EditDialog.php
  • packages/framework/src/Http/Controllers/Api/Admin/TaxRatesController.php
  • packages/framework/src/Actions/TaxRate/GetOrderTaxRates.php
  • packages/framework/src/Actions/TaxRate/Provider/Database/GetOrderTaxRates.php
  • packages/framework/src/Actions/TaxRate/Provider/TaxJar/GetOrderTaxRates.php
  • packages/framework/src/Actions/Order/CreateOrder.php