Opensalestax Sylius Laravel Package

First release of opensalestax-sylius — a Sylius bundle that replaces Sylius's built-in tax calculation with destination-based US sales tax computed by a self-hosted OpenSalesTax engine.

Install

composer require ejosterberg/opensalestax-sylius

Register in config/bundles.php:

return [
    OpenSalesTax\Sylius\OpenSalesTaxSyliusBundle::class => ['all' => true],
];

Configure in config/packages/opensalestax_sylius.yaml:

opensalestax_sylius:
    engine_url: '%env(OSTAX_ENGINE_URL)%'

What's in this release

• Symfony bundle skeleton (Sylius ^1.13, Symfony ^6.4 || ^7.0)
• OstaxCalculator implementing Sylius\Component\Taxation\Calculator\CalculatorInterface
• OstaxTaxationStrategy implementing Sylius\Component\Core\Taxation\Strategy\TaxCalculationStrategyInterface
• USD-only / US-only gates (constitution §5)
• Fail-soft default; opt-in fail-hard (constitution §8)
• Per-state nexus filter (mirrors WooCommerce v0.5 / Vendure v1.2 sibling pattern)
• 60-min PSR-6 cache memoization
• Dual-licensed Apache-2.0 OR GPL-2.0-or-later

Quality gates

• 66 PHPUnit tests, 151 assertions
• PHPStan max — clean
• Psalm 6 — clean
• php-cs-fixer — clean
• composer audit — no advisories
• CI matrix: PHP 8.2 / 8.3 / 8.4

What's NOT in this release (planned for v0.2)

• Live Sylius VM integration test (next session priority)
• Per-product OST category mapping (Sylius TaxCategory overlay)
• Refund-flow proration (AdjustmentFactory injection)
• Sylius admin UI panel (deferred to v1.0)

See specs/handoff.md for the full v0.2 roadmap.

Compatibility

Disclaimer

This bundle calculates US sales tax. It does not file returns, remit collected tax, or validate exemption certificates. The merchant remains responsible for filing and remittance.