How We Built a Real-Time Tax Authority Sync & Anomaly Detector with Laravel, Livewire and NAV Online Számla 3.0

SalesForm.hu — Tue, 20 Oct 2026 10:34:50 +0000

Running a business comes with a mountain of regulatory overhead. In Hungary, every single business invoice must be reported to the National Tax and Customs Administration (NAV) electronically in real time via an XML-based SOAP/REST API.

While this ensures total transparency for the tax office, it creates an enormous headache for micro-entrepreneurs and freelancers under the KATA fixed-tax regime. One mistaken invoice issued to a corporation or exceeding the strict revenue threshold triggers an immediate 40% retroactive punitive tax.

To solve this, we built Katazom.hu, a cloud-based compliance engine. In this article, I'll walk through how we architected our real-time invoice synchronization pipeline using Laravel 11, Livewire, and asynchronous queue workers.

The Architecture: 3 Key Challenges

1. Ingestion: Dealing with Government API Throttling & XML Parsing

The NAV Online Számla 3.0 API requires cryptographic challenge-response authentication (SHA3-512 hashes and timestamp validation).
To avoid blocking the UI, every sync request is pushed to a dedicated Redis queue:

We batch requests into 50-invoice chunks.
We stream XML rather than buffering huge payloads into memory.
We decouple technical invoice errors from business compliance issues.

2. The Anomaly Detection Engine

A common trap for KATA freelancers is mistakenly selecting the wrong VAT status (e.g. standard 27% VAT instead of exemption) or issuing an invoice to a corporate entity without realizing that recent laws forbid B2B transactions under simplified KATA.

Our background auditor evaluates every incoming invoice payload against the entrepreneur's historical profile:

Verifies VAT exemption codes (AAM).
Checks partner tax numbers via the official registry using our open-source validator katazom/hungarian-tax-validator.
Flags discrepancies immediately and generates a ready-to-copy corrective invoice formula.

3. Pro-Rata Math for Paused Businesses

Hungarian law currently enforces an 18M HUF annual cap (scaling to 22M HUF in the upcoming 2027 tax reform), reducing it by 1/12th for each month a freelancer suspends their trade.

We exposed this logic directly in a free embeddable widget: katazom-calculator-widget and our free portal IngyenKATA.hu.

Conclusion & Open Source