ScontrinoZero
Il registratore di cassa virtuale. Zero hardware, zero complicazioni.
ScontrinoZero è un'applicazione mobile-first che consente a esercenti e professionisti di emettere scontrini elettronici e trasmettere i corrispettivi all'Agenzia delle Entrate direttamente da smartphone, tablet o PC — senza bisogno di un registratore telematico fisico.
Il problema
In Italia, chi effettua vendite al dettaglio è obbligato a memorizzare e trasmettere telematicamente i corrispettivi (D.Lgs. 127/2015). La soluzione tradizionale — un registratore telematico (RT) — comporta l'acquisto (400-800 €), l'installazione da parte di un tecnico abilitato, la verificazione periodica ogni due anni e, quasi sempre, un contratto di assistenza facoltativo. Per micro-attività, ambulanti e B&B con pochi scontrini al giorno, è un peso sproporzionato.
La soluzione
ScontrinoZero usa la procedura web "Documento Commerciale Online" dell'Agenzia delle Entrate, automatizzando i passaggi che l'esercente farebbe a mano sul portale. Memorizzazione, emissione e trasmissione restano un unico adempimento contestuale: lo scontrino esiste solo dopo la conferma dell'AdE e porta il progressivo assegnato da lei. Nessun archivio fiscale parallelo, nessuna alterazione dei dati inviati o ricevuti in risposta.
Funzionalità principali
- Emissione scontrini elettronici — direttamente dal tuo dispositivo, con invio in tempo reale all'AdE
- Lotteria degli Scontrini — inserisci il codice fiscale del cliente per partecipare automaticamente
- Gestione resi e annullamenti — con un tap
- Catalogo prodotti — accesso rapido ai prodotti più venduti
- Multi-dispositivo — usa la stessa cassa da smartphone, tablet o browser
- Stampa e condivisione — condividi lo scontrino via QR code, link pubblico o stampa
- Storico corrispettivi — consulta e scarica i tuoi scontrini in qualsiasi momento
Tech Stack
| Layer | Tecnologie |
|---|
| Frontend | Next.js 16 (App Router), React 19, TypeScript, Tailwind CSS 4 |
| Componenti | shadcn/ui, TanStack Query v5 |
| Database | Supabase (PostgreSQL), Drizzle ORM, Row Level Security |
| Pagamenti | Stripe: piani Starter, Pro e Team (prezzi); self-hosted gratuito |
| Email | Resend + React Email |
| Integrazione | HTTP dirette verso portale AdE (no headless browser) |
| Deploy | Docker standalone su VPS, Cloudflare Tunnel |
| Qualità | Vitest, SonarCloud, Sentry |
Conformità normativa
ScontrinoZero opera come interfaccia alla procedura web dell'Agenzia delle Entrate, garantendo:
- Contestualità dell'adempimento (memorizzazione + trasmissione + emissione in un unico flusso)
- Nessuna alterazione dei dati trasmessi o ricevuti dall'AdE
- Nessuna intermediazione — il dispositivo dell'esercente comunica direttamente con i sistemi dell'Agenzia
Target
Pensato per chi emette scontrini ma non vuole (o non può) investire in un registratore telematico fisico:
🏪 Piccoli negozi · 💇 Parrucchieri e centri estetici · 🏨 B&B e affittacamere · 🚐 Ambulanti · 🚗 NCC · 🔧 Artigiani · 🎪 Fiere e sagre
Guide pubbliche
Approfondimenti normativi e operativi (top-of-funnel SEO, accessibili a tutti):
Tutte le guide sono disponibili anche dall'hub /guide.
Self-hosting
Per chi preferisce gestire l'installazione in autonomia (gratis, ma anche tutta la responsabilità):
- Clona il repository e configura le variabili d'ambiente (
.env.example come riferimento).
- Crea un progetto Supabase Cloud (free tier sufficiente per cominciare) e applica le migrazioni:
npx tsx scripts/migrate.ts
- Genera la chiave di cifratura per le credenziali AdE (Fisconline o CIE):
node -e "console.log(require('crypto').randomBytes(32).toString('hex'))"
e impostala in ENCRYPTION_KEY (procedura di rotazione zero-downtime
nell'header di scripts/rotate-encryption-key.ts).
- Build e run con Docker Compose (
next-app + cloudflared):
docker compose pull && docker compose up -d
- Punta il tuo dominio via Cloudflare Tunnel.
La versione self-hosted include tutte le funzionalità della versione SaaS; il vantaggio della versione hosted su scontrinozero.it sono backup, aggiornamenti automatici, supporto e hosting gestito.
Telemetria
L'immagine pubblica non invia nulla al progetto Sentry di ScontrinoZero:
SENTRY_DSN è letta a runtime dal tuo .env, quindi se non la imposti la
telemetria server è semplicemente spenta.
Se vuoi la tua, crea un progetto Sentry e imposta SENTRY_DSN con il DSN di
quel progetto: errori server ed edge finiranno lì.
Per la telemetria browser serve invece ribuildare l'immagine passando il
tuo NEXT_PUBLIC_SENTRY_DSN come --build-arg: le variabili NEXT_PUBLIC_*
sono inlineate nel bundle JavaScript al momento del build, non lette a runtime,
quindi metterle nel .env non ha alcun effetto sull'immagine già costruita.
Nota: l'immagine pubblicata su GHCR porta nel bundle client il DSN del
progetto di produzione, ma gli eventi provenienti da domini diversi da
scontrinozero.it vengono scartati prima dell'invio
(isForeignHostEvent() in src/lib/sentry-filters.ts) — la tua istanza non
ci manda dati, e tu non li vedi.
Stato del progetto
🚀 In produzione su scontrinozero.it
Roadmap, bug noti e idee in valutazione sono nelle
issue GitHub.
Licenza
O'Saasy License — self-hosted gratuito, SaaS a pagamento. Vietato usare il software per offrire un servizio hosted concorrente.
