Fiscalizzazione (Cloud)
La sezione Fiscale ti permette di configurare e monitorare l’emissione fiscale degli scontrini per ogni ordine. È raggiungibile dal pannello di amministrazione alla voce Fiscale. Questa funzionalità è disponibile solo nella versione Cloud.
La Community Edition non include il modulo di fiscalizzazione cloud. La sezione non è visibile nelle installazioni self-hosted.
Panoramica
La sezione è organizzata in tre schede:
| Scheda | Descrizione |
|---|---|
| Riconciliazione | Vista predefinita. Mostra tutti gli ordini con il loro stato fiscale per la verifica a fine giornata. |
| Scontrini Emessi | Elenco di tutti i tentativi di emissione con stato in tempo reale, filtri e azione di riprova. |
| Configurazione | Impostazioni del modulo: abilitazione, metodo di emissione, credenziali OpenAPI.it, policy zero. |
Come Accedere
Apri il pannello di amministrazione
Dalla dashboard dell’organizzazione, clicca su Amministrazione nel menu laterale.
Vai a Fiscale
Nella barra laterale amministrativa, clicca su Fiscale. La voce è visibile solo nella versione Cloud e solo per gli utenti con ruolo Admin o OrgAdmin.
Se la voce Fiscale non è visibile, verifica di essere in modalità Cloud e di avere i permessi necessari.
Configurazione (scheda “Configurazione”)
Stato del Modulo
La prima card, Stato del modulo, controlla l’intero sistema di fiscalizzazione per l’organizzazione.
- Lo switch Attivo/Disattivato abilita o disabilita la gestione scontrini per tutti gli ordini
- Quando disattivato, nessun tentativo fiscale viene creato e il badge mostra Disattivato
- Quando attivato, le sezioni di configurazione successive diventano visibili
Disattivare il modulo non cancella la configurazione esistente, ma sospende qualsiasi attività fiscale su nuovi ordini.
Metodo di Emissione
Quando il modulo è attivo, puoi scegliere come emettere gli scontrini:
| Opzione | Descrizione |
|---|---|
| Emissione integrata | Gli scontrini vengono emessi tramite un servizio collegato come Scontrina. SagraFacile avvia l’emissione e ne traccia lo stato. |
| Emissione esterna | SagraFacile tiene traccia degli ordini da fiscalizzare, ma non si collega a nessun servizio. Il cassiere emette lo scontrino manualmente (es. con registratore telematico) e lo conferma nel sistema. Utile per la riconciliazione a fine giornata. |
Servizio e Modalità (solo Emissione Integrata)
Se scegli Emissione integrata, seleziona il provider e la modalità:
Provider
| Provider | Descrizione |
|---|---|
| Scontrina | Emissione tramite l’app Scontrina. Non richiede registratore telematico fisico: basta un tablet o smartphone con l’app installata. |
| OpenAPI.it | Emissione automatica completamente integrata tramite il servizio OpenAPI.it. Ideale per postazioni desktop. Richiede credenziali AdE per l’invio telematico. |
Modalità di Emissione (Scontrina)
Dopo aver selezionato Scontrina, scegli come inviare i dati dell’ordine all’app:
| Modalità | Ideale per | Funzionamento |
|---|---|---|
| Apertura app (DeepLink) | Tablet e dispositivi mobili | L’app Scontrina si apre automaticamente con i dati dell’ordine pre-compilati |
| Codice QR | Postazioni desktop | Viene mostrato un QR code da scansionare con uno smartphone o tablet su cui è installata l’app Scontrina |
Se la cassa è su un tablet e Scontrina è installata sullo stesso dispositivo, usa Apertura app. Se la cassa è su un PC desktop con Scontrina su un dispositivo separato, usa Codice QR.
Configurazione OpenAPI.it
Se scegli OpenAPI.it, compila i campi nella card Configurazione OpenAPI.it:
| Campo | Descrizione |
|---|---|
| P.IVA | Partita IVA dell’organizzazione emittente |
| Ragione Sociale | Denominazione dell’organizzazione |
| Indirizzo email per le notifiche del provider | |
| Aliquota IVA predefinita | Aliquota IVA utilizzata per le righe di coperto e asporto (es. 22 per il 22%). Obbligatorio. |
| API Key | Chiave API fornita da OpenAPI.it |
| Credenziali AdE | Username e password per l’Agenzia delle Entrate, necessari per la trasmissione telematica |
Con OpenAPI.it, ogni prodotto del menu deve avere un codice IVA configurato nella sezione Fiscalizzazione. Se un prodotto manca del codice IVA, l’ordine viene marcato come Emissione esterna richiesta e lo scontrino non viene emesso automaticamente. Configura i codici IVA prima di iniziare le operazioni.
Le credenziali AdE scadono periodicamente (di norma annualmente). Quando scadono, l’emissione degli scontrini si interrompe. Aggiorna le credenziali in questa pagina prima della scadenza.
Con OpenAPI.it l’emissione è completamente automatica: SagraFacile invia i dati dell’ordine al provider al momento del pagamento e aggiorna lo stato in tempo reale tramite webhook. Non è richiesta alcuna azione manuale da parte del cassiere per la maggior parte degli ordini.
Email scontrino al cliente
Nella versione con OpenAPI.it, il cassiere può raccogliere l’email del cliente al momento del pagamento e inviargli una copia dello scontrino elettronico. Il cliente riceve la email solo se lo scontrino viene emesso con successo.
Opzioni Avanzate
La card Opzioni avanzate contiene la policy sugli ordini con totale effettivo pari a zero:
- Attivo: gli ordini a importo zero vengono fiscalizzati normalmente
- Disattivo: gli ordini con totale effettivo 0 vengono marcati come Non richiesto e nessun tentativo fiscale viene creato
Il totale “effettivo” è il totale dopo eventuali sconti manuali applicati dal cassiere, non il totale nominale degli articoli.
Salvare la Configurazione
Dopo aver impostato tutte le opzioni, clicca su Salva configurazione. Le modifiche sono attive immediatamente per i nuovi ordini.
Flusso Fiscale in Cassa
Dopo la conferma di un pagamento, SagraFacile avvia automaticamente il processo di fiscalizzazione in base alla configurazione attiva. In determinati stati, al cassiere viene mostrato il dialog Fiscalizzazione ordine.
Modalità Apertura App (DeepLink)
Conferma il pagamento
Il cassiere clicca Paga Contanti o Paga POS e conferma nel dialog di riepilogo.
Si apre il dialog di fiscalizzazione
Viene mostrato il dialog Fiscalizzazione ordine con stato In attesa. Un messaggio indica: “Apri Scontrina sul dispositivo fiscale per completare l’emissione.”
Apri Scontrina
Clicca Apri Scontrina: l’app si apre automaticamente con i dati dell’ordine pre-compilati. Completa l’emissione nell’app.
Conferma l’emissione
Torna su SagraFacile e clicca Conferma emissione. Puoi inserire il numero documento fiscale (opzionale) prima di confermare.
Modalità Codice QR
Conferma il pagamento
Il cassiere completa il pagamento normalmente.
Si apre il dialog con il QR
Viene mostrato il dialog Fiscalizzazione ordine con un QR code e l’indicazione: “Inquadra il QR con Scontrina sullo smartphone.”
Scansiona il QR con Scontrina
Usa lo smartphone o tablet con l’app Scontrina per scansionare il QR. L’app riceve i dati dell’ordine e completa l’emissione.
Conferma l’emissione
Torna su SagraFacile e clicca Conferma emissione per registrare lo scontrino come emesso.
Modalità Emissione Esterna
Conferma il pagamento
Il cassiere completa il pagamento normalmente.
Si apre il dialog con stato “Emissione esterna richiesta”
Il sistema registra l’ordine come in attesa di fiscalizzazione manuale.
Emetti lo scontrino con il registratore telematico
Il cassiere emette lo scontrino con il dispositivo fiscale esterno.
Conferma nel sistema
Clicca Conferma emissione nel dialog. Puoi inserire il numero documento fiscale. Lo stato dell’ordine passa a Confermato manualmente.
Azioni sul Dialog
Il dialog Fiscalizzazione ordine offre azioni diverse in base allo stato corrente:
| Azione | Disponibile quando | Descrizione |
|---|---|---|
| Aggiorna stato | Stato: In attesa | Interroga nuovamente il provider per aggiornare lo stato (aggiornamento automatico ogni 5 secondi) |
| Riprova fiscalizzazione | Stato: Errore, Emissione esterna richiesta o Sostituzione fiscale richiesta | Avvia un nuovo tentativo di fiscalizzazione |
| Conferma emissione | Stato: In attesa, Errore o Emissione esterna richiesta | Conferma manualmente che lo scontrino è stato emesso, con numero documento opzionale |
| Correggi metodo di pagamento | Stato: Emesso (OpenAPI.it, entro 24h) | Annulla lo scontrino emesso e ne emette uno nuovo con il metodo di pagamento corretto |
| Chiudi | Sempre | Chiude il dialog senza modificare lo stato fiscale |
Correzione Metodo di Pagamento
Se il cassiere ha selezionato il metodo di pagamento sbagliato (es. ha cliccato Contanti ma il cliente ha pagato con POS), è possibile correggere il metodo entro 24 ore dall’emissione dello scontrino.
Questa operazione è disponibile solo con OpenAPI.it ed entro 24 ore dall’emissione. Dopo 24 ore non è più possibile annullare il documento: utilizza il flusso di reso/rimborso nella scheda Scontrini Emessi della sezione Fiscale.
Apri lo storico ordini
Vai a Storico Ordini e cerca l’ordine in questione, poi clicca su Ristampa / Dettagli.
Clicca su “Correggi metodo di pagamento”
Nel dialog, nella sezione Correzione scontrino, sarà visibile il pulsante per correggere il metodo verso l’unica alternativa disponibile (Contanti → POS o POS → Contanti).
Conferma nel dialog di avviso
Apparirà un messaggio di conferma che descrive l’operazione: lo scontrino attuale viene annullato e ne viene emesso uno nuovo. Clicca Conferma per procedere.
Attendi il nuovo scontrino
Il sistema annulla il documento originale su OpenAPI.it e ne emette uno nuovo con il metodo corretto.
Nella maggior parte dei casi lo stato fiscale torna a In attesa e si aggiorna automaticamente a Emesso quando il provider conferma.
Se invece l’annullamento va a buon fine ma la nuova emissione non si completa subito, lo stato passa a Sostituzione fiscale richiesta. In questo caso l’operatore può usare Riprova fiscalizzazione per completare la nuova emissione senza annullare di nuovo il documento precedente.
Stati Fiscali
Gli ordini nella versione Cloud riportano uno stato fiscale che puoi consultare nello storico:
| Stato | Descrizione |
|---|---|
Non richiesto | La fiscalizzazione non è richiesta per questo ordine (es. ordini a importo zero con policy disattiva) |
In attesa | Il tentativo di fiscalizzazione è stato creato ed è in attesa di completamento |
Emesso | Lo scontrino è stato emesso con successo tramite il provider |
Errore | Il tentativo è fallito. È possibile riprovare dal dialog o dalla riconciliazione |
Sostituzione fiscale richiesta | Il documento precedente è già stato annullato, ma la nuova emissione non è ancora completata. È possibile riprovare dal dialog o dalla riconciliazione. |
Emissione esterna richiesta | L’ordine richiede emissione manuale con registratore telematico |
Confermato manualmente | Il cassiere ha confermato manualmente l’emissione dello scontrino |
Fattura richiesta (manuale) | Il cassiere ha indicato che il cliente richiede una fattura elettronica. Nessuno scontrino viene emesso automaticamente. La fattura deve essere emessa manualmente tramite il software gestionale dell’organizzazione. |
Scontrini Emessi (scheda “Scontrini Emessi”)
La scheda Scontrini Emessi mostra tutti i tentativi di emissione con il loro stato in tempo reale. Utile per il monitoraggio tecnico e per gestire errori su singoli scontrini.
Da questa scheda puoi:
- Filtrare per stato (Emesso, In attesa, Errore, Errore con riprova automatica) e per servizio (OpenAPI.it, Scontrina)
- Verificare il numero documento e la data di emissione per ogni scontrino
- Vedere se l’email scontrino è stata inviata al cliente (icona ✉)
- Riprovare manualmente scontrini in errore permanente o in errore con necessità di attenzione
La scheda si aggiorna automaticamente ogni 15 secondi quando ci sono scontrini in stato In attesa o Creato.
Gestione degli errori
| Stato | Cosa significa | Azione |
|---|---|---|
Emesso | Emissione completata con successo | Nessuna |
In attesa | OpenAPI.it ha ricevuto la richiesta, in attesa di conferma AdE | Attendi l’aggiornamento automatico |
Errore (riprova auto) | Tentativo fallito, il sistema sta riprovando automaticamente | Se compare il pulsante Forza riprova, la riprova automatica è bloccata: clicca per sbloccare |
Errore | Errore permanente, nessuna riprova automatica | Clicca Riprova per un nuovo tentativo manuale |
Quando usi OpenAPI.it, una copia digitale dello scontrino può essere inviata via email o resa disponibile tramite link pubblico. Il sistema tiene traccia operativa di queste azioni per aiutare assistenza e riconciliazione, ma questa cronologia non sostituisce eventuali verifiche amministrative richieste dall’organizzazione.
Se una configurazione OpenAPI.it è stata salvata ma mancano ancora i dati minimi obbligatori, la scheda la segnala come Configurazione incompleta e ti chiede di completare la registrazione prima dell’uso operativo.
Riconciliazione (scheda predefinita)
La scheda Riconciliazione è la vista predefinita della sezione Fiscale. A differenza della scheda Scontrini Emessi (che mostra i singoli tentativi), questa vista mostra un ordine per riga con il suo stato fiscale corrente. È lo strumento principale per la verifica a fine giornata.
Da questa scheda puoi:
- Filtrare gli ordini per stato fiscale, area e giornata operativa
- Rivedere i dettagli di ogni tentativo fiscale (codice errore, numero documento)
- Avviare retry in blocco per ordini in errore
- Esportare i dati per la riconciliazione contabile
- Emettere rimborsi fiscali per ordini già emessi (reso o annullamento)
Rimborso fiscale (OpenAPI.it)
Per gli ordini emessi tramite OpenAPI.it è possibile emettere un documento di reso direttamente dalla riconciliazione.
Apri i dettagli dell’ordine
Trova l’ordine nella tabella e clicca sull’icona dettagli. Nel pannello laterale appare il pulsante Emetti rimborso fiscale.
Scegli il tipo di operazione
- Annullamento (void): disponibile solo entro 24 ore dall’emissione. Annulla completamente il documento fiscale.
- Reso parziale: disponibile sempre. Seleziona gli articoli da rendere e le quantità.
Seleziona gli articoli (solo reso parziale)
Il sistema carica automaticamente gli articoli della ricevuta originale con i prezzi unitari. Per ogni articolo usa i pulsanti + e − per indicare quante unità rendere. Il totale del rimborso si aggiorna in tempo reale.
I resi OpenAPI.it sono basati su quantità di articoli, non su importi liberi. Puoi rendere 1 pizza da €10, non “€5 di pizza da €10”. Il totale del rimborso è sempre la somma dei prezzi unitari degli articoli selezionati.
Conferma il rimborso
Clicca Conferma rimborso. Il sistema invia la richiesta a OpenAPI.it. In caso di successo lo stato dell’ordine viene aggiornato.
La riconciliazione è lo strumento principale per gestire le eccezioni fiscali a fine giornata. Controlla regolarmente gli ordini in stato Errore o Emissione esterna richiesta prima di chiudere la giornata operativa.
Prossimi Passi
Dopo aver configurato la fiscalizzazione:
- Interfaccia POS — come il cassiere gestisce il handoff fiscale in cassa desktop
- Interfaccia Mobile — gestione fiscale nella vista ordini mobile
- Ordini — consulta lo stato fiscale nello storico ordini
- Postazioni Cassa — configurazione delle postazioni associate alla fiscalizzazione