Installation

composer require cboxdk/laravel-tax

Then sync the register, before anything is priced:

php artisan tax:data:sync

This is a deploy step, not a one-off. Until it has run the engine refuses rather than guessing, and the refusal names the command. Put it alongside php artisan migrate. See The register for what it pulls, how to take less than all of it, and what the licence permits.

If you invoice in a currency other than the country's own — euros for a Danish sale, dollars anywhere in the EU — also fetch the European Central Bank's reference rates, and schedule it daily, since the bank publishes once a day:

php artisan tax:fx:sync

See Invoice currency.

TaxServiceProvider is auto-discovered and binds:

• Contracts\TaxCalculator → DefaultTaxCalculator
• Contracts\RegimeRegistry → the shipped regimes (DefaultRegimeRegistry::withDefaults())
• Contracts\TaxRateSource → RegisterRateSource (the compiled register — run php artisan tax:data:sync first)
• Contracts\TaxRegister → InstalledRegister (what the installed register says, typed)
• Contracts\ExchangeRates → EcbExchangeRates (the ECB's rates — run php artisan tax:fx:sync)

To put your own source in front of the register, bind TaxRateSource in a service provider — see Rate sources. Publish the config with:

php artisan vendor:publish --tag=tax-config

Upgrading from the retired datasets

Merge the new published config into your application's existing config/tax.php. Replace us_tax_data, eu_tax_data and tedb settings with register settings, and add tax:data:sync to deployment. The unused register.enabled switch has been removed; bind your own source when replacing the register.

Move us_tax_data.rooftop to geocodio.rooftop (GEOCODIO_ROOFTOP). The old TAX_US_DATASET_ROOFTOP environment variable remains a fallback when the new variable is unset. Other retired dataset options have no effect.

Check SaaS taxability for the changed handling of undetermined US categories. Use FakeRegister to provide explicit test data in applications that previously depended on bundled rates.