Current roadmap progress
Core VAT Engine
- EU VAT calculation (B2C, destination-based)
- Prices include VAT logic
- Accurate rounding & Money domain
- Tax classes (standard, reduced, books, etc.)
- High-performance calculation API
- Historical & future rates support (valid_from / valid_to)
- Clean domain architecture (Calculator, Money, Errors)
- Transaction date support (RFC3339 & YYYY-MM-DD)
VAT Rates & Rules Management
- RateProvider abstraction
- In-memory VAT rates provider
- PostgreSQL-backed VAT rates provider
- Redis cached rate provider (positive + negative cache)
- Rate validity windows
- Deterministic rate resolution (ambiguity handling)
- Public rate lookup API (GET /v1/vat/rates)
Observability & Reliability
- Health & readiness checks
- Request ID & distributed tracing (X-Request-ID)
- Prometheus metrics (requests, duration, in-flight)
- Graceful shutdown (configurable timeout)
- Production-grade logging (Zerolog, INFO/DEBUG levels)
- Structured error codes & domain errors
- Production vs local environment configuration
Audit & Compliance Foundation
- Transaction persistence (vat_transactions table)
- Immutable VAT calculation records schema
- Per-country aggregation ready
- VAT thresholds table (vat_thresholds)
- Per-country threshold configuration
- Validity period support
- Audit-friendly data model
SaaS Platform (Alpha Launch)
- User authentication
- API key generation & management
- Usage tracking & analytics
- Rate limiting per user
- Dashboard with usage stats
- API documentation portal
- Developer getting started guide
Compliance Logic
- Auto-logging calculations to vat_transactions
- Transaction query API
- Historical data export
- EU distance selling threshold logic (€10,000)
- Per-country / per-period aggregation
- Multi-store & multi-channel support
- Threshold progress tracking
- Alerts when thresholds are close / exceeded
OSS / IOSS Reporting
- OSS quarterly summaries
- Country-level VAT breakdowns
- IOSS-ready data model (< €150 imports)
- CSV / JSON export for accountants
- Accountant-friendly reporting format
- Multi-jurisdiction reporting
E-commerce Integrations
- Shopify integration (order sync)
- Magento 2 integration (order sync)
- Sylius 2 integration (order sync)
- WooCommerce integration
- Headless / custom shop integration
- Multi-platform aggregation
- Webhook notifications
Billing & Multi-language
- Stripe billing integration
- Subscription management
- Usage-based billing (API calls)
- Multi-language UI
- Localized error messages (Accept-Language header)
- Multi-language documentation portal
- Team accounts & permissions
- Invoicing & billing history
B2B & Advanced Compliance
- B2B VAT & reverse charge logic
- VAT number validation (EU VIES, national registries)
- Multi-entity VAT reporting
- Product → tax class mapping
- CLI tools & automation
- Regional expansion (non-EU)
- Tax rule exceptions & custom configs