Vai al contenuto
v26.3

🔌 Agente Hardware e Cloud-Failover

Nel funzionamento cloud la cassa gira su {name}.next.dikas.de — la stampante per scontrini e il terminale per carte si trovano però nel locale, nella sua rete. Da internet la cloud non può entrare in quella rete: il router non lascia passare connessioni dall'esterno verso la rete del locale. L'agente hardware fa da ponte. È un programma su un dispositivo del locale che si collega alla cloud dall'interno ed esegue sul posto gli incarichi della cassa: stampare scontrini, incassare con carta, cercare dispositivi.

Chi ne ha bisogno?

Attività la cui cassa gira (temporaneamente o in modo permanente) nella cloud e che usano dispositivi nel locale: stampanti per scontrini, stampanti di cucina, terminale per carte. Se la cassa gira in locale su una DiKAS-Box, comunica direttamente con stampanti e terminale e non ha bisogno dell'agente. Vedere anche Cloud e macchina locale.

Testi in tedesco

Alcune schermate citate qui esistono solo in tedesco: la pagina dell'agente hardware e le impostazioni delle stampanti nell'area di amministrazione, la pagina Druckerstatus della cassa e l'app Android „DiKAS Agent". I loro testi sono riportati sotto in tedesco, con la traduzione tra parentesi.

Senza agente la cassa cloud non stampa nel locale

Se nessun agente hardware è collegato, la cassa cloud non invia scontrini a stampanti con un indirizzo della rete del locale (ad es. 192.168.…). Lo stato delle stampanti mostra invece „Kein Hardware-Agent verbunden" (nessun agente hardware collegato), e la stampa di prova nelle impostazioni lo segnala subito, invece di indicare "inviato". Gli scontrini restano nell'elenco dei lavori non riusciti e si possono ristampare più tardi con „Alle wiederholen" (ripeti tutti).


Quali dispositivi possono fare da agente hardware?

Dispositivo Come agente hardware Come si abbina
App „DiKAS Agent" su un tablet o smartphone Android ✓ tramite codice QR dalle impostazioni della cassa
DiKAS-Box (appliance DikasArch, mini PC) ✓ si collega da sola se l'agente hardware è configurato per la sua attività — altrimenti contatti l'assistenza
App DiKAS (cassa su Android) ✗ —
Client Windows DiKAS (DiKAS-Client-Setup.exe) ✗ —
Browser su PC o tablet ✗ —

Il dispositivo agente deve trovarsi nella stessa rete delle stampanti e del terminale per carte, restare acceso e avere internet. Un tablet che la sera viene portato a casa non è quindi adatto come unico agente.

L'agente hardware deve essere configurato per la sua attività

Lo riconosce da una scheda apposita: Impostazioni → Hardware → Agente hardware. Se questa scheda manca, l'agente hardware non è configurato per la sua attività — si rivolga all'assistenza DiKAS. La scheda è visibile solo agli amministratori.


Cosa passa attraverso l'agente?

Funzione Tramite l'agente
Pagamento con carta (ZVT) ✓ pagamento, storno, accredito, chiusura terminale — sul terminale di rete nel locale
Stampa scontrini e cucina (ESC/POS) ✓ verso stampanti per scontrini di rete nella rete del locale
Ricerca dispositivi ✓ „Drucker suchen" (cerca stampanti) e la ricerca terminali esplorano la rete del locale
Stampa documenti A4 ✗ — su una DiKAS-Box la cassa stampa l'A4 direttamente tramite la box; altrimenti il PDF si apre nel browser per la stampa
Firma TSE ✗ — la TSE resta legata alla cassa locale (o TSE cloud), vedere TSE

Diretto o tramite l'agente — automaticamente

Se la cassa gira in locale, DiKAS comunica direttamente con i dispositivi. Se gira nella cloud e un agente è collegato, gli incarichi passano automaticamente tramite l'agente — nell'uso non c'è nulla da commutare.


Configurazione

App „DiKAS Agent" su un dispositivo Android

  1. Installare l'app „DiKAS Agent" — la riceve dall'assistenza DiKAS.
  2. Sulla cassa, come amministratore, aprire Impostazioni → Hardware → Agente hardware. Lì si trovano l'indirizzo cloud („Cloud-Adresse"), il segreto di abbinamento („Kopplungs-Secret") e un codice QR.
  3. Nell'app scegliere il ruolo „Hardware-Agent (Kasse: ZVT/Druck)".
  4. Toccare „Per QR koppeln" (abbina tramite QR) e scansionare il codice QR sullo schermo della cassa. Indirizzo cloud e segreto vengono acquisiti. In alternativa inserire entrambi a mano e toccare „Speichern & Verbinden" (salva e collega).
  5. L'app mostra „Verbunden ✓" (collegato). Nelle impostazioni della cassa lo stato indica ora „1 Gerät verbunden" (1 dispositivo collegato).

Il segreto vale per tutta la sua attività

Chi conosce il segreto di abbinamento può collegare un dispositivo come agente hardware della sua attività. Non lo divulghi e mostri il codice QR solo durante la configurazione.

Si possono abbinare più dispositivi. Se uno si guasta, subentra un altro (vedere Più dispositivi: il master).

DiKAS-Box

Una DiKAS-Box si collega da sola alla cloud se l'agente hardware è configurato per la sua attività. Sulla box non c'è nulla da inserire. Se lo stato nelle impostazioni mostra „Kein Gerät verbunden" (nessun dispositivo collegato) nonostante la box sia in funzione, si rivolga all'assistenza DiKAS.

Perché l'agente sulla box sopravvive a un guasto del server

Sulla DiKAS-Box l'agente hardware gira come servizio a sé, separato dal server di cassa. Se il server di cassa si blocca, l'agente resta collegato — stampanti e terminale per carte restano utilizzabili nel funzionamento cloud (vedere Cloud-Failover).

Verificare che tutto funzioni

In Impostazioni → Hardware → Agente hardware lo stato mostra:

Indicazione Significato
„1 Gerät verbunden" / „2 Geräte verbunden" (1 / 2 dispositivi collegati) L'agente è pronto. Stampe e pagamenti con carta dalla cloud passano tramite lui.
„Kein Gerät verbunden" (nessun dispositivo collegato) Nessun agente raggiungibile — accendere il dispositivo, controllare rete e internet, aprire l'app.
„Nicht eingerichtet" (non configurato) Manca la configurazione per la sua attività — contatti l'assistenza DiKAS.

Lo stato si aggiorna da solo. Quando si scollega l'ultimo dispositivo, „Kein Gerät verbunden" compare solo dopo circa 20 secondi — così una breve interruzione non provoca un falso allarme.


Configurare le stampanti quando la cassa gira nella cloud

Le stampanti si configurano come di consueto in Impostazioni → Hardware → Stampanti (in dettaglio: Hardware → Stampanti per scontrini). Nel funzionamento cloud vale inoltre:

  1. Collegare prima l'agente hardware (vedere sopra). Senza agente la cloud non trova nessuna stampante nel locale e non stampa lì.
  2. Scegliere „Drucker suchen" (cerca stampanti) — con un agente collegato viene esplorata la rete del locale. Oppure scegliere il tipo di collegamento „IP" e inserire nel campo „IP-Adresse" l'indirizzo della stampante nella rete del suo locale, con la porta, di solito 9100 — ad es. 192.168.1.50:9100. L'indirizzo si trova di solito sulla stampa di autotest della stampante o nell'elenco dispositivi del router.
  3. Salvare e avviare una stampa di prova („Testdruck"). Se nessun agente è collegato, risponde subito con „Kein Hardware-Agent verbunden …" invece di "inviato". Lo stesso vale per il test di larghezza („Breiten-Test") e per la stampa di prova nell'editor degli scontrini.

Non inserire 127.0.0.1

127.0.0.1 significa "questo stesso dispositivo". Vista dalla cloud, è il server di DiKAS — lì non c'è nessuna stampante, qualunque sia la porta (9100, 9101 …). Con un agente è il dispositivo agente stesso. Funziona solo per una stampante collegata via USB o seriale a una DiKAS-Box che sia essa stessa l'agente — a questo serve il tipo di collegamento „Lokal" con „Usb 1" fino a „Com 4". Per una stampante di rete inserire sempre il suo indirizzo nella rete del locale.

Stampanti con indirizzo pubblico

Se una stampante è raggiungibile tramite un indirizzo IP pubblico o un nome internet con inoltro delle porte, la cloud stampa lì direttamente, anche senza agente.

Cosa segnala lo stato delle stampanti

Se una stampa non riesce, in alto nella cassa compare un'icona rossa della stampante. Porta — come Menu → Stampanti — alla pagina Druckerstatus (stato stampanti). Lì, per ogni lavoro non riuscito, compare un'indicazione e, sotto in piccolo, il messaggio tecnico:

Il messaggio inizia con Cosa succede Cosa fare
„Kein Hardware-Agent verbunden" (nessun agente hardware collegato) La cassa gira nella cloud e nessun agente è collegato. Accendere il dispositivo agente nel locale, aprire l'app „DiKAS Agent" o controllare la DiKAS-Box; verificare lo stato in Impostazioni → Hardware → Agente hardware. Poi „Alle wiederholen" (ripeti tutti).
„Drucker nicht erreichbar" (stampante non raggiungibile) La stampante non risponde. È accesa e collegata alla rete? Indirizzo IP e porta (di solito 9100) in Impostazioni → Hardware → Stampanti sono corretti?
„Der Hardware-Agent hat den Auftrag erhalten …" (l'agente ha ricevuto il lavoro …) L'agente è collegato, ma la stampante non ha accettato lo scontrino. Controllare la stampante dal punto di vista del dispositivo agente: accesa, carta inserita, indirizzo corretto, nella stessa rete dell'agente.

Più dispositivi: il master

Se sono collegati più dispositivi agente, esattamente uno lavora come master: scontrini, pagamenti con carta e ricerca dispositivi vanno a questo dispositivo. Se il master si guasta, gli incarichi passano subito a un altro dispositivo collegato; se il master manca per più di circa 20 secondi, quel dispositivo diventa esso stesso master.

Ogni dispositivo agente deve raggiungere tutte le stampanti

Chi è master stampa tutti gli scontrini. Se i dispositivi agente si trovano in reti diverse o una stampante è collegata via USB a una DiKAS-Box, un altro dispositivo non raggiunge quella stampante. In questo caso abbinare solo dispositivi della stessa rete, oppure solo la box.

L'elenco dei dispositivi

In Impostazioni → Hardware → Agente hardware, sotto „Gekoppelte Geräte" (dispositivi abbinati) compare ogni dispositivo abbinato singolarmente con:

  • nome e tipo: „Windows-Kasse" (cassa Windows), „DiKAS-Box" o „Android-Gerät" (dispositivo Android),
  • „Online" o „Offline" (oppure „Gesperrt", bloccato),
  • „Master" se il dispositivo esegue in quel momento gli incarichi,
  • „(fest)" (fisso) se è stato impostato a mano come master.

Se non ne è ancora abbinato nessuno, si legge „Noch kein Gerät gekoppelt." (ancora nessun dispositivo abbinato). I dispositivi che si collegano tramite il codice QR o il segreto di abbinamento — l'app „DiKAS Agent" e la DiKAS-Box — vengono contati nello stato sopra („1 Gerät verbunden"); non compaiono singolarmente nell'elenco. Tra questi DiKAS sceglie il master da sé: il dispositivo collegato da più tempo.

Pulsante Effetto
„Als Master festlegen" (imposta come master) Questo dispositivo riceve gli incarichi finché è collegato — anche se un altro era master. Se non è collegato, subentra un altro.
„Automatisch wählen" (scegli automaticamente) Annulla l'impostazione; DiKAS torna a scegliere il master da sé.
„Sperren" (blocca) Dopo una richiesta di conferma il dispositivo viene scollegato subito. Non può più stampare né incassare e non può abbinarsi di nuovo finché non viene sbloccato. Pensato per dispositivi persi o dismessi.
„Entsperren" (sblocca) Rimuove il blocco. Il dispositivo deve poi abbinarsi di nuovo.

Una breve interruzione (sotto circa 20 secondi) non fa perdere il ruolo di master a un dispositivo dell'elenco.

Controllare l'impostazione dopo interventi di manutenzione

Un'impostazione fatta con „Als Master festlegen" può andare persa dopo interventi di manutenzione sul server. Se poi manca l'indicazione „(fest)", impostare di nuovo il dispositivo.

Solo gli amministratori vedono e modificano l'elenco dei dispositivi.


Cloud-Failover: il server locale si guasta

Se il server di cassa locale va offline (blackout, rete, guasto), l'attività deve continuare. DiKAS rileva il guasto e propone il passaggio alla cloud:

  1. La cassa verifica regolarmente se il server locale è raggiungibile.
  2. Se si guasta e la cloud è raggiungibile, in basso compare un avviso: "Server locale non raggiungibile — passare al cloud?"
  3. Dopo la conferma la cassa carica l'indirizzo cloud {name}.next.dikas.de. Le impostazioni locali (postazione, assegnazione stampanti/terminale) vengono riprese e il nome utente è già compilato — basta accedere di nuovo.
  4. L'hardware continua a funzionare se un agente hardware è collegato: pagamento con carta e stampa degli scontrini passano ora tramite l'agente, che continua a girare indipendentemente dal server di cassa. Senza agente la cassa segnala „Kein Hardware-Agent verbunden".
  5. Quando il server locale torna disponibile, la cassa propone il ritorno.

Inoltro immediato (Relay) durante il failover

L'inoltro Relay presuppone il server locale in funzione e durante il failover non è quindi disponibile. Stampa e pagamento con carta nel funzionamento cloud passano tramite l'agente hardware.


Passare online manualmente

Anche senza guasto si può passare dal funzionamento locale alla cloud — ad es. per continuare a lavorare da fuori. Per questo nel menu principale della cassa compare (con funzionamento locale, ad es. sulla DiKAS-Box o sulla cassa Windows, non appena è noto un indirizzo cloud) la voce "Passa a online". Esegue lo stesso passaggio del failover. Nell'app Android questa voce non esiste.


Risoluzione dei problemi

Cosa vede Causa Cosa fare
La cassa cloud non stampa nulla, lo stato delle stampanti mostra „Kein Hardware-Agent verbunden" Nessun dispositivo agente collegato Accendere il dispositivo agente, aprire l'app „DiKAS Agent" o controllare la DiKAS-Box; lo stato in Impostazioni → Hardware → Agente hardware deve indicare "… verbunden". Poi „Alle wiederholen".
La stampa di prova risponde subito „Kein Hardware-Agent verbunden …" Come sopra — la stampa di prova verifica prima se la strada verso la stampante è libera Collegare l'agente, poi ripetere la stampa di prova
Nelle impostazioni manca la scheda Agente hardware L'agente hardware non è configurato per la sua attività (oppure non ha effettuato l'accesso come amministratore) Accedere come amministratore; se la scheda continua a mancare, contatti l'assistenza DiKAS
„Drucker nicht erreichbar" Stampante spenta, cavo staccato, indirizzo o porta errati Accendere la stampante, controllare il cavo di rete, verificare indirizzo IP e porta (di solito 9100)
„Der Hardware-Agent hat den Auftrag erhalten, der Drucker hat ihn aber nicht angenommen" Il dispositivo agente non raggiunge la stampante, oppure la stampante ha un problema Controllare carta, coperchio, alimentazione; la stampante è nella stessa rete del dispositivo agente?
Per la stampante è indicato 127.0.0.1 (ad es. con porta da 9100 a 9108) È il dispositivo stesso, non la stampante Inserire l'indirizzo reale della stampante nella rete del locale, ad es. 192.168.1.50:9100. „Lokal" (Usb/Com) solo per stampanti collegate direttamente a una DiKAS-Box che sia l'agente
Un dispositivo risulta „Offline" nell'elenco Dispositivo spento, in standby, senza internet o app chiusa Accendere il dispositivo, controllare la rete, aprire l'app; se necessario disattivare il risparmio energetico per l'app, così che Android non la chiuda
Un dispositivo risulta „Gesperrt" e non si collega più Un amministratore lo ha bloccato Se deve tornare a lavorare: „Entsperren", poi abbinarlo di nuovo
Stato „Kein Gerät verbunden" sebbene la DiKAS-Box sia in funzione L'agente hardware non è configurato sulla box Contatti l'assistenza DiKAS

Domande frequenti

Devo installare qualcosa sulla DiKAS-Box? No. L'agente fa parte del software della box e si collega da solo non appena l'agente hardware è configurato per la sua attività.

La mia cassa Windows può fare da agente hardware? No. Il client Windows DiKAS è un'interfaccia di cassa e non comanda dispositivi per la cassa cloud. Usi una DiKAS-Box o un dispositivo Android con l'app „DiKAS Agent".

Serve un inoltro delle porte sul router? No. L'agente stabilisce il collegamento con la cloud dall'interno.

Pagamento con carta e stampa funzionano se il server locale è spento? Sì — tramite l'agente hardware, purché un dispositivo agente nel locale sia collegato. La cloud deve conoscere gli indirizzi di terminale e stampanti; vengono trovati e salvati tramite la ricerca dispositivi.

E se nessun agente è collegato? La cassa cloud segnala allora „Kein Hardware-Agent verbunden". Stampa e pagamento con carta nel locale tornano possibili solo quando un dispositivo agente è collegato. Gli scontrini non riusciti si possono poi ristampare con „Alle wiederholen".

I pagamenti con carta vengono addebitati due volte durante il failover? No. Se il risultato di un pagamento va perso, la cassa segnala un errore invece di ripeterlo automaticamente — così si evita un doppio addebito.


Prossimo passo

→ Hardware: configurare le stampanti per scontrini · Cloud e macchina locale · Pagamento con carta