🔌 Agente Hardware e Cloud-Failover¶
In modalità cloud la cassa funziona su {name}.next.dikas.de — l'hardware vero e proprio
(terminale EC, stampante scontrini) si trova invece nel locale. L'agente hardware crea
questo ponte: un programma leggero nella rete del locale che esegue pagamenti e stampe in locale
ed è comandato tramite una connessione in uscita verso la cloud. Così l'hardware funziona
anche quando la cassa non gira più in locale, ma nella cloud.
Chi ne ha bisogno?
Le sedi che gestiscono la propria cassa (temporaneamente o stabilmente) nella cloud, ma utilizzano dispositivi locali. Le casse gestite in modo puramente locale parlano direttamente con il proprio hardware e non hanno bisogno dell'agente. Vedi anche Cloud e macchina locale.
Chi può fare da agente?¶
L'agente hardware è già integrato nelle app dei dispositivi DiKAS — non serve installare nulla di extra:
| Host | Piattaforma | Ruolo |
|---|---|---|
| Appliance DikasArch | Mini-PC (Arch Linux, kiosk Electron) | Cassa e agente hardware in uno |
| DiKAS Mobile | Android (app MAUI) | Cassa mobile con funzione di agente |
| DiKAS Geräte-Agent | Tablet Android | puro agente hardware (senza interfaccia di cassa) |
Ogni dispositivo nella rete del locale può fare da agente. Se ce ne sono più collegati, uno se ne occupa; se questo si guasta, gli altri continuano a servire.
Cosa passa attraverso l'agente?¶
| Funzione | Tramite l'agente |
|---|---|
| Pagamento con carta EC (ZVT) | ✓ Pagamento, storno, accredito, chiusura cassa — al terminale di rete |
| Stampa scontrini/documenti (ESC/POS) | ✓ su stampante scontrini di rete oppure stampanti USB/seriali collegate localmente |
| Ricerca dispositivi in rete | ✓ trova terminali e stampanti nella rete del locale |
| Stampa documenti A4 (CUPS) | ✓ tramite il bridge stampante locale dell'appliance |
| Firma TSE | ✗ — la TSE resta legata alla cassa locale (o Cloud-TSE), vedi TSE |
Diretto vs. agente — automatico
Se il server raggiunge il dispositivo direttamente in rete (funzionamento locale), DiKAS lo contatta direttamente. Se la cassa è nella cloud e un agente è collegato, tutto avviene automaticamente tramite l'agente — senza dover cambiare nulla nell'uso quotidiano.
Abbinamento (Pairing)¶
L'agente si connette da sé alla cloud (in uscita, compatibile con il NAT — non serve alcuna apertura di porte). L'autenticazione avviene per mandante tramite un segreto derivato dalla licenza.
- Appliance DikasArch: si abbina automaticamente — conosce il proprio mandante dalla licenza
e ricava da sé l'indirizzo cloud (
{name}.next.dikas.de) e il segreto di abbinamento. - Tablet/Mobile: abbinamento tramite codice QR dall'area Admin (indirizzo cloud + segreto).
Lo stato della connessione (dispositivi collegati) è visibile nell'area Admin sotto Impostazioni → Hardware → Agente Hardware.
Cloud-Failover: il server locale si guasta¶
Se il server di cassa locale va offline (interruzione di corrente, rete, guasto), l'attività deve poter continuare. DiKAS riconosce il guasto e propone il passaggio alla cloud:
- La cassa verifica regolarmente se il server locale è raggiungibile.
- Se questo si guasta e la cloud è raggiungibile, in basso compare un avviso: „Server locale non raggiungibile — passare alla cloud?"
- Dopo la conferma, la cassa carica l'indirizzo cloud
{name}.next.dikas.de. Le impostazioni locali (postazione di lavoro, assegnazione stampante/terminale) vengono riprese, il nome utente è precompilato — basta accedere di nuovo. - L'hardware continua a funzionare: il pagamento EC e la stampa scontrini passano ora attraverso l'agente hardware, che continua a funzionare indipendentemente dal server di cassa. Le stampe A4 passano attraverso il bridge stampante locale.
- Quando il server locale torna disponibile, la cassa propone il ritorno alla modalità locale.
Perché l'agente sopravvive al guasto
Sull'appliance DikasArch l'agente hardware gira come servizio a sé stante, separato dal server di cassa. Se il server di cassa si blocca, l'agente resta collegato — i dispositivi restano utilizzabili in modalità cloud.
Inoltro immediato (Relay) durante il failover
L'inoltro Relay presuppone il server locale in funzione e nel failover non è quindi disponibile. La stampa locale e il pagamento EC in modalità cloud passano attraverso l'agente hardware (o il bridge stampante per l'A4).
Passare online manualmente¶
Anche senza un guasto è possibile passare dal funzionamento locale alla cloud — ad es. per continuare a lavorare in trasferta. Nel menu principale della cassa compare quindi (su appliance e mobile, non appena è noto un indirizzo cloud) la voce „Passa online". Esegue lo stesso passaggio del failover.
Domande frequenti¶
Devo installare qualcosa sull'appliance? No. L'agente fa parte del software DikasArch e si abbina automaticamente tramite la licenza.
Il pagamento EC e la stampa funzionano davvero quando il server locale è spento? Sì — tramite l'agente hardware, purché un dispositivo sia collegato nella rete del locale. La cloud deve conoscere i dispositivi (indirizzi di terminale/stampante); questi vengono trovati e salvati tramite la ricerca dispositivi.
Cosa succede se nessun agente è collegato? In modalità cloud la cassa segnala allora un errore chiaro („nessun agente hardware collegato") — EC/stampa sono di nuovo possibili solo quando un dispositivo è collegato.
I documenti vengono addebitati due volte durante il failover? No. Se il risultato di un pagamento va perso, la cassa segnala un errore invece di ripetere automaticamente il tentativo — evitando così un doppio addebito.