Registratore telematico (RT)
L’integrazione con il registratore telematico serve a emettere lo scontrino elettronico dal banco cassa senza ribattere gli importi. Il gestionale invia il documento al gateway del tuo RT, che resta il dispositivo fiscale di riferimento. È utile ai laboratori che incassano allo sportello.
OpzionaleCosa fa
Scontrini elettronici verso il tuo RT.
Categoria: pagamenti — Incassi online e in cassa, ricevute e registratore telematico.
Cosa serve
- Registratore telematico omologato e un gateway che ne esponga le funzioni via HTTP
- Terminale POS certificato separato per la lettura della carta
- Rete locale che consenta al server di raggiungere il gateway del registratore
Come funziona
Dalla schermata cassa il documento viene composto con importo, righe e metodo di pagamento.
La chiamata non parte dal browser: passa da un proxy server che controlla ruolo e permessi, verifica che l’indirizzo sia quello configurato e aggiunge la chiave del laboratorio.
Il gateway del registratore risponde con l’esito e il numero documento, che viene salvato accanto alla transazione di cassa.
Quando serve
Quando l’incasso avviene allo sportello e lo scontrino deve essere emesso contestualmente.
Quando vuoi che cassa, prestazioni e ciclo attivo restino allineati senza doppia digitazione.
Limiti
Non esiste un driver del protocollo di uno specifico modello di registratore. Serve un gateway che esponga un endpoint HTTP verso il dispositivo.
La chiusura fiscale giornaliera e la gestione della matricola restano sul registratore: il gestionale non le sostituisce.
Verifica sempre l’esito sul dispositivo prima di considerare emesso lo scontrino: il documento fiscale è quello prodotto dal registratore.
La carta si legge sul terminale POS certificato. Il gestionale registra brand, ultime quattro cifre e codice autorizzazione, mai il numero della carta.
Come si attiva
Se ne occupa chi installa LabBox: il vostro tecnico informatico oppure noi.
Per il tecnico
- `NEXT_PUBLIC_RT_ENDPOINT` (o `RT_ENDPOINT`) — indirizzo base del gateway
- `RT_API_KEY` — chiave del laboratorio, letta solo lato server
- Verifica con il fornitore del registratore che esista un gateway HTTP e fatti dare indirizzo e credenziali.
- Imposta `RT_ENDPOINT` con l’indirizzo base e `RT_API_KEY` con la chiave, entrambi solo lato server.
- Rifai il deploy e controlla che la schermata cassa non segnali più la configurazione mancante.
- Emetti uno scontrino di prova di importo minimo e confrontalo con quello stampato dal registratore.
- Verifica la chiusura giornaliera sul dispositivo prima di usarlo in produzione.
Domande frequenti
Il registratore telematico è incluso?
No. È un dispositivo fiscale che il laboratorio acquista e fa omologare; il gestionale ci dialoga tramite il suo gateway.
Cosa succede se non configuro l’endpoint?
Il proxy risponde con un errore di configurazione e nulla viene trasmesso al registratore. La cassa va usata con la procedura manuale del dispositivo.
Come vengono trattati i dati della carta?
Il numero di carta non entra mai nel gestionale: viene letto dal terminale POS certificato o dal modulo del gestore dei pagamenti. Il gestionale conserva solo brand, ultime quattro cifre e codice autorizzazione.
Moduli che la usano
Registratore telematico (RT) lavora insieme a questi moduli di LabBox.
Vuoi vedere Registratore telematico (RT) collegato al tuo laboratorio?
Entra nella demo con dati di esempio, senza registrarti.