README

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

Requirements

• PHP 8.2+
• Laravel 11 or 12
• 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

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