Il gestionale offre la possibilità di collegarsi con il proprio registratore di cassa per contabilizzare le operazioni di vendita o resi registrate dal modulo della cassa.
In questo articolo verranno date informazioni sugli step da seguire per procedere ad una corretta installazione del registratore di cassa sul proprio MacOS.
Attenzione: ricordarsi di effettuare tutti gli step descritti all'interno del Punto Vendita dal quale verranno registrate le operazioni di cassa ed effettuate le stampe dello scontrino.
Indice degli argomenti:
- Premessa all'Installazione di un terminale nel gestionale
- 1° Step: Attivazione di una nuova installazione
- 2° Step: Scarica componenti di installazione
- 3° Step: Installazione del Gateway sul MacOS
- 4° Step: Procedura per verificare lo sviluppatore del file "bidings.node"
Premessa all'Installazione di un terminale nel gestionale
Prima di iniziare è bene che l'Utente che effettua l'installazione controlli di avere i permessi per accedere al modulo Gestione Installazioni e Configurazione Postazione di Vendita dalle Configurazioni di Sistema del Punto Vendita. (Il controllo va effettuato dall'Azienda Principale > Ruoli e Schema dei Permessi)
1° Step: Attivazione di una Nuova Installazione
- Accedere al gestionale nel Punto Vendita da cui verrà utilizzato il registratore di cassa.
- Configurazioni di Sistema > Gestione Installazioni.
Se è la prima volta che viene effettuata la registrazione di un'installazione l'elenco verrà visualizzato vuoto.
- Cliccare sul comando "+" in alto a sinistra della pagina. Si apre la finestra Nuovo Gestore Dispositivi in cui andrà inserito il nome con cui si desidera chiamare il nuovo dispositivo.
- confermare la scelta con il pulsante Conferma.
Dopo aver cliccato su Conferma la pagina si modifica, mostrando in alto a sinistra, in un campo non editabile, un Codice di Licenza che viene assegnato automaticamente dal gestionale al dispositivo appena creato.
2° Step: Scarica componenti di installazione
Per installare il registratore di cassa sono necessari due elementi:
- Il Gateway, ossia programma che permette la comunicazione tra il registratore ed il gestionale
- Il file di Licenza del Gateway.
Entrambi gli elementi sono gratuiti e scaricabili autonomamente dal proprio gestionale. Una volta scaricati va eseguita la loro installazione come descritto nel prossimo paragrafo. Dunque, prima di procedere con l'installazione, si dovrà scaricarli sulla propria macchina in questo modo:
- Dalla pagina Gestione Installazioni selezionare l'installazione da configurare presente nell'elenco
- Accedendo al dettaglio dell'installazione > Dettaglio Gestore Dispositivi, cliccare in alto a destra su Download Gateway (1) > Download Gateway per MacOS (2) e su Scarica File Licenza (3):
Cliccando sul pulsante il sistema inizia il download del Gateway e del file <license.lic> che verrà salvato sulla propria macchina. Questo file va conservato poiché richiesto nello step successivo.
3° Step: Installazione del Gateway sul MacOS
Dopo il download:
- Aprire la cartella dei downloads (in alternativa, se il download del file viene visualizzato in anteprima, raggiungere il file direttamente dalla stessa)
- Nella cartella verrà visualizzato sia il Gateway che il suo file di licenza. Fare doppio clic sul file MSDCAMacOsinstaller:
- Al clic si apre il programma di installazione del Gateway seguito da un messaggio come questo:
- Cliccare su OK
- Subito dopo, andare su Preferenze di sistema > Sicurezza e Privacy
- Cliccare in basso sul comando Open Anyway
- Potrebbe uscire un ulteriore messaggio che chiede se si è sicuri di aprire, perciò anche in quel caso cliccare su Open
- Si atterra in una finestra da cui continuare l'installazione:
- Cliccare su Continua fino alla voce Installation Type che richiederà, per continuare, di inserire la password amministratore
- Subito dopo aver inserito la password richiesta, si apre una cartella da cui aprire il documento license_picker:
- Dopo aver cliccato su license_picker il sistema chiederà di scegliere un file. Il file da scegliere sarà quello scaricato all'inizio della procedura cliccando su Scarica File Licenza dalla pagina di configurazione su MagicStore
- A conferma del buon esito dell'operazione apparirà un messaggio che cita: Procedura eseguita. Cliccare su OK
- Tornare su Preferenze di sistema > Sicurezza e Privacy
- Dalla pagina Privacy scorrere l'elenco sulla sinistra fino ad individuare la voce Accesso completo al disco (per la versione in inglese la voce sarà intitolata Full Disk Access)
- Selezionare Accesso completo disco e trascinare nell'elenco sulla sinistra un file presente nella cartella di cui sopra (la stessa che contiene license_picker) e intitolato service-osx-macos. Questa operazione farà si che il service del MacOS funzioni con il service del registratore di cassa:
- Prestare attenzione che il file trascinato risulti selezionato.
- Dopo aver trascinato il file, aprire di nuovo la cartella di cui sopra e fare doppio clic su avvia_servizio
- Si apre un foglio di testo in cui andrà nuovamente inserita la password da amministratore:
A questo punto il processo di installazione è terminato.
Se non appare alcun messaggio di errore è possibile procedere con la configurazione del terminale in base al protocollo del proprio registratore.
Per cui:
- In caso di protocollo Xon-Xoff cliccare qui per consultare la guida sulla configurazione del terminale
- In caso di protocollo ELA cliccare qui per consultare la guida sulla configurazione del terminale
Nel caso in cui, invece, all'inserimento della password apparisse un messaggio di errore come questo:
proseguire come descritto nello step successivo.
4° step: Procedura per verificare lo sviluppatore del file "bidings.node"
Visto che MagicStore non è uno sviluppatore Apple, potrebbe accadere che nell'installazione del software proveniente dal Gestionale il MacOS allerti l'Utente sul fatto che si sta cercando di aprire un file, in questo caso denominato "bidings.node", sviluppato da uno sviluppatore non Apple. In questo modo il MacOS si scarica dalla responsabilità di installare sulla macchina un'app che potrebbe contenere malware.
In realtà il file "bidings.node" non è altro che l'installazione grazie a cui avviene la comunicazione tra il broker degli scontrini ed il gestore degli scontrini. Trattandosi di un'installazione assolutamente sicura, bisogna inserire delle informazioni perchè il MacOS permetta di completare l'installazione.
Per farlo, procedere come descritto:
- Cliccare su "Annulla" in corrispondenza del messaggio dell'errore
- Dalla cartella 0.4.7 fare doppio clic su "disinstalla_servizio". Questo perchè la precedente installazione è stata bloccata. Per cui va rimossa prima di procedere con la nuova.
- Si apre una finestra di testo denominata "utente-disinstalla_servizio-sudo-80X24". In corrispondenza della voce Password inserire la password di sistema dell'amministratore. In questo modo si completa la disinstallazione del servizio.
- Aprire la finestra "Sicurezza e Privacy" > tab "Generali". In fondo alla finestra c'è un riquadro denominato "Consenti app scaricate da..." Prestare attenzione che sia selezionata la voce "App Store e sviluppatori identificati". In corrispondenza di questa voce si legge il nome del file bloccato nell'installazione (nel nostro caso bidings_node) poichè proveniente da uno sviluppatore non identificato Apple. Per sbloccare l'installazione, quindi, cliccare su "Consenti comunque".
- In questo modo è stata data l'autorizzazione ad installare l'app anche se non direttamente sviluppata da Apple.
- Riaprire la cartella 0.4.7 e cliccare di nuovo su "avvia_servizio"
- Dalla finestra di testo che si apre reinserire la password da amministratore di sistema
- Si apre una finestra di alert che specifica all'utente che l'app "bidings.node" appartiene ad uno sviluppatore non Apple, quindi non verificabile. Da qui l'Utente deve confermare la volontà di aprire l'app cliccando su "Apri".
- Al clic su "Apri" il MacOS procede in autonomia all'apertura dell'app ed all' installazione.
- Accedendo al Gestionale nel Punto Vendita > Configurazioni di Sistema> Gestione Installazioni> ricaricando la pagina si visualizza in "Stato aggiornamento"> Installato - Aggiornato.
Esistono 3 stati di aggiornamento, ciascuno identificato da uno specifico colore:
- Non Installato: Questo è lo stato di default visualizzato nella pagina prima dell'installazione del Gateway
- Installato - Aggiornato: Questo stato appare dopo aver installato il gateway corretto
- Installato - Non Aggiornato: Questo stato appare se viene installata una versione del gateway non aggiornata
Questa informazione viene visualizzata anche nella sezione "Dettaglio Gestore".
Terminata l'installazione è possibile procedere con la Configurazione del terminale in base al Protocollo del proprio registratore di Cassa.
Per cui:
- In caso di Protocollo Xon-Xoff cliccare qui per leggere la guida sulla configurazione del terminale
- In caso di Protocollo ELA cliccare qui per leggere la guida sulla configurazione del terminale