Opensalestax Sylius Laravel Package

Product Decisions This Supports

• Tax Compliance for US E-Commerce: Enables Sylius-based e-commerce platforms to replace built-in tax calculations with destination-based US sales tax via OpenSalesTax, addressing compliance for multi-state operations.
• Self-Hosted Tax Engine: Supports merchants who prefer self-hosted solutions over third-party SaaS (e.g., Avalara, TaxJar) for cost control, data sovereignty, or customization.
• Roadmap for Advanced Tax Features: Foundation for future integrations like product-level tax categories, refund proration, and admin UI controls (planned in v0.2+).
• Build vs. Buy: Justifies buying this package over custom development for Sylius tax logic, reducing dev effort while maintaining flexibility.
• Use Cases:
  • B2C e-commerce with multi-state US sales.
  • Platforms requiring audit trails or offline tax calculations.
  • Projects needing open-source compliance (dual-licensed Apache/GPL).

When to Consider This Package

Adopt if:

• Your Sylius-based store operates in the US and needs destination-based sales tax.
• You’re using Sylius ^1.13 and Symfony 6.4/7.0.
• You prefer a self-hosted OpenSalesTax engine (v0.14+) over SaaS providers.
• You need fail-soft behavior (graceful degradation) over strict fail-fast modes.
• Your team can handle basic configuration (engine URL, nexus rules) without UI tooling.

Look elsewhere if:

• You need real-time tax filings/remittance (this package only calculates tax).
• Your stack uses Sylius <1.13 or non-US tax jurisdictions.
• You require pre-built admin panels (UI deferred to v1.0).
• You lack resources to self-host OpenSalesTax or troubleshoot engine issues.
• You need multi-currency support (USD-only in v0.1).

How to Pitch It (Stakeholders)

Executives: "This package lets us replace Sylius’s basic tax engine with accurate, self-hosted US sales tax calculations via OpenSalesTax—reducing compliance risk and avoiding SaaS costs. It’s production-ready for core tax logic (v0.1) with a clear roadmap for advanced features like product-level tax rules (v0.2). Dual-licensed for flexibility, and backed by rigorous testing (PHPStan/Psalm clean)."

Engineering: *"A lightweight Symfony bundle that:

• Drops in as a Sylius tax calculator (replaces TaxationStrategy).
• Caches aggressively (60-min PSR-6 memoization) for performance.
• Fails softly by default (configurable to fail-hard).
• Supports nexus rules (per-state filtering) out of the box.
• Roadmap: UI controls (v1.0), refund proration (v0.2). Tradeoff: Requires self-hosted OpenSalesTax engine (v0.14+)."*