veltix/tax-engine

Tax Engine

A Laravel package for EU tax/VAT calculation with support for OSS, IOSS, reverse charge, and export rules.

Requirements

• PHP 8.3+
• Laravel 12 or 13
• ext-bcmath

Installation

composer require veltix/tax-engine

Publish the configuration:

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

If using database storage for compliance snapshots, publish and run migrations:

php artisan vendor:publish --tag=tax-engine-migrations
php artisan migrate

Configuration

Key settings in config/tax.php:

Usage

use Veltix\TaxEngine\Actions\CalculateTaxAction;
use Veltix\TaxEngine\Data\TransactionData;
use Veltix\TaxEngine\Enums\CustomerType;
use Veltix\TaxEngine\Enums\SupplyType;
use Veltix\TaxEngine\Support\Country;
use Veltix\TaxEngine\Support\Money;

$action = app(CalculateTaxAction::class);

$result = $action->execute(new TransactionData(
    transactionId: 'order-123',
    amount: Money::fromCents(10000), // EUR 100.00
    sellerCountry: new Country('DE'),
    buyerCountry: new Country('FR'),
    customerType: CustomerType::B2C,
    supplyType: SupplyType::DigitalServices,
));

$result->taxAmount;    // Money object with calculated tax
$result->grossAmount;  // Net + tax
$result->decision;     // TaxDecisionData with scheme, rate, reasoning

VAT Rates

The built-in StaticRateRepository uses the EU VAT rates in EuVatRates (rate table version 2026.1, rates in force on 2026-10-05). The table holds current rates only; it does not give a past date its old rate. Sources and the dates of recent changes are in docs/rates-sources.md. To use your own rates, bind your own RateRepositoryContract implementation.

Available Rules

Rules are evaluated by priority (highest first):

Extending with Custom Rules

Implement RuleContract and tag it in your service provider:

use Veltix\TaxEngine\Contracts\RuleContract;

class MyCustomRule implements RuleContract
{
    public function applies(TransactionData $transaction): bool { /* ... */ }
    public function evaluate(TransactionData $transaction): TaxDecisionData { /* ... */ }
    public function priority(): int { return 25; }
}

// In your service provider:
$this->app->bind(MyCustomRule::class, fn () => new MyCustomRule());
$this->app->tag(MyCustomRule::class, 'tax-engine.rules');

License

MIT