Protocollo di comunicazione Comma 6b 1.0 - pdf

Ministero dell'Economia e delle Finanze
Amministrazione Autonoma dei Monopoli di Stato
Direzione per i giochi
PROTOCOLLO DI COMUNICAZIONE COMMA 6B
10 AGOSTO 2011
Protocollo di comunicazione comma 6b
Versione 1.0
Pag. 2 di 127
10 Agosto 2011
INDICE
1. PREMESSA
6 2. GLOSSARIO
8 3. CONTESTO GENERALE
10 3.1 Messaggi dal sistema del concessionario VLT al sistema di controllo VLT
10 3.2 Messaggi dal sistema di controllo VLT al sistema del concessionario VLT
12 4. 14 AUTENTICAZIONE DEI MESSAGGI
4.1 Codice di autenticazione
14 4.2 Struttura delle chiavi
15 5. COMPRESSIONE
17 6. DESCRIZIONE DEI MESSAGGI
18 6.1 Convenzioni di Codifica
18 6.2 Separatori
20 6.3 Struttura generale del messaggio
21 6.3.1 INTESTAZIONE HTTP
21 6.3.2 MESSAGGIO APPLICATIVO
22 6.3.3 TESTATA DEL MESSAGGIO
22 6.3.4 MESSAGGIO OPERATIVO
24 6.4 Messaggi operativi inviati dal sistema del concessionario VLT al sistema di
controllo VLT
25 2
Protocollo di comunicazione comma 6b
Versione 1.0
Pag. 3 di 127
10 Agosto 2011
6.4.1 DICHIARAZIONE DI UNA NUOVA UBICAZIONE (CODICE MESSAGGIO 300) 28 6.4.2 VARIAZIONE DEI DATI DI UBICAZIONE (CODICE MESSAGGIO 301)
31 6.4.3 CESSAZIONE DI UN’UBICAZIONE (CODICE MESSAGGIO 302)
34 6.4.4 INSTALLAZIONE DI UN SISTEMA DI SALA (CODICE MESSAGGIO 303)
35 6.4.5 VARIAZIONE DI UN SISTEMA DI SALA (CODICE MESSAGGIO 304)
37 6.4.6 INSTALLAZIONE
MESSAGGIO 305)
6.4.7 SPOSTAMENTO/VARIAZIONE/MANUTENZIONE
VIDEOTERMINALE (CODICE MESSAGGIO 306)
DI
UN
APPARECCHIO
VIDEOTERMINALE
DI
UN
APPARECCHIO
42 6.4.8 CESSAZIONE DI UN SISTEMA DI SALA(CODICE MESSAGGIO 307)
6.4.9 VARIAZIONE
DEI
DATI
IDENTIFICATIVI
(CODICE
39 DI
UN
46 APPARECCHIO
VIDEOTERMINALE (CODICE MESSAGGIO 308)
47 6.4.10 CESSAZIONE DI UN APPARECCHIO VIDEOTERMINALE (CODICE MESSAGGIO
309)
49 6.4.11 INSTALLAZIONE/RIMOZIONE/ABILITAZIONE/DISABILITAZIONE DI UN
GIOCO SU UNO O PIÙ APPARECCHI VIDEOTERMINALI (CODICE MESSAGGIO
310)
51 6.4.12 RICHIESTA
DEI
DATI
IDENTIFICATIVI
DI
UN
APPARECCHIO
VIDEOTERMINALE (CODICE MESSAGGIO 311)
6.4.13 6.4.14 53 COMUNICAZIONE DI DATI SUPPLEMENTARI PER LA VERIFICA DI IDONEITÀ
DELLA SALA (CODICE MESSAGGIO 312)
54 RICHIESTA
DI UN CAMBIO DI STATO DI UN GIOCO SU UN APPARECCHIO
VIDEOTERMINALE (CODICE MESSAGGIO 313)
56 6.4.15 RICHIESTA DELLE NOTIFICHE MANCANTI (CODICE MESSAGGIO 504)
58 6.4.16 TRASMISSIONE GIORNALIERA,
(CODICE MESSAGGIO 600)
59 6.4.17 MENSILE, ANNUALE INCASSI E VINCITE
DEFINIZIONE/ ACCANTONAMENTI/EROGAZIONE
MESSAGGIO 601)
3
JACKPOT
(CODICE
65 Protocollo di comunicazione comma 6b
Versione 1.0
Pag. 4 di 127
10 Agosto 2011
6.4.18 COMUNICAZIONE DELL’UTILIZZO DEL CREDITO ANNUALE
76 6.4.19 TRASMISSIONE DEGLI
77 6.4.20 CAMBIO DI STATO DI UNO O PIÙ APPARECCHI VIDEOTERMINALI (CODICE
MESSAGGIO 701)
80 6.4.21 NOTIFICA DI RICEZIONE (CODICE MESSAGGIO 500)
6.4.22 NOTIFICA
ACCANTONAMENTI (CODICE MESSAGGIO 605)
82 DI RICEZIONE CON SEGNALAZIONE DI ERRORE
MESSAGGIO 501)
(CODICE
83 6.5 Messaggi inviati dal sistema di controllo VLT al sistema del concessionario VLT85 6.5.1 NOTIFICA DI RICEZIONE (CODICE MESSAGGIO 000)
88 6.5.2 NOTIFICA DI ERRORE (CODICE MESSAGGIO 001)
89 6.5.3 NOTIFICA DI VALIDAZIONE (CODICE MESSAGGIO 002)
92 6.5.4 NOTIFICA DI RICHIESTA EVASA (CODICE MESSAGGIO 003)
93 6.5.5 NOTIFICA
DEL CODICE IDENTIFICATIVO DEI JACKPOT E/O DI POSSIBILI
ANOMALIE RISCONTRATE (CODICE MESSAGGIO 005)
6.5.6 NOTIFICA
DEI
DATI
IDENTIFICATIVI
DI
94 UN
APPARECCHIO
VIDEOTERMINALE (CODICE MESSAGGIO 006)
6.5.7 NOTIFICA
97 DEL CODICE IDENTIFICATIVO DELL’UBICAZIONE
MESSAGGIO 008)
6.5.8 NOTIFICA
(CODICE
99 SOSPENSIONE/CANCELLAZIONE/ANNULLAMENTO
DI
SOSPENSIONE DI UN SOGGETTO DALL’ELENCO DEI SOGGETTI(CODICE
MESSAGGIO 014)
6.5.9 6.5.10 100 ABILITAZIONE/DISABILITAZIONE
(CODICE MESSAGGIO 100)
VERIFICA
DI UN APPARECCHIO VIDEOTERMINALE
101 DELL’INTEGRITÀ DEL SOFTWARE INSTALLATO SU DI UN
APPARECCHIO VIDEOTERMINALE (CODICE MESSAGGIO 101)
6.5.11 VERIFICA
102 DELL’INTEGRITA’ DEL SOFTWARE DI UNO SPECIFICO GIOCO
INSTALLATO
SU
DI
UN
MESSAGGIO 102)
4
APPARECCHIO
VIDEOTERMINALE
(CODICE
103 Protocollo di comunicazione comma 6b
Versione 1.0
Pag. 5 di 127
10 Agosto 2011
6.5.12 VERIFICA DELL’INTEGRITÀ DEL SOFTWARE INSTALLATO SU DI UN SISTEMA
CENTRALE(CODICE MESSAGGIO 103)
104 6.5.13 RICHIESTA DELLA DATA E DEL RISULTATO DELL’ULTIMA VERIFICA
DELL’INTEGRITÀ DEL SOFTWARE INSTALLATO SU DI UN APPARECCHIO
VIDEOTERMINALE (CODICE MESSAGGIO 210)
105 6.5.14 RICHIESTA DELLA DATA E DEL RISULTATO DELL’ULTIMA VERIFICA
DELL’INTEGRITÀ DEL SOFTWARE DI UNO SPECIFICO GIOCO INSTALLATO SU
DI UN APPARECCHIO VIDEOTERMINALE (CODICE MESSAGGIO 211)
106 6.5.15 RICHIESTA DELLO STATO DEI GIOCHI INSTALLATI SU DI UN APPARECCHIO
VIDEOTERMINALE (CODICE MESSAGGIO 212)
108 6.5.16 RICHIESTA DELLO STATO DI UN APPARECCHIO VIDEOTERMINALE (CODICE
MESSAGGIO 213)
110 6.5.17 RICHIESTA DELLA DATA E DEL RISULTATO DELL’ULTIMA
DELL’INTEGRITÀ DEL SOFTWARE INSTALLATO SU DI UN
CENTRALE VLT (CODICE MESSAGGIO 214)
6.5.18 RICHIESTA DEI DATI DI CONTABILITÀ(CODICE MESSAGGIO 250)
6.5.19 AUTORIZZAZIONE
AL
CAMBIO
DI
STATO
DI
UN
GIOCO
APPARECCHIO VIDEOTERMINALE (CODICE MESSAGGIO 400)
VERIFICA
SISTEMA
111 112 SU
UN
116 7. TABELLE DI DECODIFICA
117 8. ELENCO DELLE TABELLE E DELLE FIGURE
125 5
Protocollo di comunicazione comma 6b
Versione 1.0
1.
Pag. 6 di 127
10 Agosto 2011
PREMESSA
Il presente documento riporta il protocollo di comunicazione comma 6b
relativamente ai messaggi di colloquio tra il sistema del concessionario VLT
(già sistema del concessionario ) e il sistema di controllo VLT ( già sistema di
controllo ) di AAMS per la sperimentazione, l’affidamento in concessione
dell’attivazione e conduzione operativa della rete telematica di collegamento
del sistema del concessionario VLT e della rete telematica di collegamento
tra il sistema del concessionario VLT e il sistema di controllo VLT al fine di
gestire e controllare da remoto il gioco attraverso apparecchi videoterminali
collocati in ambienti dedicati.
Successivamente alla data del 30 Maggio 2012, entreranno in vigore le modifiche
al presente protocollo di comunicazione, più precisamente :
1) modifiche ai messaggi 006, 008, 300, 301, 302, 312, 601 e 701;
2) i nuovi messaggi 014, 103, 214, 250 e 605;
Successivamente alla data del 30 Maggio 2012, entreranno in vigore i codici
univoci presenti nell’Elenco unico di censimento, che dovranno essere utilizzati
per identificare le sale nel presente protocollo, in tutti i messaggi. L’utilizzo
ove presenti le sale, è quindi sia nei messaggi di cui ai punti 1) e 2) che per i
messaggi 303, 304, 305, 306, 310, 313, 600 .
Successivamente alla data del 30 Maggio 2012, entreranno in vigore i codici
univoci presenti nell’Elenco dei soggetti, per le comunicazioni previste al
messaggio 014.
I termini in grassetto corsivo utilizzati assumono il significato indicato affianco
di ciascuno di essi nelle definizioni riportate nel successivo paragrafo 2.
Il documento si articola nelle seguenti sezioni:
-
-
contesto generale, in cui s’illustrano:
•
le entità coinvolte nella comunicazione,
•
le tipologie e i flussi dei messaggi,
•
le regole che le entità devono seguire per il trattamento dei messaggi;
autenticazione dei messaggi, in cui s’illustrano:
6
Protocollo di comunicazione comma 6b
Versione 1.0
•
Pag. 7 di 127
10 Agosto 2011
le modalità di calcolo e verifica del codice di autenticazione, che fa
parte del messaggio cui si riferisce, al fine di garantire al sistema
destinatario la certezza della sua provenienza e integrità,
-
compressione, in cui s’illustrano le modalità di compressione dei messaggi
che superano una dimensione prefissata di lunghezza del messaggio;
-
descrizione dei messaggi, in cui s’illustrano le strutture dei singoli messaggi
oggetto di scambio, che riguardano:
-
-
•
dati di gioco registrati sulla banca dati del concessionario;
•
segnalazioni d’irregolarità evidenziate dall’elaborazione dei dati raccolti;
•
eventi che si verificano durante il ciclo di vita di ciascun apparecchio
videoterminale e Sistema di sala;
•
dati relativi a ciascun apparecchio videoterminale, gioco, Sistema di
sala;
•
dati relativi alle ubicazioni;
tabelle di decodifica, in cui s’illustrano le tabelle da utilizzare per
impostare il valore di tutti i campi presenti nei messaggi operativi che
presuppongono l’utilizzo di particolari codici;
elenco delle tabelle e figure, in cui s’illustrano gli elenchi di tutti i
messaggi, dei loro tracciati e delle tabelle di decodifica utilizzate per la
composizione dei messaggi stessi.
7
Protocollo di comunicazione comma 6b
Versione 1.0
2.
Pag. 8 di 127
10 Agosto 2011
GLOSSARIO
Oltre ai termini riportati nel nomenclatore unico delle definizioni, riportato
nell’atto di convenzione, nel documento sono utilizzate le seguenti definizioni:
codice identificativo di verifica(CIV), già codice identificativo AAMS, indica
il codice assegnato da AAMS e stampato sull’etichetta che il concessionario
dovrà applicare su ogni apparecchio videoterminale. Il concessionario
comunicherà al sistema di controllo VLT
il legame tra il codeid
dell’apparecchio videoterminale e il CIV tramite il messaggio d’installazione
dell’apparecchio videoterminale.
Codeid indica il codice identificativo univoco ed immutabile, assegnato
all’apparecchio videoterminale dal concessionario, utilizzando uno dei valori
disponibili tra quelli forniti da AAMS.
codice di autenticazione, indica la sequenza di caratteri ottenuta con le
modalità descritte nel paragrafo Codice di autenticazione;
Elenco dei soggetti, indica l’elenco dei soggetti che svolgono attività funzionali
alla raccolta del gioco mediante apparecchi da divertimento con vincite in
denaro (vedi G.U. n. 100 del 2-5-2011);
Elenco unico di censimento, indica l’elenco contenente gli identificativi univoci
degli esercizi, da utilizzare nei messaggi del presente protocollo e messo a
disposizione da AAMS a seguito delle dichiarazioni degli esercenti effettuate
tramite l’ Elenco dei soggetti.
messaggio applicativo, indica la parte del messaggio priva dell’intestazione
http;
messaggio operativo, indica la parte del messaggio applicativo priva del codice
di autenticazione e della testata; contiene, quindi, le informazioni che sono
effettivo oggetto di scambio tra sistema mittente e sistema destinatario;
notifica di ricezione, indica il messaggio operativo mediante il quale il sistema
destinatario comunica al sistema mittente l’avvenuta ricezione del messaggio;
notifica di validazione, indica il messaggio operativo mediante il quale il
sistema di controllo VLT di AAMS segnala al sistema del concessionario
VLT l’avvenuta ricezione e controllo del messaggio;
notifica di errore, indica il messaggio operativo mediante il quale il sistema di
controllo VLT di AAMS segnala al sistema del concessionario VLT la
8
Protocollo di comunicazione comma 6b
Versione 1.0
Pag. 9 di 127
10 Agosto 2011
presenza di errori in un messaggio operativo da questi precedentemente
inviato;
separatore, indica particolari caratteri il cui utilizzo è strettamente riservato a
separare tra loro i dati o i gruppi di dati che costituiscono il messaggio
applicativo;
sessione, indica l’intervallo di tempo che intercorre tra l’inizio e la fine della
connessione tra l’entità mittente e l’entità destinataria; in una sessione l’invio
del mittente prevede sempre una risposta da parte del destinatario;
testata, indica la parte del messaggio applicativo che contiene le informazioni
di servizio relative al messaggio stesso, necessarie a eseguirne la corretta
elaborazione.
9
Protocollo di comunicazione comma 6b
Versione 1.0
3.
Pag. 10 di 127
10 Agosto 2011
CONTESTO GENERALE
Le entità coinvolte nella comunicazione sono il sistema del concessionario
VLT e il sistema di controllo VLT di AAMS.
Lo scambio d’informazioni tra i due sistemi utilizza il protocollo di colloquio
HTTP 1.0.
I messaggi oggetto di scambio tra sistema di controllo VLT e sistema del
concessionario VLT sono suddivisi nelle seguenti tipologie:
- Invio dati, sono messaggi mediante i quali il sistema mittente trasmette dati
al sistema destinatario senza che questo ne abbia richiesto l’invio;
- Richieste, sono messaggi mediante i quali il sistema mittente richiede al
sistema destinatario la trasmissione di specifici dati;
- Risposte alle richieste, sono messaggi mediante i quali il sistema che ha
ricevuto un messaggio di tipo richieste risponde con la trasmissione di
specifici dati;
- Azioni, sono messaggi mediante i quali il sistema di controllo VLT
richiede al sistema del concessionario VLT di intraprendere determinate
azioni.
- Segnalazioni sono messaggi mediante i quali il sistema mittente segnala al
sistema destinatario eventi particolari o errori riscontrati durante le
elaborazioni effettuate.
3.1
MESSAGGI
DAL SISTEMA DEL CONCESSIONARIO
VLT
AL SISTEMA DI
CONTROLLO VLT
I messaggi inviati dal sistema del concessionario VLT al sistema di controllo
VLT sono dei seguenti tipi:
- invio dati;
- segnalazioni;
- risposte alle richieste.
La figura che segue illustra il flusso di comunicazione dei messaggi invio dati e
delle segnalazioni:
10
Protocollo di comunicazione comma 6b
Versione 1.0
Pag. 11 di 127
10 Agosto 2011
Sistema del concessionario VLT
Predisposizione del
messaggio
Sistema di controllo VLT
Ricezione del
messaggio
Invio
messaggio
Controlli
Analisi
errore
SI
Errori
Messaggio 001
notifica di errore
Acquisizione notifica
NO
Messaggio 000
notifica di ricezione
Invio
notifica
SI Errori
Controlli
NO
SI
Errori
Messaggio 001
notifica di errore
NO
Notifica di
validazione(002, 005, 006,
008,014)
Acquisizione
messaggio
Invio
notifica
SI Errori
NO
FINE OK
Figura 1 Flusso di comunicazione sistema del concessionario VLT - sistema di
controllo VLT
11
Protocollo di comunicazione comma 6b
Versione 1.0
Pag. 12 di 127
10 Agosto 2011
Il sistema del concessionario VLT trasmette un messaggio al sistema di
controllo VLT.
Il sistema di controllo VLT esegue dei controlli, contestualmente alla
ricezione.
Il sistema di controllo VLT, invia nella stessa sessione:
- un messaggio di notifica di ricezione per confermare l’avvenuta ricezione
del messaggio oppure una notifica di errore.
In caso di ricezione di notifica di errore il sistema del concessionario VLT
deve:
- analizzare la notifica di errore;
- rimuovere l’errore;
- provvedere, ove necessario, alla ritrasmissione delle informazioni.
In caso di notifica di ricezione il sistema di controllo VLT invia in un’altra
sessione:
- una notifica di validazione per confermare l’avvenuto controllo dei dati
del messaggio;
- in alternativa, un messaggio di notifica di errore .
3.2
MESSAGGI
DAL
SISTEMA
DI
CONTROLLO
VLT
AL
SISTEMA
DEL
CONCESSIONARIO VLT
I messaggi inviati dal sistema di controllo VLT al sistema del concessionario
VLT sono del seguente tipo:
- richieste di dati registrati nella banca dati di gioco del concessionario.
- segnalazioni e azioni che il concessionario deve eseguire.
Il sistema del concessionario VLT, alla ricezione del messaggio di tipo richieste
inviato dal sistema di controllo VLT, deve:
- inviare contestualmente la notifica di ricezione, altrimenti la richiesta
risulterà inevasa;
12
Protocollo di comunicazione comma 6b
Versione 1.0
-
Pag. 13 di 127
10 Agosto 2011
predisporre la risposta all’interrogazione ricevuta e inviarla entro le ore 24
dello stesso giorno della richiesta.
Il sistema di controllo VLT nella medesima sessione in cui riceve la risposta
alla sua richiesta o la notifica di ricezione con segnalazione di errore, invia la
notifica di richiesta evasa.
La figura che segue illustra il flusso di comunicazione dei messaggi di tipo
segnalazione o azioni.
Sistema del concessionario
VLT
Sistema di controllo VLT
Ricezione
segnalazione o azione
Invio
segnalazione o
azione
Predisposizione
segnalazione o azione
Invio notifica di
ricezione
Messaggio
Notifica
registrata
Invio della risposta
alla segnalazione o
della notifica di
ricezione con
segnalazione di errore
Invio risposta o
Acquisizione notifica
Notifica 003
500
Ricezione della
risposta o della
notifica
messaggio 501
Invio della notifica di
richiesta evasa
Figura 2 Flusso di comunicazione delle segnalazioni, azioni e notifiche di AAMS
Le segnalazioni di AAMS prevedono esclusivamente l’invio della notifica di
ricezione.
13
Protocollo di comunicazione comma 6b
Versione 1.0
Pag. 14 di 127
10 Agosto 2011
4.
AUTENTICAZIONE DEI MESSAGGI
4.1
CODICE DI AUTENTICAZIONE
Tutte le comunicazioni tra i due sistemi utilizzano tecniche di autenticazione
basate sulla crittografia asimmetrica.
Per motivi di sicurezza e integrità dei dati, sui messaggi da trasmettere è
eseguita una procedura di “hashing” e il ”digest” così ottenuto è crittografato
con la chiave privata di chi trasmette il messaggio e codificato base64,
determinando il codice di autenticazione.
Il destinatario, utilizzando la chiave pubblica del mittente, provvederà a
decifrare il digest e a confrontarlo con quello ottenuto applicando al messaggio
ricevuto il medesimo algoritmo di hashing; tale verifica, in caso di esito
positivo, attesta:
- la provenienza del messaggio;
- che il messaggio non è stato alterato successivamente al momento in cui il
mittente ha calcolato il codice di autenticazione.
Il sistema di controllo VLT e il sistema del concessionario VLT devono
quindi utilizzare delle funzioni che consentano il calcolo del digest da parte del
sistema mittente e la verifica dello stesso da parte del sistema destinatario.
I prodotti di riferimento per l’implementazione sono le librerie Open Source
MHASH e OPENSSL, e il formato delle chiavi private e delle chiavi pubbliche
è il PEM (Privacy Enhanced Mail).
A livello applicativo, il sistema di controllo VLT interfaccia MHASH e
OPENSSL tramite le funzioni PHP (versione: 5.2.9) mhash,
openssl_private_encrypt e openssl_public_decrypt, i cui sorgenti in linguaggio
C sono liberamente disponibili e ai quali si rimanda per i dettagli
implementativi.
Si precisa che le citate funzioni di encrypt/decrypt utilizzano il valore di
default per il quarto parametro; di conseguenza, le chiamate alle funzioni
OPENSSL di basso livello RSA_private_encrypt e RSA_public_decrypt
prevedono un “padding” di tipo RSA_PKCS1_PADDING (PKCS #1 v1.5).
14
Protocollo di comunicazione comma 6b
Versione 1.0
Pag. 15 di 127
10 Agosto 2011
E’ data facoltà al concessionario di utilizzare prodotti alternativi a quelli di
riferimento, a patto che essi siano in grado di produrre risultati equivalenti e
intercambiabili.
L’algoritmo di hashing utilizzato è MD5; se il sistema del concessionario VLT
utilizza per l’implementazione gli stessi prodotti utilizzati dal sistema di
controllo VLT, il digest si ottiene mediante la chiamata PHP
mhash(MHASH_MD5, $msg).
Per il calcolo del codice di autenticazione, i passi da seguire sono i seguenti:
1. costruire la stringa di caratteri costituita dalla testata e dal messaggio
operativo, eventualmente compresso, separati tra loro dall’apposito
separatore specificato al paragrafo 6.2;
2. applicare l’algoritmo di hashing alla stringa ottenuta con le modalità
descritte al punto precedente;
3. crittografare il digest ottenuto con la propria chiave privata;
4. codificare base64 il digest crittografato.
Il messaggio applicativo da trasmettere è costituito dal codice di
autenticazione, seguito dalla stringa calcolata con le modalità descritte al
precedente punto 1, separati tra loro dall’apposito separatore, così come
specificato al successivo paragrafo 6.2;
Per la verifica del codice di autenticazione, i passi da seguire sono i seguenti:
5. ricavare dalla testata il codice identificativo del mittente;
6. individuare, attraverso tale codice, la chiave pubblica associata al sistema
mittente;
7. decifrare il codice di autenticazione, presente nel messaggio applicativo
ricevuto, utilizzando la chiave pubblica individuata con le modalità
descritte al punto precedente;
8. applicare l’algoritmo di hashing alla stringa costituita dalla testata e dal
messaggio operativo separati tra loro dall’apposito separatore
specificato al paragrafo 6.2.
Se le due stringhe ottenute con le modalità descritte ai punti 7 e 8 coincidono, il
destinatario è certo dell’identità del mittente e dell’integrità dei dati ricevuti.
4.2
STRUTTURA DELLE CHIAVI
Il formato della chiave privata e delle chiavi pubbliche è il PEM (Privacy
Enhanced Mail).
15
Protocollo di comunicazione comma 6b
Versione 1.0
Pag. 16 di 127
10 Agosto 2011
La chiave privata è costituita da 256 bit protetta “Triplo DES” .
Il concessionario deve custodire nel sistema del concessionario VLT la chiave
pubblica di AAMS e la propria chiave privata, della quale garantisce la
riservatezza.
Il sistema di controllo VLT possiede nelle proprie banche dati le chiavi
pubbliche di tutti i concessionari.
I concessionari devono utilizzare, per garantire la sicurezza e l’integrità dei dati
nelle comunicazioni tra il sistema del concessionario VLT e il sistema di
controllo VLT, la stessa chiave prevista per lo scambio d’informazioni tra le
entità denominate sistema di elaborazione e sistema centrale nel protocollo di
comunicazione riferite ad apparecchi da intrattenimento di cui all’articolo 110,
comma 6, lettera a) del T.U.L.P.S.
16
Protocollo di comunicazione comma 6b
Versione 1.0
5.
Pag. 17 di 127
10 Agosto 2011
COMPRESSIONE
Se la lunghezza del messaggio operativo è maggiore o uguale a 1 KB (1024
caratteri), è necessario procedere alla compressione; lo standard di riferimento è
quello previsto dalla RFC 1951 “DEFLATE Compressed Data Format
Specification version 1.3”, con particolare riferimento alla libreria Open Source
ZLIB ivi citata.
La compressione non deve essere effettuata quando il messaggio operativo ha
dimensione compresa tra 1 e 1023 caratteri.
A livello applicativo, il sistema di controllo VLT interfaccia la ZLIB tramite le
funzioni PHP (versione: 5.2.9) gzdeflate e gzinflate, i cui sorgenti in linguaggio
C sono liberamente disponibili e ai quali si rimanda per i dettagli
implementativi.
Si precisa che la chiamata alla gzdeflate prevede l’impostazione del secondo
parametro al valore “1” per selezionare il livello di compressione, scelta che
garantisce il miglior compromesso tra dimensione delle stringhe prodotte e
velocità di compressione / decompressione per il tipo di applicazione
d’interesse.
E' data facoltà al concessionario di utilizzare prodotti alternativi a quelli di
riferimento, a patto che essi siano in grado di produrre risultati equivalenti e
intercambiabili.
17
Protocollo di comunicazione comma 6b
Versione 1.0
6.
Pag. 18 di 127
10 Agosto 2011
DESCRIZIONE DEI MESSAGGI
Il paragrafo descrive i contenuti dei messaggi oggetto di scambio tra il sistema
del concessionario VLT e il sistema di controllo VLT.
6.1
CONVENZIONI DI CODIFICA
La struttura dei messaggi è descritta in forma tabellare.
Ciascuna tabella è costituita dalle seguenti colonne:
- Colonna 1 – Progressivo campo: contiene un progressivo che identifica il
campo all’interno della tabella;
- Colonna 2 – Tipo: contiene il codice che definisce il tipo di campo;
- Colonna 3 – Lunghezza massima: contiene il numero di caratteri massimo
che costituiscono il campo;
- Colonna 4 – Obbl.: contiene l’indicazione se il campo è obbligatorio o
meno;
- Colonna 5 – Descrizione: contiene indicazioni sul dato da riportare nel
campo del messaggio.
- Colonna 6 – Note di compilazione: contiene indicazioni su come valorizzare
il campo.
Di seguito sono definiti i tipi di dato previsti:
Tipo
Descrizione
String
Campo
Codifica
alfanumerico
di
lunghezza ASCII
variabile
Numeric
Campo numerico intero di lunghezza ASCII
variabile
SNumeric
Campo numerico intero con segno di ASCII
lunghezza variabile
Eurocent
Campo numerico contenente valori ASCII
espressi in centesimi di euro
18
Protocollo di comunicazione comma 6b
Versione 1.0
Pag. 19 di 127
10 Agosto 2011
Tipo
Descrizione
Codifica
Dataora
Campo numerico di 12 caratteri che ASCII
contiene la data in formato AAMMGG,
seguito da ora, minuti, secondi nel
formato HHMMSS
Data
Campo numerico di 6 caratteri che ASCII
contiene la data in formato AAMMGG
Riga
Separatore
Elenco di elementi costituiti da uno o ASCII
più campi dei tipi sopra indicati
Carattere utilizzato per separare un ASCII
campo dal successivo.
Per i campi di tipo String, Numeric, SNumeric, Eurocent rappresentati in
codifica ASCII, si specifica quanto segue:
- String: può contenere tutti i caratteri ASCII con l’esclusione dei caratteri di
tipo separatore. Nel caso in cui il campo sia obbligatorio e non abbia valore
significativo occorre comunque impostare un carattere a spazio (ASCII hex
20);
- Numeric: ciascun carattere può assumere i valori da “0” a “9”. Nel caso in
cui il campo sia obbligatorio e non abbia valore significativo occorre
comunque impostarlo a “0”;
- SNumeric: il primo carattere può assumere i valori “+” o “-” e gli altri
possono assumere i valori da “0” a “9”. Se il primo carattere è diverso da
“-” il campo viene considerato positivo. Nel caso in cui il campo sia
obbligatorio e non abbia valore significativo occorre comunque impostarlo
a “0”;
- Eurocent: esprime importi in centesimi di euro con un numero variabile di
caratteri, il primo dei quali può assumere i valori “ +” o “-” e gli altri
possono assumere i valori da “0” a “9”. Se il primo carattere è diverso da
“-” il campo viene considerato positivo. Nel caso in cui il campo sia
obbligatorio e non abbia valore significativo occorre comunque impostarlo
a “0”;
Riguardo, infine, alla colonna “Obbl.”, i valori in essa contenuti assumono il
seguente significato:
- valore “S” se il campo è sempre obbligatorio;
19
Protocollo di comunicazione comma 6b
Versione 1.0
-
6.2
Pag. 20 di 127
10 Agosto 2011
valore “C” se il campo è obbligatorio in alcuni casi indicati nelle note di
compilazione, altrimenti è facoltativo;
SEPARATORI
Ciascun messaggio operativo, è composto da una o più righe.
Ciascun campo deve essere separato dal campo successivo da uno specifico
carattere di separazione.
I separatori previsti sono: “#”, “|”, “;” il loro utilizzo è riservato
all’interno di ciascuna delle parti che compongono il messaggio
applicativo, così come mostrato nella tabella che segue:
Carattere
Utilizzo
#
Separa i componenti del messaggio applicativo (codice di
autenticazione, testata, messaggio operativo)
;
Separa le righe all’interno del messaggio operativo
|
Separa i campi all’interno della testata e all’interno di ciascuna
riga del messaggio operativo
Il separatore “#” non deve essere inserito prima del codice di autenticazione e
dopo il messaggio operativo.
Il separatore “;” non deve essere inserito prima della prima riga e dopo l’ultima
riga del messaggio operativo.
Il separatore “|” non deve essere inserito prima del primo campo e dopo
l’ultimo campo della testata e prima del primo campo e dopo l’ultimo campo
di ciascuna riga del messaggio operativo.
I campi non obbligatori devono essere rappresentati con una stringa nulla
(lunghezza 0 caratteri); ne consegue che all’interno del messaggio si potranno
trovare separatori contigui.
20
Protocollo di comunicazione comma 6b
Versione 1.0
Pag. 21 di 127
10 Agosto 2011
Per non appesantire la descrizione dei messaggi operativi, le tabelle non
contengono in modo esplicito l’indicazione dei separatori.
6.3
STRUTTURA GENERALE DEL MESSAGGIO
L’insieme di caratteri che viaggiano da un sistema ad un altro possono essere
suddivisi in due componenti:
- intestazione http;
- messaggio applicativo.
6.3.1
INTESTAZIONE HTTP
Le intestazioni HTTP hanno numerosità e lunghezza variabili e sono separate
dal messaggio applicativo dalla sequenza CRLFCRLF dove CR = carriage
return (ASCII hex 0D) e LF = line feed (ASCII hex 0A).
Al fine di minimizzare i dati scambiati, l’invio delle informazioni dal sistema
del concessionario VLT verso il sistema di controllo VLT utilizza il metodo
POST, indirizzato alla URL /vlt, con le sole intestazioni HTTP indispensabili:
POST /vlt HTTP/1.0
Host: <IP sistema remoto>
Content-Length: <lunghezza messaggio applicativo >
Parte delle intestazioni delle risposte è impostata dal Web Server e non è
eliminabile; di conseguenza, il programma chiamante dovrà semplicemente
scartare tutto il testo precedente ed inclusivo della sequenza CRLFCRLF.
Per quanto riguarda le comunicazioni effettuate dal sistema di controllo VLT
verso il sistema del concessionario VLT, viene utilizzato lo stesso metodo
POST http; il concessionario deve comunicare la URL completa cui indirizzare
tutte i messaggi.
21
Protocollo di comunicazione comma 6b
Versione 1.0
6.3.2
Pag. 22 di 127
10 Agosto 2011
MESSAGGIO APPLICATIVO
Il messaggio applicativo è strutturato come evidenziato nella tabella che segue:
Progressivo
campo
Tipo
Lunghezza
massima
Obbl.
1
String
Variabile
S
Codice di autenticazione
2
String
Variabile
S
Testata
3
String
Variabile
C
Messaggio operativo
Tracciato
6.3.3
1
Descrizione
Struttura generale del messaggio applicativo
TESTATA DEL MESSAGGIO
Tutti i messaggi scambiati tra le parti prevedono, salvo dove esplicitamente
indicato, una testata così composta:
Progressivo
campo
Tipo
Lunghezza
massima
Obbl.
Descrizione
1
Numeric
15
S
Codice identificativo del messaggio applicativo
2
Numeric
3
S
Codice identificativo del messaggio operativo
3
Numeric
6
S
Lunghezza del messaggio operativo prima della
compressione
4
String
1
S
Codice identificativo del mittente
Tracciato
2
Testata del messaggio
Il contenuto dei campi indicati nella tabella dipende da quale sistema
trasmesso il messaggio. In particolare:
-
ha
Campo 1, contiene l’identificativo del messaggio applicativo. Il formato è il
seguente:
22
Protocollo di comunicazione comma 6b
Versione 1.0
Pag. 23 di 127
10 Agosto 2011
<ggg><aa><nnnnnnnnnn>
dove
−
<ggg> rappresentata il progressivo numerico del giorno all’interno
dell’anno (giorno giuliano). Ad esempio, il primo gennaio, è valorizzato
con “001”, il primo febbraio è “032”, 25 settembre è “268”. Bisogna
inoltre tener conto negli anni bisestili del giorno 29 febbraio in questo
caso il primo marzo sarà il giorno “061”.
−
<aa> rappresenta le ultime due cifre dell’anno
−
<nnnnnnnnnn> codice numerico. L’identificativo (progressivo del
giorno + anno + codice numerico) deve essere univoco per
concessionario e per il sistema di controllo VLT.
Per i messaggi di tipo invio dati, richiesta o segnalazione, il contenuto del
campo deve essere generato dal sistema mittente ed identifica univocamente
il messaggio applicativo.
Per i messaggi di notifica, azione o risposta alla richiesta, il contenuto del
campo deve essere valorizzato con lo stesso valore contenuto nella testata
del messaggio a cui fa riferimento la notifica o la risposta alla richiesta.
-
-
Campo 2, contiene il codice dei messaggi operativi ricavato:
−
dalle tabelle specificate nel paragrafo 6.4, nel caso in cui il messaggio sia
stato trasmesso dal sistema del concessionario VLT;
−
dalle tabelle specificate nel paragrafo 6.5, nel caso in cui il messaggio sia
stato trasmesso dal sistema di controllo VLT;
Campo 3, contiene la lunghezza del messaggio operativo prima della
compressione. Il valore contenuto in tale campo deve essere utilizzato per
capire se il messaggio è compresso.
La lunghezza massima per un singolo messaggio operativo è di 999.999
byte.
I messaggi trasmessi dal sistema del concessionario VLT contenenti un
messaggio operativo avente lunghezza superiore al valore massimo, non
saranno elaborati dal sistema di controllo VLT.
Qualora il sistema del concessionario VLT debba effettuare l’invio di un
messaggio operativo con lunghezza maggiore, dovrà frazionare in più
messaggi operativi le informazioni, mantenendo comunque tutte le righe e
tutti i campi della struttura prevista, e procedere alla trasmissione di più
messaggi aventi nel campo 1 della testata identificativi distinti.
23
Protocollo di comunicazione comma 6b
Versione 1.0
Pag. 24 di 127
10 Agosto 2011
Qualora invece la risposta del sistema del concessionario VLT ad una
richiesta del sistema di controllo VLT comporta un messaggio operativo
con lunghezza superiore al valore massimo, il sistema del concessionario
VLT risponderà che la richiesta non può essere evasa.
Se il campo è uguale a 0 (zero), il messaggio operativo non è presente.
-
6.3.4
Campo 4, contiene:
−
il codice identificativo del concessionario mittente, assegnato al
concessionario da AAMS all’atto della stipula della concessione, nel caso
in cui il messaggio sia stato trasmesso dal sistema del concessionario
VLT;
−
“0”, nel caso in cui il messaggio sia stato trasmesso dal sistema di
controllo VLT.
MESSAGGIO OPERATIVO
I messaggi operativi possono essere di tipo:
- Singolo, se è costituito da una sola riga il cui tipo, indicato nel primo campo
della riga, vale sempre “A”;
- Lista, se è costituito da più righe il cui tipo è indicato nel primo campo della
riga.
- Vuoto, se il messaggio operativo ha lunghezza nulla (cioè uguale a 0).
Nei messaggi operativi di tipo lista che contengono più righe dello stesso tipo,
il numero progressivo che identifica univocamente la riga, riportato nei
messaggi con cui il sistema di controllo VLT notifica l’esito dei controlli,
viene calcolato dal sistema di controllo VLT a partire dalla riga di tipo “A”
che viene sempre identificata come la riga numero “1”.
24
Protocollo di comunicazione comma 6b
Versione 1.0
6.4
MESSAGGI
Pag. 25 di 127
10 Agosto 2011
OPERATIVI INVIATI DAL SISTEMA DEL CONCESSIONARIO
VLT
AL
SISTEMA DI CONTROLLO VLT
Il paragrafo contiene una descrizione dei messaggi operativi che il sistema del
concessionario VLT invia al sistema di controllo VLT.
La tabella che segue riporta l’elenco dei messaggi operativi
25
Protocollo di comunicazione comma 6b
Versione 1.0
Pag. 26 di 127
10 Agosto 2011
Codice
Descrizione
messaggio
300
Dichiarazione di una nuova ubicazione
301
Variazione dei dati di ubicazione
302
Cessazione dell’ubicazione
303
Installazione di un sistema di sala
304
Variazione di un sistema di sala
305
Installazione di un apparecchio videoterminale
306
Spostamento/Variazione/Manutenzione di un
apparecchio videoterminale
307
Cessazione di un sistema di sala
308
Variazione dei dati identificativi di un apparecchio
videoterminale
309
Cessazione di un apparecchio videoterminale
310
Installazione/rimozione/abilitazione/disabilitazione di un
gioco su uno o più apparecchi videoterminali
311
Richiesta dei dati identificativi di un apparecchio
videoterminale
Comunicazione di dati supplementari per la verifica di
idoneità della sala
Richiesta di un cambio di stato di un gioco su un
apparecchio videoterminale
312
313
504
Richiesta delle notifiche mancanti
600
Trasmissione giornaliera, mensile, annuale incassi e vincite
601
Definizione/Accantonamenti/Erogazione jackpot
605
Trasmissione degli accantonamenti
701
Cambio di stato di un apparecchio videoterminale
Messaggi operativi concessionario - AAMS 1
26
Protocollo di comunicazione comma 6b
Versione 1.0
Pag. 27 di 127
10 Agosto 2011
La tabella che segue riporta l’elenco dei messaggi operativi di notifica che il
sistema del concessionario VLT invia in risposta alle richieste inoltrate dal
sistema di controllo VLT:
Codice
Descrizione
messaggio
500
Notifica di ricezione
501
Notifica di ricezione con segnalazione di errore
Messaggi operativi concessionario - AAMS 2
I messaggi operativi che contengono le risposte alle richieste inoltrate dal
sistema del concessionario VLT sono descritti nel paragrafo 6.5
27
Protocollo di comunicazione comma 6b
Versione 1.0
6.4.1
Pag. 28 di 127
10 Agosto 2011
DICHIARAZIONE DI UNA NUOVA UBICAZIONE (CODICE MESSAGGIO 300)
Descrizione
Il messaggio viene utilizzato dal sistema del concessionario VLT per
trasmettere al sistema di controllo VLT i dati di una nuova ubicazione.
Nel caso l’ubicazione di destinazione non sia ancora censita nella banca dati
del sistema di controllo VLT, a seguito di esito positivo dei controlli, viene
restituita una notifica di validazione (Codice messaggio 008) contenente il
codice identificativo dell’ubicazione assegnato da AAMS.
Si precisa che, quando sarà reso disponibile l'Elenco unico di censimento e
successivamente al 30 Maggio 2012, il messaggio servirà esclusivamente per il
censimento dei nuovi magazzini.
Tipo di messaggio
Singolo: contiene i dati d’ubicazione.
Struttura
28
Protocollo di comunicazione comma 6b
Versione 1.0
Pag. 29 di 127
10 Agosto 2011
Progressivo
campo
1
Tipo
String
Lunghezza
massima
1
Obbl.
S
Descrizione
Tipo riga
2
3
String
Numeric
16
2
S
S
4
String
50
S
Codice fiscale
Tipo ubicazione
Nome
commerciale
dell'ubicazione
5
6
7
Numeric
String
String
3
40
7
S
S
S
Toponimo
Indirizzo
Numero civico
8
String
5
S
CAP
9
10
String
String
2
60
S
S
Provincia
Comune
11
String
4
S
12
Numeric
5
C
Codice catastale
Superficie del
locale
Tracciato
3
Note di compilazione
Vale “A”
Codice fiscale del titolare
dell’ubicazione
Vedi Tabella 1
Indicare un codice
toponimo fra quelli riportati
nella tabella presente sul
sito di AAMS
Nome della via, piazza,…
CAP del comune di
ubicazione
Provincia del comune di
ubicazione
Comune di ubicazione
Codice Catastale del
comune di ubicazione
Metri quadrati
Messaggio 300
Note di compilazione
− Campo 3
Il valore deve essere rilevato dalla Tabella 1
Tipi d’ubicazione
− Campo 12
E’ valorizzato solo se il campo 3 è diverso da 9
(Magazzino).
29
Protocollo di comunicazione comma 6b
Versione 1.0
Pag. 30 di 127
10 Agosto 2011
Si precisa che, quando sarà reso disponibile l'Elenco unico di censimento e
successivamente al 30 Maggio 2012, il tracciato del messaggio sarà sostituito come
segue:
Progressivo
campo
1
Tipo
String
Lunghezza
massima
1
Obbl.
S
Descrizione
Tipo riga
2
3
String
Numeric
16
2
S
S
4
String
60
S
Codice fiscale
Tipo ubicazione
Nome
commerciale
dell'ubicazione
5
6
7
Numeric
String
String
3
40
7
S
S
S
Toponimo
Indirizzo
Numero civico
8
String
5
S
CAP
9
10
String
String
2
40
S
S
Provincia
Comune
11
String
4
S
12
Numeric
5
C
Codice catastale
Superficie del
locale
Tracciato
4
30
Messaggio 300
Note di compilazione
Vale “A”
Codice fiscale del titolare
dell’ubicazione
Vedi Tabella 1
Indicare un codice
toponimo fra quelli riportati
nella tabella presente sul
sito di AAMS
Nome della via, piazza,…
CAP del comune di
ubicazione
Provincia del comune di
ubicazione
Comune di ubicazione
Codice Catastale del
comune di ubicazione
Metri quadrati
Protocollo di comunicazione comma 6b
Versione 1.0
6.4.2
Pag. 31 di 127
10 Agosto 2011
VARIAZIONE DEI DATI DI UBICAZIONE (CODICE MESSAGGIO 301)
Descrizione
Il messaggio viene utilizzato dal sistema del concessionario VLT per
comunicare la variazione dei dati di un’ubicazione già censita nella banca dati
del sistema di controllo VLT. I dati comunicati sono quelli che subiscono una
variazione.
Come data di variazione si assume la data di ricezione del messaggio sul sistema
di controllo VLT.
Si precisa che, quando sarà disponibile l'Elenco unico di censimento e
successivamente al 30 Maggio 2012, il messaggio servirà esclusivamente per il
censimento dei nuovi magazzini.
Tipo di messaggio
Singolo: contiene i dati d’ubicazione.
31
Protocollo di comunicazione comma 6b
Versione 1.0
Pag. 32 di 127
10 Agosto 2011
Struttura
Progressivo
campo
1
Tipo
String
Lunghezza
massima
1
Obbl.
S
Descrizione
Tipo riga
2
String
16
C
Codice fiscale
3
4
String
Numeric
12
2
S
C
5
String
50
C
Id ubicazione Codice rilasciato da AAMS
Tipo ubicazione
Vedi Tabella 1
Nome
commerciale
dell'ubicazione
6
7
8
Numeric
String
String
3
40
7
C
C
C
Toponimo
Indirizzo
Numero civico
9
String
5
C
CAP
10
11
String
String
2
60
C
C
Provincia
Comune
12
String
4
C
Codice catastale
Tracciato
5
Note di compilazione
Vale “A”
Codice fiscale del titolare
dell’ubicazione
Indicare un codice
toponimo fra quelli riportati
nella tabella presente sul
sito di AAMS
Nome della via, piazza,…
CAP del comune di
ubicazione
Provincia del comune di
ubicazione
Comune di ubicazione
Codice Catastale del
comune di ubicazione
Messaggio 301
Note di compilazione
− Campo 2
Codice fiscale del nuovo titolare.
− Campi 4 – 12 Nel caso in cui le informazioni da variare sono riferite ad
una sala , il messaggio deve essere inviato necessariamente prima che venga
emesso il certificato di idoneità della sala.
Si precisa che, quando sarà disponibile l'Elenco unico di censimento e
successivamente al 30 Maggio 2012, il tracciato del messaggio sarà sostituito come
segue:
32
Protocollo di comunicazione comma 6b
Versione 1.0
Pag. 33 di 127
10 Agosto 2011
Progressivo
campo
1
Tipo
String
Lunghezza
massima
1
Obbl.
S
2
String
16
C
3
4
String
Numeric
12
2
S
C
5
String
60
C
Descrizione
Tipo riga
Codice fiscale
Codice
identificativo
dell'ubicazione Codice rilasciato da AAMS
Tipo ubicazione
Vedi Tabella 1
Nome
commerciale
dell'ubicazione
6
7
8
Numeric
String
String
3
40
7
C
C
C
Toponimo
Indirizzo
Numero civico
9
String
5
C
CAP
10
11
String
String
2
40
C
C
Provincia
Comune
12
String
4
C
Codice catastale
Tracciato 6
33
Note di compilazione
Vale “A”
Codice fiscale del titolare
dell’ubicazione
Indicare un codice
toponimo fra quelli riportati
nella tabella presente sul
sito di AAMS
Nome della via, piazza,…
Messaggio 301
CAP del comune di
ubicazione
Provincia del comune di
ubicazione
Comune di ubicazione
Codice Catastale del
comune di ubicazione
Protocollo di comunicazione comma 6b
Versione 1.0
6.4.3
Pag. 34 di 127
10 Agosto 2011
CESSAZIONE DI UN’UBICAZIONE (CODICE MESSAGGIO 302)
Descrizione
Il messaggio viene utilizzato dal sistema del concessionario VLT per
trasmettere al sistema di controllo VLT la cessazione di un’ubicazione.
Non si può cessare una sala se presente almeno un componente del sistema del
concessionario VLT. In tale caso è necessario spostare i componenti presso
un’altra ubicazione.
Come data della cessazione si assume la data di ricezione del messaggio sul
sistema di controllo VLT.
Si precisa che, quando sarà disponibile l'Elenco unico di censimento e
successivamente al 30 Maggio 2012, il messaggio deve essere utilizzato
esclusivamente per la cessazione dei magazzini.
Tipo di messaggio
Singolo: contiene l’identificativo dell’ubicazione da cessare.
Struttura
Progressivo
campo
1
Tipo
String
Lunghezza
massima
1
Obbl.
S
2
String
12
S
Tracciato
7
34
Descrizione
Tipo riga
Codice
identificativo
dell'ubicazione
Messaggio 302
Note di compilazione
Vale “A”
Codice rilasciato da AAMS
Protocollo di comunicazione comma 6b
Versione 1.0
6.4.4
Pag. 35 di 127
10 Agosto 2011
INSTALLAZIONE DI UN SISTEMA DI SALA (CODICE MESSAGGIO 303)
Descrizione
Il messaggio viene utilizzato dal sistema del concessionario VLT per
trasmettere al sistema di controllo VLT i dati relativi all’installazione di un
nuovo sistema di sala presso una sala.
Tipo di messaggio
Singolo: contiene i dati del sistema di sala, dell’ubicazione e del sistema di
gioco VLT.
Struttura
Progressivo
campo
1
Tipo
String
Lunghezza
massima
1
Obbl.
S
2
3
String
String
16
16
S
S
4
Numeric
10
S
Descrizione
Note di compilazione
Tipo riga
Vale “A”
Codice
identificativo del
sistema di sala
utilizzato sul
sistema di gioco
MAC ADDRESS
Codice
identificativo del
modello
Codice rilasciato da AAMS
5
Numeric
2
S
6
String
12
S
Tipo di
connessione con
il sistema di gioco
Vedi Tabella 2
Codice
identificativo dell'
ubicazione
Codice rilasciato da AAMS
S
Codice
identificativo del
sistema di gioco Codice rilasciato da AAMS
7
Numeric
Tracciato
10
8
Messaggio 303
Note di compilazione
- Campo 2
E’ il codice identificativo del sistema di sala nell’ambito del
sistema di gioco VLT
35
Protocollo di comunicazione comma 6b
Versione 1.0
-
-
Pag. 36 di 127
10 Agosto 2011
Campo 3
E’ un campo di lunghezza pari esclusivamente a 12 o 16; in
presenza di valore di lunghezza inferiore bisogna effettuare un padding a
sinistra con il carattere “0” (zero) .
Campo 4
Assegnato da AAMS in fase di collaudo del sistema di
gioco VLT.
Campo 5
Il valore deve essere rilevato dalla Tabella 2
Tipologia di collegamento
Campo 6
Codice identificativo della sala in cui viene installato il
sistema di sala.
Campo 7
Codice identificativo del sistema di gioco VLT a cui è
connesso rilasciato da AAMS in fase di collaudo.
36
Protocollo di comunicazione comma 6b
Versione 1.0
6.4.5
Pag. 37 di 127
10 Agosto 2011
VARIAZIONE DI UN SISTEMA DI SALA (CODICE MESSAGGIO 304)
Descrizione
Il messaggio viene utilizzato dal sistema del concessionario VLT per
trasmettere al sistema di controllo VLT i dati relativi alla variazione :
spostamento di un sistema di sala presso un’altra
ubicazione (sala o magazzino);
modifica del tipo di connessione;
modifica del MAC ADDRESS.
Nel caso in cui il sistema di sala viene spostato presso un'altra ubicazione,
tutti gli apparecchi videoterminali collegati al sistema di sala rimangono nella
vecchia ubicazione e si considerano connessi al sistema di gioco VLT. Il
sistema del concessionario VLT dovrà comunicare al sistema di controllo
VLT il tipo di connessione utilizzato da ogni apparecchio videoterminale
tramite l’apposito messaggio 306.
Tipo di messaggio
Singolo: contiene i dati del sistema di sala, dell’ubicazione e del sistema di
gioco VLT.
37
Protocollo di comunicazione comma 6b
Versione 1.0
Pag. 38 di 127
10 Agosto 2011
Struttura
Progressivo
campo
1
Tipo
String
Lunghezza
massima
1
Obbl.
S
2
3
String
String
16
16
C
S
Descrizione
Tipo riga
Codice
identificativo del
sistema di sala
utilizzato sul
sistema di gioco
MAC ADDRESS
Note di compilazione
Vale “A”
4
Numeric
2
C
5
String
12
S
Tipo di
connessione con
il sistema di gioco
Vedi Tabella 2
Codice
identificativo dell'
ubicazione
Codice rilasciato da AAMS
6
String
16
C
MAC ADDRESS
Tracciato
9
Nuovo MAC ADDRESS
Messaggio 304
Note di compilazione
- Campo 2
E’ il codice identificativo del sistema di sala nell’ambito del
sistema di gioco VLT
- Campo 3
E’ un campo di lunghezza pari esclusivamente a 12 o 16; in
presenza di valore di lunghezza inferiore bisogna effettuare un padding a
sinistra con il carattere “0” (zero).
- Campo 4
In caso di spostamento del sistema di sala presso un
magazzino, il campo non deve essere valorizzato. In tutti gli altri casi, il
valore deve essere rilevato dalla Tabella 2 Tipologia
di
collegamento
- Campo 5
Identificativo dell’ubicazione di destinazione.
- Campo 6
E’ un campo di lunghezza pari esclusivamente a 12 o 16; in
presenza di valore di lunghezza inferiore bisogna effettuare un padding a
sinistra con il carattere “0” (zero).
38
Protocollo di comunicazione comma 6b
Versione 1.0
6.4.6
INSTALLAZIONE
MESSAGGIO 305)
DI
Pag. 39 di 127
10 Agosto 2011
UN
APPARECCHIO
VIDEOTERMINALE
(CODICE
Descrizione
Il messaggio viene utilizzato dal sistema del concessionario VLT per
trasmettere al sistema di controllo VLT una dichiarazione d’installazione di
un apparecchio videoterminale presso una sala e un sistema di gioco VLT.
Come data d’installazione si assume la data di ricezione del messaggio sul
sistema di controllo VLT.
Come stato dell’apparecchio videoterminale al momento dell’installazione si
assume quello di acceso e abilitato al gioco.
Il codice identificativo dell’apparecchio videoterminale, rilasciato da AAMS,
deve essere usato per le comunicazioni con il sistema di controllo VLT per
identificare l’apparecchio videoterminale.
Tipo di messaggio
Singolo: contiene i dati d’installazione di un apparecchio videoterminale.
39
Protocollo di comunicazione comma 6b
Versione 1.0
Pag. 40 di 127
10 Agosto 2011
Struttura
Progressivo
campo
1
Tipo
String
Lunghezza
massima
1
Obbl.
S
2
String
15
S
3
String
11
S
Codeid
4
String
16
S
MAC ADDRESS
C
Tipo di
connessione con
il sistema di sala
Vedi Tabella 2
Tipo di
connessione con
il sistema di gioco
Vedi Tabella 2
5
Numeric
2
Descrizione
Note di compilazione
Vale “A”
Tipo riga
Codice
identificativo
dell'apparecchio
Codice utilizzato sul
videoterminale sistema del concessionario
Codice rilasciato da AAMS
6
Numeric
2
C
7
Numeric
10
S
Codice modello Codice rilasciato da AAMS
Codice
identificativo
dell'ubicazione
Codice rilasciato da AAMS
8
String
12
S
9
String
16
C
MAC ADDRESS Relativo al sistema di sala
S
S
Codice
identificativo del
sistema di gioco Codice rilasciato da AAMS
CIV
10
11
Numeric
String
10
11
Tracciato
10
Messaggio 305
Note di compilazione
- Campo 2
è il codice identificativo assegnato dal sistema di gioco.
- Campo 5 e 6 In una sala, almeno uno dei due campi deve essere
valorizzato, il valore deve essere rilevato dalla Tabella 2 Tipologia
di collegamento
- Campo 7
Codice identificativo assegnato da AAMS in fase di
collaudo del sistema di gioco VLT.
40
Protocollo di comunicazione comma 6b
Versione 1.0
-
-
-
Pag. 41 di 127
10 Agosto 2011
Campo 9
Va compilato quando l’apparecchio videoterminale viene
connesso ad un sistema di sala che farà da tramite tra l’apparecchio
videoterminale e il sistema di gioco VLT. Corrisponde al valore indicato
nel messaggio 303 relativo all’istallazione del sistema di sala .
I campi 4 e 9 definiti come MAC ADDRESS sono di lunghezza pari
esclusivamente a 12 o 16; in presenza di valore di lunghezza inferiore
bisogna effettuare un padding a sinistra con il carattere “0” (zero).
Campo 10
Rappresenta il codice identificativo, assegnato da AAMS in
fase di collaudo, del sistema di gioco VLT.
Campo 11
Rappresenta il codice identificativo di verifica (CIV)
stampato sull’etichetta e applicato in modo visibile sull’apparecchio
videoterminale.
41
Protocollo di comunicazione comma 6b
Versione 1.0
Pag. 42 di 127
10 Agosto 2011
SPOSTAMENTO/VARIAZIONE/MANUTENZIONE
VIDEOTERMINALE (CODICE MESSAGGIO 306)
6.4.7
DI
UN
APPARECCHIO
Descrizione
Il messaggio viene utilizzato dal sistema del concessionario VLT per
trasmettere al sistema di controllo VLT:
-
lo spostamento di un apparecchio videoterminale;
la variazione del
sistema di sala cui è collegato l’apparecchio
videoterminale;
le modalità di connessione dell’apparecchio videoterminale con il
sistema di gioco VLT / sistema di sala;
l’inizio e la fine della manutenzione straordinaria di un apparecchio
videoterminale .
Come data di spostamento/variazione/manutenzione si assume la data di
ricezione del messaggio sul sistema di controllo VLT.
Tipo di messaggio
Singolo
Struttura
42
Protocollo di comunicazione comma 6b
Versione 1.0
Pag. 43 di 127
10 Agosto 2011
Progressivo
campo
1
Tipo
String
Lunghezza
massima
1
Obbl.
S
Descrizione
Tipo riga
Note di compilazione
Vale “A”
2
String
11
S
Codeid
Codice rilasciato da AAMS
3
String
12
S
Codice
identificativo dell'
ubicazione
Codice rilasciato da AAMS
4
Numeric
2
C
Tipo di
connessione con
il sistema di sala
5
String
16
C
MAC ADDRESS Relativo al sistema di sala
C
Tipo di
connessione con
il sistema di gioco
6
Numeric
2
7
Numeric
10
C
8
Numeric
1
C
Tracciato
11
Vedi Tabella 2
Vedi Tabella 2
Codice
identificativo del
sistema di gioco Codice rilasciato da AAMS
1 (inizio/spostamento
apparecchio in
manutenzione);
Flag
0 (fine manutenzione)
manutenzione
Messaggio 306
Note di compilazione
- Campo 3
Codice identificativo dell’ubicazione presso la quale l’
apparecchio videoterminale viene spostato.
Lo spostamento in magazzino di un apparecchio videoterminale elimina
sempre il legame/tipo di connessione tra il sistema di sala/ sistema di
gioco VLT e l’apparecchio videoterminale.
- Campi 4 e 5 rappresentano le modalità di connessione al sistema di sala,
il valore del campo 4 deve essere rilevato dalla Tabella 2 Tipologia
di collegamento
I campi possono assumere i seguenti valori:
- entrambi non valorizzati, per indicare nessuna variazione rispetto
alla situazione attuale;
43
Protocollo di comunicazione comma 6b
Versione 1.0
Pag. 44 di 127
10 Agosto 2011
-
-
entrambi valorizzati, per indicare la variazione del sistema di sala
e della connessione tra l’apparecchio videoterminale ed il sistema
di sala;
- Campo 4 non valorizzato e Campo 5 valorizzato, per indicare
l’eliminazione del legame tra sistema di sala ed apparecchio
videoterminale;
Campo 5
Va compilato quando l’apparecchio videoterminale viene
connesso ad un sistema di sala che farà da tramite tra l’apparecchio
videoterminale e il sistema di gioco VLT. Corrisponde al valore indicato
nel messaggio 303 relativo all’istallazione del sistema di sala .
Il campo è di lunghezza pari esclusivamente a 12 o 16; in presenza di valore
di lunghezza inferiore bisogna effettuare un padding a sinistra con il
carattere “0” (zero).
-
Campi 6 e 7 rappresentano le modalità di connessione al sistema di
gioco VLT, il valore del Campo 6 deve essere rilevato dalla Tabella 2
Tipologia di collegamento
I campi possono assumere i seguenti valori solo se :
- entrambi non valorizzati, per indicare nessuna variazione rispetto
alla situazione attuale;
- entrambi valorizzati, per indicare la variazione della connessione
tra l’apparecchio videoterminale ed il sistema di gioco VLT;
- Campo 6 non valorizzato e Campo 7 valorizzato, per indicare
l’eliminazione del legame tra sistema di gioco VLT ed
apparecchio videoterminale;
-
Campo 7
Va compilato quando l’apparecchio videoterminale viene
connesso direttamente al sistema di gioco VLT e rappresenta il codice
identificativo, assegnato da AAMS in fase di collaudo, del sistema di gioco
VLT.
Campo 8
Assume il valore 1 solo nei seguenti casi :
-
•
si inizia la manutenzione su un apparecchio videoterminale.
•
si sposta un apparecchio videoterminale già in stato di
manutenzione presso un'altra ubicazione.
Nei suddetti casi, i campi 4,5,6 e 7 non devono essere valorizzati. Lo
spostamento di ubicazione di un apparecchio videoterminale in stato di
manutenzione elimina sempre il legame tra il sistema di sala e
44
Protocollo di comunicazione comma 6b
Versione 1.0
Pag. 45 di 127
10 Agosto 2011
l’apparecchio videoterminale, il tipo di connessione con il sistema di
gioco VLT rimane invariato.
Se il campo 8 assume il valore 0, segnala la conclusione di un periodo di
manutenzione. Il campo 8 non è valorizzato negli altri casi di utilizzo del
messaggio 306.
45
Protocollo di comunicazione comma 6b
Versione 1.0
6.4.8
Pag. 46 di 127
10 Agosto 2011
CESSAZIONE DI UN SISTEMA DI SALA(CODICE MESSAGGIO 307)
Descrizione
Il messaggio viene utilizzato dal sistema del concessionario VLT per
trasmettere al sistema di controllo VLT la cessazione di un sistema di sala.
Non si può cessare un sistema di sala se collegato un apparecchio
videoterminale. In tale caso è necessario eliminare i legami e comunicare al
sistema di controllo VLT le variazioni degli apparecchi videoterminali con
l’apposito messaggio 306.
Come data della cessazione si assume la data di ricezione del messaggio sul
sistema di controllo VLT.
Tipo di messaggio
Singolo: contiene l’identificativo del sistema di sala da cessare.
Struttura
Progressivo
campo
1
2
Tipo
String
Lunghezza
massima
1
Obbl.
S
Descrizione
Tipo riga
String
16
S
MAC ADDRESS
Tracciato
12
Note di compilazione
Vale “A”
Messaggio 307
Note di compilazione
- Campo 2
E’ un campo di lunghezza pari esclusivamente a 12 o 16; in
presenza di valore di lunghezza inferiore bisogna effettuare un padding a
sinistra con il carattere “0” (zero).
46
Protocollo di comunicazione comma 6b
Versione 1.0
6.4.9
VARIAZIONE
DEI
Pag. 47 di 127
10 Agosto 2011
DATI
IDENTIFICATIVI
DI
UN
APPARECCHIO
VIDEOTERMINALE (CODICE MESSAGGIO 308)
Il messaggio viene utilizzato dal sistema del concessionario VLT per
comunicare al sistema di controllo VLT l’avvenuta sostituzione del :
- MAC ADDRESS di un apparecchio videoterminale.
- Etichetta di un apparecchio videoterminale.
Come data di variazione si assume la data di ricezione del messaggio sul sistema
di controllo VLT.
Tipo di messaggio
Singolo: contiene i dati del nuovo MAC ADDRESS e/o del nuovo codice
identificativo di verifica (CIV).
Struttura
Progressivo
campo
1
Tipo
String
Lunghezza
massima
1
Obbl.
S
2
3
String
String
11
16
S
S
Codeid
Codice rilasciato da AAMS
MAC ADDRESS
4
5
6
String
String
String
16
11
11
C
S
C
7
Numeric
2
C
MAC ADDRESS
CIV
CIV
Motivo della
sostituzione
Tracciato
13
Descrizione
Tipo riga
Note di compilazione
Vale “A”
Nuovo MAC ADDRESS
Nuovo CIV
Vedi Tabella 9
Messaggio 308
Note di compilazione
- Campo 3
E’ un campo di lunghezza pari esclusivamente a 12 o 16; in
presenza di valore di lunghezza inferiore bisogna effettuare un padding a
sinistra con il carattere “0” (zero). Rappresenta il MAC ADDRESS
precedentemente segnalato e censito al sistema di controllo VLT
dell’apparecchio videoterminale indicato al campo 2.
47
Protocollo di comunicazione comma 6b
Versione 1.0
-
-
-
-
Pag. 48 di 127
10 Agosto 2011
Campo 4
E’ un campo di lunghezza pari esclusivamente a 12 o 16; in
presenza di valore di lunghezza inferiore bisogna effettuare un padding a
sinistra con il carattere “0” (zero). Rappresenta il nuovo MAC ADDRESS
dell’apparecchio videoterminale indicato al campo 2.
Campo 5
Rappresenta il codice identificativo di verifica (CIV)
dell’etichetta precedentemente applicata sull’apparecchio videoterminale
indicato al campo 2 e censito al sistema di controllo VLT.
Campo 6
Rappresenta il nuovo codice identificativo di verifica
(CIV) dell’etichetta applicata sull’apparecchio videoterminale indicato al
campo 2.
Campo 7
Rappresenta il motivo della sostituzione del codice
identificativo di verifica (CIV), il valore del campo 7 deve essere rilevato
dalla Tabella 9 Motivi di sostituzione dell’etichetta identificativa.
48
Protocollo di comunicazione comma 6b
Versione 1.0
6.4.10
CESSAZIONE
309)
Pag. 49 di 127
10 Agosto 2011
DI UN APPARECCHIO VIDEOTERMINALE
(CODICE
MESSAGGIO
Descrizione
Il messaggio viene utilizzato dal sistema del concessionario VLT per
comunicare al sistema di controllo VLT la data di cessazione di uno o più
apparecchi videoterminali.
I tipi di cessazione previsti sono:
•
Dismissione,
•
Incendio,
•
Furto,
•
Sequestro
Tipo di messaggio
Lista: contiene i dati di riepilogo e i dati di dettaglio relativi agli apparecchi
videoterminali per cui si trasmette la cessazione.
Struttura
Il messaggio è composto da più righe, così come illustrato nella tabella che
segue:
Riga
A
Descrizione
Dati di riepilogo
Occorrenze
Una per messaggio
Per ogni cessazione si ripete la seguente riga.
B
Dati di ogni apparecchio
videoterminale per cui si
comunica la cessazione.
49
Una per ogni apparecchio
videoterminale
Protocollo di comunicazione comma 6b
Versione 1.0
Progressivo
campo
1
2
Tipo
String
Pag. 50 di 127
10 Agosto 2011
Lunghezza
massima
1
String
Tracciato
11
Obbl.
S
S
14
Descrizione
Tipo riga
Totale degli
apparecchi
videoterminali
cessati
Il numero totale degli
apparecchi per cui si
trasmette la cessazione
Messaggio 309 Riga A
Progressivo
campo
1
Tipo
String
Lunghezza
massima
1
Obbl.
S
Descrizione
Tipo riga
2
String
11
S
Codeid
3
Date
6
S
4
Numeric
2
S
Tracciato
Note di compilazione
Vale “A”
15
Note di compilazione
Vale “B”
Codice rilasciato da AAMS
Data di avvenuta
Data cessazione
cessazione
Motivo della
cessazione
Vedi tabella 8
Messaggio 309 Riga B
Note di compilazione
- Campo 4
Il valore deve essere rilevato dalla Tabella 8
Motivi di cessazione di un apparecchio videoterminale
50
-
Protocollo di comunicazione comma 6b
Versione 1.0
6.4.11
Pag. 51 di 127
10 Agosto 2011
INSTALLAZIONE/RIMOZIONE/ABILITAZIONE/DISABILITAZIONE DI UN GIOCO
SU UNO O PIÙ APPARECCHI VIDEOTERMINALI (CODICE MESSAGGIO 310)
Descrizione
Il messaggio viene utilizzato dal sistema del concessionario VLT per
trasmettere al sistema di controllo VLT l’installazione/rimozione e
abilitazione/disabilitazione di un gioco su :
un singolo apparecchio videoterminale.
tutti gli apparecchi videoterminali di un sistema di gioco.
tutti gli apparecchi videoterminali di una determinata
sala.
Come data dell’azione si assume la data di ricezione del messaggio sul sistema
di controllo VLT.
Tipo di messaggio
Singolo: contiene l’operazione da eseguire sul gioco.
Struttura
Progressivo
campo
1
Tipo
String
Lunghezza
massima
1
Obbl.
S
2
Numeric
10
S
3
String
1
C
Descrizione
Note di compilazione
Tipo riga
Vale “A”
Codice
identificativo del
gioco
Codice rilasciato da AAMS
Azione
1(Installato) /
0(Rimosso)
1(Abilitazione) /
0(Disabilitazione)/
4
String
1
C
5
String
11
C
6
String
12
C
Tracciato
16
51
Azione
Codeid
Codice rilasciato da AAMS
Codice
identificativo dell'
ubicazione
Codice rilasciato da AAMS
Messaggio 310
Protocollo di comunicazione comma 6b
Versione 1.0
Pag. 52 di 127
10 Agosto 2011
Note di compilazione
- Campo 3
Il valore che può assumere il campo è:
o 1 (uno) in caso di installazione del gioco sull’apparecchio
videoterminale;
o 0 (zero) in caso di rimozione del gioco dall’apparecchio videoterminale;
- Campo 4
Il valore che può assumere il campo è:
o 1 (uno) in caso di abilitazione del gioco sull’apparecchio videoterminale;
o 0 (zero) in caso di disabilitazione dell’offerta del gioco pur rimanendo esso
installato sull’apparecchio videoterminale ;
- Campo 5
Codice identificativo dell’apparecchio videoterminale su
cui viene effettuata l’azione.
o Nel caso in cui il campo non è valorizzato
- Se il campo 6 non è valorizzato le azioni descritte nei campi 3 e 4
vengono applicate su tutti gli apparecchi videoterminali del
sistema di gioco VLT.
- Se il campo 6 è valorizzato le azioni descritte nei campi 3 e 4
vengono applicate su tutti gli apparecchi videoterminali della
sala.
o Nel caso in cui il campo è valorizzato, il campo 6 è obbligatorio e deve
coincidere con quanto già censito attraverso il messaggio 306, nella banca
dati del sistema di controllo VLT.
52
Protocollo di comunicazione comma 6b
Versione 1.0
6.4.12
Pag. 53 di 127
10 Agosto 2011
RICHIESTA DEI DATI IDENTIFICATIVI
(CODICE MESSAGGIO 311)
DI UN APPARECCHIO VIDEOTERMINALE
Descrizione
Il messaggio viene utilizzato dal sistema del concessionario VLT per
richiedere al sistema di controllo VLT i dati identificativi di un determinato
apparecchio videoterminale.
Alla ricezione del presente messaggio da parte del sistema di controllo VLTa
seguito di esito positivo dei controlli, viene restituita una notifica di
validazione (Codice messaggio 006) con i relativi dati anagrafici
dell’apparecchio videoterminale.
Tipo di messaggio
Singolo: contiene il codice dell’apparecchio videoterminale di cui si richiedono
i dati.
Struttura
Progressivo
campo
1
Tipo
String
Lunghezza
massima
1
Obbl.
S
Descrizione
Tipo riga
Note di compilazione
Vale “A”
2
String
11
S
Codeid
Codice rilasciato da AAMS
Tracciato
17
53
Messaggio 311
Protocollo di comunicazione comma 6b
Versione 1.0
6.4.13
Pag. 54 di 127
10 Agosto 2011
COMUNICAZIONE DI DATI SUPPLEMENTARI
DELLA SALA (CODICE MESSAGGIO 312)
PER LA VERIFICA DI IDONEITÀ
Descrizione
Il messaggio è utilizzato dal sistema del concessionario VLT per trasmettere al
sistema di controllo VLT le seguenti informazioni :
•
La data prevista della fine esecuzione della prima fase della verifica di
idoneità della sala.
•
La superficie della sala dedicata agli apparecchi videoterminali del
concessionario.
Tipo di messaggio
Singolo: contiene i dati complementari per la verifica d’idoneità della sala.
Struttura
Progressivo
campo
1
Tipo
String
Lunghezza
massima
1
Obbl.
S
2
String
12
S
3
Data
6
S
4
Numeric
5
S
Tracciato
18
54
Descrizione
Tipo riga
Codice
identificativo
dell'ubicazione
Note di compilazione
Vale “A”
Codice rilasciato da AAMS
Deve essere almeno un
Data di
esecuzione della giorno successivo alla data
di invio del messaggio
prima fase
Metri quadrati del locale
dedicato agli apparecchi
Superficie
videoterminali del
concessionario
Messaggio 312
Protocollo di comunicazione comma 6b
Versione 1.0
Pag. 55 di 127
10 Agosto 2011
Si precisa che, quanto precedentemente descritto, per il messaggio 312, dal 30
Maggio 2012 sarà sostituito da quanto segue :
il messaggio è utilizzato dal sistema del concessionario VLT per trasmettere al
sistema di controllo VLT le seguenti informazioni :
•
La data prevista della fine esecuzione della prima fase della verifica di
idoneità della sala.
•
La superficie della sala dedicata agli apparecchi videoterminali del
concessionario.
•
Il sistema di gioco VLT per il quale si esegue la verifica d’idoneità della
sala.
Progressivo
campo
1
Tipo
String
Lunghezza
massima
1
Obbl.
S
2
String
12
3
Data
6
S
Descrizione
Tipo riga
Codice
identificativo
dell'ubicazione
Codice rilasciato da AAMS
S
Data prevista
della fine della
prima fase
Deve essere almeno un
giorno successivo alla data
di invio del messaggio
4
Numeric
5
S
5
Numeric
10
S
Tracciato
19
55
Note di compilazione
Vale “A”
Metri quadrati del locale
dedicato agli apparecchi
videoterminali del
concessionario
Superficie
Codice
identificativo del Codice rilasciato da AAMS
sistema di gioco
Messaggio 312
Protocollo di comunicazione comma 6b
Versione 1.0
6.4.14
RICHIESTA
Pag. 56 di 127
10 Agosto 2011
DI UN CAMBIO DI STATO DI UN GIOCO SU UN APPARECCHIO
VIDEOTERMINALE (CODICE MESSAGGIO 313)
Descrizione
Il messaggio viene utilizzato dal sistema del concessionario VLT per
richiedere al sistema di controllo VLT l’installazione/rimozione e
abilitazione/disabilitazione di un gioco su un singolo apparecchio
videoterminale.
Successivamente, il sistema di controllo VLT comunicherà al sistema del
concessionario VLT l’avvenuta autorizzazione di cambio stato mediante il
messaggio 400.
Tipo di messaggio
Singolo: contiene la richiesta dell’operazione da eseguire sul gioco e il motivo.
Struttura
Progressivo
campo
1
Tipo
String
Lunghezza
massima
1
Obbl.
S
2
Numeric
10
S
3
String
1
C
Descrizione
Note di compilazione
Tipo riga
Vale “A”
Codice
identificativo del
gioco
Codice rilasciato da AAMS
Azione
1(Installato) /
0(Rimosso)
1(Abilitazione) /
0(Disabilitazione)/
4
String
1
C
5
String
11
S
6
DataOra
12
S
7
String
256
S
Tracciato
20
Azione
Codeid
Codice rilasciato da AAMS
Data di cambio Data relativa al cambio di
stato
stato del campo 2
Descrizione del
motivo
Messaggio 313
Note di compilazione
- Campo 3
Il valore che può assumere il campo è:
56
Protocollo di comunicazione comma 6b
Versione 1.0
Pag. 57 di 127
10 Agosto 2011
o 1 (uno) in caso di installazione del gioco sull’apparecchio
videoterminale;
o 0 (zero) in caso di rimozione del gioco dall’apparecchio videoterminale;
- Campo 4
Il valore che può assumere il campo è:
o 1 (uno) in caso di abilitazione del gioco sull’apparecchio videoterminale;
o 0 (zero) in caso di disabilitazione dell’offerta del gioco pur rimanendo esso
installato sull’apparecchio videoterminale ;
- Campo 5
Codice identificativo dell’apparecchio videoterminale su
cui viene effettuata l’azione.
57
Protocollo di comunicazione comma 6b
Versione 1.0
6.4.15
Pag. 58 di 127
10 Agosto 2011
RICHIESTA DELLE NOTIFICHE MANCANTI (CODICE MESSAGGIO 504)
Descrizione
Il messaggio viene utilizzato dal sistema del concessionario VLT per
trasmettere al sistema di controllo VLT la richiesta di notifiche, ai messaggi
precedentemente inviati, non ricevute dal sistema del concessionario VLT.
Nel messaggio è indicato l’ identificativo del messaggio inviato di cui non si è
avuta ancora una notifica.
Non sarà possibile richiedere le notifiche di ricezione mancanti relative a
messaggi ricevuti dal sistema di controllo VLT oltre le ore 24 UTC del giorno
successivo a quello di trasmissione.
Alla ricezione del presente messaggio da parte del sistema di controllo VLT
seguiranno le normali notifiche relative al messaggio stesso, ed in caso di
corretta ricezione verrà inviata l’ultima notifica del messaggio di cui è richiesta
notifica.
Tipo di messaggio
Singolo: il messaggio per cui non è stata mai ricevuta una notifica dal sistema di
controllo VLT.
Struttura
Progressivo
campo
1
Tipo
String
Lunghezza
massima
1
Obbl.
S
2
Numeric
15
S
Tracciato
21
58
Descrizione
Tipo riga
Identificativo del
messaggio
applicativo di cui
si richiede
notifica
Messaggio 504
Note di compilazione
Vale “A”
Protocollo di comunicazione comma 6b
Versione 1.0
6.4.16
Pag. 59 di 127
10 Agosto 2011
TRASMISSIONE GIORNALIERA, MENSILE, ANNUALE INCASSI E VINCITE (CODICE
MESSAGGIO 600)
Descrizione
Il messaggio viene utilizzato dal sistema del concessionario VLT per
trasmettere al sistema di controllo VLT i dati di contabilità relativi ad uno dei
seguenti componenti del sistema del concessionario VLT:
sistema di gioco VLT,
sala,
apparecchio videoterminale
anche suddivisi per ciascun gioco presente nel componente e relativi ad un:
giorno,
mese,
anno
Tipo di messaggio
Il messaggio è composto da più righe, così come illustrato nella tabella che
segue:
Riga
Descrizione
A
Dati di contabilità del
componente del sistema
del concessionario VLT
Occorrenze
Una per messaggio
Per ogni gioco si ripete la seguente riga.
B
Dati di contabilità per
ciascun gioco presente
nel componente del
sistema del
concessionario VLT
definito sulla riga A.
59
Una per gioco
Protocollo di comunicazione comma 6b
Versione 1.0
Pag. 60 di 127
10 Agosto 2011
Struttura
Progressivo
campo
1
Tipo
String
Lunghezza
massima
1
Obbl.
S
Descrizione
Tipo riga
Note di compilazione
Vale “A”
2
Numeric
1
S
Tipo componente
Vedi Tabella 4
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
String
Eurocent
Eurocent
Eurocent
Eurocent
Eurocent
Numeric
Eurocent
Eurocent
Eurocent
Eurocent
Eurocent
Numeric
Numeric
Numeric
Numeric
12
12
12
12
12
12
12
12
12
12
12
12
12
4
2
2
S
S
S
C
S
S
S
S
S
C
S
S
S
S
C
C
Codice identificativo
del componente
Codice rilasciato da AAMS
BET
Importo puntate
WIN
Vincite conseguite
TOT_PAID
Importo riscosso
TOT_IN
Importo introdotto
TOT_OUT
Importo erogato
BET_NUM
Numero puntate
TOT_BET
Totale importo puntate
TOT_WIN
Totale vincite conseguite
TOT_TOT_PAID
Totale importo riscosso
TOT_TOT_IN
Totale importo introdotto
TOT_TOT_OUT
Totale importo erogato
TOT_BET_NUM
Totale numero puntate
Anno
Mese
da 01 a 12
Giorno
da 01 a 31
19
Numeric
10
C
Codice identificativo
del sistema di gioco Codice rilasciato da AAMS
Tracciato
22
Messaggio 600 Riga A
Note di compilazione
- Campo 2
Il valore deve essere rilevato dalla Tabella 4
Tipologia di componente.
- Campi 2 e 3 Individuano il componente di cui si inviano i dati di gioco
contenuti nei successivi campi.
- Campo 4
Importo totale delle somme puntate, comprensivo degli
importi derivanti da vincite ricollocate in gioco, nell’intervallo temporale
definito nei campi 16, 17 e 18.
- Campo 5
Importo totale delle vincite conseguite (comprensivo degli
importi ricollocati in gioco) nell’intervallo temporale definito nei campi 16,
17 e 18. Sono esclusi dall’importo le vincite conseguite relativamente ai
jackpot
60
Protocollo di comunicazione comma 6b
Versione 1.0
-
-
-
-
-
-
-
-
-
-
Pag. 61 di 127
10 Agosto 2011
Campo 6
Importo totale del TOT_OUT riscosso nell’intervallo
temporale definito nei campi 16, 17 e 18. Deve essere valorizzato solo nel
caso in cui il Campo 2 vale 1 o 2.
Campo 7
Importo totale introdotto attraverso i
sistemi di
introduzione credito previsti su ciascun apparecchio videoterminale
nell’intervallo temporale definito nei campi 16, 17 e 18.
Campo 8
Importo totale erogato attraverso i sistemi di erogazione
previsti su ciascun apparecchio videoterminale nell’intervallo temporale
definito nei campi 16, 17 e 18.
Campo 9
Numero delle puntate effettuate anche a seguito di vincite
ricollocate in gioco nell’intervallo temporale definito nei campi 16, 17 e 18.
Campo 10
Importo totale delle somme puntate, comprensivo degli
importi derivanti da vincite ricollocate in gioco, calcolato a partire dal 1°
Gennaio dell’anno di invio del messaggio sino al giorno precedente l’invio
del messaggio.
Campo 11
Importo totale delle vincite conseguite (comprensivo degli
importi ricollocati in gioco), calcolato a partire dal 1° Gennaio di invio del
messaggio sino al giorno precedente l’invio del messaggio. Sono esclusi
dall’importo le vincite conseguite relativamente ai jackpot
Campo 12
Importo
totale
del
TOT_TOT_OUT
riscosso
nell’intervallo, calcolato a partire dal 1° Gennaio dell’anno di invio del
messaggio sino al giorno precedente l’invio del messaggio. Deve essere
valorizzato solo nel caso in cui il Campo 2 vale 1 o 2.
Campo 13
Importo totale introdotto attraverso i
sistemi di
introduzione credito previsti su ciascun apparecchio videoterminale,
calcolato a partire dal 1° Gennaio dell’anno di invio del messaggio sino al
giorno precedente l’invio del messaggio.
Campo 14
Importo totale erogato attraverso i sistemi di erogazione
previsti su ciascun apparecchio videoterminale, calcolato a partire dal 1°
Gennaio dell’anno di invio del messaggio sino al giorno precedente l’invio
del messaggio.
Campo 15
Numero delle puntate effettuate anche a seguito di vincite
ricollocate in gioco, calcolato a partire dal 1° Gennaio dell’anno di invio del
messaggio sino al giorno precedente l’invio del messaggio.
Campi 16, 17 e 18
Definiscono l’intervallo temporale a cui si
riferiscono i dati inviati nei campi da 4 a 9.
Campo 16
Deve essere sempre valorizzato. Nel caso in cui i dati inviati
si riferiscano ad un intervallo temporale annuale, i campi 17 e 18 non
devono essere valorizzati.
61
Protocollo di comunicazione comma 6b
Versione 1.0
-
-
-
-
Pag. 62 di 127
10 Agosto 2011
Campo 17
Deve essere valorizzato esclusivamente se i dati sono relativi
ad un periodo temporale :
ƒ mensile, in tal caso il campo 18 non deve essere valorizzato.
ƒ giornaliero, in tal caso il giorno è rappresentato nel
successivo campo 18.
Campo 18
Deve essere valorizzato esclusivamente se i dati sono relativi
ad un periodo temporale giornaliero, in tal caso i campi 16 e 17 sono
obbligatori e rappresentano rispettivamente anno e mese.
Campo 19
Rappresenta il sistema di gioco VLT al quale è legato il
componente del campo 3. È assente nel caso in cui il campo 2 assume il
valore 1 (sistema di gioco), negli altri casi è obbligatorio e deve coincidere
con quanto censito nella banca dati del sistema di controllo VLT.
I dati di gioco inviati nel messaggio devono essere riferiti ad un intervallo
temporale già concluso.
Campi 10 a 15 Nel caso in cui il messaggio sia inviato il giorno 1° gennaio,
i campi rappresentano il valore del contatore calcolato a partire dal 1°
Gennaio dell’anno precedente al 31 Dicembre dell’anno precedente.
62
Protocollo di comunicazione comma 6b
Versione 1.0
Pag. 63 di 127
10 Agosto 2011
Struttura
Progressivo
campo
1
Tipo
String
Lunghezza
massima
1
Obbl.
S
2
3
4
5
6
7
8
Numeric
Eurocent
Eurocent
Numeric
Eurocent
Eurocent
Numeric
10
12
12
12
12
12
12
S
S
S
S
S
S
S
Tracciato 23
Descrizione
Tipo riga
Note di compilazione
Vale “B”
Codice identificativo
del gioco
Codice rilasciato da AAMS
BET
WIN
Vincita conseguita
BET_NUM
TOT_BET
TOT_WIN
Vincita conseguita
TOT_BET_NUM
Messaggio 600 Riga B
Note di compilazione
- Campo 2
Codice identificativo del gioco di cui si inviano i dati
contenuti nei campi successivi; tali dati devono essere raggruppati per il
componente specificato nella riga A campo 3. Il gioco deve essere stato
installato sul componente della riga A nell’intervallo temporale definito nei
campi 16, 17 e 18 della riga A.
- Campo 3
Importo totale delle somme puntate, comprensivo degli
importi derivanti da vincite ricollocate in gioco, nell’intervallo temporale
definito nei campi 16, 17 e 18 della riga A.
- Campo 4
Importo totale delle vincite conseguite (comprensivo degli
importi ricollocati in gioco) nell’intervallo temporale definito nei campi 16,
17 e 18 della riga A. Sono esclusi dall’importo le vincite conseguite
relativamente ai jackpot
- Campo 5
Numero delle puntate effettuate anche a seguito di vincite
ricollocate in gioco nell’intervallo temporale definito nei campi 16, 17 e 18
della riga A.
- Campo 6
Importo totale delle somme puntate, comprensivo delle
somme rigiocate, calcolato a partire dal 1° Gennaio dell’anno di invio del
messaggio sino al giorno precedente l’invio del messaggio.
- Campo 7
Importo totale delle vincite conseguite (comprensivo degli
importi rigiocati), calcolato a partire dal 1° Gennaio dell’anno di invio del
messaggio sino al giorno precedente l’invio del messaggio. Sono esclusi
dall’importo le vincite conseguite relativamente ai jackpot.
- Campo 8
Numero delle puntate effettuate anche a seguito di vincite
rigiocate, calcolato a partire dal 1° Gennaio dell’anno di invio del messaggio
sino al giorno precedente l’invio del messaggio.
63
Protocollo di comunicazione comma 6b
Versione 1.0
-
Pag. 64 di 127
10 Agosto 2011
Campi 6 a 8 Nel caso in cui il messaggio sia inviato il giorno 1° gennaio, i
campi rappresentano il valore del contatore calcolato a partire dal 1°
Gennaio dell’anno precedente al 31 Dicembre dell’anno precedente.
64
Protocollo di comunicazione comma 6b
Versione 1.0
6.4.17
Pag. 65 di 127
10 Agosto 2011
DEFINIZIONE/ ACCANTONAMENTI/EROGAZIONE
MESSAGGIO 601)
JACKPOT (CODICE
Descrizione
Il messaggio viene utilizzato dal sistema del concessionario VLT per
trasmettere al sistema di controllo VLT i dati relativi ai jackpot: e più
specificatamente :
•
nel momento in cui si definisce il nuovo jackpot;
•
giornalmente con le relative somme accantonate per i jackpot già
esistenti e non ancora erogati; tale invio è effettuato una sola volta al
giorno per ogni jackpot;
•
nel momento in cui si eroga il jackpot;
Ogni dato inviato contiene il riferimento a ciascun sistema di gioco VLT.
I jackpot possono essere di tipo
•
“progressivo” se l’importo della vincita è determinato come
accantonamento di una percentuale degli incassi delle puntate. Tale
importo ottenuto come accantonamento si può sommare a un
importo minimo iniziale.
•
“progressivo con soglia iniziale” se l’importo iniziale della vincita è
predefinito (soglia iniziale) e si incrementa con una percentuale di
accantonamento degli incassi delle puntate. In particolare l’incremento
avviene sulla soglia iniziale esclusivamente quando gli importi incassati
attraverso l’accantonamento superano tale soglia iniziale. Dal
superamento della soglia iniziale tutti i successivi importi derivanti
dalla percentuale di accantonamento degli incassi delle puntate
incrementa il jackpot.
•
“predefinito” se l’importo della vincita è predeterminato e non si
incrementa.
65
Protocollo di comunicazione comma 6b
Versione 1.0
Pag. 66 di 127
10 Agosto 2011
Tipo di messaggio
Il messaggio è composto da più righe, così come illustrato nella tabella che
segue:
Riga
Descrizione
A
Dati del sistema di gioco
VLT
Occorrenze
Una per messaggio
Per ogni jackpot non ancora erogato si ripete la seguente riga
B
Importo accantonato per il Una per jackpot
jackpot
Per ogni nuovo jackpot da definire si ripete la seguente riga
C
Dati identificativi jackpot Una per jackpot
Per un jackpot erogato
D
Dati
relativi
alla Una per jackpot
erogazione di un jackpot
Rappresenta la somma dei jackpot non ancora erogati
E
Accantonamento
Una per messaggio solo in caso di
complessivo dei jackpot creazione oppure di erogazione
da erogare
jackpot
I dati che il Concessionario è tenuto ad inviare al momento della definizione di
nuovo jackpot sono:
•
codice identificativo del sistema di gioco VLT e importo totale delle
somme complessivamente puntate (riga A);
•
accantonamento complessivo dei jackpot da erogare (riga E) escluso
l’importo del nuovo jackpot;
•
dati identificativi del nuovo jackpot (riga C).
In caso di esito positivo alla notifica di ricezione del messaggio 601 di
definizione nuovo jackpot, la risposta del sistema di controllo VLT , è una
delle alternative di seguito elencate :
•
avvenuta accettazione dei dati, (notifica di validazione Messaggio 005,
Riga A e Riga B);
66
Protocollo di comunicazione comma 6b
Versione 1.0
Pag. 67 di 127
10 Agosto 2011
•
avvenuta accettazione dei dati, con segnalazione di anomalie
riscontrate (notifica di validazione Messaggio 005, Riga A, Riga B e
Riga C);
•
notifica di errori , Messaggio 001.
A ciascun jackpot è assegnato un identificativo che viene trasmesso al
concessionario con la notifica 005.
I dati che il Concessionario è tenuto ad inviare ogni volta che un jackpot viene
erogato sono:
•
codice identificativo del sistema di gioco VLT e importo totale delle
somme complessivamente puntate (riga A);
•
accantonamento complessivo dei jackpot da erogare (riga E) escluso il
montepremi del jackpot erogato;
•
dati relativi all’erogazione del jackpot (riga D).
In caso di esito positivo alla notifica di ricezione del messaggio 601 di
erogazione jackpot, la risposta del sistema di controllo VLT, è una delle
alternative di seguito elencate :
•
nessuna anomalia riscontrata (notifica di validazione Messaggio 002);
•
avvenuta accettazione dei dati, con segnalazione di anomalie
riscontrate (notifica di validazione Messaggio 005, Riga A e Riga C);
•
notifica di errori , Messaggio 001.
I dati inviati da trasmettere con periodicità giornaliera sono:
•
codice identificativo del sistema di gioco VLT e importo totale delle
somme complessivamente puntate (riga A);
•
importo accantonato per ciascun jackpot non ancora erogato (riga
B).
•
numero delle partite che concorrono all’accantonamento del jackpot
dalla sua creazione (riga B).
•
numero delle partite sui giochi che partecipano al jackpot dalla sua
creazione (riga B).
67
Protocollo di comunicazione comma 6b
Versione 1.0
Pag. 68 di 127
10 Agosto 2011
Struttura
Progressivo
campo
1
Tipo
String
Lunghezza
massima
1
Obbl.
S
2
3
Numeric
Eurocent
10
12
S
S
4
Numeric
1
S
Tracciato
24
Descrizione
Tipo riga
Note di compilazione
Vale “A”
Codice
identificativo del
sistema di gioco Codice rilasciato da AAMS
TOT_BET
0 Definizione nuovo
Jackopt,
Motivo della 1 Erogazione Jackpot,
trasmissione 2 Accantonamenti
giornalieri
Messaggio 601 Riga A
Note di compilazione
− Campo 2
Codice identificativo del sistema di gioco VLT su cui sono
definiti i jackpot di cui si inviano i dati.
− Campo 3
Importo totale delle somme complessivamente puntate sul
sistema di gioco VLT, calcolato a partire dal 1° Gennaio dell’anno di
invio del messaggio sino al momento di invio del messaggio.
− Campo 4
Indica se i dati contenuti nelle righe B e C o D sono relativi
alla definizione, all’erogazione o agli accantonamenti giornalieri dei
jackpot.
68
Protocollo di comunicazione comma 6b
Versione 1.0
Progressivo
campo
1
Pag. 69 di 127
10 Agosto 2011
Tipo
String
Lunghezza
massima
1
Obbl.
S
2
Numeric
10
S
3
Eurocent
10
S
Descrizione
Tipo riga
Codice
identificativo del
jackpot
Somma
accantonata
4
Numeric
12
S
BET_NUM_J
5
Numeric
12
S
BET_NUM
Tracciato
25
Note di compilazione
Vale “B”
Codice rilasciato da
AAMS
Numero delle partite che
concorrono
all’accantonamento del
jackpot dalla sua
creazione
Numero delle partite sui
giochi che partecipano
al jackpot dalla sua
creazione
Messaggio 601 Riga B
Note di compilazione
− Campo 2
Codice identificativo di un jackpot non ancora erogato
− Campo 3
Somma accantonata per il jackpot, indicato al Campo 2
fino al momento di invio del messaggio.
69
Protocollo di comunicazione comma 6b
Versione 1.0
Progressivo
campo
1
2
Pag. 70 di 127
10 Agosto 2011
Tipo
String
Lunghezza
massima
1
Obbl.
S
String
50
S
3
Numeric
10
C
4
String
12
C
Descrizione
Tipo riga
Codice
identificativo del
jackpot
String
1
S
Tipo Jackpot
6
Eurocent
10
C
Importo della
vincita
26
Codice utilizzato sul
sistema del concessionario
Codice
identificativo del
gioco
Codice
identificativo
dell'ubicazione
5
Tracciato
Note di compilazione
Vale “C”
Codice rilasciato da AAMS
Codice rilasciato da AAMS
0 (predefinito)
1(progressivo)
2 (progressivo con soglia
iniziale)
Montepremi di un jackpot
predefinito ovvero soglia
iniziale di un jackpot
progressivo
Messaggio 601 Riga C
Note di compilazione
− Campo 2
E’ il codice identificativo univoco del jackpot nell’ambito
del sistema di gioco VLT.
− Campo 3
Va valorizzato se il jackpot è definito per un singolo gioco.
− Campo 4
Va valorizzato se il jackpot è legato alla sala. Se non
valorizzato è legato al sistema di gioco VLT definito sulla riga A.
− Campo 6
Se valorizzato rappresenta l’importo del jackpot quando il
jackpot è di tipo “predefinito”, la soglia iniziale quando il jackpot è di tipo
“progressivo con soglia iniziale” ovvero il valore minimo iniziale quando il
jackpot è di tipo “progressivo”.
70
Protocollo di comunicazione comma 6b
Versione 1.0
Progressivo
campo
1
Tipo
String
Pag. 71 di 127
10 Agosto 2011
Lunghezza
massima
1
Obbl.
S
2
Numeric
10
S
3
String
11
S
4
Eurocent
10
S
Tracciato
27
Descrizione
Tipo riga
Note di compilazione
Vale “D”
Codice
identificativo del
jackpot
Codice rilasciato da AAMS
Codeid
Importo della
vincita
Codice rilasciato da AAMS
Messaggio 601 Riga D
Note di compilazione
− Campo 3
Codice Identificativo dell’apparecchio videoterminale sul
quale è stato erogato il jackpot.
Progressivo
campo
1
Tipo
String
Lunghezza
massima
1
Obbl.
S
2
Eurocent
10
S
Tracciato
28
Descrizione
Tipo riga
Somma
accantonata
Note di compilazione
Vale “E”
Messaggio 601 Riga E
Note di compilazione
− Campo 2
Somma accantonata per tutti i jackpot, del sistema di gioco
VLT fino al momento di invio del messaggio.
Si precisa che, quanto precedentemente descritto, per il messaggio 601, dal 30
Maggio 2012 sarà sostituito da quanto segue :
Descrizione
Il messaggio viene utilizzato dal sistema del concessionario VLT per
trasmettere al sistema di controllo VLT i dati relativi ai jackpot: e più
specificatamente :
-
nel momento in cui si definisce il nuovo jackpot;
nel momento in cui si eroga il jackpot;
71
Protocollo di comunicazione comma 6b
Versione 1.0
Pag. 72 di 127
10 Agosto 2011
ogni dato inviato contiene il riferimento a ciascun sistema di gioco VLT.
I jackpot possono essere di tipo
•
“progressivo” se l’importo della vincita è determinato come
accantonamento di una percentuale degli incassi delle puntate. Tale
importo ottenuto come accantonamento si può sommare a un
importo minimo iniziale.
•
“progressivo con soglia iniziale” se l’importo iniziale della vincita è
predefinito (soglia iniziale) e si incrementa con una percentuale di
accantonamento degli incassi delle puntate. In particolare l’incremento
avviene sulla soglia iniziale esclusivamente quando gli importi incassati
attraverso l’accantonamento superano tale soglia iniziale. Dal
superamento della soglia iniziale tutti i successivi importi derivanti
dalla percentuale di accantonamento degli incassi delle puntate
incrementa il jackpot.
•
“predefinito” se l’importo della vincita è predeterminato e non si
incrementa.
Tipo di messaggio
Il messaggio è composto da più righe, così come illustrato nella tabella che
segue:
Riga
Descrizione
A
Dati del sistema di gioco
VLT
Occorrenze
Una per messaggio
Per ogni nuovo jackpot da definire si ripete la seguente riga
C
Dati
jackpot
identificativi Una per jackpot
Per un jackpot erogato
D
Dati
relativi
all’ Una per jackpot
erogazione di un jackpot
I dati che il Concessionario è tenuto ad inviare al momento della definizione di
nuovo jackpot sono:
72
Protocollo di comunicazione comma 6b
Versione 1.0
Pag. 73 di 127
10 Agosto 2011
•
codice identificativo del sistema di gioco VLT e importo totale delle
somme complessivamente puntate (riga A);
•
dati identificativi del nuovo jackpot (riga C).
In caso di esito positivo alla notifica di ricezione del messaggio 601 di
definizione nuovo jackpot, la risposta del sistema di controllo VLT, è una
delle alternative di seguito elencate :
•
avvenuta accettazione dei dati, (notifica di validazione Messaggio 005,
Riga A e Riga B);
•
avvenuta accettazione dei dati, con segnalazione di anomalie
riscontrate (notifica di validazione Messaggio 005, Riga A, Riga C);
•
notifica di errori , Messaggio 001.
A ciascun jackpot è assegnato un identificativo che viene trasmesso al
concessionario con la notifica 005.
I dati che il concessionario è tenuto ad inviare ogni volta che un jackpot viene
erogato sono:
•
codice identificativo del sistema di gioco VLT e importo totale delle
somme complessivamente puntate (riga A);
•
dati relativi all’erogazione del jackpot, ivi incluso il gioco che ne ha
permesso la vincita (riga D).
In caso di esito positivo alla notifica di ricezione del messaggio 601 di
erogazione jackpot, la risposta del sistema di controllo VLT, è una delle
alternative di seguito elencate :
•
nessuna anomalia riscontrata (notifica di validazione Messaggio 002);
•
avvenuta accettazione dei dati, con segnalazione di anomalie
riscontrate (notifica di validazione Messaggio 005, Riga A e Riga C);
•
notifica di errori , Messaggio 001.
73
Protocollo di comunicazione comma 6b
Versione 1.0
Pag. 74 di 127
10 Agosto 2011
Struttura
Progressivo
campo
1
Tipo
String
Lunghezza
massima
1
Obbl.
S
2
3
Numeric
Eurocent
10
12
S
S
4
Numeric
1
S
Tracciato
29
Descrizione
Tipo riga
Note di compilazione
Vale “A”
Codice
identificativo del
sistema di gioco Codice rilasciato da AAMS
TOT_BET
0 Definizione nuovo
Motivo della Jackopt,
trasmissione 1 Erogazione Jackpot
Messaggio 601 Riga A
Note di compilazione
- Campo 2
Codice identificativo del sistema di gioco VLT su cui sono
definiti i jackpot di cui si inviano i dati.
- Campo 3
Importo totale delle somme complessivamente puntate sul
sistema di gioco VLT, calcolato a partire dal 1° Gennaio dell’anno di invio
del messaggio sino al momento di invio del messaggio.
- Campo 4
Indica se i dati contenuti nelle righe C o D sono relativi alla
definizione o all’erogazione dei jackpot.
o
Progressivo
campo
1
Tipo
String
2
String
50
S
3
Numeric
10
C
4
String
12
C
Descrizione
Tipo riga
Codice
identificativo del
jackpot
Codice
identificativo del
gioco
Codice
identificativo
dell'ubicazione
5
String
1
S
Tipo Jackpot
C
Importo della
vincita
6
Eurocent
Tracciato
Lunghezza
massima Obbl.
1
S
10
30
Note di compilazione
Vale “C”
Codice utilizzato sul sistema del
concessionario
Codice rilasciato da AAMS
Codice rilasciato da AAMS
0 (predefinito)
1(progressivo)
2 (progressivo con soglia iniziale)
Montepremi di un jackpot
predefinito ovvero soglia iniziale di
un jackpot progressivo
Messaggio 601 Riga C
74
Protocollo di comunicazione comma 6b
Versione 1.0
Pag. 75 di 127
10 Agosto 2011
Note di compilazione
- Campo 2
E’ il codice identificativo univoco del jackpot nell’ambito
del sistema di gioco VLT.
- Campo 3
Va valorizzato se il jackpot è definito per un singolo gioco.
- Campo 4
Va valorizzato se il jackpot è legato alla sala. Se non
valorizzato è legato al sistema di gioco VLT definito sulla riga A.
- Campo 6
Se valorizzato rappresenta l’importo del jackpot quando il
jackpot è di tipo “predefinito”, la soglia iniziale quando il jackpot è di tipo
“progressivo con soglia iniziale” ovvero il valore minimo iniziale quando il
jackpot è di tipo “progressivo”.
Progressivo
campo
1
Tipo
String
Lunghezza
massima
1
Obbl.
S
2
Numeric
10
S
3
String
11
S
4
Eurocent
10
S
5
String
10
S
Tracciato
31
Descrizione
Tipo riga
Note di compilazione
Vale “D”
Codice
identificativo del
jackpot
Codice rilasciato da AAMS
Codeid
Codice rilasciato da AAMS
Importo della
vincita
Codice
identificativo del
gioco
Codice rilasciato da AAMS
Messaggio 601 Riga D
Note di compilazione
- Campo 3 Codice Identificativo dell’apparecchio videoterminale sul quale è
stato erogato il jackpot.
- Campo 5 Codice identificativo del gioco da cui è scaturita la vincita del
jackpot indicato al campo 2.
75
Protocollo di comunicazione comma 6b
Versione 1.0
6.4.18
Pag. 76 di 127
10 Agosto 2011
COMUNICAZIONE DELL’UTILIZZO DEL CREDITO ANNUALE
Il concessionario per comunicare la scelta dell’utilizzo del credito annuale,
trasmette, un'unica dichiarazione, effettuata attraverso il messaggio 812 inviato
dal sistema di controllo AWP al sistema del concessionario AWP e definito
nel protocollo di comunicazione comma 6a.
76
Protocollo di comunicazione comma 6b
Versione 1.0
6.4.19
TRASMISSIONE DEGLI
Pag. 77 di 127
10 Agosto 2011
ACCANTONAMENTI (CODICE MESSAGGIO 605)
Il messaggio deve essere implementato dal 30 Maggio 2012.
Descrizione
Il messaggio viene utilizzato dal sistema del concessionario VLT per
trasmettere al sistema di controllo VLT i dati relativi all’accantonamento
suddivisi per:
- singolo gioco,
- tipologia di jackpot,
- sala se la tipologia di jackpot è riferita ad un jackpot di sala.
L’accantonamento è costituito dei seguenti importi:
importi accantonati per i jackpot dichiarati dal sistema del
concessionario VLT e non ancora erogati.
importo costituito per futuri jackpot e non disponibile e riconducibile
immediatamente ad una vincita nonché invisibile al giocatore.
Ogni comunicazione dell’accantonamento suddiviso per gioco, tipologia di
jackpot e sala deve essere trasmesso con frequenza giornaliera.
Il messaggio non deve essere inviato nel caso in cui il sistema di gioco VLT
non prevede jackpot.
Tipo di messaggio
Il messaggio è composto da più righe, così come illustrato nella tabella che
segue:
Riga
Descrizione
A
Dati del sistema di gioco
VLT
77
Occorrenze
Una per messaggio
Protocollo di comunicazione comma 6b
Versione 1.0
Riga
Pag. 78 di 127
10 Agosto 2011
Descrizione
Occorrenze
Per ogni gioco, tipologia di jackpot e sala che ha contribuito
all’accantonamento.
B
Dati sull’accantonamento
Per ogni gioco, tipologia di jackpot
e sala
Struttura
Progressivo
campo
1
2
Tipo
String
Lunghezza
massima Obbl.
1
S
Numeric
10
Tracciato
S
32
Descrizione
Tipo riga
Note di compilazione
Vale “A”
Codice
identificativo del
sistema di gioco
Codice rilasciato da
AAMS
Messaggio 605 Riga A
Note di compilazione
- Campo 2
Codice identificativo del sistema di gioco VLT su cui sono
definiti gli accantonamenti.
Progressivo
campo
1
Tipo
String
Lunghezza
massima Obbl.
1
S
2
Numeric
10
C
3
4
Eurocent
Numeric
10
1
S
S
5
String
12
C
Tracciato
33
Descrizione
Tipo riga
Note di compilazione
Vale “B”
Codice identificativo
del gioco
Codice rilasciato da
AAMS
Somma accantonata
Tipologia di jackpot
Codice identificativo
dell'ubicazione
Vedi Tabella 10
Codice rilasciato da
AAMS
Messaggio 605 Riga B
Note di compilazione
- Campo 2
Codice identificativo del gioco che contribuisce
all’accantonamento.
- Campo 3
Somma accantonata, fino al momento dell’invio del
messaggio, derivante esclusivamente dai contributi del gioco indicato al
Campo 2 per i jackpot o futuri jackpot di tipologia indicata al campo 4
78
Protocollo di comunicazione comma 6b
Versione 1.0
-
Pag. 79 di 127
10 Agosto 2011
Campo 4
Il valore deve essere rilevato dalla Tabella 10
Tipologia di jackpot
Campo 5
Deve essere valorizzato se la tipologia di jackpot è legato ad
una sala (campo 4 con valore ‘3’ o ‘4’).
79
Protocollo di comunicazione comma 6b
Versione 1.0
6.4.20
CAMBIO
Pag. 80 di 127
10 Agosto 2011
DI STATO DI UNO O PIÙ APPARECCHI VIDEOTERMINALI
(CODICE
MESSAGGIO 701)
Descrizione
Il messaggio è utilizzato dal sistema del concessionario VLT per trasmettere al
sistema di controllo VLT il cambio di stato :
di un singolo apparecchio videoterminale.
di tutti gli apparecchi videoterminali di una determinata
sala.
Come data di cambio di stato si assume il campo 4.
Tipo di messaggio
Singolo
Progressivo
campo
1
Tipo
String
Lunghezza
massima
1
Obbl.
S
2
3
String
String
11
1
C
S
4
DataOra
12
S
5
String
12
S
Tracciato
34
Descrizione
Tipo riga
Note di compilazione
Vale “A”
Codeid
Codice rilasciato da AAMS
Flag Stato
Vedia tabella 7
Data di cambio Data relativa allo stato del
stato
campo 3
Codice
identificativo
dell'ubicazione Codice rilasciato da AAMS
Messaggio 701
Note di compilazione
- Campo 2
Codice identificativo dell’apparecchio videoterminale su
cui viene effettuata l’azione. Nel caso in cui il campo non sia valorizzato,
l’azione descritta nel campo 3 viene applicata su tutti gli apparecchi
videoterminali della sala (campo 5).
80
Protocollo di comunicazione comma 6b
Versione 1.0
-
Pag. 81 di 127
10 Agosto 2011
Campo 3
Il valore deve essere rilevato dalla Tabella 7
Stato di funzionamento di un apparecchio videoterminale.
-
Quanto precedentemente descritto, per il messaggio 701, dal 30 Maggio 2012
sarà sostituito da quanto segue :
il messaggio è utilizzato dal sistema del concessionario VLT per trasmettere al
sistema di controllo VLT il cambio di stato :
di un singolo apparecchio videoterminale.
di tutti gli apparecchi videoterminali di una determinata
sala e di un determinato sistema di gioco VLT.
Progressivo
campo
1
Tipo
String
Lunghezza
massima
1
Obbl.
S
Descrizione
Tipo riga
Note di compilazione
Vale “A”
2
3
String
String
11
1
C
S
4
DataOra
12
S
Codice rilasciato da AAMS
Vedia tabella 7
Data relativa allo stato del
campo 3
5
String
12
S
6
Numeric
10
S
Codeid
Flag Stato
Data di cambio
stato
Codice
identificativo
dell'ubicazione
Codice
identificativo del
sistema di gioco
Tracciato
35
81
Messaggio 701
Codice rilasciato da AAMS
Codice rilasciato da AAMS
Protocollo di comunicazione comma 6b
Versione 1.0
6.4.21
Pag. 82 di 127
10 Agosto 2011
NOTIFICA DI RICEZIONE (CODICE MESSAGGIO 500)
Descrizione
Il messaggio viene utilizzato dal sistema del concessionario VLT per
trasmettere al sistema di controllo VLT l’avvenuta ricezione di un messaggio
di tipo richieste, azioni o segnalazioni.
Tipo di messaggio
Vuoto: il messaggio è composto dalla sola testata mentre il messaggio operativo
è assente (cioè di lunghezza 0)
82
Protocollo di comunicazione comma 6b
Versione 1.0
6.4.22
NOTIFICA
DI
Pag. 83 di 127
10 Agosto 2011
RICEZIONE
CON
SEGNALAZIONE
DI
ERRORE
(CODICE
MESSAGGIO 501)
Descrizione
Il messaggio viene utilizzato dal sistema del concessionario VLT per
trasmettere al sistema di controllo VLT di non poter predisporre la risposta
corrispondente alla richiesta pervenuta.
Tipo di messaggio
Lista: il motivo di mancata estrazione o non elaborabilità, relativo ai dati
presenti nel messaggio inviato dal sistema di controllo VLT.
Struttura
Il messaggio è composto da più righe, così come illustrato nella tabella che
segue:
Riga
Descrizione
Occorrenze
A
Dati di riepilogo
Una per messaggio
B
Dettaglio del motivo di mancata
estrazione
Una per mancata estrazione
Progressivo
Lunghezza
Tipo
campo
massima
1
String
1
2
Numeric
6
Tracciato
36
Obbl.
Descrizione
S
S
Deve essere uguale a “A”
Totale righe di dettaglio
Messaggio 501 Risposta Riga A
83
Protocollo di comunicazione comma 6b
Versione 1.0
Progressivo
campo
1
2
3
Pag. 84 di 127
10 Agosto 2011
Obbl.
Descrizione
Note di compilazione
String
Lunghezza
massima
1
S
Vale "B"
Numeric
String
2
256
S
C
Tipo riga
Motivo della
mancata
comunicazione
Descrizione
Tipo
Tracciato
37
Vedi Tabella 6.
Obbligatorio solo se B2=9
Messaggio 501 Risposta Riga B
Note di compilazione
- Campo 2
Il valore deve essere rilevato dalla Tabella 6
Motivi di mancata
84
-
Protocollo di comunicazione comma 6b
Versione 1.0
6.5
MESSAGGI
Pag. 85 di 127
10 Agosto 2011
INVIATI DAL SISTEMA DI CONTROLLO
VLT
AL SISTEMA DEL
CONCESSIONARIO VLT
Il paragrafo contiene la descrizione dei messaggi operativi che il sistema di
controllo VLT invia al sistema del concessionario VLT.
Codice
messaggio
Descrizione
INVIO COMANDI DAL SISTEMA DI CONTROLLO VLT AL SISTEMA DEL
CONCESSIONARIO VLT
100
Abilitazione/disabilitazione di un apparecchio
videoterminale
101
Verifica dell’integrità del software installato su un
apparecchio videoterminale
102
Verifica dell’integrità del software di uno specifico gioco
installato su un apparecchio videoterminale
103
Verifica dell’integrità’ del software installato su di un
sistema centrale
INTERROGAZIONI ALLA BANCA DATI DEL SISTEMA DEL
CONCESSIONARIO VLT
210
Richiesta della data e del risultato dell’ultima verifica
dell’integrità del software installato su di un apparecchio
videoterminale
211
Richiesta della data e del risultato dell’ultima verifica
dell’integrità del software di uno specifico gioco istallato
su di un apparecchio videoterminale
212
Richiesta dello stato dei giochi installati su di un
apparecchio videoterminale
213
Richiesta dello stato di un apparecchio videoterminale
214
Richiesta della data e del risultato dell’ultima verifica
dell’integrità del software installato su di un sistema
centrale
250
Richiesta dei dati di contabilità
400
Autorizzazione al cambio di stato di un gioco su un
apparecchio videoterminale
85
Protocollo di comunicazione comma 6b
Versione 1.0
Pag. 86 di 127
10 Agosto 2011
Messaggi operativi AAMS – Concessionario 1
A seguito dei messaggi che provengono dal sistema del concessionario VLT, il
sistema di controllo VLT invia messaggi operativi di servizio elencati nella
tabella che segue:
Codice
Descrizione
messaggio
000
Notifica di ricezione
001
Notifica di errore
002
Notifica di validazione
003
Notifica di richiesta evasa
005
Notifica del codice identificativo di jackpot e/o di possibili
errori riscontrati durante la sua creazione o la sua
erogazione
006
Notifica di dati
videoterminale
008
Notifica del codice identificativo dell’ubicazione
014
Notifica
di
sospensione/cancellazione/annullamento
sospensione di un soggetto dall’Elenco dei soggetti
identificativi
di
un
apparecchio
Messaggi operativi AAMS – Concessionario 2
Nella medesima sessione in cui viene ricevuto il messaggio trasmesso dal
sistema del concessionario VLT, se il controllo su tale messaggio ha esito
negativo, il sistema di controllo VLT trasmette il messaggio (001) di notifica di
errore ed il messaggio viene scartato.
Se detto controllo ha esito positivo, viene trasmesso il messaggio (000) di
notifica di ricezione e, successivamente alla chiusura della sessione, vengono
effettuati ulteriori controlli a seguito dei quali il sistema di controllo VLT
trasmetterà in alternativa:
- il messaggio 001,
- il messaggio 002,
- il messaggio 005,
- il messaggio 006,
86
Protocollo di comunicazione comma 6b
Versione 1.0
-
Pag. 87 di 127
10 Agosto 2011
il messaggio 008,
il messaggio 014.
87
Protocollo di comunicazione comma 6b
Versione 1.0
6.5.1
Pag. 88 di 127
10 Agosto 2011
NOTIFICA DI RICEZIONE (CODICE MESSAGGIO 000)
Descrizione
La notifica viene utilizzata dal sistema di controllo VLT per trasmettere al
sistema del concessionario VLT l’esito positivo dei controlli effettuati alla
ricezione di un messaggio dal sistema del concessionario VLT stesso.
La notifica viene trasmessa nella medesima sessione in cui è stato ricevuto il
messaggio e costituisce la conferma della corretta ricezione da parte del sistema
di controllo VLT.
Tipo di messaggio
Vuoto: il messaggio è composto dalla sola testata mentre il messaggio operativo
è assente (cioè di lunghezza 0).
88
Protocollo di comunicazione comma 6b
Versione 1.0
6.5.2
Pag. 89 di 127
10 Agosto 2011
NOTIFICA DI ERRORE (CODICE MESSAGGIO 001)
Descrizione
La notifica viene utilizzata dal sistema di controllo VLT per trasmettere al
sistema del concessionario VLT l’esito negativo dei controlli effettuati su un
messaggio ricevuto.
Il messaggio operativo contiene l’elenco completo degli errori che impediscono
l’accettazione del messaggio e in particolare le informazioni che specificano:
il codice dell’errore riscontrato;
il tipo della riga contenente l’errore;
il numero della riga in cui si è stato riscontrato l’errore;
il numero del campo in cui è stato riscontrato l’errore.
Tipo di messaggio
Lista: il messaggio contiene almeno un errore.
89
Protocollo di comunicazione comma 6b
Versione 1.0
Pag. 90 di 127
10 Agosto 2011
Struttura
Il messaggio è composto da più righe, così come illustrato nella tabella che
segue:
Riga
A
Descrizione
Occorrenze
Una per messaggio
Dati di riepilogo
Per ogni errore si ripete la seguente riga
B
Riga A
Dati di dettaglio degli errori
riscontrati
Una per ogni errore
Dati di riepilogo
Progressivo
campo
Tipo
Lunghezza
massima
Obbl.
1
String
1
S
Tipo riga
2
Numeric
6
S
Totale errori
riscontrati
Tracciato
38
Descrizione
Note di compilazione
Vale "A"
Messaggio 001 – Riga A
90
Protocollo di comunicazione comma 6b
Versione 1.0
Riga B
Pag. 91 di 127
10 Agosto 2011
Dati di dettaglio degli errori riscontrati
Progressivo
campo
1
String
Lunghezza
massima
1
2
Numeric
4
Tipo
Obbl.
Descrizione
Note di compilazione
S
Tipo riga
Vale "B"
S
Codice dell'errore
Vedi Tabella 5
riscontrato
3
Numeric
6
S
Progressivo riga
4
String
1
S
Identificativo
della riga che
contiene l'errore
Progressivo che identifica
la riga all'interno del
messaggio inviato, nella
quale è presente il campo
errato. Anche per i
messaggi composti da
un'unica riga, indicare "1"
Coincide con il campo 1
della riga presente nel
messaggio originario
S
Identificativo del
campo del in cui
è stato riscontrato
l'errore
Coincide con il numero
riportato nella colonna
"Progressivo campo" che
corrisponde al campo errato
5
Numeric
Tracciato
2
39
Messaggio 001 – Riga B
Note di compilazione
-
Campo 2
Rappresenta il codice dell’errore riscontrato e deve essere
rilevato dalla Tabella 5 Codici di Errore
91
Protocollo di comunicazione comma 6b
Versione 1.0
6.5.3
Pag. 92 di 127
10 Agosto 2011
NOTIFICA DI VALIDAZIONE (CODICE MESSAGGIO 002)
Descrizione
La notifica viene utilizzata dal sistema di controllo VLT per trasmettere al
sistema del concessionario VLT l’esito positivo dei controlli effettuati
successivamente alla chiusura della sessione.
Tipo di messaggio
Vuoto: il messaggio è composto dalla sola testata mentre il messaggio operativo
è assente (cioè di lunghezza 0).
92
Protocollo di comunicazione comma 6b
Versione 1.0
6.5.4
Pag. 93 di 127
10 Agosto 2011
NOTIFICA DI RICHIESTA EVASA (CODICE MESSAGGIO 003)
Descrizione
Il messaggio viene utilizzato dal sistema di controllo VLT per notificare al
sistema del concessionario VLT la ricezione della risposta ad una richiesta del
sistema di controllo VLT stesso.
Tale messaggio viene trasmesso nella medesima sessione nella quale viene
ricevuta la risposta cui si riferisce la notifica
Tipo di messaggio
Vuoto: il messaggio è composto dalla sola testata mentre il messaggio operativo
è assente (cioè di lunghezza 0).
93
Protocollo di comunicazione comma 6b
Versione 1.0
6.5.5
NOTIFICA
Pag. 94 di 127
10 Agosto 2011
DEL CODICE IDENTIFICATIVO DEI JACKPOT E/O DI POSSIBILI
ANOMALIE RISCONTRATE (CODICE MESSAGGIO 005)
Descrizione
Il messaggio viene utilizzato dal sistema di controllo VLT per trasmettere al
sistema del concessionario VLT i codici identificativi assegnati da AAMS ai
nuovi jackpot definiti dal concessionario tramite un messaggio 601.
Questa notifica viene trasmessa, anche in caso di possibili anomalie riscontrate
durante la creazione o l’erogazione di jackpot, successivamente alla chiusura
della sessione.
Tipo di messaggio
Notifica
Struttura
Il messaggio è composto da più righe, così come illustrato nella tabella che
segue:
Riga
A
Descrizione
Occorrenze
Una per messaggio
Dati di riepilogo
Per ogni jackpot si ripete la seguente riga
B
Una per ogni jackpot.
Codici identificativi del
jackpot
L’ordine delle righe B è lo stesso di
quello delle righe C del 601.
Per ogni anomalia si ripete la seguente riga
C
Descrizione dell’anomalia
94
Una per ogni anomalia
Protocollo di comunicazione comma 6b
Versione 1.0
Progressivo
campo
1
2
3
Tipo
String
Numeric
Numeric
Tracciato
Pag. 95 di 127
10 Agosto 2011
Lunghezza
massima
1
10
10
40
Descrizione
Tipo riga
Numero righe B
Numero righe C
Note di compilazione
Vale “A”
Messaggio 005 – Riga A
Progressivo
campo
1
Tipo
String
Lunghezza
massima
1
2
String
50
3
Numeric
10
Tracciato
41
Descrizione
Note di compilazione
Tipo riga
Vale “B”
Codice
Codice utilizzato sul
identificativo del
sistema di gioco del
jackpot
concessionario
Codice
identificativo
jackpot
Codice rilasciato da AAMS
Messaggio 005 – Riga B
Note di compilazione
La suddetta riga B è presente solo in caso di risposta al messaggio 601,
contenente il campo 4 della riga A, con valore pari a 0 (definizione di nuovo
Jackpot).
95
Protocollo di comunicazione comma 6b
Versione 1.0
Riga C
Pag. 96 di 127
10 Agosto 2011
Anomalie del jackpot
Progressivo
campo
1
Tipo
String
Lunghezza
massima
1
2
Numeric
4
3
4
5
Descrizione
Tipo riga
Codice
dell'anomalia
riscontrata
Note di compilazione
Vale "C"
Vedi Tabella 5
6
Progressivo riga
Progressivo che identifica
la riga all'interno del
messaggio 601, nella quale
è presente il campo errato.
1
Identificativo
della riga che
contiene l'errore
Coincide con il campo 1
della riga presente nel
messaggio originario
Numeric
2
Identificativo del
campo del in cui
è stato riscontrato
l'anomalia
Coincide con il numero
riportato nella colonna
"Progressivo campo" che
corrisponde al campo errato
Tracciato
42
Messaggio 005 – Riga C
Numeric
String
96
Protocollo di comunicazione comma 6b
Versione 1.0
6.5.6
Pag. 97 di 127
10 Agosto 2011
NOTIFICA DEI DATI IDENTIFICATIVI DI UN APPARECCHIO VIDEOTERMINALE
(CODICE MESSAGGIO 006)
Descrizione
Il messaggio viene utilizzato dal sistema di controllo VLT per trasmettere al
sistema del concessionario VLT i dati identificativi di un apparecchio
videoterminale come notifica di validazione in risposta al messaggio 311.
Tipo di messaggio
Notifica
Struttura
Progressivo
campo
1
Tipo
String
Lunghezza
massima
1
Descrizione
Tipo riga
Note di compilazione
Vale "A"
2
String
11
Codeid
Codice che rilascia AAMS
3
String
16
4
5
String
String
12
16
6
7
8
Numeric
Numeric
Eurocent
Tracciato
Relativo all'apparecchio
MAC ADDRESS
videoterminale
Codice
identificativo dell'
ubicazione
Codice rilasciato da AAMS
MAC ADDRESS Relativo al sistema di sala
2
Tipo di
connessione con
il sistema di sala
2
12
Tipo di
connessione con
il sistema di gioco
TOT_BET
43
Vedi Tabella 2
Vedi Tabella 2
Messaggio 006
Note di compilazione
- Campo 4
Codice identificativo dell’ubicazione in cui è installato
l’apparecchio videoterminale.
- Campi 3 e 5
Il campo è di lunghezza pari esclusivamente a 12 o 16; in
presenza di valore di lunghezza inferiore bisogna effettuare un padding a
sinistra con il carattere “0” (zero).
97
Protocollo di comunicazione comma 6b
Versione 1.0
-
-
Pag. 98 di 127
10 Agosto 2011
Campi 6 e 7 Il valore deve essere rilevato dalla Tabella 2
Tipologia di collegamento
Campi 5, 6 e 7Sono valorizzati a seconda di quanto è stato censito con
esito positivo dal sistema del concessionario VLT al sistema di controllo
VLT.
Campo 8
Importo totale delle somme complessivamente puntate
sull’apparecchio videoterminale. Corrisponde, se presente nell’anno,
all’ultimo valore comunicato all’interno del messaggio 600, Riga A, campo
10 dal sistema del concessionario VLT al sistema di controllo VLT ed
avente esito positivo.
Il tracciato precedentemente descritto, per il presente messaggio 006, dal 30
Maggio 2012 sarà sostituito da quanto segue
Progressivo
campo
1
Tipo
String
Lunghezza
massima
1
Descrizione
Tipo riga
Note di compilazione
Vale "A"
2
String
11
Codeid
Codice che rilascia AAMS
3
String
16
4
5
String
String
12
16
6
Numeric
2
Tipo di
connessione con
il sistema di sala
Tipo di
connessione con
il sistema di gioco
TOT_BET
7
8
Numeric
Eurocent
2
12
9
Numeric
10
Tracciato
Relativo all'apparecchio
MAC ADDRESS
videoterminale
Codice
identificativo dell'
ubicazione
Codice rilasciato da AAMS
MAC ADDRESS Relativo al sistema di sala
Vedi Tabella 2
Vedi Tabella 2
Codice modello Codice rilasciato da AAMS
44
98
Messaggio 006
Protocollo di comunicazione comma 6b
Versione 1.0
6.5.7
NOTIFICA
DEL
Pag. 99 di 127
10 Agosto 2011
CODICE
IDENTIFICATIVO
DELL’UBICAZIONE
(CODICE
MESSAGGIO 008)
Descrizione
Il messaggio viene utilizzato dal sistema di controllo VLT per trasmettere al
sistema del concessionario VLT il codice identificativo assegnato da AAMS
alla nuova ubicazione censito tramite un messaggio 300.
Questa notifica viene trasmessa solo nel caso di esito positivo dei controlli
effettuati su un messaggio 300 successivamente alla chiusura della sessione.
Si precisa che, quando sarà disponibile l'Elenco unico di censimento e
successivamente al 30 Maggio 2012, il messaggio, sarà utilizzato esclusivamente
per la notifica del codice identificativo dei magazzini.
Tipo di messaggio
Notifica
Struttura
Progressivo
campo
1
Tipo
String
Lunghezza
massima
1
2
String
16
Tracciato
Descrizione
Tipo riga
Note di compilazione
Vale “A”
Codice identificativo
dell'ubicazione
Codice rilasciato da AAMS
45
99
Messaggio 008
Protocollo di comunicazione comma 6b
Versione 1.0
6.5.8
NOTIFICA
Pag. 100 di 127
10 Agosto 2011
SOSPENSIONE/CANCELLAZIONE/ANNULLAMENTO
DI
SOSPENSIONE DI UN SOGGETTO DALL’ELENCO DEI SOGGETTI(CODICE
MESSAGGIO 014)
Descrizione
Il messaggio viene utilizzato dal sistema di controllo VLT per trasmettere al
sistema del concessionario VLT la notifica di sospensione/cancellazione/
annullamento sospensione di un soggetto dall’Elenco dei soggetti.
Si precisa che, quando sarà disponibile l'Elenco dei soggetti e successivamente al
30 Maggio 2012, il messaggio sarà utilizzato per trasmettere i dati al sistema del
concessionario VLT.
Tipo di messaggio
Notifica
Struttura
Progressivo
campo
1
2
3
Tipo
String
String
Numeric
Lunghezza
massima
1
Descrizione
Tipo riga
16
Codice fiscale/Partita
iva del soggetto
sospeso/cancellato/c
on annullamento
della sospensione
Vale “1” per cancellazione,
“2” per sospensione e “3”
per l'annullamento della
sospensione
1
Tracciato
Note di compilazione
Vale “A”
46
100
Messaggio 014
Protocollo di comunicazione comma 6b
Versione 1.0
6.5.9
Pag. 101 di 127
10 Agosto 2011
ABILITAZIONE/DISABILITAZIONE
(CODICE MESSAGGIO 100)
DI UN APPARECCHIO VIDEOTERMINALE
Descrizione
Il messaggio viene utilizzato dal sistema di controllo VLT per ordinare al
sistema del concessionario VLT un cambio di stato su un apparecchio
videoterminale.
Tipo di messaggio
Azioni,
Struttura
Progressivo
campo
1
Tipo
String
Lunghezza
massima
1
Descrizione
Tipo riga
Note di compilazione
Vale "A"
2
String
11
Codeid
3
String
1
Flag Stato
Codice che rilascia AAMS
Abilitazionee(1)/
Disabilitazione(0)
Tracciato
47
Messaggio 100 Richiesta
101
Protocollo di comunicazione comma 6b
Versione 1.0
6.5.10
VERIFICA
Pag. 102 di 127
10 Agosto 2011
DELL’INTEGRITÀ
DEL
SOFTWARE
INSTALLATO
SU
DI
UN
APPARECCHIO VIDEOTERMINALE (CODICE MESSAGGIO 101)
Descrizione
Il messaggio viene utilizzato dal sistema di controllo VLT per chiedere al
sistema del concessionario VLT di verificare l’integrità del software istallato
su un apparecchio videoterminale.
Tipo di messaggio
Richiesta
Struttura
Progressivo
campo
1
Tipo
String
Lunghezza
massima
1
Obbl.
S
Descrizione
Tipo riga
Note di compilazione
Vale “A”
2
String
11
S
Codeid
Codice rilasciato da AAMS
Tracciato
48
Messaggio 101 Richiesta
Tipo di messaggio
Risposte alle richieste
Struttura
Progressivo
campo
1
Tipo
String
Lunghezza
massima
1
Obbl.
S
Descrizione
Tipo riga
Note di compilazione
Vale “A”
2
String
11
S
3
String
1
S
Codeid
Risultato della
verifica
Codice rilasciato da AAMS
1 codice esatto, 0 codice
errato
Tracciato
49
Messaggio 101 Risposta
102
Protocollo di comunicazione comma 6b
Versione 1.0
6.5.11
VERIFICA
Pag. 103 di 127
10 Agosto 2011
DELL’INTEGRITA’ DEL SOFTWARE DI UNO SPECIFICO GIOCO
INSTALLATO SU DI UN APPARECCHIO VIDEOTERMINALE (CODICE MESSAGGIO
102)
Descrizione
Il messaggio viene utilizzato dal sistema di controllo VLT per chiedere al
sistema del concessionario VLT di verificare l’integrità del software di uno
specifico gioco istallato su un apparecchio videoterminale.
Tipo di messaggio
Richiesta
Struttura
Progressivo
campo
1
Tipo
String
Lunghezza
massima
1
Obbl.
S
2
Numeric
10
S
3
String
11
S
Tracciato
50
Descrizione
Note di compilazione
Tipo riga
Vale “A”
Codice
identificativo del
gioco
Codice rilasciato da AAMS
Codeid
Codice rilasciato da AAMS
Messaggio 102 Richiesta
Tipo di messaggio
Risposte alle richieste
Struttura
Progressivo
campo
1
Tipo
String
Lunghezza
massima
1
Obbl.
S
2
Numeric
10
S
3
String
11
S
Codeid
Codice rilasciato da AAMS
4
String
1
S
Risultato della
verifica
1 codice esatto,0 codice
errato
Tracciato
51
Descrizione
Note di compilazione
Tipo riga
Vale “A”
Codice
identificativo del
gioco
Codice rilasciato da AAMS
Messaggio 102 Risposta
103
Protocollo di comunicazione comma 6b
Versione 1.0
6.5.12
VERIFICA
Pag. 104 di 127
10 Agosto 2011
DELL’INTEGRITÀ DEL SOFTWARE INSTALLATO SU DI UN SISTEMA
CENTRALE(CODICE MESSAGGIO 103)
Il messaggio deve essere implementato dal 30 Maggio 2012.
Descrizione
Il messaggio viene utilizzato dal sistema di controllo VLT per chiedere al
sistema del concessionario VLT di verificare l’integrità del software installato
su di un sistema centrale VLT.
Tipo di messaggio
Richiesta
Struttura
Progressivo
campo
1
2
Tipo
String
Numeric
Tracciato
Lunghezza
massima
1
Obbl.
S
10
52
S
Descrizione
Tipo riga
Note di compilazione
Vale “A”
Codice
identificativo del
sistema di gioco Codice rilasciato da AAMS
Messaggio 103 Richiesta
Tipo di messaggio
Risposte alle richieste
Struttura
Progressivo
campo
1
Tipo
String
Lunghezza
massima
1
Obbl.
S
2
Numeric
10
S
3
String
1
S
Tracciato
53
Descrizione
Tipo riga
Codice
identificativo del
sistema di gioco Codice rilasciato da AAMS
Risultato della
1 codice esatto, 0 codice
verifica
errato
Messaggio 103 Risposta
104
Note di compilazione
Vale “A”
Protocollo di comunicazione comma 6b
Versione 1.0
6.5.13
RICHIESTA
DELLA
Pag. 105 di 127
10 Agosto 2011
DATA
E
DEL
RISULTATO
DELL’ULTIMA
VERIFICA
DELL’INTEGRITÀ DEL SOFTWARE INSTALLATO SU DI UN APPARECCHIO
VIDEOTERMINALE
(CODICE MESSAGGIO 210)
Descrizione
Il messaggio viene utilizzato dal sistema di controllo VLT per chiedere al
sistema del concessionario VLT la data e il risultato dell’ultima verifica di
integrità del software istallato su un apparecchio videoterminale.
Tipo di messaggio
Richieste
Struttura
Progressivo
campo
1
Tipo
String
Lunghezza
massima
1
Obbl.
S
Descrizione
Tipo riga
Note di compilazione
Vale “A”
2
String
11
S
Codeid
Codice rilasciato da AAMS
Tracciato
54
Messaggio 210 Richiesta
Tipo di messaggio
Risposte alle richieste
Struttura
Progressivo
campo
1
Tipo
String
Lunghezza
massima
1
Obbl.
S
Descrizione
Tipo riga
Note di compilazione
Vale “A”
2
3
String
Date
11
6
S
S
Codeid
Data
Codice rilasciato da AAMS
Data interrogazione
4
String
1
S
Risultato della
verifica
1 codice esatto,0 codice
errato
Tracciato
55
Messaggio 210 Risposta
105
Protocollo di comunicazione comma 6b
Versione 1.0
6.5.14
Pag. 106 di 127
10 Agosto 2011
RICHIESTA DELLA DATA E DEL RISULTATO DELL’ULTIMA VERIFICA
DELL’INTEGRITÀ DEL SOFTWARE DI UNO SPECIFICO GIOCO INSTALLATO SU
DI UN APPARECCHIO VIDEOTERMINALE (CODICE MESSAGGIO 211)
Descrizione
Il messaggio viene utilizzato dal sistema di controllo VLT per chiedere al
sistema del concessionario VLT la data e il risultato dell’ultima verifica di
integrità del software di un gioco istallato su un apparecchio videoterminale.
Tipo di messaggio
Richieste
Struttura
Progressivo
campo
1
Tipo
String
Lunghezza
massima
1
Obbl.
S
2
Numeric
10
S
3
String
11
S
Tracciato
56
Descrizione
Note di compilazione
Tipo riga
Vale “A”
Codice
identificativo del
gioco
Codice rilasciato da AAMS
Codeid
Messaggio 211 Richiesta
106
Codice rilasciato da AAMS
Protocollo di comunicazione comma 6b
Versione 1.0
Pag. 107 di 127
10 Agosto 2011
Tipo di messaggio
Risposte alle richieste
Struttura
Progressivo
campo
1
Tipo
String
Lunghezza
massima
1
Obbl.
S
2
Numeric
10
S
3
4
String
Date
11
6
S
S
5
String
1
S
Tracciato
57
Descrizione
Note di compilazione
Tipo riga
Vale “A”
Codice
identificativo del
gioco
Codice rilasciato da AAMS
Codeid
Data
Risultato della
verifica
Messaggio 211 Risposta
107
Codice rilasciato da AAMS
Data interrogazione
1 codice esatto,0 codice
errato
Protocollo di comunicazione comma 6b
Versione 1.0
6.5.15
RICHIESTA
Pag. 108 di 127
10 Agosto 2011
DELLO STATO DEI GIOCHI INSTALLATI SU DI UN APPARECCHIO
VIDEOTERMINALE (CODICE MESSAGGIO 212)
Descrizione
Il messaggio viene utilizzato dal sistema di controllo VLT per chiedere al
sistema del concessionario VLT l’elenco dello stato dei giochi installati su un
apparecchio videoterminale.
Tipo di messaggio
Richieste
Struttura
Progressivo
campo
1
2
Tipo
String
Lunghezza
massima
1
Obbl.
S
Descrizione
Tipo riga
Note di compilazione
Vale “A”
String
11
S
Codeid
Codice rilasciato da AAMS
Tracciato
58
Messaggio 212 Richiesta
Tipo di messaggio
Risposte alle richieste
Riga
Descrizione
A
Indica il numero di righe
B
Occorrenze
Una per messaggio.
Per ogni gioco installato.
B
Una per gioco installato
apparecchio videoterminale
Stato
108
sul
Protocollo di comunicazione comma 6b
Versione 1.0
Pag. 109 di 127
10 Agosto 2011
Struttura
Progressivo
campo
1
Tipo
String
Lunghezza
massima
1
Obbl.
S
2
String
11
S
3
Numeric
10
S
Tracciato
59
Tipo
String
Lunghezza
massima
1
Obbl.
S
2
3
Numeric
String
10
1
S
S
60
Note di compilazione
Vale “A”
Codeid
Codice rilasciato da AAMS
Numero di righe
B
Messaggio 212 Risposta Riga A
Progressivo
campo
1
Tracciato
Descrizione
Tipo riga
Descrizione
Note di compilazione
Tipo riga
Vale “B”
Codice
identificativo del
gioco
Codice rilasciato da AAMS
Stato
1 abilitato/ 0 disabilitato
Messaggio 212 Risposta Riga B
109
Protocollo di comunicazione comma 6b
Versione 1.0
6.5.16
RICHIESTA
Pag. 110 di 127
10 Agosto 2011
DELLO STATO DI UN APPARECCHIO VIDEOTERMINALE
(CODICE
MESSAGGIO 213)
Descrizione
Il messaggio viene utilizzato dal sistema di controllo VLT per chiedere al
sistema del concessionario VLT lo stato di un apparecchio videoterminale.
Tipo di messaggio
Richieste
Struttura
Progressivo
campo
1
Tipo
String
Lunghezza
massima
1
Obbl.
S
Descrizione
Tipo riga
Note di compilazione
Vale “A”
2
String
11
S
Codeid
Codice rilasciato da AAMS
Tracciato
61
Messaggio 213 Richiesta
Tipo di messaggio
Risposte alle richieste
Struttura
Progressivo
campo
1
Tipo
String
Lunghezza
massima
1
Obbl.
S
Descrizione
Tipo riga
2
3
String
String
11
1
S
S
Codeid
Flag Stato
4
DataOra
12
S
5
String
1
S
Flag Stato
S
Data di cambio
stato
6
DataOra
Tracciato
12
62
Codice rilasciato da AAMS
Acceso(1)/Spento(0)
Data relativa dell'ultimo
Data di cambio cambio di stato del campo
stato
3
Messaggio 213 Risposta
110
Note di compilazione
Vale “A”
Disabilitato al gioco(2) /
Abilitato al gioco (3)
Data relativa dell'ultimo
cambio di stato del campo
5
Protocollo di comunicazione comma 6b
Versione 1.0
6.5.17
Pag. 111 di 127
10 Agosto 2011
RICHIESTA DELLA DATA E DEL RISULTATO DELL’ULTIMA
DELL’INTEGRITÀ DEL SOFTWARE INSTALLATO SU DI UN SISTEMA
VLT (CODICE MESSAGGIO 214)
VERIFICA
CENTRALE
Il messaggio deve essere implementato dal 30 Maggio 2012.
Descrizione
Il messaggio viene utilizzato dal sistema di controllo VLT per chiedere al
sistema del concessionario VLT la data e il risultato dell’ultima verifica di
integrità del software installato su di un sistema centrale VLT.
Tipo di messaggio
Richieste
Struttura
Progressivo
campo
1
Tipo
String
2
Numeric
Tracciato
Lunghezza
massima
1
Obbl.
S
10
63
S
Descrizione
Tipo riga
Note di compilazione
Vale “A”
Codice
identificativo del
sistema di gioco Codice rilasciato da AAMS
Messaggio 214 Richiesta
Tipo di messaggio
Risposte alle richieste
Struttura
Progressivo
campo
1
Tipo
String
Lunghezza
massima
1
Obbl.
S
2
3
Numeric
Date
10
6
S
S
4
String
1
S
Tracciato
64
Descrizione
Tipo riga
Codice
identificativo del
sistema di gioco Codice rilasciato da AAMS
Data
Data interrogazione
Risultato della
1 codice esatto,0 codice
verifica
errato
Messaggio 214 Risposta
111
Note di compilazione
Vale “A”
Protocollo di comunicazione comma 6b
Versione 1.0
6.5.18
Pag. 112 di 127
10 Agosto 2011
RICHIESTA DEI DATI DI CONTABILITÀ(CODICE MESSAGGIO 250)
Il messaggio deve essere implementato dal 30 Maggio 2012.
Descrizione
Il messaggio viene utilizzato dal sistema di controllo VLT per chiedere al
sistema del concessionario VLT i dati di contabilità relativi ad uno dei
seguenti componenti del sistema del concessionario VLT:
sistema di gioco VLT,
sala,
apparecchio videoterminale
relativi ad un:
giorno,
mese,
anno.
Tipo di messaggio
Richiesta
Progressivo
campo
1
Tipo
String
Lunghezza
massima
1
Obbl.
S
Descrizione
Tipo riga
Note di compilazione
Vale “A”
2
Numeric
1
S
Tipo componente
Vedi Tabella 4
3
4
5
6
String
Numeric
Numeric
Numeric
12
4
2
2
S
S
C
C
Codice identificativo
del componente
Codice rilasciato da AAMS
Anno
Mese
da 01 a 12
Giorno
da 01 a 31
7
Numeric
10
C
Codice identificativo
del sistema di gioco Codice rilasciato da AAMS
Tracciato
65
Messaggio 250 Richiesta
Note di compilazione
112
Protocollo di comunicazione comma 6b
Versione 1.0
-
Pag. 113 di 127
10 Agosto 2011
Campo 2
Il valore deve essere rilevato dalla Tabella 4
Tipologia di componente.
Campi 2 e 3 Individuano il componente da cui si richiede i data di gioco.
Campi 4, 5 e 6 Definiscono l’intervallo temporale su cui il sistema di
controllo VLT richiede i dati di contabilità.
Campo 7
Rappresenta il sistema di gioco VLT al quale è legato il
componente del campo 3. È assente nel caso in cui il campo 2 assume il
valore 1 (sistema di gioco VLT), negli altri casi è obbligatorio.
Struttura
Risposta
Riga
Descrizione
A
Dati di contabilità del
componente del sistema
del concessionario VLT
Occorrenze
Una per messaggio
Per ogni gioco si ripete la seguente riga.
B
Dati di contabilità per
ciascun gioco presente
nel componente del
sistema del
concessionario VLT
definito sulla riga A.
113
Una per gioco
Protocollo di comunicazione comma 6b
Versione 1.0
Pag. 114 di 127
10 Agosto 2011
Struttura
Progressivo
campo
1
Tipo
String
Lunghezza
massima
1
Obbl.
S
Descrizione
Tipo riga
Note di compilazione
Vale “A”
2
Numeric
1
S
Tipo componente
Vedi Tabella 4
3
4
5
6
7
8
9
10
11
12
String
Eurocent
Eurocent
Eurocent
Eurocent
Eurocent
Numeric
Numeric
Numeric
Numeric
12
12
12
12
12
12
12
4
2
2
S
S
S
C
S
S
S
S
C
C
Codice identificativo
del componente
Codice rilasciato da AAMS
BET
Importo puntate
WIN
Vincite conseguite
TOT_PAID
Importo riscosso
TOT_IN
Importo introdotto
TOT_OUT
Importo erogato
BET_NUM
Numero puntate
Anno
Mese
da 01 a 12
Giorno
da 01 a 31
13
Numeric
10
C
Codice identificativo
del sistema di gioco Codice rilasciato da AAMS
Tracciato
66
Messaggio 250 Risposta Riga A
Note di compilazione
- Campo 2
Il valore deve essere rilevato dalla Tabella 4
Tipologia di componente.
- Campi 2 e 3 Individuano il componente di cui si inviano i dati di gioco
contenuti nei successivi campi.
- Campo 4
Importo totale delle somme puntate, comprensivo degli
importi derivanti da vincite ricollocate in gioco, nell’intervallo temporale
definito nei campi 10, 11 e 12.
- Campo 5
Importo totale delle vincite conseguite (comprensivo degli
importi ricollocati in gioco) nell’intervallo temporale definito nei campi 10,
11 e 12. Sono esclusi dall’importo le vincite conseguite relativamente ai
jackpot
- Campo 6
Importo totale del TOT_OUT riscosso nell’intervallo
temporale definito nei campi 10, 11 e 12. Deve essere valorizzato solo nel
caso in cui il Campo 2 vale 1 o 2.
- Campo 7
Importo totale introdotto attraverso i sistemi di
introduzione credito previsti su ciascun apparecchio videoterminale
nell’intervallo temporale definito nei campi 10, 11 e 12.
114
Protocollo di comunicazione comma 6b
Versione 1.0
-
-
-
Pag. 115 di 127
10 Agosto 2011
Campo 8
Importo totale erogato attraverso i sistemi di erogazione
previsti su ciascun apparecchio videoterminale nell’intervallo temporale
definito nei campi 10, 11 e 12.
Campo 9
Numero delle puntate effettuate anche a seguito di vincite
ricollocate in gioco nell’intervallo temporale definito nei campi 10, 11 e 12.
Campi 10, 11 e 12
Definiscono l’intervallo temporale a cui si
riferiscono i dati inviati nei campi da 4 a 9. L’intervallo temporale deve
essere uguali ai campi 4,5 e 6 della riga A della richiesta
Campo 13
Rappresenta il sistema di gioco VLT al quale è legato il
componente del campo 3. È assente nel caso in cui il campo 2 assume il
valore 1 (sistema di gioco), negli altri casi è obbligatorio e deve coincidere
con quanto censito nella banca dati del sistema di controllo VLT.
Progressivo
campo
1
Tipo
String
Lunghezza
massima
1
Obbl.
S
2
3
4
5
Numeric
Eurocent
Eurocent
Numeric
10
12
12
12
S
S
S
S
Tracciato
67
Descrizione
Tipo riga
Note di compilazione
Vale “B”
Codice identificativo
del gioco
Codice rilasciato da AAMS
BET
WIN
Vincita conseguita
BET_NUM
Messaggio 250 Risposta Riga B
Note di compilazione
- Campo 2
Codice identificativo del gioco di cui si inviano i dati
contenuti nei campi successivi; tali dati devono essere raggruppati per il
componente specificato nella riga A campo 3. Il gioco deve essere stato
installato sul componente della riga A nell’intervallo temporale definito nei
campi 10, 11 e 12 della riga A.
- Campo 3
Importo totale delle somme puntate, comprensivo degli
importi derivanti da vincite ricollocate in gioco, nell’intervallo temporale
definito nei campi 10, 11 e 12 della riga A.
- Campo 4
Importo totale delle vincite conseguite (comprensivo degli
importi ricollocati in gioco) nell’intervallo temporale definito nei campi 10,
11 e 12 della riga A. Sono esclusi dall’importo le vincite conseguite
relativamente ai jackpot
- Campo 5
Numero delle puntate effettuate anche a seguito di vincite
ricollocate in gioco nell’intervallo temporale definito nei campi 10, 11 e 12
della riga A.
115
Protocollo di comunicazione comma 6b
Versione 1.0
6.5.19
Pag. 116 di 127
10 Agosto 2011
AUTORIZZAZIONE AL CAMBIO DI STATO DI UN GIOCO SU UN
VIDEOTERMINALE (CODICE MESSAGGIO 400)
APPARECCHIO
Il messaggio viene utilizzato dal sistema di controllo VLT per comunicare
l’autorizzazione al cambio stato di un gioco su un apparecchio videoterminale
(richiesto mediante il messaggio 313).
Tipo di messaggio
Azione
Struttura
Progressivo
campo
1
Tipo
String
Lunghezza
massima
1
Obbl.
S
2
Numeric
15
S
Tracciato
68
116
Descrizione
Tipo riga
Identificativo del
messaggio
applicativo della
richiesta 313
Messaggio 400
Note di compilazione
Vale “A”
Protocollo di comunicazione comma 6b
Versione 1.0
7.
Pag. 117 di 127
10 Agosto 2011
TABELLE DI DECODIFICA
Il paragrafo contiene le tabelle da utilizzare per impostare il valore di tutti i
campi presenti nei messaggi operativi che presuppongono l’utilizzo di
particolari codici.
Tali tabelle, successivamente alla data del presente documento, potranno essere
oggetto di periodici aggiornamenti.
Tabella 1
Codice
1
2
3
4
5
6
9
-
Tipi d’ubicazione
Descrizione
Sala giochi
Agenzia scommesse
Agenzia ippica
Sala bingo
Negozio di gioco
Esercizio comma6
Magazzino
117
Protocollo di comunicazione comma 6b
Versione 1.0
Tabella 2
-
Pag. 118 di 127
10 Agosto 2011
Tipologia di collegamento
Codice
1
2
3
4
5
6
7
8
9
10
11
12
13
Descrizione
PSTN
ISDN
DSL / ADSL
CDN
GSM
GPRS
UMTS
WIMAX
MISTO
ALTRO
HDSL
LAN
WI-FI
118
Protocollo di comunicazione comma 6b
Versione 1.0
Tabella 3
-
Pag. 119 di 127
10 Agosto 2011
Tipologia sistemi collegamenti
Codice
1
2
3
4
Tabella 4
Descrizione
Videoterminale - Sistema di sala
Sistema di sala - Sistema centrale
Videoterminale - Sistema centrale
Sistema centrale - Sistema di recovery e di backup
-
Tipologia di componente
Codice
1
2
3
Tabella 5
Descrizione
Sistema di gioco
Sala/Magazzino
Apparecchio videoterminale
-
Codici di Errore
119
Protocollo di comunicazione comma 6b
Versione 1.0
Pag. 120 di 127
10 Agosto 2011
Codice
0
1
2
3
4
5
6
7
8
9
10
13
18
19
20
21
1000
1001
1002
1003
1004
2000
2001
2002
2003
2055
3000
3001
3002
3003
3004
3005
3006
3007
Descrizione
NESSUN ERRORE
ACCETTAZIONE TEMPORANEAMENTE NON DISPONIBILE
TESTATA NON ELABORABILE
TIPO MESSAGGIO NON PREVISTO O NON ATTIVO
MESSAGGIO DUPLICATO
LUNGHEZZA MESSAGGIO ERRATA
CODICE MITTENTE ERRATO O MANCANTE
MESSAGGIO CON NUMERO DI RIGHE ERRATO
MESSAGGIO CON NUMERO DI CAMPI ERRATO
INCONGRUENZA DATI DI GIOCO
NON CONFORMITÀ AL GIOCO LECITO
VALORE DEL CAMPO NON CONGRUENTE
NOTIFICA DI RICEZIONE NON RICEVUTA
RISPOSTA NON CONGRUENTE ALLA RICHIESTA
MESSAGGIO PREVENTIVO NON RICEVUTO
IDENTIFICATIVO MESSAGGIO APPLICATIVO NON VALIDO OD
INESISTENTE
CAMPO OBBLIGATORIO ASSENTE
TIPO CAMPO NON CORRETTO
LUNGHEZZA CAMPO ERRATA
FORMATO DEL CAMPO ERRATO
FORMATO DEL RECORD ERRATO
INCONGRUENZA DATE
DATA CESSAZIONE PRECEDENTE ALL'ULTIMA VARIAZIONE DI DATI
IMPOSSIBILE CESSARE L'APPARECCHIO, PRESENTI BET >0 IN PERIODO
SUCCESSIVO
DATA CESSAZIONE PRECEDENTE AD UN'EROGAZIONE DI JACKPOT
EVENTO NON PREVISTO
CODICE IDENTIFICATIVO SPECIFICATO NEL CAMPO NON PREVISTO
NELLA TABELLA DI RIFERIMENTO
CODICE FISCALE ERRATO
APPARECCHIO VIDEOTERMINALE SCONOSCIUTO
L'UBICAZIONE NON E' UN AMBIENTE DEDICATO COLLAUDATO
CODICE GIOCO NON VALIDO
GIOCO NON CERTIFICATO
DATI DUPLICATI
INCONGRUENZA DEI CONTATORI
120
Protocollo di comunicazione comma 6b
Versione 1.0
3008
3009
3010
3014
3024
3026
3027
3028
3029
3030
3031
3032
3033
3034
3035
3042
3051
3052
3053
3054
3055
3056
3060
3061
3062
3063
3065
4010
4013
Pag. 121 di 127
10 Agosto 2011
NESSUN VLT INSTALLATO SUL SISTEMA DI GIOCO
IL MODELLO DEL JACKPOT NON E' PRESENTE NEL DB
INCONGRUENZA DEI CONTATORI TOTALI SUCCESSIVI ALLA DATA
DI CESSAZIONE
DATA ESTRAZIONE NON CONGRUENTE
L’APPARECCHIO VLT RISULTA ROTTAMATO
APPARECCHIO VLT NON ASSOCIATO ALL’ESERCIZIO
STATO INCONGRUENTE DELL’APPARECCHIO
SONO PRESENTI SISTEMI DI SALA ATTIVI, NON SI PUO' CESSARE
QUESTA UBICAZIONE
SONO PRESENTI VLT ATTIVI, NON SI PUO' CESSARE QUESTA
UBICAZIONE
SONO PRESENTI VLT ATTIVI, NON SI PUO' CESSARE IL SISTEMA DI
SALA
CODICE UBICAZIONE NON CONGRUENTE
SONO PRESENTI JACKPOT NON EROGATI
ESISTE UN VLT AVENTE STESSA DATA MA STATO DIFFERENTE
NESSUN VLT INSTALLATO NELL'UBICAZIONE
CODICE IDENTIFICATIVO DI UBICAZIONE NON VALIDO
SPOSTAMENTO NON CONSENTITO
CODICE FISCALE NON ESISTENTE IN ANAGRAFE TRIBUTARIA
CODICE FISCALE ERRATO IN ANAGRAFE TRIBUTARIA
PARTITA IVA CESSATA IN ANAGRAFE TRIBUTARIA
PARTITA IVA NON PRESENTE O NON ATTIVA IN ANAGRAFE
TRIBUTARIA
OMOCODICI
CODICE FISCALE NON ASSEGNATO IN ANAGRAFE TRIBUTARIA
CODICE FISCALE DUPLICATO IN BANCA DATI
UBICAZIONE DUPLICATA IN BANCA DATI
CODICE UBICAZIONE CORRETTO MA DATI DI UBICAZIONE NON
CONGRUENTI IN BANCA DATI
DATI DI UBICAZIONE CORRETTI MA CODICE UBICAZIONE NON
CONGRUENTE IN BANCA DATI
COMUNE, PROVINCIA E CODICE CATASTALE DELL’AMBIENTE
DEDICATO NON CONGRUENTI
CONCESSIONARIO SCONOSCIUTO
UBICAZIONE NON ASSOCIATA AL CONCESSIONARIO
121
Protocollo di comunicazione comma 6b
Versione 1.0
4014
4019
4046
4052
4053
5004
5054
6003
6004
6005
6006
6007
6008
6009
6010
6011
6013
6015
6016
6017
6018
6019
6020
6021
6022
6023
6024
6025
Pag. 122 di 127
10 Agosto 2011
UBICAZIONE SCONOSCIUTA
UBICAZIONE DELL’APPARECCHIO VIDEOTERMINALE NON
CORRETTA
DATI DI RICHIESTA NON TROVATI
APPARECCHIO VIDEOTERMINALE NON AUTORIZZATO
DATA DI ESTRAZIONE FUORI TERMINE
ERRORE NELLA TRASMISSIONE DEI DATI
CODICE DI AUTENTICAZIONE ERRATO
L’APPARECCHIO VIDEOTERMINALE RISULTA BLOCCATO
APPARECCHIO VIDEOTERMINALE NON APPARTENENTE AL
CONCESSIONARIO
NESSUN DATO RICEVUTO CON DATA DI ESTRAZIONE UGUALE A
QUELLA INDICATA NEL MESSAGGIO
COMPONENTE GIA' INSTALLATO
APPARECCHIO VIDEOTERMINALE NON VALIDO
MESSAGGIO NON ANCORA ELABORATO
COMPONENTE NON PRESENTE IN BANCA DATI
MODELLO DI SISTEMA DI SALA NON ASSOCIATO AL SISTEMA DI
GIOCO
CONNESSIONE NON PREVISTA TRA MODELLO DI SISTEMA DI SALA E
SISTEMA DI GIOCO
NON E' STATA SPECIFICATA LA MODALITA' DI CONNESSIONE
IL NUMERO DI APPARECCHI VIDEOTERMINALI INSTALLATI NELLA
SALA SUPERA IL MASSIMO CONSENTITO
IL SISTEMA DI SALA E' INSTALLATO IN UN'ALTRA UBICAZIONE
CONNESSIONE NON PREVISTA TRA MODELLO APPARECCHIO
VIDEOTERMINALE E MODELLO DI SISTEMA DI SALA
MODELLO APPARECCHIO VIDEOTERMINALE NON ASSOCIATO AL
MODELLO DI SISTEMA DI SALA
IL NUMERO DI APPARECCHI VIDEOTERMINALI INSTALLATI SUL
SISTEMA DI SALA SUPERA IL MASSIMO CONSENTITO
IL SISTEMA DI SALA NON E' ASSOCIATO AL SISTEMA DI GIOCO
IL NUMERO DI APPARECCHI VIDEOTERMINALI INSTALLATI SUL
SISTEMA DI GIOCO SUPERA IL MASSIMO CONSENTITO
MODELLO DI APPARECCHIO VIDEOTERMINALE NON ASSOCIATO AL
SISTEMA DI GIOCO
CONNESSIONE NON PREVISTA TRA MODELLO APPARECCHIO
VIDEOTERMINALE E SISTEMA DI GIOCO
SISTEMA DI GIOCO NON ASSOCIATO ALL'APPARECCHIO
VIDEOTERMINALE
NESSUNA CONNESSIONE PRESENTE PER IL VLT
122
Protocollo di comunicazione comma 6b
Versione 1.0
6026
6027
Pag. 123 di 127
10 Agosto 2011
GIOCO E APPARECCHIO VIDEOTERMINALE NON ASSOCIATI ALLO
STESSO SISTEMA DI GIOCO
GIOCO NON INSTALLATO SULL'APPARECCHIO VIDEOTERMINALE
I seguenti codici d'errore entreranno in vigore dal 30 Maggio 2012
6028
6029
Tabella 6
COMPONENTE CESSATO
INCONGRUENTE CON I DATI DEFINITI IN UN MESSAGGIO 600
ACCETTATO DAL SISTEMA DI CONTROLLO DI AAMS
-
Motivi di mancata risposta
Codice
00
20
21
30
31
32
33
34
35
36
37
9
Tabella 7
Descrizione
Lunghezza messaggio operativo, da associare alla risposta, maggiore o uguale a
1 Mbyte
Banca dati non disponibile
Apparecchio videoterminale non disponibile
Elaborazione non completata per errori applicativi
Estrazione dei dati non effettuata per presenza di un guasto
Estrazione dei dati non effettuata per interventi di manutenzione
sull'apparecchio videoterminale
Estrazione dei dati non effettuata per interventi di manutenzione sul sistema di
sala
Estrazione dei dati non effettuata per interventi di manutenzione sul
collegamento presso l’ambiente dedicato
Estrazione dei dati non effettuata per interventi di manutenzione sulla rete di
comunicazione
Guasto al sistema di gioco
Manutenzione del sistema di gioco
Altro
-
Stato di funzionamento di un apparecchio videoterminale
123
Protocollo di comunicazione comma 6b
Versione 1.0
Pag. 124 di 127
10 Agosto 2011
Codice
0
1
2
3
Descrizione
Spento
Acceso
Disabilitato dal gioco
Abilitato al gioco
Tabella 8
-
Motivi di cessazione di un apparecchio videoterminale
Codice
1
2
3
4
99
Descrizione
Dismissione
Incendio
Furto
Sequestro
Altro
Tabella 9
-
Motivi di sostituzione dell’etichetta identificativa
Codice
1
2
3
Descrizione
Smarrimento
Furto
Danneggiamento
Tabella 10
-
Tipologia di jackpot
Codice
1
2
3
4
Descrizione
Jackpot di sistema dedicato esclusivamente ad un gioco
Jackpot di sistema con participazione di più giochi
Jackpot di sala dedicato esclusivamente ad un gioco
Jackpot di sala con participazione di più giochi
124
Protocollo di comunicazione comma 6b
Versione 1.0
8.
Pag. 125 di 127
10 Agosto 2011
ELENCO DELLE TABELLE E DELLE FIGURE
Elenco dei messaggi operativi provenienti dal sistema del concessionario VLT,
diretti verso il sistema di controllo VLT
Messaggi operativi concessionario - AAMS 1 ................................................................ 26 Messaggi operativi concessionario - AAMS 2 ................................................................. 27 Elenco dei messaggi operativi provenienti dal sistema di controllo VLT, diretti
verso il sistema del concessionario VLT
Messaggi operativi AAMS – Concessionario 1 ............................................................... 86 Messaggi operativi AAMS – Concessionario 2 ............................................................... 86 Elenco dei tracciati dei messaggi applicativi
Tracciato 1 Struttura generale del messaggio applicativo ......................................... 22 Tracciato 2 Testata del messaggio ............................................................................ 22 Tracciato 3 Messaggio 300 ........................................................................................ 29 Tracciato 4 Messaggio 300 ....................................................................................... 30 Tracciato 5 Messaggio 301 ........................................................................................ 32 Tracciato 6 Messaggio 301 ........................................................................................ 33 Tracciato 7 Messaggio 302 ........................................................................................ 34 Tracciato 8 Messaggio 303 ........................................................................................ 35 Tracciato 9 Messaggio 304 ........................................................................................ 38 Tracciato 10 Messaggio 305 ...................................................................................... 40 Tracciato 11 Messaggio 306 .................................................................................... 43 Tracciato 12 Messaggio 307 ...................................................................................... 46 Tracciato 13 Messaggio 308 ...................................................................................... 47 Tracciato 14 Messaggio 309 Riga A .......................................................................... 50 Tracciato 15 Messaggio 309 Riga B ........................................................................... 50 Tracciato 16 Messaggio 310 ...................................................................................... 51 Tracciato 17 Messaggio 311 ...................................................................................... 53 Tracciato 18 Messaggio 312 ...................................................................................... 54 Tracciato 19 Messaggio 312 ...................................................................................... 55 Tracciato 20 Messaggio 313 ...................................................................................... 56 Tracciato 21 Messaggio 504 ...................................................................................... 58 Tracciato 22 Messaggio 600 Riga A .......................................................................... 60 Tracciato 23 Messaggio 600 Riga B ........................................................................... 63 Tracciato 24 Messaggio 601 Riga A .......................................................................... 68 Tracciato 25 Messaggio 601 Riga B ........................................................................... 69 125
Protocollo di comunicazione comma 6b
Versione 1.0
Tracciato Tracciato Tracciato Tracciato Tracciato Tracciato Tracciato Tracciato Tracciato Tracciato Tracciato Tracciato Tracciato Tracciato Tracciato Tracciato Tracciato Tracciato Tracciato Tracciato Tracciato Tracciato Tracciato Tracciato Tracciato Tracciato Tracciato Tracciato Tracciato Tracciato Tracciato Tracciato Tracciato Tracciato Tracciato Tracciato Tracciato Tracciato Tracciato Tracciato Tracciato Tracciato Pag. 126 di 127
10 Agosto 2011
26 Messaggio 601 Riga C .......................................................................... 70 27 Messaggio 601 Riga D .......................................................................... 71 28 Messaggio 601 Riga E ........................................................................... 71 29 Messaggio 601 Riga A .......................................................................... 74 30 Messaggio 601 Riga C .......................................................................... 74 31 Messaggio 601 Riga D .......................................................................... 75 32 Messaggio 605 Riga A .......................................................................... 78 33 Messaggio 605 Riga B ........................................................................... 78 34 Messaggio 701 ...................................................................................... 80 35 Messaggio 701 ...................................................................................... 81 36 Messaggio 501 Risposta Riga A ............................................................ 83 37 Messaggio 501 Risposta Riga B ............................................................ 84 38 Messaggio 001 – Riga A ....................................................................... 90 39 Messaggio 001 – Riga B ........................................................................ 91 40 Messaggio 005 – Riga A ....................................................................... 95 41 Messaggio 005 – Riga B ........................................................................ 95 42 Messaggio 005 – Riga C ....................................................................... 96 43 Messaggio 006 ...................................................................................... 97 44 Messaggio 006 ...................................................................................... 98 45 Messaggio 008 ...................................................................................... 99 46 Messaggio 014 .................................................................................... 100 47 Messaggio 100 Richiesta ..................................................................... 101 48 Messaggio 101 Richiesta ..................................................................... 102 49 Messaggio 101 Risposta ...................................................................... 102 50 Messaggio 102 Richiesta ..................................................................... 103 51 Messaggio 102 Risposta ...................................................................... 103 52 Messaggio 103 Richiesta ..................................................................... 104 53 Messaggio 103 Risposta ...................................................................... 104 54 Messaggio 210 Richiesta ..................................................................... 105 55 Messaggio 210 Risposta ...................................................................... 105 56 Messaggio 211 Richiesta ..................................................................... 106 57 Messaggio 211 Risposta ...................................................................... 107 58 Messaggio 212 Richiesta ..................................................................... 108 59 Messaggio 212 Risposta Riga A .......................................................... 109 60 Messaggio 212 Risposta Riga B .......................................................... 109 61 Messaggio 213 Richiesta ..................................................................... 110 62 Messaggio 213 Risposta ...................................................................... 110 63 Messaggio 214 Richiesta ..................................................................... 111 64 Messaggio 214 Risposta ...................................................................... 111 65 Messaggio 250 Richiesta ..................................................................... 112 66 Messaggio 250 Risposta Riga A .......................................................... 114 67 Messaggio 250 Risposta Riga B .......................................................... 115 126
Protocollo di comunicazione comma 6b
Versione 1.0
Tracciato Pag. 127 di 127
10 Agosto 2011
68 Messaggio 400 .................................................................................... 116 Elenco delle tabelle di decodifica
Tabella 1 Tabella 2 Tabella 3 Tabella 4 Tabella 5 Tabella 6 Tabella 7 Tabella 8 Tabella 9 Tabella 10 - Tipi d’ubicazione.................................................................................. 117 - Tipologia di collegamento .................................................................... 118 - Tipologia sistemi collegamenti ............................................................. 119 - Tipologia di componente ..................................................................... 119 - Codici di Errore ................................................................................... 119 - Motivi di mancata risposta ................................................................... 123 - Stato di funzionamento di un apparecchio videoterminale .................. 123 - Motivi di cessazione di un apparecchio videoterminale ....................... 124 - Motivi di sostituzione dell’etichetta identificativa ............................... 124 - Tipologia di jackpot ............................................................................ 124 Elenco delle figure
Figura 1 Flusso di comunicazione sistema del concessionario VLT - sistema di controllo
VLT ......................................................................................................................... 11 Figura 2 Flusso di comunicazione delle segnalazioni, azioni e notifiche di AAMS......... 13 127