L’agente di stampa è un piccolo programma da installare sul PC della cassa, quello che ha la stampantina delle ricevute o che vede la cartella del driver del registratore di cassa. Serve quando Atlantis Evo gira su un server (per esempio una VPS in cloud) e al banco si vende dal pannello vendite dell’app: alla conferma della vendita Atlantis prepara la ricevuta, il documento o lo scontrino e li manda, attraverso il broker, all’agente della postazione, che li stampa subito.
Ogni agente porta il nome di una postazione di Atlantis e riceve solo le stampe di quella postazione. Più casse, nello stesso negozio o in negozi diversi, hanno ciascuna il proprio agente. Il gestionale usato dal desktop, anche da remoto, non passa dall’agente: l’agente lavora solo per il pannello vendite dell’app.
Come funziona
- Al banco si conferma la vendita nel pannello vendite dell’app, sulla postazione scelta (per esempio BANCO1).
- Atlantis salva la vendita e prepara la stampa: la ricevuta o il documento in PDF, con le stesse stampe di sempre, oppure le righe dello scontrino per il registratore di cassa.
- Il broker la consegna all’agente che si è collegato con il nome BANCO1, e solo a lui.
- L’agente stampa il PDF sulla stampante della postazione, senza finestre, oppure scrive i file per il driver del registratore e ne aspetta la risposta.
- L’esito torna all’app: “Stampa inviata”, oppure una finestra che spiega perché la stampa non è riuscita e cosa si può fare.
L’agente si collega con lo stesso ID installazione dell’app, cioè il codice del servizio Web API di Atlantis. Non servono porte aperte sul PC della cassa né sul router: è l’agente a collegarsi al broker, come fa il browser.
Cosa serve
- Atlantis collegato al broker con un servizio Web API attivo, con la spunta Pannello Pos (vedi “Amministrazione Web API“).
- La postazione definita in Codici Fissi per Postazione.
- Un PC Windows a 64 bit con accesso a internet e, per ricevute e documenti, la stampante installata in Windows; per lo scontrino, il driver del registratore di cassa installato e funzionante, con la sua cartella raggiungibile da quel PC (locale o di rete).
La postazione in Atlantis
In Archivi → Impostazioni → Codici fissi → Codici Fissi per Postazione l’agente usa questi campi:
| Campo | A cosa serve per l’agente |
|---|---|
| Cod. Postazione | È il nome dell’agente: va scritto uguale nella configurazione dell’agente (maiuscole e minuscole non contano). |
| Stampante Predefinita (Pos web) | La stampante del PC dell’agente su cui escono ricevute e documenti. Basta una parte del nome, purché non sia comune a due stampanti. Vuoto = stampante predefinita di Windows di quel PC. |
| Tipo stampa predefinita (Pos web) | Nessuna, Scontrino non fiscale, Documento o Registratore di cassa. Con un tipo impostato il pannello vendite stampa subito alla conferma, senza chiedere come; con Nessuna chiede ogni volta. |
| Percorso generazione files | La cartella del driver del registratore vista dal PC dell’agente, per esempio C:\Driver\Cassa oppure \\server\cassa. |
| Numero COM | Dà l’estensione dei file del driver: COM 1 → sr_dati.001. |
| Codice attivazione Driver | Il codice del driver del registratore. Senza, lo scontrino non parte: “Postazione non configurata: BANCO1 (manca il codice attivazione driver)”. |
Se la causale POS ha un suo Percorso files cassa (dati specifici della causale), per lo scontrino vale quello e non il percorso della postazione. La connessione FTP della postazione non si usa con l’agente ed è da considerare superata.
La voce Registratore di cassa nel tipo stampa predefinito fa partire lo scontrino solo se in Codici Fissi, scheda Cassa, è spuntato Attiva registratore di cassa; altrimenti il pannello chiede come stampare.
Installazione
Il programma di installazione mette l’agente in C:\atlantis\agente_stampa, con il suo Java: non serve installare altro. Durante l’installazione si possono scegliere l’icona sul desktop e Avvia l’agente all’accesso a Windows: è consigliato, così dopo un riavvio del PC le stampe arrivano senza doversi ricordare di aprirlo.
Al primo avvio l’agente non è configurato: la finestra si apre da sola con la configurazione.
Configurazione dell’agente
| Campo | Cosa scrivere |
|---|---|
| Postazione | Il Cod. Postazione di Atlantis, al massimo 40 caratteri. |
| ID installazione | L’ID installazione del servizio Web API, dalla maschera Web API di Atlantis. Si può incollare anche tutto il Link APP mobile della stessa maschera: l’agente ne ricava l’ID da solo. |
| Indirizzo broker | Già compilato (wss://ws.daobox.net:4433/ws): da cambiare solo se lo indica l’assistenza. |
Con Salva l’agente si ricollega subito con i nuovi dati. Al salvataggio possono comparire: “Indicare il codice della postazione (al massimo 40 caratteri).”, “Indicare l’ID installazione (solo lettere e cifre).”, “L’indirizzo del broker deve iniziare con wss://”. La configurazione è nel file agente.properties, nella cartella dell’agente.
La stampante
Il pulsante Stampanti… elenca le stampanti installate su quel PC, con la predefinita di Windows già selezionata. Copia nome copia il nome della stampante selezionata, da incollare nel campo Stampante Predefinita (Pos web) della postazione in Atlantis. Stampa di prova manda alla stampante selezionata un piccolo foglio (7,2 × 5 cm) con postazione e nome della stampante: serve a verificare che l’agente arrivi davvero alla stampante.
L’agente cerca prima una stampante con esattamente quel nome (maiuscole e minuscole non contano), poi una il cui nome contiene il testo indicato: “EPSON” va bene solo se sul PC c’è una sola EPSON. Il PDF viene stampato nella sua dimensione reale, in una copia, senza finestre di stampa.
Cosa succede alla conferma della vendita
Ricevuta o documentoL’agente della postazione è collegato?sìnoL’agente stampa il PDF sullastampante della postazioneAtlantis cerca la stampantesul proprio computerLa stampa riesce?La trova?sìnosìnoStampatol’app mostra”Stampa inviata”Non stampatoApri PDFRiprovaChiudiStampatosul computerdi Atlantis,come sempreNon stampatoApri PDFRiprovaChiudiIl PDF ha la stessa grafica della stampa normalee si apre nel browser del tablet o del PC.Con Atlantis su un server di solito la stampantenon c’è: senza agente si arriva al PDF.Scontrino sul registratore di cassaL’agente della postazione è collegato?sìnoL’agente scrive i file nellacartella del driver sul suo PCAtlantis cerca la cartelladel driver sul proprio computerIl driver conferma?La trova?sìnosìnoEmessonumero scontrinosalvato sullavenditaNon emessoerrore del drivero nessuna rispostaRiprova · ChiudiCome semprescambio dei filedal computerdi AtlantisNon emessocartella assentee agente spentoRiprova · ChiudiPer lo scontrino non c’è un PDF: si avvia l’agente e si usa Riprova.Prima di riprovare controllare che il registratorenon abbia già emesso lo scontrino.Lo scontrino elettronico non passa dall’agente.In tutti i casi la vendita è già salvata: la stampa si può ripetere senza rifare la vendita.
La vendita è già salvata prima della stampa: qualunque cosa succeda alla stampa, non si perde e non va rifatta. Se la stampa non riesce, l’app mostra la finestra “Vendita n. … non stampata” con il motivo e i pulsanti:
- Apri PDF (solo per ricevuta e documento): apre la stampa in PDF nel browser del tablet o del PC; da lì si può stampare con la stampa del dispositivo, salvare o inviare al cliente;
- Riprova: ripete la stampa della stessa vendita, per esempio dopo aver avviato l’agente;
- Chiudi.
Ricevuta o documento
| Situazione | Cosa succede |
|---|---|
| Agente collegato, stampante trovata | Stampa sul PC della cassa; l’app mostra “Stampa inviata”. |
| Agente collegato, stampante non trovata | “Stampante ‘EPSON’ non trovata su questo PC” (oppure “Nessuna stampante predefinita su questo PC” con il campo vuoto), con Apri PDF e Riprova. |
| Agente collegato ma non risponde in tempo | “Nessuna risposta dall’agente di stampa entro … secondi”, con Apri PDF e Riprova. |
| Agente non collegato, stampante presente sul computer di Atlantis | Stampa sul computer di Atlantis, come sempre (caso di Atlantis installato in negozio). |
| Agente non collegato, stampante assente sul computer di Atlantis | “Stampante ‘EPSON’ non trovata sul computer di Atlantis e l’agente di stampa della postazione BANCO1 non e’ collegato”, con Apri PDF e Riprova. |
Scontrino sul registratore di cassa
| Situazione | Cosa succede |
|---|---|
| Agente collegato, il driver conferma | Scontrino emesso; il suo numero viene salvato sulla vendita. |
| Il driver risponde con un errore | Il messaggio del driver, con Riprova. |
| Il driver non risponde entro 10 secondi | “File finesco.001 non trovato.”, con Riprova. |
| Il PC dell’agente non vede la cartella | “Cartella del registratore di cassa non trovata su questo PC: …”, con Riprova. |
| Agente non collegato, cartella presente sul computer di Atlantis | Scambio dei file dal computer di Atlantis, come sempre. |
| Agente non collegato, cartella assente sul computer di Atlantis | “Cartella del registratore di cassa non trovata: … Agente di stampa della postazione BANCO1 non collegato”, con Riprova. |
Per lo scontrino il messaggio compare preceduto da “Errore di stampa:”.
Prima di premere Riprova su uno scontrino, controllare il registratore. Se il driver ha emesso lo scontrino ma ha risposto tardi, Atlantis non lo sa: un nuovo tentativo emette un secondo scontrino per la stessa vendita.
Per lo scontrino non c’è un PDF: se l’agente non si può avviare, lo scontrino si emette a mano sul registratore. Lo scontrino elettronico (servizio esterno) non passa dall’agente.
L’agente parla con il driver come fa Atlantis installato sul PC della cassa: cancella le risposte vecchie, scrive sr_dati.NNN con le righe dello scontrino e sr_start.NNN con il codice di attivazione, poi aspetta fino a 10 secondi che il driver scriva finesco.NNN (riuscito) o sr_err.NNN (errore). Dal file Sr_out.NNN ricava il numero dello scontrino.
La finestra e l’icona

In alto lo stato del collegamento, sotto il registro delle ultime operazioni (le ultime 500 righe): collegamenti, stampe eseguite, scontrini, errori. In basso i pulsanti Stampanti…, Configurazione… ed Esci.
L’agente vive nella barra delle applicazioni, vicino all’orologio, con un’icona a forma di stampante e un pallino colorato:
- la X della finestra la nasconde soltanto: l’agente continua a lavorare;
- doppio clic sull’icona, oppure clic destro → Apri, riapre la finestra;
- per chiudere davvero si usa Esci, che chiede conferma: “Chiudendo l’agente le stampe di questa postazione non arriveranno piu’ alla stampante. Uscire?”;
- se è già configurato, all’avvio l’agente parte nascosto nella barra.
Se il collegamento cade (internet, riavvio del broker), l’agente si ricollega da solo: riprova dopo 5 secondi e poi a intervalli crescenti fino a un minuto, indicando “nuovo tentativo tra … s”.
Il registro completo è nei file agente0.log, agente1.log e agente2.log della cartella dell’agente (a rotazione, 1 MB ciascuno): è quello da mandare all’assistenza in caso di problemi.
Più postazioni sullo stesso PC
Un PC con due stampanti di cassa, per due postazioni, fa girare due agenti, ciascuno con la sua cartella di configurazione. Il secondo si avvia con un collegamento a agente_stampa.cmd che indica la cartella:
C:\atlantis\agente_stampa\agente_stampa.cmd --config C:\atlantis\agente_stampa\banco2
Ogni agente ha la sua finestra, la sua icona e il suo registro. Due agenti con la stessa cartella non partono: “L’agente di stampa e’ gia’ avviato con la configurazione di …”.
Due agenti con lo stesso nome di postazione si rubano il posto. L’ultimo che si collega sostituisce l’altro, che si ricollega e lo sostituisce a sua volta. Ogni postazione deve avere un solo agente.
Problemi frequenti
| Cosa si vede | Cosa fare |
|---|---|
| Da configurare | Compilare postazione e ID installazione. |
| Non collegato – “Autenticazione rifiutata dal broker” | La versione dell’agente non è accettata dal broker: rivolgersi all’assistenza. |
| Non collegato – “Troppi agenti collegati per questa installazione” | Sono già collegati 50 agenti con quell’ID installazione. |
| Collegato, ma nel registro “(Atlantis al momento non e’ collegato)” e le stampe non arrivano | Atlantis è spento o non collegato al broker, oppure l’ID installazione non è quello giusto: ricopiarlo dalla maschera Web API. |
| Stampa sulla stampante sbagliata | Il testo nel campo Stampante Predefinita (Pos web) è comune a due stampanti: scrivere il nome intero. |
| Le stampe di una cassa escono su un’altra | Due agenti hanno lo stesso nome di postazione, oppure il tablet ha scelto la postazione sbagliata. |
| Dopo un riavvio del PC non stampa più | L’agente non parte con Windows: reinstallare scegliendo Avvia l’agente all’accesso a Windows, oppure avviarlo dall’icona. |
Promemoria
- Un agente per postazione, con il nome uguale al Cod. Postazione di Atlantis; mai due agenti con lo stesso nome.
- La stampante e la cartella del registratore indicate nella postazione sono quelle del PC dell’agente, non del server.
- L’agente deve essere acceso quando si vende: la X lo nasconde, solo Esci lo chiude.
- Con un tipo stampa predefinito sulla postazione il pannello stampa subito alla conferma.
- Se la stampa non riesce la vendita è comunque salvata: Apri PDF per ricevuta e documento, Riprova quando l’agente è di nuovo collegato.
- Prima di riprovare uno scontrino, controllare che il registratore non l’abbia già emesso.
- Usare Stampa di prova dopo ogni installazione o cambio di stampante.
- In caso di problemi, il registro (agente0.log) dice cosa è successo e quando.
Vedi anche “App Mobile: vendite al banco“.