Protocollo di comunicazione Comma 6b 1.4
Transcript
Protocollo di comunicazione Comma 6b 1.4
Ministero dell'Economia e delle Finanze Amministrazione Autonoma dei Monopoli di Stato Direzione per i giochi PROTOCOLLO DI COMUNICAZIONE COMMA 6B 04 MAGGIO 2012 Protoccollo di comuniccazione comma 6b Versiione 1.4 Pag ag. 2 di 126 044 Maggio 20122 E INDICE 1. PREMESSA A 6 1.1 Modifichee rispetto alla a versionee precedente 7 2. GLOSSARIIO 8 3. CONTEST TO GENERAL LE 10 3.1 Messaggii dal sistem ma del conceessionario VLT V al sisttema di conntrollo VLT T 10 3.2 Messaggii dal sistem ma di controollo VLT all sistema deel concessio ionario VLT T 12 4. AUTENTIC CAZIONE DEI MESSAGG GI 14 4.1 Codice dii autenticazzione 14 4.2 Struttura delle chiavi 15 5. COMPRESSSIONE 17 6. DESCRIZIONE DEI MESSAGGI 18 6.1 Convenzioni di Codiifica 18 6.2 Separatorri 19 6.3 Struttura generale deel messagg gio 20 66.3.1 INTESTAZION N NE HTTP 21 66.3.2 MESSAGGIO APPLICATIVVO 22 66.3.3 TESTATA DELL MESSAGGIIO 22 66.3.4 MESSAGGIO OPERATIVO O 24 6.4 Messaggii operativi inviati dall sistema del concesssionario V VLT al sistema di controllo VLT 25 2 Protocollo di comunicazione comma 6b Versione 1.4 Pag. 3 di 126 04 Maggio 2012 6.4.1 DICHIARAZIONE DI UNA NUOVA UBICAZIONE (CODICE MESSAGGIO 300) 27 6.4.2 VARIAZIONE DEI DATI DI UBICAZIONE (CODICE MESSAGGIO 301) 29 6.4.3 CESSAZIONE DI UN’UBICAZIONE (CODICE MESSAGGIO 302) 31 6.4.4 INSTALLAZIONE DI UN SISTEMA DI SALA (CODICE MESSAGGIO 303) 32 6.4.5 VARIAZIONE DI UN SISTEMA DI SALA (CODICE MESSAGGIO 304) 34 6.4.6 INSTALLAZIONE DI UN APPARECCHIO VIDEOTERMINALE (CODICE MESSAGGIO 305) 36 6.4.7 SPOSTAMENTO/VARIAZIONE/MANUTENZIONE VIDEOTERMINALE (CODICE MESSAGGIO 306) DI UN APPARECCHIO 39 6.4.8 CESSAZIONE DI UN SISTEMA DI SALA(CODICE MESSAGGIO 307) 6.4.9 VARIAZIONE DEI DATI IDENTIFICATIVI DI UN APPARECCHIO VIDEOTERMINALE (CODICE MESSAGGIO 308) 43 6.4.10 CESSAZIONE 309) DI UN APPARECCHIO VIDEOTERMINALE (CODICE 42 MESSAGGIO 45 6.4.11 INSTALLAZIONE/RIMOZIONE/ABILITAZIONE/DISABILITAZIONE DI UN GIOCO SU UNO O PIÙ APPARECCHI VIDEOTERMINALI (CODICE MESSAGGIO 310) 47 6.4.12 RICHIESTA DEI DATI IDENTIFICATIVI (CODICE MESSAGGIO 311) 6.4.13 DI UN APPARECCHIO VIDEOTERMINALE COMUNICAZIONE DI DATI SUPPLEMENTARI DELLA SALA (CODICE MESSAGGIO 312) 49 PER LA VERIFICA DI IDONEITÀ 50 6.4.14 RICHIESTA 6.4.15 AUTODICHIARAZIONE DEL RAPPORTO GIURIDICO TRA IL CONCESSIONARIO ED 54 UN SOGGETTO ISCRITTO NELL’ELENCO DEI SOGGETTI 6.4.16 RICHIESTA DELLE NOTIFICHE MANCANTI (CODICE MESSAGGIO 504) 6.4.17 TRASMISSIONE GIORNALIERA, MENSILE, ANNUALE INCASSI E VINCITE MESSAGGIO 600) (CODICE 56 6.4.18 DEFINIZIONE/ ACCANTONAMENTI/EROGAZIONE MESSAGGIO 601) (CODICE 62 DI UN CAMBIO DI STATO DI UN GIOCO SU UN APPARECCHIO 52 VIDEOTERMINALE (CODICE MESSAGGIO 313) 3 JACKPOT 55 Protoccollo di comuniccazione comma 6b Versiione 1.4 Pag ag. 4 di 126 044 Maggio 20122 66.4.19 COMUNICAZIONE DELL’ UTILIZZO DEL D CREDITO O ANNUALE 72 66.4.20 TRASMISSION NE DEGLI 73 66.4.21 TRASMISSION NE MENSILE E, ANNUAL LE DEGLI IMPORTI I PE ER L’APPLIC CAZIONE D DELL ’ADDIZIIONALE DELLLE VINCITE E ECCEDEN NTI L’IMPORT TO PREVIST TO COME SO OGLIA (COD DICE MESSAG GGIO 606) 75 66.4.22 ANNULLAME ENTO MESSA AGGIO 600 (C CODICE MESSSAGGIO 6077) 77 66.4.23 R RETTIFICA TO OT_BET MESSSAGGIO 601 1 (CODICE MESSAGGIO M 78 66.4.24 CAMBIO 66.4.25 NOTIFICA DII RICEZIONEE (CODICE MESSAGGIO M 500) 5 66.4.26 NOTIFICA AC CCANTONAM MENTI (COD DICE MESSAG GGIO 605) 608) DI STATO DI UNO O PIÙ Ù APPARECC CHI VIDEOT TERMINALI MESSAGGIO 701) M 7 DI D RICEZIO ONE CON SEGNALAZ ZIONE (CODICE 79 81 DI ERRORE M MESSAGGIO 501) 5 (CODICE 82 6.5 Messaggii inviati dall sistema di controllo VLT V al sisttema del cooncessionarrio VLT84 66.5.1 NOTIFICA DII RICEZIONEE (CODICE MESSAGGIO M 000) 0 86 66.5.2 NOTIFICA DII ERRORE (C CODICE MESSSAGGIO 001) 87 66.5.3 NOTIFICA DII VALIDAZIO ONE (CODICE E MESSAGGIIO 002) 90 66.5.4 NOTIFICA DII RICHIESTA EVASA (COD DICE MESSAGGIO 003) 91 66.5.5 NOTIFICA 66.5.6 NOTIFICA DEI DATI IDEENTIFICATIV VI (C CODICE MESSSAGGIO 00 6) DEL D CODICE E IDENTIFIC CATIVO DE EI JACKPOT E/O DI POSSIBILI P A ANOMALIE RISCONTRATE E (CODICE MESSAGGIO M 005) 92 DI UN AP PPARECCHIO O VIDEOTER RMINALE 95 66.5.7 NOTIFICA 66.5.8 NOTIFICA DI SOSPENSIO ONE/CANCE ELLAZIONE/RIPRISTINO O D DALL ’ELENC CO DEI SOGG GETTI 66.5.9 66.5.10 DEL M MESSAGGIO 008) 0 CODIICE IDENT TIFICATIVO ABILITAZION NE/DISABILIITAZIONE (C CODICE MESSSAGGIO 10 0) VERIFICA DELL’UBIC CAZIONE DI UN SO OGGETTO 98 DI D UN APPARECCHIO O VIDEOTER RMINALE DELL D ’INTEG GRITÀ DEL SOFTWAR RE INSTALLLATO APPARECCHIO A O VIDEOTER RMINALE (C CODICE MESSSAGGIO 101)) 4 (CODICE 97 99 SU DI UN 100 Protocollo di comunicazione comma 6b Versione 1.4 6.5.11 Pag. 5 di 126 04 Maggio 2012 VERIFICA DELL’INTEGRITA’ DEL SOFTWARE DI UNO SPECIFICO GIOCO INSTALLATO SU DI UN APPARECCHIO VIDEOTERMINALE (CODICE MESSAGGIO 102) 101 6.5.12 VERIFICA DELL’INTEGRITÀ DEL SOFTWARE INSTALLATO SU DI UN SISTEMA 102 CENTRALE(CODICE MESSAGGIO 103) 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) 103 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) 104 6.5.15 RICHIESTA 6.5.16 RICHIESTA DELLO STATO DEI GIOCHI INSTALLATI SU DI UN APPARECCHIO VIDEOTERMINALE (CODICE MESSAGGIO 212) 106 DELLO STATO DI UN APPARECCHIO VIDEOTERMINALE MESSAGGIO 213) (CODICE 108 6.5.17 RICHIESTA DELLA DATA E DEL RISULTATO DELL’ULTIMA VERIFICA DELL’INTEGRITÀ DEL SOFTWARE INSTALLATO SU DI UN SISTEMA CENTRALE VLT (CODICE MESSAGGIO 214) 109 6.5.18 RICHIESTA DEI DATI DI CONTABILITÀ(CODICE MESSAGGIO 250) 6.5.19 AUTORIZZAZIONE 110 AL CAMBIO DI STATO DI UN GIOCO SU UN APPARECCHIO VIDEOTERMINALE (CODICE MESSAGGIO 400) 114 7. TABELLE DI DECODIFICA 115 8. ELENCO DELLE TABELLE E DELLE FIGURE 124 5 Protocollo di comunicazione comma 6b Versione 1.4 1. Pag. 6 di 126 04 Maggio 2012 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. Dalla data del 1 settembre 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 103, 214, 250, 605, 606, 607 e 608; Dalla data del 1 settembre 2012, dovranno essere utilizzati i codici univoci presenti nell’ Elenco dei soggetti per Esercizi, 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. 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: • - 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; 6 Protoccollo di comuniccazione comma 6b Versiione 1.4 - - - 1.1 Pag ag. 7 di 126 044 Maggio 20122 deescrizione dei d messaggi gi, in cui s’iillustrano le strutture ddei singoli messaggi m ogggetto di scaambio, che rriguardano: • dati di giocco registrati sulla banca dati del con ncessionario;; • segnalazion ni d’irregolaarità evidenziate dall’elab borazione deei dati racco olti; • eventi chee si verificaano durantee il ciclo dii vita di cia iascun appaarecchio videoterm minale e Sisttema di sala; • dati relativii a ciascun aapparecchio o videoterm minale, giocco, Sistema di sala; • dati relativii alle ubicaziioni; tab belle di deccodifica, in ccui s’illustraano le tabellle da utilizzzare per imp postare il vaalore di tuttti i campi ppresenti nei messaggii operativi cche presupp pongono l’uutilizzo di paarticolari coddici; eleenco delle taabelle e figuure, in cui s’’illustrano glli elenchi di tutti i messsaggi, dei loro tracciati e delle tabbelle di decodifica utiliizzate per la composizzione dei m messaggi stesssi. MODIFFICHE RISPE ETTO ALLA A VERSIONE PRECEDEN NTE Le moddifiche sono o riepilogatee nella tabellaa che segue: Paragrafo 1 2 Descrizione Dataa d’entrata inn vigore dellle modifichee il 1 settembbre 2012. Aggiiornato il gloossario. 6.4.21 Il meessaggio 6066 deve esseree implementato dal 1 seettembre 20112. 6.4.22 Mod dificate le co ndizioni d’uuso del messsaggio 607. 6.4.23 Mod dificate le co ndizioni d’uuso del messsaggio 608. 7 Protocollo di comunicazione comma 6b Versione 1.4 2. Pag. 8 di 126 04 Maggio 2012 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 dei soggetti per Esercizi, indica l’elenco contenente gli identificativi univoci degli esercizi dei soggetti, 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 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; 8 Protocollo di comunicazione comma 6b Versione 1.4 Pag. 9 di 126 04 Maggio 2012 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 Protoccollo di comuniccazione comma 6b Versiione 1.4 3. Pag ag. 10 di 126 044 Maggio 20122 CONT TESTO GE ENERALE E Le entiità coinvoltee nella comuunicazione sono s il sistema del conncessionario o VLT e il sisteema di conttrollo VLT ddi AAMS. Lo scambio d’info ormazioni traa i due sistemi utilizza ili protocolloo di colloquiio HTTP 1.0. I messsaggi oggettto di scam mbio tra sistema di controllo V VLT e sisteema del concesssionario VLT V sono suuddivisi nellee seguenti tiipologie: - Invvio dati, sono o messaggi mediante i quali il sisttema mittennte trasmettte dati al sisttema destinaatario senza che questo ne abbia ricchiesto l’inviio; - Ricchieste, sono messaggi m mediante i quali q il sistem ma mittentee richiede all sistema desstinatario la trasmissionee di specificci dati; - Risp sposte alle richhieste, sono m messaggi meediante i quaali il sistemaa che ha riceevuto un meessaggio di tiipo richiestee risponde con la trasmissione di sppecifici dati; - Azzioni, sono messaggi m meediante i quaali il sistema di controollo VLT richiede al sisstema del co oncessionaario VLT dii intraprendeere determinnate azioni. - Seggnalazioni son no messaggii mediante i quali il sisttema mittentte segnala al a sistema desstinatario eventi e partiicolari o errori riscon ntrati durannte le elab borazioni efffettuate. 3.1 MESSA AGGI DAL SISTEMA DEL L CONCESSIO ONARIO VL LT AL SISTEEMA DI CON NTROLLO VLT I messsaggi inviati dal sistem ma del conccessionario VLT al sisstema di controllo c VLT sono s dei segguenti tipi: - inviio dati; - segnnalazioni; - rispposte alle richieste. La figuura che segu ue illustra il flusso di co omunicazion ne dei messaaggi invio daati e delle segnalazzioni: 10 Protocollo di comunicazione comma 6b Versione 1.4 Pag. 11 di 126 04 Maggio 2012 Sistema del concessionario VLT Predisposizionedel messaggio Sistema di controllo VLT Ricezionedel messaggio Invio messaggio Controlli Analisi errore SI Errori Messaggio001 notificadi errore Acquisizionenotifica NO Messaggio000 notificadi ricezione Invio notifica SI Errori Controlli NO SI Errori Messaggio 001 notificadi errore NO Notificadi validazione(002, 005, 006, 008) Acquisizione messaggio Invio notifica SI Errori NO FINEOK Figura 1 Flusso di comunicazione sistema del concessionario VLT - sistema di controllo VLT 11 Protoccollo di comuniccazione comma 6b Versiione 1.4 Pag ag. 12 di 126 044 Maggio 20122 Il sisttema del concession c nario VLT trasmette un messagggio al sisttema di contro ollo VLT. Il sisteema di conttrollo VLT esegue dei controlli, c contestualmennte alla ricezzione. Il sisteema di conttrollo VLT,, invia nella stessa sessiione: - un messaggio di notificaa di ricezion ne per conffermare l’avvvenuta ricezzione del meessaggio opp pure una not otifica di errrore. In casso di ricezio one di noti tifica di errrore il sisteema del cooncessionarrio VLT deve: - an nalizzare la notifica n di errrore; - rim muovere l’errrore; - prrovvedere, ove o necessarrio, alla ritrassmissione deelle informaazioni. In casso di notifi fica di ricezzione il sisstema di co ontrollo VL LT invia in n un’altra sessioone: - un na notifica di validaziione per co onfermare l’avvenuto coontrollo deii dati del m messaggio; - in n alternativa, un messagggio di notifi fica di erroree . 3.2 MESSAAGGI DAL SIISTEMA DI CCONTROLLO O VLT AL SIISTEMA DEL L CONCESSIIONARIO VLT I messsaggi inviati dal sistem ma di contro ollo VLT al a sistema ddel concessionario VLT sono del segu uente tipo: - richhieste di dati registrati r nellla banca daati di gioco del d concessioonario. - segnnalazioni e azzioni che il cooncessionariio deve esegguire. Il sisteema del co oncessionarrio VLT, alla a ricezionee del messaaggio di tipo o richieste inviato o dal sistema di controollo VLT, deeve: - invviare contesttualmente laa notifica di d ricezionee, altrimenti la richiesta risulterà ineevasa; - preedisporre la risposta all’’interrogazio one ricevutaa e inviarla eentro le ore 24 dello stesso giorno della d richiestta. Il sisttema di con ntrollo VLT T nella med desima sessio one in cui rriceve la risp posta alla sua ricchiesta o la notifica dii ricezione con c segnalazzione di erroore, invia la notifica di richiestta evasa. 12 Protocollo di comunicazione comma 6b Versione 1.4 Pag. 13 di 126 04 Maggio 2012 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 Acquisizione notifica 500 Invio risposta o Ricezione della risposta o della notifica messaggio 501 Notifica 003 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 Protoccollo di comuniccazione comma 6b Versiione 1.4 Pag ag. 14 di 126 044 Maggio 20122 4. AUTE ENTICAZIIONE DEII MESSAGG GI 4.1 CODIC CE DI AUTEN NTICAZION NE Tutte le l comunicaazioni tra i ddue sistemi utilizzano u teecniche di aautenticazion ne basate sulla crrittografia assimmetrica. Per mo otivi di sicurrezza e integgrità dei datii, sui messagggi da trasm mettere è esegguita una proceddura di “hasshing” e il ”digest” co osì ottenuto o è crittogra rafato con la l chiave privataa di chi trasm mette il messsaggio e co odificato basse64, determ minando il codice c di autentticazione. Il destiinatario, utillizzando la chiave pubb blica del mitttente, provvvederà a deecifrare il digest e a confro ontarlo con quello otteenuto appliccando al m messaggio riccevuto il medesiimo algoritm mo di hashinng; tale veriffica, in caso di esito posiitivo, attestaa: - la provenienza p a del messagggio; - chee il messaggio non è stato alteraato successiv vamente al momento in cui il mitttente ha callcolato il cod odice di aute tenticazionee. Il sisteema di controllo VLT e il sistema del conce essionario V VLT devon no quindi utilizzaare delle fun nzioni che consentano il calcolo del digest dda parte dell sistema mittentte e la verifica dello stessso da parte del sistema destinatarioo. I proddotti di rifeerimento peer l’implem mentazione sono le libbrerie Open n Source MHASSH e OPEN NSSL, e il foormato dellee chiavi priv vate e delle cchiavi pubb bliche è il PEM (Privacy ( Enh hanced Mail)l). A livelllo applicativvo, il sistem ma di contro ollo VLT in nterfaccia MH HASH e OP PENSSL tramitee le funzio oni PHP ((versione: 5.2.9 5 ) mhash, openssll_private_en ncrypt e opensssl_public_deecrypt, i cui sorgenti in linguaggio l C sono liberramente disp ponibili e ai qualii si rimanda per i dettaggli implemen ntativi. Si preccisa che le cittate funzionni di encryptt/decrypt utiilizzano il vaalore di defaault per il quarto parametro;; di conseguuenza, le ch hiamate allee funzioni O OPENSSL di basso p uun “paddingg” di tipo livello RSA_privatte_encrypt e RSA_publiic_decrypt prevedono RSA_P PKCS1_PAD DDING (PK KCS #1 v1..5). E’ datta facoltà al a concessiionario di utilizzare prodotti p altternativi a quelli di riferim mento, a pattto che esssi siano in grado di produrre p rissultati equivvalenti e intercaambiabili. L’algorritmo di hasshing utilizzzato è MD55; se il siste ema del cooncessionarrio VLT utilizzaa per l’impleementazionee gli stessi prodotti p utilizzati dal siistema di controllo c VLT, ili digest si ottiene mediaante la chiam mata PHP mhash(MHA m ASH_MD5, $msg). $ 14 Protoccollo di comuniccazione comma 6b Versiione 1.4 Pag ag. 15 di 126 044 Maggio 20122 Per il calcolo c del codice c di auutenticazion one, i passi da seguire son ono i seguentti: 1. costruire la l stringa ddi caratteri costituita dalla d testataa e dal meessaggio operativo, eventualm mente com mpresso, seeparati tra loro dall’’apposito separatore specificato al paragrafo o 6.2; 2. applicare l’’algoritmo ddi hashing allla stringa otttenuta con le modalità descritte al punto prrecedente; 3. crittografarre il digest oottenuto con n la propria chiave c privaata; 4. codificare base64 b il diggest crittografato. Il messsaggio app plicativo da trasmetteree è costituito o dal codicee di autentic icazione, seguito o dalla strin nga calcolatta con le modalità m descritte al pprecedente punto p 1, separatti tra loro dall’appositto separato tore, così come c specifficato al su uccessivo paragraafo 6.2; Per la verifica v del codice c di au autenticazio one, i passi da d seguire soono i seguen nti: 5. ricavare daalla testata il codice iden ntificativo del d mittente; 6. individuaree, attraversoo tale codicce, la chiavee pubblica associata all sistema mittente; 7. decifrare ill codice dii autenticazzione, presen nte nel messsaggio app plicativo ricevuto, utilizzando u laa chiave pubblica indiv viduata con lle modalità descritte al punto prrecedente; 8. applicare l’algoritmo l di hashing alla stringaa costituita dalla testaata e dal messaggio io operativoo separati trra loro dall’aapposito sep eparatore sp pecificato al paragraffo 6.2. Se le due d stringhee ottenute ccon le modaalità descrittte ai punti 7 e 8 coinccidono, il destinaatario è certo o dell’identittà del mitten nte e dell’integrità dei daati ricevuti. 4.2 STRUT TTURA DELL LE CHIAVI Il form mato della ch hiave privataa e delle chiiavi pubblich he è il PEM M (Privacy Enhanced E Mail). La chiaave privata è costituita dda 256 bit prrotetta “Trip plo DES” . Il conccessionario deve custoddire nel sistema del concessiona c ario VLT la l chiave pubblicca di AAMSS e la propriaa chiave privvata, della qu uale garantissce la riservaatezza. Il sisteema di controllo VLT T possiede nelle proprie banche datiti le chiavi pubbliche p di tutti i concessionari. I conceessionari devono utilizzzare, per garrantire la sicurezza e l’inntegrità dei dati d nelle comun nicazioni tra il sistema del conceessionario VLT V e il sisstema di controllo c VLT, la l stessa chiaave previstaa per lo scam mbio d’inform mazioni tra lle entità den nominate sistemaa di elaborazzione e sisteema centralee nel protoco ollo di comuunicazione riferite ad 15 Protocollo di comunicazione comma 6b Versione 1.4 Pag. 16 di 126 04 Maggio 2012 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.4 5. Pag. 17 di 126 04 Maggio 2012 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 Protoccollo di comuniccazione comma 6b Versiione 1.4 6. Pag ag. 18 di 126 044 Maggio 20122 DESC CRIZIONE E DEI MESSSAGGI Il paraggrafo descriive i contennuti dei messsaggi oggetto di scambiio tra il sistema del concesssionario VLT V e il sisttema di con ntrollo VLT T. 6.1 CONVE ENZIONI DII CODIFICA A La struuttura dei meessaggi è desscritta in forrma tabellaree. Ciascun na tabella è costituita daalle seguentii colonne: - Co olonna 1 – Progressivo P caampo: contieene un proggressivo chee identifica ili campo all’interno dellaa tabella; - Co olonna 2 – Tipo: T contienee il codice che definiscee il tipo di caampo; - Co olonna 3 – Lunghezza m massima: con ntiene il num mero di carratteri masssimo che cosstituiscono ili campo; - Co olonna 4 – Obbl.: O contienne l’indicazio one se il cam mpo è obbliggatorio o meeno; - Co olonna 5 – Descrizione: D coontiene indiicazioni sul dato da ripoortare nel caampo del meessaggio. - Co olonna 6 – Note di com mpilazione: co ontiene indiicazioni su come valorrizzare il cam mpo. Di seguuito sono deefiniti i tipi ddi dato prevvisti: Tipo Descrizione Codifica String Cam mpo alfanuumerico di lunghezza l variabile v ASCII Numerric Cam mpo num merico inteero di lu unghezza ASCII varriabile SNumeeric Cam mpo num merico inteero con segno di ASCII lun nghezza varriabile Euroceent Cam mpo num merico contenente c valori ASCII esp pressi in cenntesimi di euro e Dataoraa Cam mpo num merico di 12 carattteri che ASCII con ntiene la ddata in forrmato AAM MMGG, segguito da oraa, minuti, secondi nel formato 18 Protoccollo di comuniccazione comma 6b Versiione 1.4 Tipo Pag ag. 19 di 126 044 Maggio 20122 Descrizione Codifica HH HMMSS Data Cam mpo num merico di 6 carattteri che ASCII con ntiene la daata in formaato AAMM MGG Riga Separaatore Eleenco di eleementi costtituiti da un no o più ASCII cam mpi dei tipi sopra indiccati Carrattere utiliizzato per separare un n campo ASCII dal successivoo. Per i caampi di tipo o String, Num meric, SNumeeric, Eurocent rappresentaati in codifica ASCII, si speciifica quanto segue: - Strring: può con ntenere tuttii i caratteri ASCII A con l’esclusionee dei caratterri di tipo sep paratore. Nel N caso inn cui il cam mpo sia ob bbligatorio e non abbiia valore sign nificativo occcorre comuunque impostare un caraattere a spazzio (ASCII hex h 20); - Nuumeric: ciascu un carattere può assumere i valori da “0” a “99”. Nel caso o in cui il cam mpo sia ob bbligatorio e non abbiia valore siignificativo occorre co omunque imp postarlo a “00”; - SN Numeric: il prrimo caratte re può assuumere i valori “+” o “-”” e gli altri possono asssumere i valori da “0” a “9”. Se ili primo carattere è diveerso da “-” il campo vieene considerrato positivoo. Nel caso in i cui il cam mpo sia obblligatorio e non n abbia vallore significaativo occorrre comunquee impostarlo o a “0”; - Euurocent: espriime importii in centesiimi di euro o con un nnumero varriabile di carratteri, il primo dei qual ali può assum mere i valorri “ +” o “-”” e gli altri possono asssumere i valori da “0” a “9”. Se ili primo carattere è diveerso da “-” il campo vieene considerrato positivoo. Nel caso in i cui il cam mpo sia obblligatorio e non n abbia vallore significaativo occorrre comunquee impostarlo o a “0”; Riguardo, infine, alla colonnna “Obbl.”, i valori in essa conntenuti assu umono il seguen nte significato: - vallore “S” se ill campo è seempre obbliigatorio; - vallore “C” see il campoo è obbligatorio in alccuni casi inndicati nellee note di com mpilazione, alttrimenti è faacoltativo; 6.2 SEPAR RATORI Ciascun n messaggi gio operativo vo, è compossto da una o più righe. Ciascun n campo deeve essere seeparato dal campo c succeessivo da unno specifico carattere di sepaarazione. 19 Protoccollo di comuniccazione comma 6b Versiione 1.4 Pag ag. 20 di 126 044 Maggio 20122 I sepaaratori prevvisti sono: “#”, “|”, “;” il loro utilizzo è rriservato alll’interno di ciasscuna delle parti che compongono il messsaggio appl plicativo, co osì come mostraato nella tab bella che seegue: Caratttere Utilizzo o # Sepaara i compponenti deel messagg gio applica cativo (cod dice di auteenticazionee, testata, messaggio m operativo o ) ; Sepaara le righe aall’interno del d messagg gio operativvo | Sepaara i campi all’interno della testata ta e all’internno di ciascuuna riga del messaggio m o operativo Il sepaaratore “#” ” non deve essere inserrito prima del d codice ddi autenticaazione e dopo ill messaggio io operativoo. Il sepaaratore “;” non n deve esssere inserito o prima della prima rigaa e dopo l’ulltima riga del meessaggio op perativo. Il sepaaratore “|” ” non deve eessere inseriito prima deel primo cam mpo e dopo o l’ultimo campo o della testaata e prima del primo campo e do opo l’ultimoo campo di ciascuna riga del messaggiio operativoo. I cam mpi non ob bbligatori ddevono esseere rappressentati con una stringa nulla (lungheezza 0 carattteri); ne connsegue che all’interno a deel messaggioo si potranno o trovare separaatori contiguui. Per no on appesan ntire la deescrizione dei d messag ggi operati tivi, le tabeelle non conten ngono in mo odo esplicitoo l’indicazion ne dei separratori. 6.3 TTURA GENE ERALE DEL L MESSAGGIO O STRUT L’insiem me di caratteri che viiaggiano daa un sistem ma ad un alltro posson no essere suddiviisi in due co omponenti: - intestazione htttp; - meessaggio app plicativo. 20 Protocollo di comunicazione comma 6b Versione 1.4 6.3.1 Pag. 21 di 126 04 Maggio 2012 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.4 6.3.2 Pag. 22 di 126 04 Maggio 2012 MESSAGGIO APPLICATIVO Il messaggio applicativo è strutturato come evidenziato nella tabella che segue: 6.3.3 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 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: Pr ogr essivo campo Tipo Lunghezza massima Obbl. 1 Numeric 15 S 2 Numeric 3 S 3 Numeric 6 S 4 String 1 S Tracciato 2 Descr izione C odice identificativo del messaggio applicativo C odice identificativo del messaggio operativo Lunghezza del messaggio operativo prima della compressione C odice identificativo del mittente Testata del messaggio Il contenuto dei campi indicati nella tabella dipende da quale sistema ha trasmesso il messaggio. In particolare: - Campo 1, contiene l’identificativo del messaggio applicativo. Il formato è il seguente: <ggg><aa><nnnnnnnnnn> dove 22 Protocollo di comunicazione comma 6b Versione 1.4 Pag. 23 di 126 04 Maggio 2012 − <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. 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. 23 Protocollo di comunicazione comma 6b Versione 1.4 - 6.3.4 Pag. 24 di 126 04 Maggio 2012 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 Protoccollo di comuniccazione comma 6b Versiione 1.4 6.4 Pag ag. 25 di 126 044 Maggio 20122 MESSA AGGI OPERA ATIVI INVIA ATI DAL SIISTEMA DEL CONCESSSIONARIO SISTEM MA DI CONT TROLLO VLT T VLT V AL Il paraagrafo contiene una desscrizione deei messagg gi operativii che il sisteema del concesssionario VLT V invia al sistema dii controllo VLT. V La tabeella che segu ue riporta l’eelenco dei messaggi m op perativi Co odice Descrizion D e messaggio 3 300 Dichiarazionee di una nuo ova ubicazion ne 3 301 Vaariazione deei dati di ubicazione 3 302 Ceessazione deell’ubicazion ne 3 303 In nstallazione ddi un sistem ma di sala 3 304 Vaariazione di un sistemaa di sala 3 305 In nstallazione ddi un apparrecchio vide eoterminalee 3 306 Sp postamento//Variazione/Manutenziione di un aapparecchio o videoterminaale 3 307 Ceessazione dii un sistemaa di sala 3 308 Vaariazione deei dati identificativi di un n apparecchhio videoterminaale 3 309 Ceessazione dii un apparecchio video oterminale 3 310 In nstallazione//rimozione/ /abilitazione/disabilitaziione di un gio oco su uno o più apparrecchi videoterminali 3 311 Riichiesta dei ddati identificcativi di un apparecchi a io videoterminaale Co omunicazionne di dati suupplementarri per la veriffica di idoneeità deella sala Riichiesta di uun cambio dii stato di un gioco su unn apparecch hio videoterminaale 3 312 3 313 5 504 Riichiesta dellee notifiche mancanti m 25 Protocollo di comunicazione comma 6b Versione 1.4 Pag. 26 di 126 04 Maggio 2012 600 Trasmissione giornaliera, mensile, annuale incassi e vincite 601 Definizione/Accantonamenti/Erogazione jackpot 605 Trasmissione degli accantonamenti 606 Trasmissione mensile, annuale degli importi per l’applicazione dell’addizionale delle vincite eccedenti l’importo previsto come soglia 607 Annullamento messaggio 600 608 Rettifica TOT_BET messaggio 601 701 Cambio di stato di un apparecchio videoterminale Messaggi operativi concessionario - AAMS 1 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 26 Protocollo di comunicazione comma 6b Versione 1.4 6.4.1 Pag. 27 di 126 04 Maggio 2012 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, dal 1 settembre 2012, il messaggio servirà esclusivamente per il censimento dei nuovi magazzini. Tipo di messaggio Singolo: contiene i dati d’ubicazione. Struttura Progressivo campo 1 Tipo String Lunghezza massima 1 Obbl. S 2 3 String Numeric 16 2 S S 4 String 50 S 5 6 7 Numeric String String 3 40 7 S S S 8 String 5 S 9 10 String String 2 60 S S 11 String 4 S 12 Numeric 5 C 27 Descrizione Tipo riga Note di compilazione Vale “A” Codice fiscale del titolare Codice fiscale dell’ubicazione Tipo ubicazione Vedi Tabella 1 Nome commerciale dell'ubicazione Indicare un codice toponimo fra quelli riportati nella tabella presente sul sito di Toponimo AAMS Indirizzo Nome della via, piazza,… Numero civico CAP del comune di CAP ubicazione Provincia del comune di Provincia ubicazione Comune Comune di ubicazione Codice Catastale del Codice catastale comune di ubicazione Superficie del locale Metri quadrati Protocollo di comunicazione comma 6b Versione 1.4 Pag. 28 di 126 04 Maggio 2012 Tracciato 3 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). Si precisa che, dal 1 settembre 2012, il tracciato del messaggio sarà sostituito come segue: Progressivo campo 1 Tipo String Lunghezza massima 1 Obbl. S 2 3 String Numeric 16 2 S S 4 String 60 S 5 6 7 Numeric String String 3 40 7 S S S 8 String 5 S 9 10 String String 2 40 S S 11 String 4 S 12 Numeric 5 C Tracciato 4 Descrizione Tipo riga Note di compilazione Vale “A” Codice fiscale del titolare Codice fiscale dell’ubicazione Tipo ubicazione Vedi Tabella 1 Nome commerciale dell'ubicazione Indicare un codice toponimo fra quelli riportati nella tabella presente sul sito di Toponimo AAMS Indirizzo Nome della via, piazza,… Numero civico CAP del comune di CAP ubicazione Provincia del comune di Provincia ubicazione Comune Comune di ubicazione Codice Catastale del Codice catastale comune di ubicazione Superficie del locale Metri quadrati Messaggio 300 Note di compilazione − Campo 3 Deve essere valorizzato a “9”. 28 Protocollo di comunicazione comma 6b Versione 1.4 6.4.2 Pag. 29 di 126 04 Maggio 2012 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, dal 1 settembre 2012, il messaggio servirà esclusivamente per la variazione dei dati dei magazzini. Tipo di messaggio Singolo: contiene i dati d’ubicazione. Struttura Progressivo campo 1 Tipo String Lunghezza massima 1 Obbl. S 2 String 16 C 3 4 String Numeric 12 2 S C 5 String 50 C 6 7 8 Numeric String String 3 40 7 C C C 9 String 5 C 10 11 String String 2 60 C C 12 String 4 C Tracciato 5 Descrizione Tipo riga Note di compilazione Vale “A” Codice fiscale del titolare Codice fiscale dell’ubicazione Codice rilasciato da Id ubicazione AAMS Tipo ubicazione Vedi Tabella 1 Nome commerciale dell'ubicazione Indicare un codice toponimo fra quelli riportati nella tabella presente sul sito di AAMS Toponimo Indirizzo Nome della via, piazza,… Numero civico CAP del comune di CAP ubicazione Provincia del comune di Provincia ubicazione Comune Comune di ubicazione Codice Catastale del Codice catastale comune di ubicazione Messaggio 301 Note di compilazione − Campo 2 Codice fiscale del nuovo titolare. 29 Protocollo di comunicazione comma 6b Versione 1.4 − Pag. 30 di 126 04 Maggio 2012 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, dal 1 settembre 2012, il tracciato del messaggio sarà sostituito come segue: Progressivo campo 1 Tipo String Lunghezza massima 1 Obbl. S Descrizione Tipo riga 2 String 16 C 3 4 String Numeric 12 2 S C 5 String 60 C Codice fiscale Codice identificativo dell'ubicazione Tipo ubicazione 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 30 6 Note di compilazione Vale “A” Codice fiscale del titolare dell’ubicazione Codice rilasciato da AAMS 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 Messaggio 301 Protocollo di comunicazione comma 6b Versione 1.4 6.4.3 Pag. 31 di 126 04 Maggio 2012 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, dal 1 settembre 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 31 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.4 6.4.4 Pag. 32 di 126 04 Maggio 2012 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 Descrizione Tipo riga Note di compilazione Vale “A” Codice rilasciato da AAMS 2 3 String String 16 16 S S 4 Numeric 10 S 5 Numeric 2 S 6 String 12 S Codice identificativo del sistema di sala utilizzato sul sistema di gioco MAC ADDRESS Codice identificativo del modello Tipo di connessione con il sistema di gioco Codice identificativo dell' ubicazione S Codice identificativo del sistema di gioco 7 Numeric Tracciato 10 8 Vedi Tabella 2 Codice rilasciato da AAMS Codice rilasciato da AAMS Messaggio 303 Note di compilazione - Campo 2 E’ il codice identificativo del sistema di sala nell’ambito del sistema di gioco VLT 32 Protocollo di comunicazione comma 6b Versione 1.4 - - Pag. 33 di 126 04 Maggio 2012 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. 33 Protocollo di comunicazione comma 6b Versione 1.4 6.4.5 Pag. 34 di 126 04 Maggio 2012 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. Struttura Progressivo campo 1 Tipo String Lunghezza massima 1 Obbl. S Descrizione Tipo riga Note di compilazione Vale “A” 2 3 String String 16 16 C S 4 Numeric 2 C 5 String 12 S Codice identificativo del sistema di sala utilizzato sul sistema di gioco MAC ADDRESS Tipo di connessione con il sistema di gioco Codice identificativo dell' ubicazione 6 String 16 C MAC ADDRESS Nuovo MAC ADDRESS 34 Vedi Tabella 2 Codice rilasciato da AAMS Protocollo di comunicazione comma 6b Versione 1.4 Tracciato Pag. 35 di 126 04 Maggio 2012 9 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). 35 Protocollo di comunicazione comma 6b Versione 1.4 6.4.6 INSTALLAZIONE MESSAGGIO 305) Pag. 36 di 126 04 Maggio 2012 DI 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. 36 Protocollo di comunicazione comma 6b Versione 1.4 Pag. 37 di 126 04 Maggio 2012 Struttura Progressivo campo 1 Tipo String Lunghezza massima 1 Obbl. S 2 String 15 S Descrizione Tipo riga Codice identificativo dell'apparecchio videoterminale 3 String 11 S Codeid 4 String 16 S MAC ADDRESS Vedi Tabella 2 S Codice modello Codice rilasciato da AAMS Codice identificativo dell'ubicazione Codice rilasciato da AAMS Numeric 2 C 6 Numeric 2 C Numeric 10 Codice utilizzato sul sistema del concessionario Codice rilasciato da AAMS Tipo di connessione con il sistema di sala Tipo di connessione con il sistema di gioco 5 7 Note di compilazione Vale “A” Vedi Tabella 2 8 String 12 S 9 String 16 C MAC ADDRESS Relativo al sistema di sala S S Codice identificativo del sistema di gioco CIV 10 11 Numeric String 10 11 Tracciato 10 Codice rilasciato da AAMS 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. - Campo 9 Va compilato quando l’apparecchio videoterminale viene connesso ad un sistema di sala che farà da tramite tra l’apparecchio 37 Protocollo di comunicazione comma 6b Versione 1.4 - - Pag. 38 di 126 04 Maggio 2012 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. 38 Protocollo di comunicazione comma 6b Versione 1.4 6.4.7 Pag. 39 di 126 04 Maggio 2012 SPOSTAMENTO/VARIAZIONE/MANUTENZIONE VIDEOTERMINALE (CODICE MESSAGGIO 306) 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 39 Protocollo di comunicazione comma 6b Versione 1.4 Pag. 40 di 126 04 Maggio 2012 Progressivo campo 1 Tipo String Lunghezza massima 1 Obbl. S Descrizione Tipo riga 2 String 11 S Codeid Note di compilazione Vale “A” Codice rilasciato da AAMS S Codice identificativo dell' ubicazione Codice rilasciato da AAMS Vedi Tabella 2 3 String 12 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 Codice identificativo del sistema di gioco 8 Numeric 1 C Flag manutenzione Tracciato 11 Vedi Tabella 2 Codice rilasciato da AAMS 1 (inizio/spostamento apparecchio in manutenzione); 0 (fine manutenzione) Messaggio 306 Note di compilazione Codice identificativo dell’ubicazione presso la quale l’ - Campo 3 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; - entrambi valorizzati, per indicare la variazione del sistema di sala e della connessione tra l’apparecchio videoterminale ed il sistema di sala; 40 Protocollo di comunicazione comma 6b Versione 1.4 Pag. 41 di 126 04 Maggio 2012 - - 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 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. 41 Protocollo di comunicazione comma 6b Versione 1.4 6.4.8 Pag. 42 di 126 04 Maggio 2012 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 Tipo String Lunghezza massima 1 Obbl. S Descrizione Tipo riga 2 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). 42 Protocollo di comunicazione comma 6b Versione 1.4 6.4.9 Pag. 43 di 126 04 Maggio 2012 VARIAZIONE DEI DATI IDENTIFICATIVI VIDEOTERMINALE (CODICE MESSAGGIO 308) DI UN APPARECCHIO 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 Descrizione Tipo riga 2 3 String String 11 16 S S Codeid MAC ADDRESS 4 5 6 String String String 16 11 11 C S C 7 Numeric 2 C MAC ADDRESS Nuovo MAC ADDRESS CIV CIV Nuovo CIV Motivo della sostituzione Vedi Tabella 9 Tracciato 13 Note di compilazione Vale “A” Codice rilasciato da AAMS 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. - 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. 43 Protocollo di comunicazione comma 6b Versione 1.4 - - Pag. 44 di 126 04 Maggio 2012 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. 44 Protocollo di comunicazione comma 6b Versione 1.4 6.4.10 CESSAZIONE 309) Pag. 45 di 126 04 Maggio 2012 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 B Progressivo campo 1 2 Descrizione Occorrenze Dati di riepilogo Una per messaggio Per ogni cessazione si ripete la seguente riga. Dati di ogni apparecchio Una per ogni apparecchio videoterminale per cui si videoterminale comunica la cessazione. Tipo String String Tracciato Lunghezza massima 1 11 14 Obbl. S Descrizione Tipo riga Note di compilazione Vale “A” S Totale degli apparecchi videoterminali cessati Il numero totale degli apparecchi per cui si trasmette la cessazione Messaggio 309 Riga A 45 Protocollo di comunicazione comma 6b Versione 1.4 Progressivo campo 1 Tipo String Pag. 46 di 126 04 Maggio 2012 Lunghezza massima 1 Obbl. S Descrizione Tipo riga 2 String 11 S Codeid 3 Date 6 S 4 Numeric 2 S Data cessazione Motivo della cessazione Tracciato 15 Note di compilazione Vale “B” Codice rilasciato da AAMS Data di avvenuta cessazione Vedi tabella 8 Messaggio 309 Riga B Note di compilazione - Campo 4 Il valore deve essere rilevato dalla Tabella 8 cessazione di un apparecchio videoterminale 46 Motivi di Protocollo di comunicazione comma 6b Versione 1.4 6.4.11 Pag. 47 di 126 04 Maggio 2012 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 Descrizione Tipo riga Codice identificativo del gioco 3 String 1 C Azione Note di compilazione Vale “A” Codice rilasciato da AAMS 1(Installato) / 0(Rimosso) 1(Abilitazione) / 0(Disabilitazione)/ 4 String 1 C Azione 5 String 11 C Codeid Codice identificativo dell' ubicazione 6 String 12 Tracciato C 16 Note di compilazione 47 Messaggio 310 Codice rilasciato da AAMS Codice rilasciato da AAMS Protocollo di comunicazione comma 6b Versione 1.4 Pag. 48 di 126 04 Maggio 2012 - 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. 48 Protocollo di comunicazione comma 6b Versione 1.4 6.4.12 Pag. 49 di 126 04 Maggio 2012 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 VLT a 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 2 String 11 S Codeid Tracciato 17 49 Messaggio 311 Note di compilazione Vale “A” Codice rilasciato da AAMS Protocollo di comunicazione comma 6b Versione 1.4 6.4.13 Pag. 50 di 126 04 Maggio 2012 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 50 Descrizione Tipo riga Codice identificativo dell'ubicazione Note di compilazione Vale “A” Codice rilasciato da AAMS Deve essere almeno un Data di giorno successivo alla esecuzione della data di invio del prima fase messaggio Metri quadrati del locale dedicato agli apparecchi Superficie videoterminali del concessionario Messaggio 312 Protocollo di comunicazione comma 6b Versione 1.4 Pag. 51 di 126 04 Maggio 2012 Si precisa che, quanto precedentemente descritto, per il messaggio 312, dal 1 settembre 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 S Descrizione Tipo riga Codice identificativo dell'ubicazione Data prevista della fine della prima fase 3 Data 6 S 4 Numeric 5 S 5 Numeric Tracciato 10 S 19 51 Superficie Codice identificativo del sistema di gioco Messaggio 312 Note di compilazione Vale “A” Codice rilasciato da AAMS Deve essere almeno un giorno successivo alla data di invio del messaggio Metri quadrati del locale dedicato agli apparecchi videoterminali del concessionario Codice rilasciato da AAMS Protocollo di comunicazione comma 6b Versione 1.4 6.4.14 Pag. 52 di 126 04 Maggio 2012 RICHIESTA 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 Descrizione Tipo riga Codice identificativo del gioco 3 String 1 C Azione Note di compilazione Vale “A” Codice rilasciato da AAMS 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 Data di cambio stato Descrizione del motivo Codice rilasciato da AAMS Data relativa al cambio di stato del campo 2 Messaggio 313 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; 52 Protocollo di comunicazione comma 6b Versione 1.4 Pag. 53 di 126 04 Maggio 2012 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. 53 Protocollo di comunicazione comma 6b Versione 1.4 6.4.15 Pag. 54 di 126 04 Maggio 2012 AUTODICHIARAZIONE DEL RAPPORTO GIURIDICO TRA IL CONCESSIONARIO ED UN SOGGETTO ISCRITTO NELL’ELENCO DEI SOGGETTI Per la comunicazione del messaggio in oggetto, il concessionario trasmette un’unica dichiarazione attraverso il messaggio 315 inviato dal sistema di controllo AWP al sistema del concessionario AWP e definito nel protocollo di comunicazione comma 6a. 54 Protocollo di comunicazione comma 6b Versione 1.4 6.4.16 Pag. 55 di 126 04 Maggio 2012 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 2 Tipo String Numeric Lunghezza massima 1 15 Tracciato 21 55 Obbl. S Descrizione Tipo riga S Identificativo del messaggio applicativo di cui si richiede notifica Messaggio 504 Note di compilazione Vale “A” Protocollo di comunicazione comma 6b Versione 1.4 6.4.17 Pag. 56 di 126 04 Maggio 2012 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. 56 Una per gioco Protocollo di comunicazione comma 6b Versione 1.4 Pag. 57 di 126 04 Maggio 2012 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 String Eurocent Eurocent 12 12 12 S S S Codice identificativo del componente Codice rilasciato da AAMS BET Importo puntate WIN Vincite conseguite 6 7 8 9 10 11 12 13 14 15 16 17 18 Eurocent Eurocent Eurocent Numeric Eurocent Eurocent Eurocent Eurocent Eurocent Numeric Numeric Numeric Numeric 12 12 12 12 12 12 12 12 12 12 4 2 2 C S S S C C C C C C S C C TOT_PAID TOT_IN TOT_OUT BET_NUM TOT_BET TOT_WIN TOT_TOT_PAID TOT_TOT_IN TOT_TOT_OUT TOT_BET_NUM Anno Mese Giorno C Codice identificativo del sistema di gioco Codice rilasciato da AAMS 19 Numeric Tracciato 10 22 Importo riscosso Importo introdotto Importo erogato Numero puntate Totale importo puntate Totale vincite conseguite Totale importo riscosso Totale importo introdotto Totale importo erogato Totale numero puntate da 01 a 12 da 01 a 31 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 lorde 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 - 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. 57 Protocollo di comunicazione comma 6b Versione 1.4 - - - - - - - - - - Pag. 58 di 126 04 Maggio 2012 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 lorde 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. 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. 58 Protocollo di comunicazione comma 6b Versione 1.4 - - - - Pag. 59 di 126 04 Maggio 2012 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. Campi 10 a 15 I campi non devono essere valorizzati se il messaggio è trasmesso successivamente al 1° gennaio ed il campo 16 non è riferito all’anno dell’invio del messaggio. 59 Protocollo di comunicazione comma 6b Versione 1.4 Pag. 60 di 126 04 Maggio 2012 Struttura Progressivo campo 1 Tipo String Lunghezza massima 1 2 3 4 5 6 7 8 Numeric Eurocent Eurocent Numeric Eurocent Eurocent Numeric 10 12 12 12 12 12 12 Tracciato 23 Obbl. S Descrizione Tipo riga Note di compilazione Vale “B” S S S S C C C Codice identificativo del gioco BET WIN BET_NUM TOT_BET TOT_WIN TOT_BET_NUM Codice rilasciato da AAMS Vincita conseguita Vincita conseguita 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 lorde 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 lorde 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. 60 Protocollo di comunicazione comma 6b Versione 1.4 - - Pag. 61 di 126 04 Maggio 2012 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. Campi 6 a 8 I campi non devono essere valorizzati se il messaggio è trasmesso successivamente al 1° gennaio ed il campo 16 della riga A non è riferito all’anno dell’invio del messaggio. 61 Protocollo di comunicazione comma 6b Versione 1.4 6.4.18 Pag. 62 di 126 04 Maggio 2012 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. 62 Protocollo di comunicazione comma 6b Versione 1.4 Pag. 63 di 126 04 Maggio 2012 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); • 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. 63 Protocollo di comunicazione comma 6b Versione 1.4 Pag. 64 di 126 04 Maggio 2012 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). 64 Protocollo di comunicazione comma 6b Versione 1.4 Pag. 65 di 126 04 Maggio 2012 Struttura Progressivo campo 1 2 3 Tipo String Lunghezza massima 1 Numeric Eurocent 4 Numeric Obbl. S Descrizione Tipo riga Note di compilazione Vale “A” S S Codice identificativo del sistema di gioco TOT_BET Codice rilasciato da AAMS 10 12 1 Tracciato Motivo della trasmissione S 24 0 Definizione nuovo Jackopt, 1 Erogazione Jackpot, 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. Progressivo campo 1 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 65 Messaggio 601 Riga B 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 Protocollo di comunicazione comma 6b Versione 1.4 − − Pag. 66 di 126 04 Maggio 2012 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. Progressivo campo 1 Tipo String Lunghezza massima 1 Obbl. S 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 6 Eurocent 10 C Importo della vincita Tracciato 26 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 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”. 66 Protocollo di comunicazione comma 6b Versione 1.4 Progressivo campo 1 2 Tipo String Numeric Pag. 67 di 126 04 Maggio 2012 Lunghezza massima 1 Obbl. S Descrizione Tipo riga Note di compilazione Vale “D” 10 S Codice identificativo del jackpot Codice rilasciato da AAMS 3 String 11 S 4 Eurocent 10 S Tracciato 27 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. − Campo 4 Importo lordo della vincita. 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 1 settembre 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; ogni dato inviato contiene il riferimento a ciascun sistema di gioco VLT. I jackpot possono essere di tipo 67 Protocollo di comunicazione comma 6b Versione 1.4 Pag. 68 di 126 04 Maggio 2012 • “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 incrementano i 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 identificativi jackpot Una per jackpot Per un jackpot erogato D Dati relativi all’ erogazione Una per jackpot di un 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); • 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 : 68 Protocollo di comunicazione comma 6b Versione 1.4 Pag. 69 di 126 04 Maggio 2012 • 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 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); • 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. Struttura Progressivo campo 1 Tipo String Lunghezza massima 1 Obbl. S Descrizione Tipo riga Note di compilazione Vale “A” Codice identificativo del sistema di gioco TOT_BET Codice rilasciato da AAMS 2 3 Numeric Eurocent 10 12 S S 4 Numeric 1 S Tracciato 29 Motivo della trasmissione 0 Definizione nuovo Jackopt, 1 Erogazione Jackpot Messaggio 601 Riga A Note di compilazione 69 Protocollo di comunicazione comma 6b Versione 1.4 - - Pag. 70 di 126 04 Maggio 2012 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. Progressivo campo 1 Tipo String 2 String 50 S 3 Numeric 10 C 4 String 12 C 5 String 1 S Tipo Jackpot C Importo della vincita 6 Lunghezza massima Obbl. 1 S Eurocent Tracciato 10 30 Descrizione Note di compilazione Tipo riga Vale “C” Codice identificativo del Codice utilizzato sul sistema del jackpot concessionario Codice identificativo del gioco Codice rilasciato da AAMS Codice identificativo dell'ubicazione 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.4 Progressivo campo 1 2 Tipo String Numeric Pag. 71 di 126 04 Maggio 2012 Lunghezza massima 1 Obbl. S Descrizione Tipo riga Note di compilazione Vale “D” 10 S Codice identificativo del jackpot Codice rilasciato da AAMS 3 String 11 S 4 Eurocent 10 S 5 String 10 S Tracciato 31 Codeid Importo della vincita Codice identificativo del gioco Codice rilasciato da AAMS 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 4 Importo lordo della vincita. - Campo 5 Codice identificativo del gioco da cui è scaturita la vincita del jackpot indicato al campo 2. 71 Protocollo di comunicazione comma 6b Versione 1.4 6.4.19 Pag. 72 di 126 04 Maggio 2012 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. 72 Protocollo di comunicazione comma 6b Versione 1.4 6.4.20 Pag. 73 di 126 04 Maggio 2012 TRASMISSIONE DEGLI ACCANTONAMENTI (CODICE MESSAGGIO 605) Il messaggio deve essere implementato dal 1 settembre 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 Occorrenze Una per messaggio Per ogni gioco, tipologia di jackpot e sala che ha contribuito all’accantonamento. B Dati sull’accantonamento 73 Per ogni gioco, tipologia di jackpot e sala Protocollo di comunicazione comma 6b Versione 1.4 Pag. 74 di 126 04 Maggio 2012 Struttura Progressivo campo Tipo 1 String 2 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, nel caso in cui vi partecipino tutti i giochi della sala o del sistema di gioco e l’importo abbia ricevuto la contribuzione di tutti i giochi, il campo 2 non deve essere valorizzato. - Campo 3 Somma accantonata, fino al momento dell’invio del messaggio, derivante esclusivamente dai contributi del gioco per i jackpot o futuri jackpot di tipologia indicata al campo 4 - 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’). 74 Protocollo di comunicazione comma 6b Versione 1.4 6.4.21 Pag. 75 di 126 04 Maggio 2012 TRASMISSIONE MENSILE, ANNUALE DEGLI IMPORTI PER L’APPLICAZIONE DELL’ADDIZIONALE DELLE VINCITE ECCEDENTI L’IMPORTO PREVISTO COME SOGLIA (CODICE MESSAGGIO 606) Il messaggio deve essere implementato dal 1 settembre 2012. Descrizione Il messaggio viene utilizzato dal sistema del concessionario VLT per tramettere al sistema di controllo VLT esclusivamente le vincite eccedenti la soglia: • L’ammontare delle vincite, al lordo dell’addizionale, comprensivo della quota di soglia; • l’ammontare delle vincite, ad esclusione della quota di soglia; • l’ammontare delle vincite, al netto dell'addizionale. I dati del messaggio si riferiscono ad un mese oppure ad un anno ed devono essere riferiti ad un intervallo temporale già concluso. Tipo di messaggio Singolo Struttura Progressivo campo 1 Tipo String Lunghezza massima Obbl. 1 S 2 3 4 Numeric Numeric Numeric 10 4 2 S S C Descrizione Tipo riga Codice identificativo del sistema di gioco Anno Mese 5 Eurocent 12 S WIN_TOT 6 Eurocent 12 S WIN_TAX 7 Eurocent 12 S WIN_NET 75 Note di compilazione Vale “A” Codice rilasciato da AAMS da 01 a 12 L’ammontare complessivo delle vincite, al lordo dell’addizionale, eccedenti la soglia L’ammontare complessivo dell’imponibile L’ammontare complessivo delle vincite nette Protocollo di comunicazione comma 6b Versione 1.4 Tracciato Pag. 76 di 126 04 Maggio 2012 34 Messaggio 606 Riga A Note di compilazione - Campi 3 e 4 Definiscono l’intervallo temporale a cui si riferiscono i dati dei campi 5, 6 e 7. - Campo 5 L’ammontare complessivo delle vincite, al lordo dell’addizionale, eccedenti la soglia; conseguite nell’intervallo temporale definito nei campi 3 e 4. - Campo 6 L’ammontare complessivo dell’imponibile conseguita nell’intervallo temporale definito nei campi 3 e 4 su cui applicare l’addizionale prevista. - Campo 7 L’ammontare complessivo delle vincite nette, di cui al campo 5, su cui è stata applicata l’addizionale prevista, conseguita nell’intervallo temporale definito nei campi 3 e 4. 76 Protocollo di comunicazione comma 6b Versione 1.4 6.4.22 Pag. 77 di 126 04 Maggio 2012 ANNULLAMENTO MESSAGGIO 600 (CODICE MESSAGGIO 607) Il messaggio deve essere implementato dal 1 settembre 2012. Descrizione Il messaggio viene utilizzato dal sistema del concessionario VLT per trasmettere al sistema di controllo VLT l’annullamento di un messaggio 600 correttamente elaborato dal sistema di controllo VLT. Il messaggio può essere trasmesso dal sistema del concessionario VLT solo previa autorizzazione e per una durata massima di 7 giorni. Tipo di messaggio Singolo Struttura Progressivo campo 1 Tipo String Lunghezza massima 1 Obbl. S 2 Numeric 15 S Tracciato 35 Descrizione Tipo riga Identificativo del messaggio 600 da annullare Messaggio 607 Riga A 77 Note di compilazione Vale “A” Protocollo di comunicazione comma 6b Versione 1.4 6.4.23 Pag. 78 di 126 04 Maggio 2012 RETTIFICA TOT_BET MESSAGGIO 601 (CODICE MESSAGGIO 608) Il messaggio deve essere implementato dal 1 settembre 2012. Descrizione Il messaggio viene utilizzato dal sistema del concessionario VLT per trasmettere al sistema di controllo VLT la rettifica del TOT_BET associato al messaggio 601 correttamente elaborato dal sistema di controllo VLT. Il messaggio può essere trasmesso dal sistema del concessionario VLT solo previa autorizzazione e per una durata massima di 7 giorni. Tipo di messaggio singolo Struttura Progressivo campo 1 Tipo String Lunghezza massima 1 Obbl. S 2 Numeric 15 S 3 Eurocent Tracciato 12 S 36 Descrizione Tipo riga Identificativo del messaggio 601 da rettificare TOT_BET Note di compilazione Vale “A” TOT_BET che sostituisce il valore associato al messaggio 601 Messaggio 608 Riga A 78 Protocollo di comunicazione comma 6b Versione 1.4 6.4.24 Pag. 79 di 126 04 Maggio 2012 CAMBIO DI STATO DI UNO O PIÙ APPARECCHI VIDEOTERMINALI MESSAGGIO 701) (CODICE 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 37 Descrizione Tipo riga Note di compilazione Vale “A” Codice rilasciato da Codeid AAMS Flag Stato Vedia tabella 7 Data di cambio Data relativa allo stato del stato campo 3 Codice identificativo Codice rilasciato da dell'ubicazione 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). - 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 1 settembre 2012, sarà sostituito da quanto segue : 79 Protocollo di comunicazione comma 6b Versione 1.4 Pag. 80 di 126 04 Maggio 2012 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 2 3 String String 11 1 C S 4 DataOra 12 S 5 String 12 S 6 Numeric 10 S Tracciato 38 80 Descrizione Tipo riga Note di compilazione Vale “A” Codice rilasciato da Codeid AAMS Flag Stato Vedia tabella 7 Data di cambio Data relativa allo stato del stato campo 3 Codice identificativo Codice rilasciato da dell'ubicazione AAMS Codice identificativo del Codice rilasciato da sistema di gioco AAMS Messaggio 701 Protocollo di comunicazione comma 6b Versione 1.4 6.4.25 Pag. 81 di 126 04 Maggio 2012 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) 81 Protocollo di comunicazione comma 6b Versione 1.4 6.4.26 Pag. 82 di 126 04 Maggio 2012 NOTIFICA DI RICEZIONE CON SEGNALAZIONE DI ERRORE MESSAGGIO 501) (CODICE 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 Pr ogr essiv Lunghezza Tipo Obbl. o campo massima 1 String 1 S 2 Numeric 6 S Tracciato 39 Descr izione Deve essere uguale a “A” Totale righe di dettaglio Messaggio 501 Risposta Riga A 82 Protocollo di comunicazione comma 6b Versione 1.4 Pag. 83 di 126 04 Maggio 2012 Pr ogr essivo campo 1 String Lunghezza massima 1 2 3 Numeric String 2 256 Tipo Tracciato 40 Obbl. S S C Descr izione Note di compilazione Tipo riga Vale "B" Motivo della mancata comunicazione Vedi Tabella 6. Descrizione Obbligatorio solo se B2=9 Messaggio 501 Risposta Riga B Note di compilazione - Campo 2 Il valore deve essere rilevato dalla Tabella 6 mancata risposta 83 Motivi di Protoccollo di comuniccazione comma 6b Versiione 1.4 6.5 MESSA AGGI Pag ag. 84 di 126 044 Maggio 20122 INVIA ATI DAL SSISTEMA DI D CONTRO OLLO CONCE ESSIONARIO O VLT VLT AL SISTEM MA DEL Il paraagrafo contiiene la des crizione dei messaggi gi operativii che il sisttema di contro ollo VLT invvia al sistem ma del conccessionario VLT. Cod dice Descrizione D e messaaggio INVIO O COMANDI DAL SISTEM EMA DI CON NTROLLO VLT VL AL SISTE EMA DEL CON NCESSIONAR ARIO VLT 1000 Ab bilitazione/ddisabilitazione di un app parecchio videoterminaale 1011 Veerifica dell’inntegrità del software insstallato su unn ap pparecchio videotermiinale 1022 Veerifica dell’iintegrità del software di uno specifiico gioco installato su uun appareccchio videote erminale 1033 Veerifica dell’inntegrità’ del software installato su ddi un sistem ma ceentrale INTERRO OGAZIONI ALLA A BANCA A DATI DEL SISTEMA DEL D CONCE ESSIONARIO O VLT 2100 Riichiesta dellaa data e del risultato dell’ultima veriifica deell’integrità ddel software installato su u di un appaarecchio videoterminaale 2111 Riichiesta dellaa data e del risultato dell’ultima verrifica deell’integrità ddel software di uno speccifico gioco istallato su di un appareccchio video oterminale 2122 g installlati su di un Riichiesta delloo stato dei giochi ap pparecchio videotermiinale 2133 Riichiesta delloo stato di un n apparecch hio videoteerminale 2144 2500 4000 Riichiesta dellla data e del risultato dell’ulttima verificca deell’integrità del softwaare installatto su di un sistem ma ceentrale Riichiesta dei ddati di contaabilità Au utorizzazionne al cambio o di stato di un gioco su un ap pparecchio videotermiinale 84 Protocollo di comunicazione comma 6b Versione 1.4 Pag. 85 di 126 04 Maggio 2012 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 008 Notifica del codice identificativo dell’ubicazione di videoterminale dati 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, - il messaggio 008. 85 Protocollo di comunicazione comma 6b Versione 1.4 6.5.1 Pag. 86 di 126 04 Maggio 2012 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). 86 Protocollo di comunicazione comma 6b Versione 1.4 6.5.2 Pag. 87 di 126 04 Maggio 2012 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. 87 Protocollo di comunicazione comma 6b Versione 1.4 Pag. 88 di 126 04 Maggio 2012 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 41 Descrizione Note di compilazione Vale "A" Messaggio 001 – Riga A 88 Protocollo di comunicazione comma 6b Versione 1.4 Riga B Pag. 89 di 126 04 Maggio 2012 Dati di dettaglio degli errori riscontrati Progressivo campo 1 String Lunghezza massima 1 2 Numeric 4 Tipo Obbl. S S 3 Numeric 6 S 4 String 1 S 5 Numeric 2 S Tracciato 42 Descrizione Tipo riga Codice dell'errore riscontrato Progressivo riga Identificativo della riga che contiene l'errore Identificativo del campo del in cui è stato riscontrato l'errore Note di compilazione Vale "B" Vedi Tabella 5 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 Coincide con il numero riportato nella colonna "Progressivo campo" che corrisponde al campo errato Messaggio 001 – Riga B Note di compilazione - Campo 2 Rappresenta il codice dell’errore riscontrato e deve essere rilevato dalla Tabella 5 89 Protocollo di comunicazione comma 6b Versione 1.4 6.5.3 Pag. 90 di 126 04 Maggio 2012 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). 90 Protocollo di comunicazione comma 6b Versione 1.4 6.5.4 Pag. 91 di 126 04 Maggio 2012 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). 91 Protocollo di comunicazione comma 6b Versione 1.4 6.5.5 Pag. 92 di 126 04 Maggio 2012 NOTIFICA 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. L’ordine delle righe B è lo stesso di quello delle righe C del 601. Codici identificativi del jackpot Per ogni anomalia si ripete la seguente riga C Una per ogni anomalia Descrizione dell’anomalia 92 Protocollo di comunicazione comma 6b Versione 1.4 Progressivo campo Tipo 1 String 2 Numeric 3 Numeric Pag. 93 di 126 04 Maggio 2012 Lunghezza massima 1 10 10 Tracciato 43 Progressivo campo 1 Tipo String Lunghezza massima 1 2 String 50 3 Descrizione Tipo riga Numero righe B Numero righe C Note di compilazione Vale “A” Messaggio 005 – Riga A Numeric 10 Descrizione Tipo riga Codice identificativo del jackpot Codice identificativo jackpot Note di compilazione Vale “B” Codice utilizzato sul sistema di gioco del concessionario Tracciato 44 Messaggio 005 – Riga B Codice rilasciato da AAMS 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). 93 Protocollo di comunicazione comma 6b Versione 1.4 Riga C Pag. 94 di 126 04 Maggio 2012 Anomalie del jackpot Progressivo campo 1 Tipo String Lunghezza massima 1 2 Numeric 4 Descrizione Tipo riga Codice dell'anomalia riscontrata Note di compilazione Vale "C" Vedi Tabella 5 3 Numeric 6 Progressivo che identifica la riga all'interno del Progressivo riga messaggio 601, nella quale è presente il campo errato. 4 String 1 Identificativo Coincide con il campo 1 della riga che della riga presente nel contiene l'errore messaggio originario 2 Identificativo del campo del in cui è stato riscontrato l'anomalia 5 Numeric Tracciato 45 Coincide con il numero riportato nella colonna "Progressivo campo" che corrisponde al campo errato Messaggio 005 – Riga C 94 Protocollo di comunicazione comma 6b Versione 1.4 6.5.6 Pag. 95 di 126 04 Maggio 2012 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 String 12 MAC ADDRESS Codice identificativo dell' ubicazione 5 String 16 MAC ADDRESS Relativo al sistema di sala 6 Numeric 2 7 8 Numeric Eurocent 2 12 Tracciato Tipo di connessione con il sistema di sala Tipo di connessione con il sistema di gioco TOT_BET 46 Relativo all'apparecchio videoterminale Codice rilasciato da AAMS 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). - Campi 6 e 7 Il valore deve essere rilevato dalla Tabella 2 Tipologia di collegamento 95 Protocollo di comunicazione comma 6b Versione 1.4 - Pag. 96 di 126 04 Maggio 2012 Campi 5, 6 e 7 Sono 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 1 settembre 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 String 12 Relativo all'apparecchio MAC ADDRESS videoterminale Codice identificativo Codice rilasciato da dell' ubicazione AAMS 5 String 16 MAC ADDRESS Relativo al sistema di sala 6 Numeric 2 7 8 Numeric Eurocent 2 12 Tipo di connessione con il sistema di sala Tipo di connessione con il sistema di gioco TOT_BET 9 Numeric 10 Codice modello Tracciato 47 96 Vedi Tabella 2 Vedi Tabella 2 Codice rilasciato da AAMS Messaggio 006 Protocollo di comunicazione comma 6b Versione 1.4 6.5.7 NOTIFICA DEL MESSAGGIO 008) Pag. 97 di 126 04 Maggio 2012 CODICE IDENTIFICATIVO DELL’UBICAZIONE (CODICE 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, dal 1 settembre 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 Descrizione Tipo riga Note di compilazione Vale “A” 2 String 16 Codice identificativo dell'ubicazione Codice rilasciato da AAMS Tracciato 48 97 Messaggio 008 Protocollo di comunicazione comma 6b Versione 1.4 6.5.8 Pag. 98 di 126 04 Maggio 2012 NOTIFICA DI SOSPENSIONE/CANCELLAZIONE/RIPRISTINO DI UN SOGGETTO DALL’ELENCO DEI SOGGETTI Per la comunicazione del messaggio in oggetto, il sistema di controllo AWP trasmette al sistema del concessionario AWP attraverso il messaggio 014 secondo le modalità definite nel protocollo di comunicazione comma 6a. 98 Protocollo di comunicazione comma 6b Versione 1.4 6.5.9 Pag. 99 di 126 04 Maggio 2012 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 49 Messaggio 100 Richiesta 99 Protocollo di comunicazione comma 6b Versione 1.4 6.5.10 Pag. 100 di 126 04 Maggio 2012 VERIFICA DELL’INTEGRITÀ DEL SOFTWARE INSTALLATO APPARECCHIO VIDEOTERMINALE (CODICE MESSAGGIO 101) SU DI UN 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 2 String 11 S Codeid Tracciato 50 Note di compilazione Vale “A” Codice rilasciato da AAMS Messaggio 101 Richiesta Tipo di messaggio Risposte alle richieste Struttura Progressivo campo 1 Tipo String Lunghezza massima 1 Obbl. S Descrizione Tipo riga 2 String 11 S 3 String 1 S Codeid Risultato della verifica Tracciato 51 Note di compilazione Vale “A” Codice rilasciato da AAMS 1 codice esatto, 0 codice errato Messaggio 101 Risposta 100 Protocollo di comunicazione comma 6b Versione 1.4 6.5.11 Pag. 101 di 126 04 Maggio 2012 VERIFICA 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 Descrizione Tipo riga Codice identificativo del gioco 3 String 11 S Codeid Tracciato 52 Note di compilazione Vale “A” Codice rilasciato da AAMS 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 Descrizione Tipo riga Codice identificativo del gioco 3 String 11 S Codeid Codice rilasciato da AAMS Codice rilasciato da AAMS S Risultato della verifica 1 codice esatto,0 codice errato 4 String Tracciato 1 53 Note di compilazione Vale “A” Messaggio 102 Risposta 101 Protocollo di comunicazione comma 6b Versione 1.4 6.5.12 Pag. 102 di 126 04 Maggio 2012 VERIFICA DELL’INTEGRITÀ DEL SOFTWARE INSTALLATO SU DI UN SISTEMA CENTRALE(CODICE MESSAGGIO 103) Il messaggio deve essere implementato dal 1 settembre 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 Lunghezza massima 1 Numeric 10 Tracciato 54 Obbl. S Descrizione Tipo riga Note di compilazione Vale “A” S 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 55 Descrizione Tipo riga Codice identificativo del Codice rilasciato da sistema di gioco AAMS Risultato della 1 codice esatto, 0 codice verifica errato Messaggio 103 Risposta 102 Note di compilazione Vale “A” Protocollo di comunicazione comma 6b Versione 1.4 6.5.13 Pag. 103 di 126 04 Maggio 2012 RICHIESTA DELLA 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 2 String 11 S Codeid Tracciato 56 Note di compilazione Vale “A” Codice rilasciato da AAMS Messaggio 210 Richiesta Tipo di messaggio Risposte alle richieste Struttura Progressivo campo 1 Tipo String Lunghezza massima 1 Obbl. S Descrizione Tipo riga 2 3 String Date 11 6 S S Codeid Data Note di compilazione Vale “A” Codice rilasciato da AAMS Data interrogazione 4 String 1 S Risultato della verifica 1 codice esatto,0 codice errato Tracciato 57 Messaggio 210 Risposta 103 Protocollo di comunicazione comma 6b Versione 1.4 6.5.14 Pag. 104 di 126 04 Maggio 2012 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 Descrizione Tipo riga Codice identificativo del gioco 3 String 11 S Codeid Tracciato 58 Note di compilazione Vale “A” Messaggio 211 Richiesta 104 Codice rilasciato da AAMS Codice rilasciato da AAMS Protocollo di comunicazione comma 6b Versione 1.4 Pag. 105 di 126 04 Maggio 2012 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 59 Descrizione Tipo riga Codice identificativo del gioco Codeid Data Risultato della verifica Note di compilazione Vale “A” Codice rilasciato da AAMS Codice rilasciato da AAMS Data interrogazione 1 codice esatto,0 codice errato Messaggio 211 Risposta 105 Protocollo di comunicazione comma 6b Versione 1.4 6.5.15 Pag. 106 di 126 04 Maggio 2012 RICHIESTA 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 String 11 Tracciato 60 Tipo di messaggio Risposte alle richieste Riga A Lunghezza massima 1 Obbl. S S Descrizione Tipo riga Note di compilazione Vale “A” Codeid Codice rilasciato da AAMS Messaggio 212 Richiesta Descrizione Indica il numero di righe B Occorrenze Una per messaggio. Per ogni gioco installato. B Una Stato per gioco installato apparecchio videoterminale 106 sul Protocollo di comunicazione comma 6b Versione 1.4 Pag. 107 di 126 04 Maggio 2012 Struttura Progressivo campo 1 Tipo String Lunghezza massima 1 Obbl. S Descrizione Tipo riga 2 String 11 S 3 Numeric 10 S Codeid Numero di righe B Tracciato Progressivo campo 1 2 3 61 Messaggio 212 Risposta Riga A Tipo String Lunghezza massima 1 Obbl. S Numeric String 10 1 S S Tracciato 62 Note di compilazione Vale “A” Codice rilasciato da AAMS Descrizione Note di compilazione Tipo riga Vale “B” Codice identificativo del Codice rilasciato da gioco AAMS Stato 1 abilitato/ 0 disabilitato Messaggio 212 Risposta Riga B 107 Protocollo di comunicazione comma 6b Versione 1.4 6.5.16 RICHIESTA Pag. 108 di 126 04 Maggio 2012 DELLO STATO DI UN APPARECCHIO VIDEOTERMINALE MESSAGGIO 213) (CODICE 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 63 Messaggio 213 Richiesta Tipo di messaggio Risposte alle richieste Struttura Progressivo campo 1 Tipo String Lunghezza massima 1 Obbl. S 2 3 String String 11 1 S S 4 DataOra 12 S 5 String 1 S 6 DataOra 12 S Tracciato 64 Descrizione Tipo riga Note di compilazione Vale “A” Codice rilasciato da Codeid AAMS Flag Stato Acceso(1)/Spento(0) Data relativa dell'ultimo Data di cambio cambio di stato del campo 3 stato Disabilitato al gioco(2) / Abilitato al gioco (3) Data relativa dell'ultimo Data di cambio cambio di stato del campo 5 stato Flag Stato Messaggio 213 Risposta 108 Protocollo di comunicazione comma 6b Versione 1.4 6.5.17 Pag. 109 di 126 04 Maggio 2012 RICHIESTA DELLA DATA E DEL RISULTATO DELL’ULTIMA VERIFICA DELL’INTEGRITÀ DEL SOFTWARE INSTALLATO SU DI UN SISTEMA CENTRALE VLT (CODICE MESSAGGIO 214) Il messaggio deve essere implementato dal 1 settembre 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 2 Tipo String Lunghezza massima 1 Numeric 10 Tracciato 65 Obbl. S Descrizione Tipo riga Note di compilazione Vale “A” S 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 66 Descrizione Tipo riga Codice identificativo del Codice rilasciato da sistema di gioco AAMS Data Data interrogazione Risultato della 1 codice esatto,0 codice verifica errato Messaggio 214 Risposta 109 Note di compilazione Vale “A” Protocollo di comunicazione comma 6b Versione 1.4 6.5.18 Pag. 110 di 126 04 Maggio 2012 RICHIESTA DEI DATI DI CONTABILITÀ(CODICE MESSAGGIO 250) Il messaggio deve essere implementato dal 1 settembre 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 S S C C Codice identificativo del componente Codice rilasciato da AAMS Anno Mese da 01 a 12 Giorno da 01 a 31 C Codice identificativo del sistema di gioco Codice rilasciato da AAMS 3 4 5 6 7 String Numeric Numeric Numeric 12 4 2 2 Numeric 10 Tracciato 67 Messaggio 250 Richiesta Note di compilazione - 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. 110 Protocollo di comunicazione comma 6b Versione 1.4 - Pag. 111 di 126 04 Maggio 2012 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. 111 Una per gioco Protocollo di comunicazione comma 6b Versione 1.4 Pag. 112 di 126 04 Maggio 2012 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 Codice identificativo del componente Codice rilasciato da AAMS BET Importo puntate WIN Vincite conseguite 3 4 5 String Eurocent Eurocent 12 12 12 S S S 6 7 8 9 10 11 12 Eurocent Eurocent Eurocent Numeric Numeric Numeric Numeric 12 12 12 12 4 2 2 C S S S S C C 13 Numeric Tracciato 10 68 C TOT_PAID TOT_IN TOT_OUT BET_NUM Anno Mese Giorno Importo riscosso Importo introdotto Importo erogato Numero puntate da 01 a 12 da 01 a 31 Codice identificativo del sistema di gioco Codice rilasciato da AAMS 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 lorde 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. 112 Protocollo di comunicazione comma 6b Versione 1.4 - - - Pag. 113 di 126 04 Maggio 2012 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 Descrizione Tipo riga Note di compilazione Vale “B” 2 3 4 5 Numeric Eurocent Eurocent Numeric 10 12 12 12 S S S S Codice identificativo del gioco BET WIN BET_NUM Codice rilasciato da AAMS Tracciato 69 Vincita conseguita 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 lorde 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. 113 Protocollo di comunicazione comma 6b Versione 1.4 6.5.19 Pag. 114 di 126 04 Maggio 2012 AUTORIZZAZIONE AL CAMBIO DI STATO DI UN GIOCO SU UN APPARECCHIO VIDEOTERMINALE (CODICE MESSAGGIO 400) 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 Segnalazione Struttura Progressivo campo 1 Tipo String Lunghezza massima 1 Obbl. S 2 Numeric 15 S Tracciato 70 114 Descrizione Tipo riga Identificativo del messaggio applicativo della richiesta 313 Messaggio 400 Note di compilazione Vale “A” Protocollo di comunicazione comma 6b Versione 1.4 7. Pag. 115 di 126 04 Maggio 2012 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 Tabella 2 - Tipi d’ubicazione Descrizione Sala giochi Agenzia scommesse Agenzia ippica Sala bingo Negozio di gioco Esercizio comma6 Magazzino - 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 115 Protocollo di comunicazione comma 6b Versione 1.4 Tabella 3 - 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 04 Maggio 2012 Tipologia sistemi collegamenti Codice 1 2 3 4 Pag. 116 di 126 Descrizione Sistema di gioco Sala/Magazzino Apparecchio videoterminale 116 Protocollo di comunicazione comma 6b Versione 1.4 Tabella 5 - Pag. 117 di 126 04 Maggio 2012 Codici di Errore 117 Protocollo di comunicazione comma 6b Versione 1.4 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 Pag. 118 di 126 04 Maggio 2012 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 118 Protocollo di comunicazione comma 6b Versione 1.4 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. 119 di 126 04 Maggio 2012 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 119 Protocollo di comunicazione comma 6b Versione 1.4 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. 120 di 126 04 Maggio 2012 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 120 Protocollo di comunicazione comma 6b Versione 1.4 6026 6027 Pag. 121 di 126 04 Maggio 2012 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 1 Settembre 2012 6028 6029 3066 3067 3068 3069 3070 COMPONENTE CESSATO INCONGRUENTE CON I DATI DEFINITI IN UN MESSAGGIO 600 ACCETTATO DAL SISTEMA DI CONTROLLO DI AAMS SOGGETTO NON IN POSSESSO DEI REQUISITI SOGGETTO NON PRESENTE SULL’ELENCO DEI SOGGETTI VIGENTE SOGGETTO PRESENTE SULL’ELENCO DEI SOGGETTI VIGENTE , MA SOSPESO SOGGETTO CESSATO SULL’ELENCO DEI SOGGETTI VIGENTE MESSAGGIO 600 DI SISTEMA DI GIOCO NON E' PRESENTE PER L'ANNO CORRENTE 121 Protocollo di comunicazione comma 6b Versione 1.4 Tabella 6 - 32 33 34 35 36 37 9 Tabella 7 04 Maggio 2012 Motivi di mancata risposta Codice 00 20 21 30 31 Pag. 122 di 126 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 Codice 0 1 2 3 Tabella 8 Descrizione Spento Acceso Disabilitato dal gioco Abilitato al gioco - Codice 1 2 3 4 99 Motivi di cessazione di un apparecchio videoterminale Descrizione Dismissione Incendio Furto Sequestro Altro 122 Protocollo di comunicazione comma 6b Versione 1.4 Tabella 9 - Descrizione Smarrimento Furto Danneggiamento Tabella 10 Codice 1 2 3 4 04 Maggio 2012 Motivi di sostituzione dell’etichetta identificativa Codice 1 2 3 Pag. 123 di 126 - Tipologia di jackpot 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 123 Protocollo di comunicazione comma 6b Versione 1.4 8. Pag. 124 di 126 04 Maggio 2012 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 ................................................................................. 26 Elenco dei messaggi operativi provenienti dal sistema di controllo VLT, diretti verso il sistema del concessionario VLT Messaggi operativi AAMS – Concessionario 1................................................................................ 85 Messaggi operativi AAMS – Concessionario 2................................................................................ 85 Elenco dei tracciati dei messaggi applicativi Tracciato 1 Struttura generale del messaggio applicativo ...................................................... 22 Tracciato 2 Testata del messaggio ............................................................................................ 22 Tracciato 3 Messaggio 300 ......................................................................................................... 28 Tracciato 4 Messaggio 300 ........................................................................................................ 28 Tracciato 5 Messaggio 301 ......................................................................................................... 29 Tracciato 6 Messaggio 301 ......................................................................................................... 30 Tracciato 7 Messaggio 302 ......................................................................................................... 31 Tracciato 8 Messaggio 303 ......................................................................................................... 32 Tracciato 9 Messaggio 304 ......................................................................................................... 35 Tracciato 10 Messaggio 305 ....................................................................................................... 37 Tracciato 11 Messaggio 306 ..................................................................................................... 40 Tracciato 12 Messaggio 307 ....................................................................................................... 42 Tracciato 13 Messaggio 308 ....................................................................................................... 43 Tracciato 14 Messaggio 309 Riga A .......................................................................................... 45 Tracciato 15 Messaggio 309 Riga B .......................................................................................... 46 Tracciato 16 Messaggio 310 ....................................................................................................... 47 Tracciato 17 Messaggio 311 ....................................................................................................... 49 Tracciato 18 Messaggio 312 ....................................................................................................... 50 Tracciato 19 Messaggio 312 ....................................................................................................... 51 Tracciato 20 Messaggio 313 ....................................................................................................... 52 Tracciato 21 Messaggio 504 ....................................................................................................... 55 Tracciato 22 Messaggio 600 Riga A .......................................................................................... 57 Tracciato 23 Messaggio 600 Riga B .......................................................................................... 60 Tracciato 24 Messaggio 601 Riga A .......................................................................................... 65 Tracciato 25 Messaggio 601 Riga B .......................................................................................... 65 Tracciato 26 Messaggio 601 Riga C .......................................................................................... 66 Tracciato 27 Messaggio 601 Riga D .......................................................................................... 67 Tracciato 28 Messaggio 601 Riga E .......................................................................................... 67 Tracciato 29 Messaggio 601 Riga A .......................................................................................... 69 124 Protocollo di comunicazione comma 6b Versione 1.4 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. 125 di 126 04 Maggio 2012 30 Messaggio 601 Riga C .......................................................................................... 70 31 Messaggio 601 Riga D .......................................................................................... 71 32 Messaggio 605 Riga A .......................................................................................... 74 33 Messaggio 605 Riga B .......................................................................................... 74 34 Messaggio 606 Riga A .......................................................................................... 76 35 Messaggio 607 Riga A .......................................................................................... 77 36 Messaggio 608 Riga A .......................................................................................... 78 37 Messaggio 701 ....................................................................................................... 79 38 Messaggio 701 ....................................................................................................... 80 39 Messaggio 501 Risposta Riga A .......................................................................... 82 40 Messaggio 501 Risposta Riga B .......................................................................... 83 41 Messaggio 001 – Riga A ....................................................................................... 88 42 Messaggio 001 – Riga B ....................................................................................... 89 43 Messaggio 005 – Riga A ....................................................................................... 93 44 Messaggio 005 – Riga B ....................................................................................... 93 45 Messaggio 005 – Riga C ....................................................................................... 94 46 Messaggio 006 ....................................................................................................... 95 47 Messaggio 006 ....................................................................................................... 96 48 Messaggio 008 ....................................................................................................... 97 49 Messaggio 100 Richiesta ...................................................................................... 99 50 Messaggio 101 Richiesta ....................................................................................100 51 Messaggio 101 Risposta .....................................................................................100 52 Messaggio 102 Richiesta ....................................................................................101 53 Messaggio 102 Risposta .....................................................................................101 54 Messaggio 103 Richiesta ....................................................................................102 55 Messaggio 103 Risposta .....................................................................................102 56 Messaggio 210 Richiesta ....................................................................................103 57 Messaggio 210 Risposta .....................................................................................103 58 Messaggio 211 Richiesta ....................................................................................104 59 Messaggio 211 Risposta .....................................................................................105 60 Messaggio 212 Richiesta ....................................................................................106 61 Messaggio 212 Risposta Riga A ........................................................................107 62 Messaggio 212 Risposta Riga B ........................................................................107 63 Messaggio 213 Richiesta ....................................................................................108 64 Messaggio 213 Risposta .....................................................................................108 65 Messaggio 214 Richiesta ....................................................................................109 66 Messaggio 214 Risposta .....................................................................................109 67 Messaggio 250 Richiesta ....................................................................................110 68 Messaggio 250 Risposta Riga A ........................................................................112 69 Messaggio 250 Risposta Riga B ........................................................................113 70 Messaggio 400 .....................................................................................................114 Elenco delle tabelle di decodifica 125 Protocollo di comunicazione comma 6b Versione 1.4 Tabella 1 Tabella 2 Tabella 3 Tabella 4 Tabella 5 Tabella 6 Tabella 7 Tabella 8 Tabella 9 Tabella 10 Pag. 126 di 126 04 Maggio 2012 - Tipi d’ubicazione ...................................................................................................115 - Tipologia di collegamento ....................................................................................115 - Tipologia sistemi collegamenti.............................................................................116 - Tipologia di componente .....................................................................................116 - Codici di Errore .....................................................................................................117 - Motivi di mancata risposta ...................................................................................122 - Stato di funzionamento di un apparecchio videoterminale .............................122 - Motivi di cessazione di un apparecchio videoterminale...................................122 - Motivi di sostituzione dell’etichetta identificativa............................................123 - Tipologia di jackpot..............................................................................................123 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 126