INSTALLAZIONE

L’installazione dell’oBox nelle macchine è caratterizzata dalla sua facilità e dal sistema di connessione Plug&Play, a seconda del tipo di protocollo (MDB o EXE) della macchina a cui il sistema sarà collegato.

Prima di installare

1. Assicurarsi che la macchina abbia attivati gli scompartimenti Cashless dal menù della macchina.

2. Nel caso della modalità Amministratore, assicurarsi che gli scompartimenti Cashless siano attivi dal menù del restitutore di monete.

3. Assicurarsi di spegnere la macchina prima di realizzare la connessione. Quando Orain verrà connesso, accenderla di nuovo.

Connessione del dispositivo Orain

Importante:

• Il connettore piccolo deve sempre essere connesso direttamente, o alla macchina o al restitutore di monete. Si tratta della connessione di entrata.  
• Il connettore grande di uscita può essere connesso se poi segue un periferico o un restitutore, altrimenti non è necessario.

MDB

Opzione 1:

Per connettere:

• Unire il cavo 1 del box Orain, dal connettore piccolo a destra, alla macchina vending attraverso il connettore maschio MDB.
• Unire il cavo 2 del box Orain, dal connettore grande a sinistra, con il portamonete e il portafoglio attraverso la connessione MDB.

Opzione 2:

Per connettere:

• Connettere il portamonete in MDB con la macchina.
• Unire cavo 1 del box Orain, dal connettore piccolo a destra, con connettore maschio MDB al portamonete.
• Unire cavo 2 di box Orain, dal connettore grande a sinistra, con connettore femmina MDB con il portafogli.

Opzione 3:

Per connettere:

• Connettere box master device o simili (p.e. COGES Engine) in MDB con la macchina vending.
• Unire cavo 1, proveniente dal connettore piccolo del box Orain a destra, con il box master o simili attraverso il connettore maschio MDB.
• Il cavo 2, proveniente dal connettore grande del box Orain, rimane libero
• Unire il portafoglio con il box master in connessione MDB.

Opzione 4:

Per connettere:

• Connettere box master device o simili (p.e. COGES Engine) in MDB con la macchina vending.
• Unire cavo 1, proveniente dal connettore piccolo del box Orain a destra, con il box master o simili attraverso il connettore maschio MDB.
• Il cavo 2, proveniente dal connettore grande del box Orain, rimane libero.
• Unire il portafoglio con il box master in connessione MDB.

Opzione 5:

Per connettere:

• Unire master in MDB con la macchina vending.
• Unire cavo 1, proveniente dal connettore piccolo del box Orain a destra, con l’unità master attraverso il connettore maschio MDB.
• Unire cavo 2, proveniente dal connettore grande del box Orain a sinistra, con il portamonete e il portafoglio attraverso la connessione MDB.

EXE

Opzione 1:

Per connettere:

• Unire il cavo 1 del box Orain, dal connettore piccolo a destra, alla macchina vending attraverso connessione EXE.
• Unire il cavo 2 del box Orain, dal connettore grande a sinistra, con il portamonete attraverso la connessione EXE.

Opzione 2:

Per connettere:

• Unire il portamonete con la macchina in connessione EXE.
• Unire il cavo 1 del box Orain, dal connettore piccolo a destra, con il portamonete attraverso il connettore MDB.
• Il cavo 2 del box Orain, proveniente dal connettore grande a sinistra, rimane libero
• Unire il portamonete e il portafoglio attraverso il connettore MDB.

Opzione 3:

Per connettere:

• Unire portamonete con macchine in connessione EXE.
• Unire cavo 1 del box Orain, dal connettore piccolo a destra, con il portamonete attraverso il connettore MDB.
• Unire cavo 2 del box Orain, dal connettore grande a sinistra, con il portafoglio attraverso il connettore MDB.

Opzione 4:

Per connettere:

• Unire master in EXE con la macchina vending.
• Unire cavo 1, proveniente dal connettore piccolo del box Orain a destra, con l’unità master attraverso il connettore maschio MDB.
• Unire cavo 2, proveniente dal connettore grande del box Orain a sinistra, con il portamonete e il portafoglio attraverso la connessione MDB.

Opzione 5:

Per connettere:

• Unire master in Executive con la macchina vending.
• Unire cavo 1, proveniente dal connettore piccolo del box Orain, con l’unità master attraverso il connettore maschio MDB.
• Il cavo 2, proveniente dal connettore grande del box Orain, rimane libero.
• Unire il portamonete e il portafoglio con il box master in connessione MDB.

CONFIGURAZIONE

Una volta che sei un cliente Orain puoi organizzare il tuo cruscotto. Iniziate aggiungendo le vostre macchine al cruscotto, configurando i vostri prodotti e assegnando i tecnici in grado di gestire le vostre macchine.

Regitrarsi/Creare un account 

Per poter creare un account su Orain è necessario registrarsi.

1. Cliccare su “LOGIN” per registrarsi.

2. Cliccare su “Creare un account” e crearlo.

3. Una volta creato, il sistema manderà un’e-mail per confermare l’indirizzo. Bisogna confermarlo per continuare.

4. Ecco come sarà l’e-mail inviata al tuo indirizzo per la conferma. Clicca qui per confermare la registrazione dell’account.

5. Inserisci le informazioni dell’azienda

6. Adesso puoi accedere al tuo dashboard.

Aggiungere macchina 

La funzionalità “Aggiungere macchina” serve a registrare un sistema Orain (OBox) che sarà installato in una macchina. Si consiglia di realizzare questo procedimento prima di effettuare l’installazione del sistema nella macchina, in quanto, diversamente, l’utente potrà scoprire la macchina attraverso l’applicazione ma il risultato sarà quello di imbattersi in una “Macchina inagibile”.

Per aggiungere una macchina, bisogna seguire i seguenti passaggi:

1. Accedi al tuo account e, attraverso il menù principale, accedi alla sezione “Configurazione” > “Macchine”

2. Clicca sul pulsante “Aggiungere macchina”

4. Compila i campi che fanno riferimento alla configurazione della macchina:

• Identificatore di macchina: l’operatore sceglie il numero, ma normalmente è il numero interno dell’azienda che fa riferimento alla macchina.
• Nome della macchina: scrivere il nome della macchina che bisognerà apporre sulla porta della macchina per la sua identificazione. Es: “Caffè Centralino Uff. Ammin.”
• Contrassegnare ubicazione: indicare il luogo per sapere dove si trova. Esempio: “Centrale Telefonica Roma”
• Tipo: scegliere il tipo: snack, bevande od OCS
• Codice di attivazione: inserire il codice di attivazione A/C (Activation Code) dalla scatola di Orain
• Ubicazione dettagliata: cercare il luogo in cui si trova la macchina sulla mappa ingrandendo la scala e cliccando sul punto esatto.
• Immagini: caricare un logo quadrato affinché sia visibile nell’APP a sinistra del nome della macchina.

Normale:

• Valuta: scegliere la valuta.
• Numero di decimali: scegliere il numero di decimali, normalmente 2.
• Fattore di moneta (1-255): scegliere fattore di moneta, minima moneta accettata, normalmente 5 per 5 centesimi di euro.
• Timeout (Secondi): scegliere il timeout, il tempo in cui si può stare connessi senza far niente, normalmente da 12 a 20.
• Multivendita e attivare la ricarica di monete (Checkbox): se lo si desidera, scegliere l’opzione “multivendita” e “attivare ricarica di monete”.

Executive:

• Price Holding (Checkbox): “Price Holding” è necessario quando si vogliono controllare i prezzi dal sistema se questo è in modalità executive.

MDB:

• Coges MDB (Checkbox): scegliere opzioni quando connesso in MDB per “vendite negative”, in Reverse Vending quando è un “portafoglio Coges MDB”.
• Scegliere Cashless 1 o Cashless 2. Se non c’è un altro Cashless connesso, normalmente andrà con l’1.
• Scegliere il formato da 32 bit quando la macchina comunica. Es: Macchina Azkoyen sigarette.

4. Configura il numero e la capacità di corsie della tua macchina.

5. Salva

Aggiungere un ruolo

1. Entra nel sistema, clicca sul tuo profilo e, successivamente, su “amministrazione”

2. Vai alla sezione “ruoli”

3. Clicca su “aggiungere ruolo”

4. Per configurare il ruolo di tecnico, seleziona le sezioni alle quali desideri che questo tecnico possa accedere, sia del dashboard che della macchina

Aggiungere un tecnico

1. Clicca sul tuo profilo e, successivamente, su “amministrazione”

2. Vai alla sezione “tecnici”

3. Clicca su “aggiungere tecnico”

4. Scrivi l’email del tecnico e seleziona il suo ruolo

• Email: deve coincidere con l’email utilizzata dal tecnico per registrarsi sull’app. Se ancora non ha un account, deve registrarsi per poter essere assegnato come tecnico.  

• Ruolo: seleziona il ruolo desiderato. Se non disponi di nessun ruolo o se vuoi crearne uno nuovo, puoi farlo dalla finestra “ruoli” > “aggiungere ruolo”

Dall’app

1. Ora clicca sulle impostazioni

2. Chiudi sessione

3. Riapri sessione

4. Adesso vedrai la nuova opzione di “Configurazione” , che come tecnico può essere richiesta per realizzare un aggiornamento. Negli aggiornamenti successivi le funzionalità disponibili per il tecnico aumenteranno

Creare un prodotto

1. Entra nel sistema e vai su “configurazione” > “prodotti”

2. Qui troverai tutte le informazioni su ogni prodotto

• Nome
• Immagine
• Allergeni
• Unità vendute
• Entrate
• Macchine

3. Clicca su “aggiungere prodotto”

4. Compila le informazioni del prodotto. Queste informazioni verranno mostrate agli utenti delle macchine che contengono questi prodotti

• Nome del prodotto
• Avvisi: allergeni
• Tipo di prodotto
• Immagine del prodotto

Prelevare saldo 

1. Entra nel sistema e vai su “menù” > “fatturazione”

2. Clicca su “prelevare saldo”

3. Scegli il conto bancario in cui vuoi che venga versato il saldo prelevato, la quantità di saldo che vuoi prelevare e clicca su “prelevare”

Integrazione con VEGA EVA-DTS 

Questo processo spiega dettagliatamente le operazioni per attivare il Servizio Amazon SQS (servizio di accodamento messaggi) utilizzato per ricevere/inviare i dati dai sistemi di telemetria con il modulo VegaSQS.

I dati che abbiamo bisogno di ottenere con questi passaggi sono:

1. Access Key Id 
2. Secret Access Key 
3. URL delle code

Configurazione Utenti Amazon

1. Accedere ad Amazon Web Services. Se non si dispone di un account, è necessario crearlo.
   1. 1. Creazione di un account su Amazon Web Services. 

Nota: Viene richiesto un numero di carta di credito per poter creare un account. In base ai prezzi di AWS, tutti i clienti potranno inviare 1 milione di richieste gratuite da Amazon SQS al mese (Costi Servizio SQS)

LINK alla creazione di un account: https://portal.aws.amazon.com/billing/signup#/start 

Uno dei campi obbligatori è il numero di telefono, sarà necessario indicare un numero telefonico reale dato che è previsto un processo di verifica. La verifica viene realizzata ricevendo una chiamata da Amazon e inserendo nel telefono il codice che apparirà sullo schermo del computer. Quando il codice scompare dallo schermo si può terminare la chiamata. 

Una volta completata la registrazione fare click su “sign in” e accedere all’account appena creato.

2. Il primo passo è creare gli utenti che utilizzeranno il servizio. Per farlo è necessario selezionare il servizio IAM (Identity and Access Management), scrivendo “IAM” nel motore di ricerca della pagina.

3. Aggiungere utenti. Fare click su “users” > “add user”

Si devono creare due utenti, uno utilizzato dal sistema di telemetria e l’altro dal modulo VegaSQS. 

Inserire “User Name”, fare click nel checkbox “Programmatic Access” e andare al passaggio successivo (Next Permission)

4. Configurare la policy. Fare click su “Attach existing policies directly” e utilizzare la barra di ricerca per scrivere “AmazonSQSFullAccess”, selezionare il checkbox alla sinistra e fare click su “Next Permission”.

5. Completando questo processo, l’utente verrà generato con le credenziali di accesso “Access Key ID” (a) e “Secrete Access key” (b), codici che saranno necessari da aggiungere nei campi di configurazione di VEGA. 

Questi ultimi possono essere scaricati da un file facendo click su Download .csv.

Questo è un esempio del contenuto del file csv scaricato:

User name,Password,Access key ID,Secret access key,Console login link CUSTOMER1,,AKIAJZYTSCCKMPFK4IJQ,xSDbfD/OeHgcxH/vi+XO+e9+LPXW94q5e5aVPVLu,https://674543845281.signin.aws.amazon.com/console

NOTA: Ricorda che si devono creare due utenti diversi, il processo di creazione è identico

Creazione di Code di invio di Dati

L’invio di dati avviene tramite il servizio di accodamento di messaggi (Amazon SQS)

1. Fare click su “Servizi” e utilizzare la barra di ricerca per selezionare “SQS”

2. Fare click su “get started now”

3. Creare code. Bisogna creare le seguenti code con i seguenti nomi 

• “XXXXX_FROM_VEGA”. Utilizzato dal sistema di telemetria per inviare i dati a Vega 
• “XXXXX_TO_VEGA”. Utilizzato da Vega per inviare i dati al sistema di telemetria 

Dove “XXXXX” identifica il nome del cliente, nel nostro esempio indichiamo “CUSTOMER1”.

4. Assicurarsi di aver selezionato EndPoint “Ireland” che identifica il server in cui verrà creata la coda. Per selezionarlo fare click nella lingua attuale del menu superiore e selezionare EU (Ireland). Per problemi tecnici al momento non è possibile selezionare l’Endpoint di Francoforte.

5. Fare click su “Quick create queue” e crea un’altra coda

6. Selezionare le due code create, fare click su “queue actions” > “queue configuration” e scrivere “Receive Messagge Wait”=20. 

Questo valore si indica in secondi ed è il massimo tempo d’attesa prima che il sistema risponda alla chiamata in assenza di dati nella coda. Quando VegaSQS chiede al servizio se ci sono messaggi da elaborare, in assenza di messaggi aspetta 20 secondi prima di generare un timeout. Questo permette una riduzione considerevole dell’utilizzo delle risorse. 

7. Copiare le URL (c) ottenute nel processo di configurazione 

Esempio di 2 URL delle code create:

https://sqs.eu-west- 1.amazonaws.com/674543845281/CUSTOMER1_TO_VEGA 

https://sqs.eu- west-1.amazonaws.com/674543845281/CUSTOMER1_FROM_VEGA 

Nota: Utilizzare sempre il protocollo HTTPS Configuracion VegaSQS

Configuracion VegaSQS 

Il programma VegaSQS comprende la funzione di inviare dati tra le code create e il DB-Oracle de Vega.

Configurazione: bisogna configurare i parametri d’accesso al DB-Vega e al servizio SQS alla voce configurazione nel menu popup. (tasto destro sull’icona)

GUIDA PER L’UTENTE

Attraverso il cruscotto è possibile analizzare tutti i dati, vedere come si evolve il reddito e rimanere in contatto con gli utenti, risolvere i problemi o avere una semplice conversazione.

Con l’applicazione, gli utenti possono ricaricare il loro saldo, fare acquisti, segnalare eventuali errori o incidenti, e richiedere il rimborso per gli acquisti non riusciti.

Registrazione e primo acquisto

1. Scarica l’app

2. Registrati

3. Scopri le macchine vicino a te

4. Seleziona la macchina desiderata e premi “Connettere”

5. Ricarica il tuo saldo

6. Seleziona il tuo prodotto nella macchina