Fiscalizzazione

Collegamento di registratori fiscali e gateway cloud per la conformità alla normativa fiscale.

1. Panoramica#

La fiscalizzazione è un obbligo di legge in molti Paesi: ogni transazione con il cliente deve essere registrata nel sistema fiscale e confermata da una ricevuta fiscale.

Cenaly affronta la questione in due modi:

Cosa è supportato oggi:

Un ambito adiacente ma diverso è lo scambio elettronico di documenti con lo Stato (non la ricevuta al cliente):

Kasa fiskalna ≠ KSeF: la prima è la ricevuta a una persona fisica, la seconda è la fattura a una persona giuridica. L'una non sostituisce l'altra.

2. Come funziona#

Il cliente paga l'ordine
       ↓
La cassa Cenaly raccoglie gli articoli, le aliquote fiscali e i metodi di pagamento
       ↓
La ricevuta viene inviata al registratore fiscale (tramite bridge) o al gateway cloud
       ↓
Il dispositivo/servizio registra la transazione presso il fisco
       ↓
Il cliente riceve la ricevuta fiscale

Dettaglio importante: il registratore fiscale è vostro ed è registrato con i vostri dati. Cenaly è il trasporto e la coda, non l'operatore dei dati fiscali.

3. Collegamento del registratore fiscale tramite bridge#

Famiglie supportate#

Le normali stampanti per ricevute (non fiscali) compatibili con ESC/POS si collegano tramite lo stesso bridge come dispositivo separato e stampano preconti, comande di cucina e ricevute commerciali.

Se nella sede non c'è una stampante per ricevute, il conto ospite (preconto) viene stampato dal registratore fiscale stesso — la larghezza di riga viene presa dal dispositivo, così la colonna con gli importi non viene tagliata. Sono in grado di farlo Daisy, ATOL e SHTRIH-M; i Thermal polacchi non stampano testo libero e rifiutano correttamente. Il registratore fiscale resta comunque un registratore fiscale: i nostri documenti ordinari (comande di cucina, copie delle ricevute) non vi vengono inviati — solo la stampa di prova e il preconto.

Collegamento passo passo#

Passo 1. Installate il bridge#

Aprite Hardware nel pannello: se il bridge non è ancora installato, la pagina stessa propone il download per il vostro sistema operativo — un installer per Windows o un archivio portable, per Linux x64/ARM un comando unico di installazione del servizio. Il bridge funziona sullo stesso computer a cui è collegato il registratore fiscale.

Passo 2. Collegate il registratore fiscale al computer#

Sono supportati la porta seriale (COM/USB-COM), la connessione di rete e la stampante di sistema tramite spooler — dipende dal modello. Il bridge è in grado di trovare l'hardware da solo: il pulsante di scansione automatica propone i dispositivi trovati, che si possono aggiungere alla configurazione con un clic.

Passo 3. Verificate#

Sulla scheda del registratore fiscale si vedono il modello, il numero di serie, le aliquote fiscali, lo stato della carta e il numero dell'ultimo rapporto Z. Qui ci sono anche i pulsanti per la stampa di prova, l'apertura del cassetto contanti e l'emissione del rapporto X.

Per i registratori Daisy nel pannello sono integrate guide dedicate: come portare il registratore in modalità stampante fiscale e cosa fare con gli errori tipici.

Passo 4. Configurate il cliché e le aliquote#

Il pulsante «Impostazioni registratore» apre un editor riga per riga dell'intestazione e del piè di pagina della ricevuta, i flag (righe vuote, separatore, logo, ricevuta dettagliata), la modalità di taglio, le aliquote fiscali e i dati dell'operatore (numero, password, nome).

4. Configurazione per paese#

🇬🇪 Georgia — Revenue Service#

Requisiti:

• registratore fiscale registrato su rs.ge, con modulo fiscale (testato su Daisy eXpert SX);
• numero di identificazione (საიდენტიფიკაციო ნომერი).

Configurazione:

1. Portare il registratore in modalità seriale «Fiscal printer» (nel pannello è disponibile una guida con la sequenza esatta sulla tastiera).
2. Aggiungerlo nella sezione Hardware come registratore fiscale.
3. Emettere una ricevuta di prova e chiudere il turno cassa con Z-report — gli importi devono coincidere.

Separatamente dalle ricevute, in Georgia funziona la sezione rs.ge: fatture elettroniche di trasporto in entrata dai fornitori, loro conferma e rifiuto, rubriche, verifica del numero di identificazione e dello status di contribuente IVA.

🇵🇱 Polonia — kasa fiskalna online#

Dal 2021 ristoranti, bar e caffè sono obbligati ad avere una cassa online che trasmette i dati al CRK (Centralne Repozytorium Kas). Non è possibile realizzare una propria cassa virtuale senza certificato GUM, quindi le vie sono due:

1. Stampante fiscale propria tramite protocollo POSNET Thermal — si collega con il bridge (vedi sezione 3). Un solo driver copre la maggior parte del parco: Posnet, Emar, Innova, Torell, Elzab Mera. Oggi in Polonia funziona solo questa via.
2. API di una cassa certificata di terzi — 🛠 in sviluppo. Il gateway è scritto, ma la sua parte server non è distribuita, e non esiste ancora un adattatore per una specifica cassa certificata: le casse virtuali polacche non hanno una specifica pubblica, e gli adattatori (XKasa, WKF, Aclas) vengono aggiunti man mano che si ottiene la loro documentazione. La scheda di collegamento nelle integrazioni della sede non è disponibile.

L'aliquota IVA il gateway non la inventa: la matrice per canale (cibo 8 %, asporto 5 %, caffè e alcolici 23 %) la calcola la piattaforma stessa, il gateway si limita a convertire la percentuale nella lettera PTU della cassa specifica.

KSeF (fatture B2B) — un circuito separato nella sezione Controparti: l'XML in formato FA(3) viene costruito dal documento emesso, cifrato e inviato al sistema del Ministero delle Finanze, lo stato e il numero UPO tornano nella scheda.

🇰🇿 Kazakistan — Registratore fiscale#

Dal 01.01.2026 gli articoli 110–111 del Codice tributario della Repubblica del Kazakistan richiedono una ricevuta del registratore fiscale il giorno dell'acquisto per qualsiasi pagamento monetario — inclusa la carta sul sito, Kaspi Pay/QR e Apple/Google Pay.

🛠 Il collegamento non è ancora disponibile. Il gateway verso l'operatore del registratore fiscale (primo driver — Webkassa) è scritto, ma la sua parte server non è distribuita: la scheda di collegamento nelle integrazioni della sede non è disponibile, e oggi non è possibile inserire i dati. Quando il gateway sarà aperto, funzionerà così: dati dell'operatore del registratore fiscale → verifica della connessione → la ricevuta parte automaticamente, e l'IVA viene calcolata secondo il regime fiscale della sede. Serve il Kazakistan — scrivete al supporto, le priorità vengono stabilite in base alla domanda.

🇷🇺 Russia — 54-FZ#

Due modi, che si possono combinare:

• Registratore fiscale proprio tramite bridge — ATOL, Mercury, SHTRIH-M, Pirit/Viki Print. Supportati FFD 1.05 e 1.2, ricevute di correzione, marcatura Chestny ZNAK, EGAIS UTM.
• Cassa cloud — sezione API cassa (Russia): HTTP-API, compatibile con il protocollo ATOL Online (v5 = FFD 1.2, v4 = FFD 1.05). Il vostro sito o CMS invia una ricevuta JSON, il servizio la mette in coda, la ricevuta viene emessa sul vostro registratore fiscale. La cassa resta vostra ed è registrata sul vostro INN — la piattaforma è solo trasporto e coda.

Circuiti russi adiacenti: verifica dello stato dei codici di marcatura Chestny ZNAK e chiusura delle VSD in entrata nel sistema informativo statale federale «Mercury» (scheda «VSD in entrata» nel magazzino).

5. Emissione delle ricevute e report#

Alla cassa (POS)#

La ricevuta viene emessa al momento del pagamento nella sezione Cassa. Qui anche: ristampa (sotto PIN del manager), reso — totale o parziale, cambio con rivendita, ricerca nella cronologia delle ricevute e pre-conto («conto ospite» prima del pagamento).

Il pre-conto viene stampato sulla stampante per ricevute, e se non è presente nella sede — sul registratore fiscale stesso (vedi sezione 3). Il lavoro in questo caso non entra nella coda della stampante offline: l'ospite aspetta il conto adesso, non «quando la stampante tornerà disponibile».

Dalla sezione «Ordini»#

Per un ordine online la ricevuta può essere emessa direttamente dalla scheda dell'ordine — il comando passa attraverso il canale cloud al bridge della sede necessaria, anche se in quel momento siete a un altro computer.

X-report e Z-report#

• X-report — intermedio, senza chiusura del turno cassa. Il pulsante è presente sia nella sezione Hardware sia nella cassa.
• Z-report — chiusura del turno cassa con conferma; nella cassa è abbinato alla chiusura del turno cassa e alla verifica effettivo/atteso (ammanchi ed eccedenze sono visibili subito).

Il registro dei turni cassa chiusi — cassiere, fondo cassa, vendite in contanti e con carta, contanti attesi ed effettivi, differenze — si trova nella sezione Finanze, scheda «Cassa».

Se la ricevuta non è stata emessa#

La cassa è hardware, e si guasta: carta esaurita, turno cassa non chiuso, sulla macchina è appesa una ricevuta non chiusa, sono passate più di ventiquattro ore senza Z-report. Prima in questi casi compariva un suggerimento a scomparsa con il testo del driver — non era possibile capirne né la causa né cosa fare.

Ora al suo posto si apre la finestra «Ricevuta non emessa»: lì è scritto cosa è successo esattamente, e passo per passo — cosa fare. Alla cassa si crede in base al suo codice di errore, non alla formulazione del driver: spesso consiglia la cosa sbagliata (per alcuni modelli il suggerimento «cambiate modalità» arriva insieme al codice «ventiquattro ore senza Z-report», anche se la modalità è a posto).

• Se la causa è visibile dal cloud — la finestra offre i pulsanti «Emettere Z-report» e «Ripetere la ricevuta».
• Se bisogna intervenire sulla macchina stessa (carta assente, ricevuta non chiusa, errore da azzerare con un tasto sulla cassa), la finestra lo dice e guida passo per passo.
• Se si tratta di un guasto per il tecnico di assistenza (modem, SIM, memoria), la ripetizione non viene proposta — non servirebbe a nulla.
• I dettagli tecnici sono nascosti nella riga «dettagli» — è comodo allegarli a una richiesta al supporto.

La finestra può essere chiusa in qualsiasi momento: la vendita è già registrata nella cronologia delle ricevute e il pagamento è stato effettuato, e la ricevuta fiscale può essere emessa di nuovo da lì stesso, quando la cassa sarà pronta. La coda non deve attendere.

6. Cosa viene stampato sulla ricevuta#

Il contenuto della ricevuta fiscale è stabilito dalla legge del paese, mentre tutto ciò che è possibile gestire è raccolto nelle «Impostazioni del registratore» della sezione Hardware:

• righe di intestazione e piè di pagina (editor riga per riga);
• logo, separatore, righe vuote;
• ricevuta dettagliata o compatta;
• modalità di taglio;
• aliquote fiscali e loro associazione ai gruppi;
• dati dell'operatore.

7. Ricevute elettroniche#

• In Russia la ricevuta elettronica al cliente viene inviata dall'OFD — tramite telefono o e-mail inseriti al momento del pagamento; è parte della 54-FZ, non una funzione separata del pannello.
• Indipendentemente dalla fiscalizzazione, Cenaly invia al cliente la conferma dell'ordine e la notifica di pagamento via e-mail, mentre il link alla schermata dell'ordine può essere salvato tra i preferiti.
• L'e-mail del cliente viene raccolta al checkout, se avete attivato questo campo nelle impostazioni del negozio online.

8. Reportistica per la contabilità#

Il registro delle ricevute viene tenuto per ogni sede e su di esso si basano:

• Finanze → Cassa — giornale dei turni cassa, contanti, discrepanze;
• Finanze → Panoramica / Vendite — ricavi, imposte, metodi di pagamento, canali;
• Finanze → P&L — report semplificato sui profitti con spese manuali;
• Impostazioni → Esportazione dati — archivio ZIP con tutti i dati dell'account, ordini e catalogo anche in CSV (apribile in Excel e «Google Fogli») — vedi Esportazione dati.

Esportazioni nei formati DSFinV-K e SAF-T la piattaforma non le genera — fanno parte dei contesti tedesco ed europeo che al momento non sono disponibili.

9. Domande frequenti#

La fiscalizzazione è obbligatoria?#

Dipende dal paese e dal tipo di attività: in Polonia e in Russia la cassa online per la ristorazione è obbligatoria, in Kazakistan dal 2026 la ricevuta del registratore fiscale è necessaria per qualsiasi transazione monetaria. Per i requisiti esatti relativi alla vostra attività, rivolgetevi al vostro commercialista o all'amministrazione fiscale.

Si può lavorare senza una stampante fisica?#

Oggi no: i gateway cloud del Kazakistan (Webkassa) e della Polonia (kasa online via API) non sono ancora aperti per il collegamento, quindi in tutti i paesi supportati serve un apparecchio proprio. In Russia la KKT fisica è necessaria in ogni caso, ma è possibile gestirla dal cloud tramite la sezione «API cassa» — il computer con la cassa si trova in un unico posto e vi invia le ricevute sia dal sito sia da 1C.

Cosa fare in caso di guasto della cassa?#

Il Bridge mostra onestamente lo stato del dispositivo e il testo dell'errore, invece di «ingoiare» silenziosamente il guasto. Finché la cassa non è disponibile, ordini e pagamenti continuano a esistere nel sistema — ma senza una KKT funzionante non comparirà alcun documento fiscale e nella maggior parte dei paesi questo è motivo per sospendere le transazioni e informare l'amministrazione fiscale.

Come collegare più casse?#

L'Hardware è gestito per sede: in ogni location c'è il proprio Bridge (o più di uno — universale, per l'Hardware, per le telecamere, per la telefonia), mentre nel registro Hardware dell'account sono visibili contemporaneamente tutti i Bridge e tutti i dispositivi di tutte le sedi, con l'assegnazione del Bridge a sedi aggiuntive.

In cosa differisce la kasa fiskalna dal KSeF?#

La kasa fiskalna è la ricevuta per la persona fisica, con regolatore GUM e KAS e repository CRK. Il KSeF è la fattura elettronica per la persona giuridica, sistema del Ministero delle Finanze. Documenti diversi e obblighi diversi; la presenza dell'uno non esonera dall'altro.

10. Supporto#

• Cenaly: support@cenaly.com → oggetto «Fiscalizzazione»
• Per le questioni relative alla registrazione delle casse — all'amministrazione fiscale del vostro paese
• Sezioni correlate: Hardware, Cassa (POS), Ricevute, rs.ge