Agenzia delle dogane e dei Monopoli Nota 28-5-2013 n. 3795/Giochi/GAD/2013 Aggiornamento protocollo di comunicazione PGAD - Versione 1.5.1.

Agenzia delle dogane e dei Monopoli
Nota 28-5-2013 n. 3795/Giochi/GAD/2013
Aggiornamento protocollo di comunicazione PGAD - Versione 1.5.1.
Emanata dall'Agenzia delle dogane e dei monopoli, Direzione centrale gestione tributi e monopolio giochi, Ufficio gioco a distanza.
Nota 28 maggio 2013, n. 3795/Giochi/GAD/2013 (1).
Aggiornamento protocollo di comunicazione PGAD - Versione 1.5.1.
(1) Emanata dall'Agenzia delle dogane e dei monopoli, Direzione centrale gestione tributi e monopolio giochi, Ufficio gioco a distanza.



Ai
Concessionari abilitati alla raccolta a distanza dei giochi pubblici


Loro sedi
e, p.c.:
Alla
Sogei Spa


Via Mario Carucci, 99


00143 - Roma





Si comunica che è disponibile la nuova versione (1.5.1, in bozza) del protocollo di comunicazione PGAD.
In particolare, rispetto alla precedente versione 1.5, sono state apportate le seguenti modifiche:
1. nella "Tabella delle Famiglie di Gioco" (Tabella 5.7) per il codice "9", la descrizione è stata modificata in "Lotto e Lotterie";
2. nella "Tabella dei Tipi di Gioco" (Tabella 5.8) sono stati aggiunti i codici:



Codice Famiglia
Codice Gioco
Descrizione
9
2
Lotto Online
9
3
10 e Lotto Online






3. nella "Tabella delle Famiglie di Gioco" (Tabella 5.7) è stata eliminata la famiglia gioco 11 "Scommesse con Interazione Diretta fra Giocatori", che viene inglobata nella famiglia 1 "Scommesse Sportive";
4. nella "Tabella dei Tipi di Gioco" (Tabella 5.8) sono stati eliminati i codici relativi alla famiglia di gioco 11 "Scommesse con Interazione Diretta fra Giocatori";
5. nella "Tabella di Mezzi di Pagamento" è stato aggiunto il codice 14 con descrizione "E-Wallet";
6. nel messaggio 4.14 (Storno Movimentazione Conto di Gioco) sono stati modificati i valori possibili del campo "Tipo Storno", che diventano "1" per lo "Storno Normale" e "2" per lo "Storno da Charge Back".


Da martedì 28 maggio 2013 saranno disponibili gli aggiornamenti in ambiente di test per le verifiche del colloquio tra i sistemi di gioco dei concessionari e il sistema Anagrafe dei Conti di Gioco, secondo le regole previste dal protocollo di comunicazione PGAD.
Da mercoledì 29 maggio 2013 saranno disponibili gli aggiornamenti in ambiente di produzione solo per le modifiche ai punti 1 e 2.
Da lunedì 1° luglio 2013 saranno disponibili gli aggiornamenti in ambiente di produzione anche per gli altri punti.
Si ricorda che l'accesso all'ambiente di test è consentito nei giorni feriali, in orario di ufficio e per il tempo strettamente necessario alla verifica della corretta predisposizione dei messaggi informatici.


Eventuali osservazioni, quesiti e richieste di chiarimento possono essere inviati all'indirizzo e-mail assistenza-giochi@sogei.it e, per conoscenza, a giocoadistanza@aams.it.


Il Dirigente
Francesco Rodano

Allegato


Protocollo per il gioco a distanza


PGAD


Introduzione


Il PGAD è un protocollo applicativo per la gestione dei conti di gioco telematici.
Le interazioni tra client e server si basano sullo scambio di due messaggi: richiesta e risposta e per definizione, il client effettua la richiesta ed il server invia la risposta.

1. Entità coinvolte
I soggetti coinvolti nell'utilizzo del protocollo sono: l'Agenzia delle dogane e dei Monopoli, i Fornitori del servizio di Connettività, i Concessionari e il Sistema Anagrafe dei Conti di Gioco.
Nel presente documento i nomi dei soggetti sono abbreviati secondo le seguenti sigle:



Entità
Sigla
Amministrazione Autonoma dei Monopoli di Stato
ADM
Fornitore del Servizio di Connettività
FSC
Concessionario
CN
Sistema Anagrafe Conti di Gioco
SACG




2. Protocollo applicativo
Il colloquio tra i Concessionari e il Sistema Anagrafe dei Conti di Gioco avviene su un canale dedicato utilizzando come meccanismo di trasporto il protocollo SOAP su HTTPS.
Ogni messaggio applicativo scambiato è imbustato in un messaggio SOAP.
Le operazioni inerenti i conti di gioco sono realizzate attraverso la tecnologia dei WEB SERVICES.
È stato adottato lo standard WS-SECURITY per autenticare i concessionari e per garantire integrità e riservatezza alla comunicazione.
L'autenticazione dei concessionari è realizzata per mezzo degli Username Tokens firmati. Il Concessionario che vuole inviare una richiesta al Sistema Anagrafe dei Conti di Gioco deve inserire uno Username Token nell'HEADER del messaggio SOAP, lo deve firmare con la propria chiave privata di firma e deve poi inserire nell'HEADER SOAP la firma prodotta e il suo certificato digitale di firma. Lo Username Token deve essere valorizzato con il "Common Name" del certificato digitale di firma utilizzato.
L'integrità è garantita dall'uso della Firma Digitale. Il mittente del messaggio SOAP firma l'intero BODY con la propria chiave privata di firma e inserisce nell'HEADER del messaggio SOAP la firma prodotta e il suo certificato digitale di firma.
La riservatezza è garantita attraverso la Cifratura. Il mittente del messaggio SOAP cifra l'intero BODY con il certificato digitale di cifratura del destinatario del messaggio.
L'integrità è richiesta per tutti i messaggi applicativi scambiati tra i Concessionari e il Sistema Anagrafe dei Conti di Gioco, mentre la riservatezza si rende necessaria solo per alcuni messaggi applicativi di richiesta.

3. Convenzioni di codifica


Di seguito sono riportati e descritti i tipi di dati utilizzati nelle specifiche dei messaggi del protocollo:



Tipo
Descrizione
byte
Numero di 8 bit con segno
short
Numero di 16 bit con segno
int
Numero di 32 bit con segno
long
Numero di 64 bit con segno
String
Una sequenza di caratteri Unicode codificati in UTF-8
Data
Struttura per la rappresentazione della data



Tipo
Descrizione
Lung. min
Lung. max






String
Giorno
2
2

String
Mese
2
2

String
Anno
4
4
Ora
Struttura per la rappresentazione dell'orario



Tipo
Descrizione
Lung. min
Lung. max






String
Ore
2
2

String
Minuti
2
2

String
Secondi
2
2



Tutti gli orari sono specificati secondo il CET (Central European Time) con la gestione automatica del DST (Daylight Saving Time).
DataOra
Struttura per la rappresentazione della data e ora



Tipo
Descrizione








Data
Data



Ora
Orario


DatiNascita
Struttura per la rappresentazione dei dati di nascita



Tipo
Descrizione
Lung. min
Lung. max






Data
Data di nascita
-
-

String
Comune di nascita
1
100

String
Sigla provincia di nascita
2
2
Residenza
Struttura per la rappresentazione dei dati di residenza



Tipo
Descrizione
Lung. min
Lung. max






String
Indirizzo di residenza
1
250

String
Comune di residenza
1
100

String
Sigla provincia di residenza
2
2

String
CAP di residenza
5
5
Documento
Struttura per la rappresentazione di un documento



Tipo
Descrizione
Lung. min
Lung. max






byte
Tipologia (vedi tabella tipologia documento)
-
-

String
Numero
1
20

Data
Data di rilascio
-
-

String
Autorità rilascio
1
100

String
Località rilascio
1
100
Persona Fisica
Struttura per la rappresentazione di una persona fisica



Tipo
Descrizione
Lung. min
Lung. max

String
Codice Fiscale
16
16

String
Cognome
1
100

String
Nome
1
100

String
Sesso
1
1

DatiNascita
Nascita
-
-

Residenza
Residenza
-
-

Documento
Documento
-
-

String
Posta Elettronica
0
100

String
Pseudonimo
0
100
Persona Giuridica
Struttura per la rappresentazione di una persona giuridica

Tipo
Descrizione
Lung. min
Lung. max

String
Partita IVA
11
11

String
Ragione Sociale
1
100

Residenza
Sede
-
-

String
Posta elettronica
0
100

String
Pseudonimo
0
100
Dettaglio Bonus
Struttura per la rappresentazione del dettaglio del bonus



Tipo
Descrizione
Lung. min
Lung. max

byte
Famiglia di gioco (vedi tabella famiglia di gioco)
-
-

byte
Tipo di gioco (vedi tabella tipo di gioco)
-
-

int
Importo bonus (in centesimi di euro)
-
-
Dettaglio Operazioni Movimentazione
Struttura per rappresentare il dettaglio delle operazioni di movimentazione



Tipo
Descrizione
Lung. min
Lung. max

byte
Causale Movimento (vedi tabelle dei codici di causale movimento e di movimento bonus)
-
-

int
Numero di operazioni
-
-

long
Totale importo
-
-
Dettaglio Operazioni Servizio
Struttura per rappresentare il dettaglio delle operazioni di servizio



Tipo
Descrizione
Lung. min
Lung. max

byte
Causale Servizio (vedi tabella dei codici di causale di operazioni di servizio)
-
-

int
Numero di operazioni
-
-








4. Struttura dei messaggi
Ogni messaggio applicativo, scambiato tra un client ed un server, è identificato dai seguenti campi:
- ID FSC: identificativo univoco del FSC che sta effettuando la transazione;
- ID RETE: identificativo univoco della Rete di vendita del CN che sta effettuando la transazione;
- ID CN: identificativo univoco del CN che sta effettuando la transazione;
- ID Transazione: identificativo univoco della transazione (a livello di CN).


4.1 Apertura conto di gioco persona fisica


Descrizione:
Questo messaggio consente ad un CN di comunicare al SACG l'apertura di un conto di gioco telematico effettuato da una persona fisica.


Richiesta:



Campo
Tipo
Lung. min
Lung. max
Descrizione
ID FSC
short


Identificativo univoco del FSC che sta effettuando la transazione
ID RETE
byte


Identificativo univoco della Rete di vendita del CN che sta effettuando la transazione (vedi tabella dei codici rete)
ID CN
long


Identificativo univoco del CN che sta effettuando la transazione
ID Transazione
long


Identificativo univoco della transazione (a livello di CN)
ID RETE Conto
byte


Identificativo univoco della Rete di vendita del CN con il quale il cliente ha stipulato il Conto di Gioco (vedi tabella dei codici rete)
ID CN Conto
long


Identificativo univoco del CN con il quale il cliente ha stipulato il Conto di Gioco
Codice Conto
String
1
20
Codice del Conto di Gioco univoco per il CN
Titolare Conto
PersonaFisica


Dati identificativi del titolare del Conto di Gioco








Ws-Security:
- Username Token
- Firma Digitale
- Cifratura


Risposta:



Campo
Tipo
Lung. min
Lung. max
Descrizione
Esito Richiesta
short


Codice univoco che descrive l'esito della richiesta
ID FSC
short


Identificativo univoco del FSC che sta effettuando la transazione
ID RETE
byte


Identificativo univoco della Rete di vendita del CN che sta effettuando la transazione (vedi tabella dei codici rete)
ID CN
long


Identificativo univoco del CN che sta effettuando la transazione
ID Transazione
long


Identificativo univoco della transazione (a livello di CN)
ID Ricevuta
String
0
25
Identificativo univoco della risposta attribuito dal sistema
Time Stamp
DataOra


Data e ora in cui il server ha processato la richiesta








Ws-Security:
- Firma Digitale


Codici di ritorno:
- 1024 - Esito ok
- 1025 - Operazione momentaneamente interdetta
- 1026 - Richiesta ancora in fase di elaborazione
- 1027 - ID Transazione relativo ad una richiesta già processata
- 1028 - Username Token non valido
- 1100 - Concessionario trasmittente non identificato
- 1101 - Concessionario titolare conto non identificato
- 1200 - Il soggetto è già titolare di un conto presso il concessionario
- 1201 - Conto esistente
- 1232 - Provincia di residenza non valida
- 1300 - Persona fisica non identificata
- 1301 - Persona fisica deceduta
- 1302 - Persona fisica minorenne
- 1303 - Dati anagrafici persona fisica non validi
- 1304 - Codice fiscale persona fisica non valido
- 1029 - Errore generico.


4.2 Apertura conto di gioco persona giuridica


Descrizione:


Questo messaggio consente ad un CN di comunicare al SACG l'apertura di un conto di gioco telematico effettuato da una persona giuridica. L'apertura di un conto di gioco intestato ad una persona giuridica è possibile soltanto nei casi previsti dalla normativa vigente, come ad esempio per effettuare le giocate a carature speciale a distanza (D.Dirett. 9 dicembre 2008 - Modalità di partecipazione ai concorsi pronostici su base sportiva "Totocalcio", "il 9", "Totogol" e "+Gol" attraverso giocate a caratura speciale - pubblicato nella Gazz. Uff. 20 dicembre 2008, n. 297).


Richiesta:



Campo
Tipo
Lung. min
Lung. max
Descrizione
ID FSC
short


Identificativo univoco del FSC che sta effettuando la transazione
ID RETE
byte


Identificativo univoco della Rete di vendita del CN che sta effettuando la transazione (vedi tabella dei codici rete)
ID CN
long


Identificativo univoco del CN che sta effettuando la transazione
ID Transazione
long


Identificativo univoco della transazione (a livello di CN)
Codice Conto
String
1
20
Codice del Conto di Gioco univoco per il CN
Titolare Conto
PersonaGiuridica


Dati identificativi del titolare del Conto di Gioco








Ws-Security:
- Username Token
- Firma Digitale


Risposta:



Campo
Tipo
Lung. min
Lung. max
Descrizione
Esito Richiesta
short


Codice univoco che descrive l'esito della richiesta
ID FSC
short


Identificativo univoco del FSC che sta effettuando la transazione
ID RETE
byte


Identificativo univoco della Rete di vendita del CN che sta effettuando la transazione (vedi tabella dei codici rete)
ID CN
long


Identificativo univoco del CN che sta effettuando la transazione
ID Transazione
long


Identificativo univoco della transazione (a livello di CN)
ID Ricevuta
String
0
25
Identificativo univoco della risposta attribuito dal sistema
Time Stamp
DataOra


Data e ora in cui il server ha processato la richiesta








Ws-Security:
- Firma Digitale


Codici di ritorno:
- 1024 - Esito ok
- 1025 - Operazione momentaneamente interdetta
- 1026 - Richiesta ancora in fase di elaborazione
- 1027 - ID Transazione relativo ad una richiesta già processata
- 1028 - Username Token non valido
- 1100 - Concessionario trasmittente non identificato
- 1102 - Concessionario titolare conto e Partita IVA non congruenti
- 1200 - Il soggetto è già titolare di un conto presso il concessionario
- 1201 - Conto esistente
- 1232 - Provincia di residenza non valida
- 1029 - Errore generico.


4.3 Movimentazione conto di gioco


Descrizione:


Questo messaggio consente ad un CN di comunicare al SACG la movimentazione su un conto di gioco telematico.


Richiesta:



Campo
Tipo
Lung. min
Lung. max
Descrizione
ID FSC
short


Identificativo univoco del FSC che sta effettuando la transazione
ID RETE
byte


Identificativo univoco della Rete di vendita del CN che sta effettuando la transazione (vedi tabella dei codici rete)
ID CN
long


Identificativo univoco del CN che sta effettuando la transazione
ID Transazione
long


Identificativo univoco della transazione (a livello di CN)
ID RETE Conto
byte


Identificativo univoco della Rete di vendita del CN con il quale il cliente ha stipulato il Conto di Gioco (vedi tabella dei codici rete)
ID CN Conto
long


Identificativo univoco del CN con il quale il cliente ha stipulato il Conto di Gioco
Codice Conto
String
1
20
Codice del Conto di Gioco univoco per il CN
Mezzo di Pagamento
byte


Codice del mezzo di pagamento utilizzato (vedi tabella dei codici dei mezzi di pagamento)
Causale Movimento
byte


Causale del movimento sul Conto Di Gioco (vedi tabella dei codici di causale di movimento). Può valere 1 (Ricarica), 3 (Prelievo) e 7 (Costi Servizi aggiuntivi)
Importo Movimento
int


Importo del movimento sul Conto Di Gioco (in centesimi di euro)
Importo Saldo
int


Saldo del Conto di Gioco comprensivo del movimento effettuato e dei bonus esistenti sul Conto di Gioco (in centesimi di euro)
Data Ora Saldo
DataOra


Data e ora del Saldo
Importo Bonus Saldo
int


Quota parte del "Importo Saldo" relativa ai bonus esistenti sul Conto di Gioco (in centesimi di euro)
Numero Dettagli Bonus Saldo
byte


Numero di dettagli bonus saldo. Specifica quanti sono gli elementi "Dettaglio Bonus Saldo" seguenti
Dettaglio Bonus Saldo

Dettaglio Bonus Saldo
DettaglioBonus


Dettaglio del bonus relativo al saldo














Ws-Security:
- Username Token
- Firma Digitale


Risposta:



Campo
Tipo
Lung. min
Lung. max
Descrizione
Esito Richiesta
short


Codice univoco che descrive l'esito della richiesta
ID FSC
short


Identificativo univoco del FSC che sta effettuando la transazione
ID RETE
byte


Identificativo univoco della Rete di vendita del CN che sta effettuando la transazione (vedi tabella dei codici rete)
ID CN
long


Identificativo univoco del CN che sta effettuando la transazione
ID Transazione
long


Identificativo univoco della transazione (a livello di CN)
ID Ricevuta
String
0
25
Identificativo univoco della risposta attribuito dal sistema
Time Stamp
DataOra


Data e ora in cui il server ha processato la richiesta








Ws-Security:
- Firma Digitale


Codici di ritorno:
- 1024 - Esito ok
- 1025 - Operazione momentaneamente interdetta
- 1026 - Richiesta ancora in fase di elaborazione
- 1027 - ID Transazione relativo ad una richiesta già processata
- 1028 - Username Token non valido
- 1100 - Concessionario trasmittente non identificato
- 1101 - Concessionario titolare conto non identificato
- 1202 - Conto non esistente
- 1203 - Movimentazione conto non consentita: conto chiuso
- 1204 - Movimentazione conto non consentita: conto dormiente
- 1216 - Importo movimento minore o uguale a zero
- 1217 - Importo saldo negativo
- 1218 - Importo bonus saldo negativo
- 1219 - Somma di importo movimento e importo bonus saldo maggiore di importo saldo
- 1220 - Importo bonus saldo maggiore di importo saldo
- 1221 - Dettaglio bonus saldo non valido: tipo gioco inesistente
- 1222 - Dettaglio bonus saldo non valido: importo minore o uguale a zero
- 1223 - Dettaglio bonus saldo non valido: tipo gioco duplicato
- 1224 - Dettaglio bonus saldo non valido: somma importi diversa da importo bonus saldo


4.4 Movimentazione bonus conto di gioco


Descrizione:


Questo messaggio consente ad un CN di comunicare al SACG la movimentazione dei bonus su un conto di gioco telematico.


Richiesta:



Campo
Tipo
Lung. min
Lung. max
Descrizione
ID FSC
Short


Identificativo univoco del FSC che sta effettuando la transazione
ID RETE
Byte


Identificativo univoco della Rete di vendita del CN che sta effettuando la transazione (vedi tabella dei codici rete)
ID CN
Long


Identificativo univoco del CN che sta effettuando la transazione
ID Transazione
Long


Identificativo univoco della transazione (a livello di CN)
ID RETE Conto
Byte


Identificativo univoco della Rete di vendita del CN con il quale il cliente ha stipulato il Conto di Gioco (vedi tabella dei codici rete)
ID CN Conto
Long


Identificativo univoco del CN con il quale il cliente ha stipulato il Conto di Gioco
Codice Conto
String
1
20
Codice del Conto di Gioco univoco per il CN
Causale Movimento
Byte


Causale del movimento dei bonus sul Conto Di Gioco (vedi tabella dei codici di causale di movimento bonus)
Importo Bonus
Int


Importo totale dei bonus (in centesimi di euro)
Numero Dettagli Bonus
Byte


Numero di dettagli bonus. Specifica quanti sono gli elementi 'Dettaglio Bonus' seguenti
Dettaglio Bonus

Dettaglio Bonus
DettaglioBonus


Dettaglio del bonus
Importo Saldo
Int


Saldo del Conto di Gioco comprensivo del movimento effettuato e dei bonus esistenti sul Conto di Gioco (in centesimi di euro)
Data Ora Saldo
DataOra


Data e ora del Saldo
Importo Bonus Saldo
Int


Quota parte del "Importo Saldo" relativa ai bonus esistenti sul Conto di Gioco (in centesimi di euro)
Numero Dettagli Bonus Saldo
Byte


Numero di dettagli bonus saldo. Specifica quanti sono gli elementi "Dettaglio Bonus Saldo" seguenti
Dettaglio Bonus Saldo

Dettaglio
Bonus
Saldo
DettaglioBonus


Dettaglio del bonus relativo al saldo














Ws-Security:
- Username Token
- Firma Digitale


Risposta:



Campo
Tipo
Lung. min
Lung. max
Descrizione
Esito Richiesta
Short


Codice univoco che descrive l'esito della richiesta
ID FSC
Short


Identificativo univoco del FSC che sta effettuando la transazione
ID RETE
Byte


Identificativo univoco della Rete di vendita del CN che sta effettuando la transazione (vedi tabella dei codici rete)
ID CN
Long


Identificativo univoco del CN che sta effettuando la transazione
ID Transazione
Long


Identificativo univoco della transazione (a livello di CN)
ID Ricevuta
String
0
25
Identificativo univoco della risposta attribuito dal sistema
Time Stamp
DataOra


Data e ora in cui il server ha processato la richiesta








Ws-Security:
- Firma Digitale


Codici di ritorno:
- 1024 - Esito ok
- 1025 - Operazione momentaneamente interdetta
- 1026 - Richiesta ancora in fase di elaborazione
- 1027 - ID Transazione relativo ad una richiesta già processata
- 1028 - Username Token non valido
- 1100 - Concessionario trasmittente non identificato
- 1101 - Concessionario titolare conto non identificato
- 1202 - Conto non esistente
- 1203 - Movimentazione conto non consentita: conto chiuso
- 1204 - Movimentazione conto non consentita: conto dormiente
- 1217 - Importo saldo negativo
- 1218 - Importo bonus saldo negativo
- 1220 - Importo bonus saldo maggiore di importo saldo
- 1221 - Dettaglio bonus saldo non valido: tipo gioco inesistente
- 1222 - Dettaglio bonus saldo non valido: importo minore o uguale a zero
- 1223 - Dettaglio bonus saldo non valido: tipo gioco duplicato
- 1224 - Dettaglio bonus saldo non valido: somma importi diversa da importo bonus saldo
- 1225 - Importo bonus minore o uguale a zero
- 1226 - Importo bonus saldo minore di importo bonus
- 1227 - Dettaglio bonus non valido: tipo gioco inesistente
- 1228 - Dettaglio bonus non valido: importo minore o uguale a zero
- 1229 - Dettaglio bonus non valido: tipo gioco duplicato
- 1230 - Dettaglio bonus non valido: somma importi diversa da importo bonus
- 1231 - Dettaglio bonus non congruente con Dettaglio bonus saldo
- 1029 - Errore generico.


4.5 Cambio stato conto di gioco


Descrizione:


Questo messaggio consente ad un CN di comunicare al SACG il cambio di stato di un conto di gioco telematico.


Richiesta:



Campo
Tipo
Lung. min
Lung. max
Descrizione
ID FSC
short


Identificativo univoco del FSC che sta effettuando la transazione
ID RETE
byte


Identificativo univoco della Rete di vendita del CN che sta effettuando la transazione (vedi tabella dei codici rete)
ID CN
long


Identificativo univoco del CN che sta effettuando la transazione
ID Transazione
long


Identificativo univoco della transazione (a livello di CN)
ID RETE Conto
byte


Identificativo univoco della Rete di vendita del CN con il quale il cliente ha stipulato il Conto di Gioco (vedi tabella dei codici rete)
ID CN Conto
long


Identificativo univoco del CN con il quale il cliente ha stipulato il Conto di Gioco
Codice Conto
String
1
20
Codice del Conto di Gioco univoco per il CN
Stato
byte


Codice nuovo stato del Conto di Gioco (vedi tabella degli stati)




Causale del cambio stato
Causale
byte


(vedi tabella dei codici di causale di cambio stato)








Ws-Security:
- Username Token
- Firma Digitale


Risposta:



Campo
Tipo
Lung. min
Lung. max
Descrizione
Esito Richiesta
short


Codice univoco che descrive l'esito della richiesta
ID FSC
short


Identificativo univoco del FSC che sta effettuando la transazione
ID RETE
byte


Identificativo univoco della Rete di vendita del CN che sta effettuando la transazione (vedi tabella dei codici rete)
ID CN
long


Identificativo univoco del CN che sta effettuando la transazione
ID Transazione
long


Identificativo univoco della transazione (a livello di CN)
ID Ricevuta
String
0
25
Identificativo univoco della risposta attribuito dal sistema
Time Stamp
DataOra


Data e ora in cui il server ha processato la richiesta








Ws-Security:
- Firma Digitale


Codici di ritorno:
- 1024 - Esito ok
- 1025 - Operazione momentaneamente interdetta
- 1026 - Richiesta ancora in fase di elaborazione
- 1027 - ID Transazione relativo ad una richiesta già processata
- 1028 - Username Token non valido
- 1100 - Concessionario trasmittente non identificato
- 1101 - Concessionario titolare conto non identificato
- 1202 - Conto non esistente
- 1208 - Riapertura conto non consentita: conto aperto
- 1209 - Riapertura conto non consentita: conto chiuso
- 1210 - Riapertura conto non consentita: conto dormiente
- 1211 - Sospensione conto non consentita: conto sospeso
- 1212 - Sospensione conto non consentita: conto chiuso
- 1213 - Sospensione conto non consentita: conto dormiente
- 1214 - Chiusura conto non consentita: conto chiuso
- 1215 - Chiusura conto non consentita: conto dormiente
- 1234 - Causale cambio stato non valida
- 1029 - Errore generico.


4.6 Saldo conto di gioco


Descrizione:


Questo messaggio consente ad un CN di comunicare al SACG il saldo di un conto di gioco telematico.


Richiesta:



Campo
Tipo
Lung. min
Lung. max
Descrizione
ID FSC
short


Identificativo univoco del FSC che sta effettuando la transazione
ID RETE
byte


Identificativo univoco della Rete di vendita del CN che sta effettuando la transazione (vedi tabella dei codici rete)
ID CN
long


Identificativo univoco del CN che sta effettuando la transazione
ID Transazione
long


Identificativo univoco della transazione (a livello di CN)
ID RETE Conto
byte


Identificativo univoco della Rete di vendita del CN con il quale il cliente ha stipulato il Conto di Gioco (vedi tabella dei codici rete)
ID CN Conto
long


Identificativo univoco del CN con il quale il cliente ha stipulato il Conto di Gioco
Codice Conto
String
1
20
Codice del Conto di Gioco univoco per il CN
Importo Saldo
int


Saldo del Conto di Gioco comprensivo dei bonus esistenti sul Conto di Gioco (in centesimi di euro)
Data Ora Saldo
DataOra


Data e ora del Saldo
Importo Bonus Saldo
int


Quota parte del "Importo Saldo" relativa ai bonus esistenti sul Conto di Gioco (in centesimi di euro)
Numero Dettagli Bonus Saldo
byte


Numero di dettagli bonus saldo. Specifica quanti sono gli elementi "Dettaglio Bonus Saldo" seguenti
Dettaglio Bonus Saldo

Dettaglio
Bonus
Saldo
DettaglioBonus


Dettaglio del bonus relativo al saldo














Ws-Security:
- Username Token
- Firma Digitale


Risposta:



Campo
Tipo
Lung. min
Lung. max
Descrizione
Esito Richiesta
Short


Codice univoco che descrive l'esito della richiesta
ID FSC
Short


Identificativo univoco del FSC che sta effettuando la transazione
ID RETE
Byte


Identificativo univoco della Rete di vendita del CN che sta effettuando la transazione (vedi tabella dei codici rete)
ID CN
Long


Identificativo univoco del CN che sta effettuando la transazione
ID Transazione
Long


Identificativo univoco della transazione (a livello di CN)
ID Ricevuta
String
0
25
Identificativo univoco della risposta attribuito dal sistema
Time Stamp
DataOra


Data e ora in cui il server ha processato la richiesta








Ws-Security:
- Firma Digitale


Codici di ritorno:
- 1024 - Esito ok
- 1025 - Operazione momentaneamente interdetta
- 1026 - Richiesta ancora in fase di elaborazione
- 1027 - ID Transazione relativo ad una richiesta già processata
- 1028 - Username Token non valido
- 1100 - Concessionario trasmittente non identificato
- 1101 - Concessionario titolare conto non identificato
- 1202 - Conto non esistente
- 1205 - Saldo conto non consentito: conto dormiente
- 1217 - Importo saldo negativo
- 1218 - Importo bonus saldo negativo
- 1220 - Importo bonus saldo maggiore di importo saldo
- 1221 - Dettaglio bonus saldo non valido: tipo gioco inesistente
- 1222 - Dettaglio bonus saldo non valido: importo minore o uguale a zero
- 1223 - Dettaglio bonus saldo non valido: tipo gioco duplicato
- 1224 - Dettaglio bonus saldo non valido: somma importi diversa da importo bonus saldo
- 1029 - Errore generico.


4.7 Modifica provincia residenza conto di gioco


Descrizione:


Questo messaggio consente ad un CN di comunicare al SACG la modifica della provincia di residenza del titolare del conto di gioco telematico. Nel caso di conto di gioco appartenente ad una persona giuridica, permette di comunicare la modifica della provincia di sede.


Richiesta:



Campo
Tipo
Lung. min
Lung. max
Descrizione
ID FSC
short


Identificativo univoco del FSC che sta effettuando la transazione
ID RETE
byte


Identificativo univoco della Rete di vendita del CN che sta effettuando la transazione (vedi tabella dei codici rete)
ID CN
long


Identificativo univoco del CN che sta effettuando la transazione
ID Transazione
long


Identificativo univoco della transazione (a livello di CN)
ID RETE Conto
byte


Identificativo univoco della Rete di vendita del CN con il quale il cliente ha stipulato il Conto di Gioco (vedi tabella dei codici rete)
ID CN Conto
long


Identificativo univoco del CN con il quale il cliente ha stipulato il Conto di Gioco
Codice Conto
String
1
20
Codice del Conto di Gioco univoco per il CN
Provincia
String
2
2
Sigla della nuova provincia di residenza del Conto di Gioco








Ws-Security:
- Username Token
- Firma Digitale


Risposta:



Campo
Tipo
Lung. min
Lung. max
Descrizione
Esito Richiesta
short


Codice univoco che descrive l'esito della richiesta
ID FSC
short


Identificativo univoco del FSC che sta effettuando la transazione
ID RETE
byte


Identificativo univoco della Rete di vendita del CN che sta effettuando la transazione (vedi tabella dei codici rete)
ID CN
long


Identificativo univoco del CN che sta effettuando la transazione
ID Transazione
long


Identificativo univoco della transazione (a livello di CN)
ID Ricevuta
String
0
25
Identificativo univoco della risposta attribuito dal sistema
Time Stamp
DataOra


Data e ora in cui il server ha processato la richiesta








Ws-Security:
- Firma Digitale


Codici di ritorno:
- 1024 - Esito ok
- 1025 - Operazione momentaneamente interdetta
- 1026 - Richiesta ancora in fase di elaborazione
- 1027 - ID Transazione relativo ad una richiesta già processata
- 1028 - Username Token non valido
- 1100 - Concessionario trasmittente non identificato
- 1101 - Concessionario titolare conto non identificato
- 1202 - Conto non esistente
- 1206 - Modifica provincia residenza conto non consentita: conto chiuso
- 1207 - Modifica provincia residenza conto non consentita: conto dormiente
- 1232 - Provincia di residenza non valida
- 1029 - Errore generico.


4.8 Interrogazione stato conto di gioco


Descrizione:


Questo messaggio consente ad un CN di richiedere al SACG lo stato di un conto di gioco telematico.


Richiesta:



Campo
Tipo
Lung. min
Lung. max
Descrizione
ID FSC
short


Identificativo univoco del FSC che sta effettuando la transazione
ID RETE
byte


Identificativo univoco della Rete di vendita del CN che sta effettuando la transazione (vedi tabella dei codici rete)
ID CN
long


Identificativo univoco del CN che sta effettuando la transazione
ID Transazione
long


Identificativo univoco della transazione (a livello di CN)
ID RETE Conto
byte


Identificativo univoco della Rete di vendita del CN con il quale il cliente ha stipulato il Conto di Gioco (vedi tabella dei codici rete)
ID CN Conto
long


Identificativo univoco del CN con il quale il cliente ha stipulato il Conto di Gioco
Codice Conto
String
1
20
Codice del Conto di Gioco univoco per il CN








Ws-Security:
- Username Token
- Firma Digitale


Risposta:



Campo
Tipo
Lung. min
Lung. max
Descrizione
Esito Richiesta
Short


Codice univoco che descrive l'esito della richiesta
ID FSC
Short


Identificativo univoco del FSC che sta effettuando la transazione
ID RETE
Byte


Identificativo univoco della Rete di vendita del CN che sta effettuando la transazione (vedi tabella dei codici rete)
ID CN
Long


Identificativo univoco del CN che sta effettuando la transazione
ID Transazione
Long


Identificativo univoco della transazione (a livello di CN)
ID Ricevuta
String
0
25
Identificativo univoco della risposta attribuito dal sistema
Time Stamp
DataOra


Data e ora in cui il server ha processato la richiesta
ID RETE Conto
Byte


Identificativo univoco della Rete di vendita del CN con il quale il cliente ha stipulato il Conto di Gioco (vedi tabella dei codici rete)
ID CN Conto
Long


Identificativo univoco del CN con il quale il cliente ha stipulato il Conto di Gioco
Codice Conto
String
1
20
Codice del Conto di Gioco univoco per il CN
Stato
byte


Codice stato del Conto di Gioco (vedi tabella degli stati)
Causale
byte


Causale del cambio stato (zero non significativo, diverso da zero vedi tabella dei codici di causale di cambio stato)








Ws-Security:
- Firma Digitale


Codici di ritorno:
- 1024 - Esito ok
- 1025 - Operazione momentaneamente interdetta
- 1026 - Richiesta ancora in fase di elaborazione
- 1027 - ID Transazione relativo ad una richiesta già processata
- 1028 - Username Token non valido
- 1100 - Concessionario trasmittente non identificato
- 1101 - Concessionario titolare conto non identificato
- 1202 - Conto non esistente
- 1029 - Errore generico.


4.9 Subregistrazione


Descrizione:


Questo messaggio consente ad un CN di richiedere al SACG la subregistrazione di un conto di gioco telematico.


Richiesta:



Campo
Tipo
Lung. min
Lung. max
Descrizione
ID FSC
short


Identificativo univoco del FSC che sta effettuando la transazione
ID RETE
byte


Identificativo univoco della Rete di vendita del CN che sta effettuando la transazione (vedi tabella dei codici rete)
ID CN
long


Identificativo univoco del CN che sta effettuando la transazione
ID Transazione
long


Identificativo univoco della transazione (a livello di CN)
ID RETE Conto
byte


Identificativo univoco della Rete di vendita del CN con il quale il cliente ha stipulato il Conto di Gioco (vedi tabella dei codici rete)
ID CN Conto
long


Identificativo univoco del CN con il quale il cliente ha stipulato il Conto di Gioco
Codice Conto
String
1
20
Codice del Conto di Gioco univoco per il CN








Ws-Security:
- Username Token
- Firma Digitale


Risposta:



Campo
Tipo
Lung. min
Lung. max
Descrizione
Esito Richiesta
Short


Codice univoco che descrive l'esito della richiesta
ID FSC
Short


Identificativo univoco del FSC che sta effettuando la transazione
ID RETE
Byte


Identificativo univoco della Rete di vendita del CN che sta effettuando la transazione (vedi tabella dei codici rete)
ID CN
Long


Identificativo univoco del CN che sta effettuando la transazione
ID Transazione
Long


Identificativo univoco della transazione (a livello di CN)
ID Ricevuta
String
0
25
Identificativo univoco della risposta attribuito dal sistema
Time Stamp
DataOra


Data e ora in cui il server ha processato la richiesta
ID RETE Conto
byte


Identificativo univoco della Rete di vendita del CN con il quale il cliente ha stipulato il Conto di Gioco (vedi tabella dei codici rete)
ID CN Conto
long


Identificativo univoco del CN con il quale il cliente ha stipulato il Conto di Gioco
Codice Conto
String
1
20
Codice del Conto di Gioco univoco per il CN








Ws-Security:
- Firma Digitale


Codici di ritorno:
- 1024 - Esito ok
- 1025 - Operazione momentaneamente interdetta
- 1026 - Richiesta ancora in fase di elaborazione
- 1027 - ID Transazione relativo ad una richiesta già processata
- 1028 - Username Token non valido
- 1100 - Concessionario trasmittente non identificato
- 1101 - Concessionario titolare conto non identificato
- 1202 - Conto non esistente
- 1233 - Non autorizzato
- 1029 - Errore generico.


4.10 Migrazione conto di gioco


Descrizione:


Questo messaggio consente ad un CN di richiedere al SACG la migrazione di un conto di gioco telematico.


Richiesta:



Campo
Tipo
Lung. min
Lung. max
Descrizione
ID FSC
Short


Identificativo univoco del FSC che sta effettuando la transazione
ID RETE
Byte


Identificativo univoco della Rete di vendita del CN che sta effettuando la transazione (vedi tabella dei codici rete)
ID CN
Long


Identificativo univoco del CN che sta effettuando la transazione
ID Transazione
long


Identificativo univoco della transazione (a livello di CN)
ID RETE Conto
originario
byte


Identificativo univoco della Rete di vendita del CN con il quale il cliente ha stipulato il Conto di Gioco (vedi tabella dei codici rete)
ID CN Conto
originario
long


Identificativo univoco del CN con il quale il cliente ha stipulato il Conto di Gioco
Codice Conto originario
String
1
20
Codice del Conto di Gioco univoco per il CN
ID RETE Conto
destinazione
byte


Nuovo identificativo univoco della Rete di vendita del CN con il quale il cliente ha stipulato il Conto di Gioco
(vedi tabella dei codici rete)
ID CN Conto destinazione
long


Nuovo identificativo univoco del CN con il quale il cliente ha stipulato il Conto di Gioco
Codice Conto destinazione
String
1
20
Nuovo codice del Conto di Gioco univoco per il CN
Codice Fiscale
String
16
16
Codice Fiscale del titolare del Conto di Gioco originario
Importo Saldo
int


Saldo del Conto di Gioco comprensivo del movimento effettuato e dei bonus esistenti sul Conto di Gioco (in centesimi di euro)
Data Ora Saldo
DataOra


Data e ora del Saldo
Importo Bonus Saldo
int


Quota parte del "Importo Saldo" relativa ai bonus esistenti sul Conto di Gioco (in centesimi di euro)
Numero Dettagli Bonus Saldo
byte


Numero di dettagli bonus saldo. Specifica quanti sono gli elementi "Dettaglio Bonus Saldo" seguenti
Dettaglio Bonus Saldo

Dettaglio
Bonus
Saldo
DettaglioBonus


Dettaglio del bonus relativo al saldo














Ws-Security:
- Username Token
- Firma Digitale
- Cifratura


Risposta:



Campo
Tipo
Lung. min
Lung. max
Descrizione
Esito Richiesta
short


Codice univoco che descrive l'esito della richiesta
ID FSC
short


Identificativo univoco del FSC che sta effettuando la transazione
ID RETE
byte


Identificativo univoco della Rete di vendita del CN che sta effettuando la transazione (vedi tabella dei codici rete)
ID CN
long


Identificativo univoco del CN che sta effettuando la transazione
ID Transazione
long


Identificativo univoco della transazione (a livello di CN)
ID Ricevuta
String
0
25
Identificativo univoco della risposta attribuito dal sistema
Time Stamp
DataOra


Data e ora in cui il server ha processato la richiesta








Ws-Security:
- Firma Digitale


Codici di ritorno:
- 1024 - Esito ok
- 1025 - Operazione momentaneamente interdetta
- 1026 - Richiesta ancora in fase di elaborazione
- 1027 - ID Transazione relativo ad una richiesta già processata
- 1028 - Username Token non valido
- 1100 - Concessionario trasmittente non identificato
- 1103 - Rete conto originario appartenente alla rete concessioni GAD
- 1104 - Rete conto destinazione non appartenente alla rete concessioni GAD
- 1105 - Concessionario conto originario non identificato
- 1106 - Concessionario conto destinazione non identificato
- 1107 - Concessionari conto originario e destinazione non correlati
- 1217 - Importo saldo negativo
- 1218 - Importo bonus saldo negativo
- 1220 - Importo bonus saldo maggiore di importo saldo
- 1221 - Dettaglio bonus saldo non valido: tipo gioco inesistente
- 1222 - Dettaglio bonus saldo non valido: importo minore o uguale a zero
- 1223 - Dettaglio bonus saldo non valido: tipo gioco duplicato
- 1224 - Dettaglio bonus saldo non valido: somma importi diversa da importo bonus saldo
- 1262 - Conto di gioco originario non esistente
- 1263 - Migrazione conto non consentita: conto originario chiuso
- 1264 - Migrazione conto non consentita: conto originario dormiente
- 1265 - Codice fiscale non associato al conto di gioco originario
- 1266 - Conto di destinazione esistente
- 1267 - Il soggetto è già titolare di un conto presso il concessionario di destinazione
- 1029 - Errore generico
- 1269 - Conto di gioco originario diverso da quello di destinazione.


4.11 Aggiorna dati documento titolare conto di gioco


Descrizione:


Questo messaggio consente ad un CN di richiedere al SACG l'aggiornamento dei dati del documento di riconoscimento del titolare di un conto di gioco telematico.


Richiesta:



Campo
Tipo
Lung. min
Lung. max
Descrizione
ID FSC
short


Identificativo univoco del FSC che sta effettuando la transazione
ID RETE
byte


Identificativo univoco della Rete di vendita del CN che sta effettuando la transazione (vedi tabella dei codici rete)
ID CN
long


Identificativo univoco del CN che sta effettuando la transazione
ID Transazione
long


Identificativo univoco della transazione (a livello di CN)
ID RETE Conto
byte


Identificativo univoco della Rete di vendita del CN con il quale il cliente ha stipulato il Conto di Gioco (vedi tabella dei codici rete)
ID CN Conto
long


Identificativo univoco del CN con il quale il cliente ha stipulato il Conto di Gioco
Codice Conto
String
1
20
Codice del Conto di Gioco univoco per il CN
Documento
Documento


Documento del titolare del Conto di Gioco








Ws-Security:
- Username Token
- Firma Digitale


Risposta:



Campo
Tipo
Lung. min
Lung. max
Descrizione
Esito Richiesta
Short


Codice univoco che descrive l'esito della richiesta
ID FSC
Short


Identificativo univoco del FSC che sta effettuando la transazione
ID RETE
Byte


Identificativo univoco della Rete di vendita del CN che sta effettuando la transazione (vedi tabella dei codici rete)
ID CN
Long


Identificativo univoco del CN che sta effettuando la transazione
ID Transazione
Long


Identificativo univoco della transazione (a livello di CN)
ID Ricevuta
String
0
25
Identificativo univoco della risposta attribuito dal sistema
Time Stamp
DataOra


Data e ora in cui il server ha processato la richiesta








Ws-Security:
- Firma Digitale


Codici di ritorno:
- 1024 - Esito ok
- 1025 - Operazione momentaneamente interdetta
- 1026 - Richiesta ancora in fase di elaborazione
- 1027 - ID Transazione relativo ad una richiesta già processata
- 1028 - Username Token non valido
- 1100 - Concessionario trasmittente non identificato
- 1101 - Concessionario titolare conto non identificato
- 1202 - Conto non esistente
- 1260 - Aggiorna dati documento titolare conto non consentita: conto chiuso
- 1261 - Aggiorna dati documento titolare conto non consentita: conto dormiente
- 1029 - Errore generico.


4.12 Riepilogo operazioni movimentazione


Descrizione:


Questo messaggio consente ad un CN di richiedere al SACG il riepilogo delle operazioni di movimentazione effettuate in una determinata data.
Le operazioni di movimentazione sono: Ricarica, Storno Ricarica, Prelievo, Storno Prelievo, Bonus, Storno Bonus, Costi Servizi Aggiuntivi.


Richiesta:



Campo
Tipo
Lung. min
Lung. max
Descrizione
ID FSC
short


Identificativo univoco del FSC che sta effettuando la transazione
ID RETE
byte


Identificativo univoco della Rete di vendita del CN che sta effettuando la transazione (vedi tabella dei codici rete)
ID CN
long


Identificativo univoco del CN che sta effettuando la transazione
ID Transazione
long


Identificativo univoco della transazione (a livello di CN)
ID RETE Conto
byte


Identificativo univoco della Rete di vendita del CN con il quale il cliente ha stipulato il Conto di Gioco (vedi tabella dei codici rete)
ID CN Conto
long


Identificativo univoco del CN con il quale il cliente ha stipulato il Conto di Gioco
Data
Data


Data delle operazioni di movimentazione








Ws-Security:
- Username Token
- Firma Digitale


Risposta:



Campo
Tipo
Lung. min
Lung. max
Descrizione
Esito Richiesta
short


Codice univoco che descrive l'esito della richiesta
ID FSC
short


Identificativo univoco del FSC che sta effettuando la transazione
ID RETE
byte


Identificativo univoco della Rete di vendita del CN che sta effettuando la transazione (vedi tabella dei codici rete)
ID CN
long


Identificativo univoco del CN che sta effettuando la transazione
ID Transazione
long


Identificativo univoco della transazione (a livello di CN)
ID Ricevuta
String
0
25
Identificativo univoco della risposta attribuito dal sistema
Time Stamp
DataOra


Data e ora in cui il server ha processato la richiesta
ID RETE Conto
byte


Identificativo univoco della Rete di vendita del CN con il quale il cliente ha stipulato il Conto di Gioco (vedi tabella dei codici rete)
ID CN Conto
long


Identificativo univoco del CN con il quale il cliente ha stipulato il Conto di Gioco
Data
Data


Data delle operazioni di movimentazione
Numero Dettagli Operazioni Movimentazione
byte


Specifica quanti sono gli elementi "Dettaglio Operazioni Movimentazione" seguenti
Dettaglio Operazioni Movimentazione
Dettaglio Operazioni Movimentazione
Dettaglio Operazioni Movimentazione


Dettaglio Operazioni di Movimentazione della data richiesta










Ws-Security:
- Firma Digitale


Codici di ritorno:
- 1024 - Esito ok
- 1025 - Operazione momentaneamente interdetta
- 1026 - Richiesta ancora in fase di elaborazione
- 1027 - ID Transazione relativo ad una richiesta già processata
- 1028 - Username Token non valido
- 1100 - Concessionario trasmittente non identificato
- 1101 - Concessionario titolare conto non identificato
- 1108 - Rete titolare conto non appartenente alla rete concessioni GAD
- 1109 - Concessionario titolare conto non utilizza lo stesso FSC del Concessionario trasmittente
- 1268 - Dati non disponibili
- 1029 - Errore generico.


4.13 Riepilogo operazioni servizio


Descrizione:


Questo messaggio consente ad un CN di richiedere al SACG il riepilogo delle operazioni di servizio effettuate in una determinata data.
Le operazioni di servizio sono: Apertura Conto Persona Fisica, Apertura Conto Persona Giuridica, Cambio Stato Conto, Saldo Conto, Modifica Provincia Residenza, Interrogazione Stato Conto, Subregistrazione, Modifica Dati Documento Titolare Conto, Migrazione Conto Di Gioco.


Richiesta:



Campo
Tipo
Lung. min
Lung. max
Descrizione
ID FSC
short


Identificativo univoco del FSC che sta effettuando la transazione
ID RETE
byte


Identificativo univoco della Rete di vendita del CN che sta effettuando la transazione (vedi tabella dei codici rete)
ID CN
long


Identificativo univoco del CN che sta effettuando la transazione
ID Transazione
long


Identificativo univoco della transazione (a livello di CN)
ID RETE Conto
byte


Identificativo univoco della Rete di vendita del CN con il quale il cliente ha stipulato il Conto di Gioco (vedi tabella dei codici rete)
ID CN Conto
long


Identificativo univoco del CN con il quale il cliente ha stipulato il Conto di Gioco
Data
Data


Data delle operazioni di servizio








Ws-Security:
- Username Token
- Firma Digitale


Risposta:



Campo
Tipo
Lung. min
Lung. max
Descrizione
Esito Richiesta
short


Codice univoco che descrive l'esito della richiesta
ID FSC
short


Identificativo univoco del FSC che sta effettuando la transazione
ID RETE
byte


Identificativo univoco della Rete di vendita del CN che sta effettuando la transazione (vedi tabella dei codici rete)
ID CN
long


Identificativo univoco del CN che sta effettuando la transazione
ID Transazione
long


Identificativo univoco della transazione (a livello di CN)
ID Ricevuta
String
0
25
Identificativo univoco della risposta attribuito dal sistema
Time Stamp
DataOra


Data e ora in cui il server ha processato la richiesta
ID RETE Conto
byte


Identificativo univoco della Rete di vendita del CN con il quale il cliente ha stipulato il Conto di Gioco (vedi tabella dei codici rete)
ID CN Conto
long


Identificativo univoco del CN con il quale il cliente ha stipulato il Conto di Gioco
Data
Data


Data delle operazioni di servizio
Numero Dettagli Operazioni Servizio
byte


Specifica quanti sono gli elementi "Dettaglio Operazioni Servizio" seguenti
Dettaglio Operazioni Servizio

Dettaglio Operazioni Servizio
Dettaglio Operazioni Servizio


Dettaglio di Operazioni Servizio della data richiesta









Ws-Security:
- Firma Digitale


Codici di ritorno:
- 1024 - Esito ok
- 1025 - Operazione momentaneamente interdetta
- 1026 - Richiesta ancora in fase di elaborazione
- 1027 - ID Transazione relativo ad una richiesta già processata
- 1028 - Username Token non valido
- 1100 - Concessionario trasmittente non identificato
- 1101 - Concessionario titolare conto non identificato
- 1108 - Rete titolare conto non appartenente alla rete concessioni GAD
- 1109 - Concessionario titolare conto non utilizza lo stesso FSC del Concessionario trasmittente
- 1268 - Dati non disponibili
- 1029 - Errore generico.


4.14 Storno movimentazione conto di gioco


Descrizione:


Questo messaggio consente ad un CN di comunicare al SACG lo storno di una precedente movimentazione su un conto di gioco telematico.


Lo storno può essere di due tipi, cosi come specificato nel campo Tipo Storno:
1: Storno Normale, in questo caso il CN ha 7 giorni di tempo per inviare la transazione;
2: Storno da Charge Back, in questo caso il CN ha 90 giorni di tempo per inviare la transazione.


Richiesta:



Campo
Tipo
Lung. min
Lung. max
Descrizione
ID FSC
short


Identificativo univoco del FSC che sta effettuando la transazione
ID RETE
byte


Identificativo univoco della Rete di vendita del CN che sta effettuando la transazione (vedi tabella dei codici rete)
ID CN
long


Identificativo univoco del CN che sta effettuando la transazione
ID Transazione
long


Identificativo univoco della transazione (a livello di CN)
ID RETE Conto
byte


Identificativo univoco della Rete di vendita del CN con il quale il cliente ha stipulato il Conto di Gioco (vedi tabella dei codici rete)
ID CN Conto
long


Identificativo univoco del CN con il quale il cliente ha stipulato il Conto di Gioco
Codice Conto
String
1
20
Codice del Conto di Gioco univoco per il CN
ID Ricevuta Mov
String
0
25
Identificativo univoco della ricevuta della movimentazione che si intende stornare
Mezzo di Pagamento
byte


Codice del mezzo di pagamento utilizzato (vedi tabella dei codici dei mezzi di pagamento)
Causale Movimento
byte


Causale del movimento sul Conto Di Gioco (vedi tabella dei codici di causale di movimento). Può valere 2 (Storno Ricarica), 4 (Storno Prelievo) e 8 (Storno Costi Servizi Aggiuntivi)
Tipo Storno
byte


0: Storno Normale
1: Storno da Charge Back (solo per Causale Movimento 4, Storno Prelievo e 8, Storno Costi Servizi Aggiuntivi)
Importo Movimento
int


Importo del movimento sul Conto Di Gioco (in centesimi di euro). Deve essere uguale o inferiore all’importo della movimentazione che si intende stornare
Importo Saldo
int


Saldo del Conto di Gioco comprensivo del movimento effettuato e dei bonus esistenti sul Conto di Gioco (in centesimi di euro)
Data Ora Saldo
DataOra


Data e ora del Saldo
Importo Bonus Saldo
int


Quota parte del ‘Importo Saldò relativa ai bonus esistenti sul Conto di Gioco (in centesimi di euro)
Numero
byte


Numero di dettagli bonus
Dettagli Bonus Saldo



saldo. Specifica quanti sono gli elementi "Dettaglio Bonus Saldo" seguenti
Dettaglio Bonus Saldo
Dettaglio




Bonus
DettaglioBonus


Dettaglio del bonus relativo al saldo
Saldo











WS-SECURITY:
- Username Token
- Firma Digitale


Risposta:



Campo
Tipo
Lung. min
Lung. max
Descrizione
Esito Richiesta
short


Codice univoco che descrive l'esito della richiesta
ID FSC
short


Identificativo univoco del FSC che sta effettuando la transazione
ID RETE
byte


Identificativo univoco della Rete di vendita del CN che sta effettuando la transazione (vedi tabella dei codici rete)
ID CN
long


Identificativo univoco del CN che sta effettuando la transazione
ID Transazione
long


Identificativo univoco della transazione (a livello di CN)
ID Ricevuta
String
0
25
Identificativo univoco della risposta attribuito dal sistema
Time Stamp
DataOra


Data e ora in cui il server ha processato la richiesta








WS-Security:
- Firma Digitale


Codici di ritorno:
- 1024 - Esito ok
- 1025 - Operazione momentaneamente interdetta
- 1026 - Richiesta ancora in fase di elaborazione
- 1027 - ID Transazione relativo ad una richiesta già processata
- 1028 - Username Token non valido
- 1029 - Errore generico
- 1100 - Concessionario trasmittente non identificato
- 1101 - Concessionario titolare conto non identificato
- 1202 - Conto non esistente
- 1203 - Movimentazione conto non consentita: conto chiuso
- 1204 - Movimentazione conto non consentita: conto dormiente
- 1216 - Importo movimento minore o uguale a zero
- 1217 - Importo saldo negativo
- 1218 - Importo bonus saldo negativo
- 1219 - Somma di importo movimento e importo bonus saldo maggiore di importo saldo
- 1220 - Importo bonus saldo maggiore di importo saldo
- 1221 - Dettaglio bonus saldo non valido: tipo gioco inesistente
- 1222 - Dettaglio bonus saldo non valido: importo minore o uguale a zero
- 1223 - Dettaglio bonus saldo non valido: tipo gioco duplicato
- 1224 - Dettaglio bonus saldo non valido: somma importi diversa da importo bonus saldo
- 1235 - Storno movimento non possibile: movimento già stornato
- 1236 - ID Ricevuta Storno non presente o non congruente
- 1237 - Storno movimento non possibile: Conto di Gioco specificato diverso da quello del movimento
- 1238 - Storno movimento non possibile: importo specificato maggiore di quello del movimento
- 1239 - Storno movimento non possibile: superato il limite di tempo

5. Appendici
5.1 Tabella dei codici rete di vendita



Codice
Descrizione
Note
2
Giochi Pubblici Sport

3
Giochi Pubblici Ippica
Comprende: Bersani e D.L. n. 149/2008
7
Rinnovato Scommesse Ippiche
Comprende: Rinnovato Scommesse Ippiche e Ippodromi
8
Rinnovato Scommesse Sportive

12
Superenalotto

13
Bingo

14
Concessioni GAD

15
Concessione LIT
Lotterie Istantanee Telematiche






5.2 Tabella degli stati di un conto di gioco



Stato
Sigla
Descrizione
1
AP
Aperto
2
SP
Sospeso
3
CH
Chiuso
4
DO
Dormiente







5.3 Tabella dei codici di causale di cambio stato



Codice
Descrizione
1
Cambio stato richiesto da AAMS
2
Cambio stato richiesto dal Concessionario
3
Cambio stato richiesto dal Titolare del conto di gioco
4
Cambio stato richiesto dall'Autorità Giudiziaria
5
Cambio stato richiesto da AAMS per decesso del titolare





5.4 Tabella delle tipologie documento del titolare conto



Codice
Descrizione
1
Carta di identità
2
Patente di guida
3
Passaporto
4
Tessera personale di riconoscimento Mod. AT
5
Tessera personale di riconoscimento Mod. BT
6
Porto d'armi
10
Altro





5.5 Tabella dei codici di causale di movimento



Codice
Descrizione
Messaggio Abilitato
1
Ricarica
4.3
2
Storno Ricarica
4.14
3
Prelievo
4.3
4
Storno Prelievo
4.14
7
Costi Servizi Aggiuntivi
4.3
8
Storno Costi Servizi Aggiuntivi
4.14






5.6 Tabella dei codici di causale di movimento bonus



Codice
Descrizione
Messaggio Abilitato
5
Bonus
4.4
6
Storno Bonus
4.4






5.7 Tabella delle famiglie di gioco



Codice
Descrizione
0
Globale
1
Scommesse Sportive
2
Scommesse Ippiche in Agenzia
3
Scommesse Ippiche in Ricevitoria
4
Scommesse Sportive in Ricevitoria
5
Concorsi Pronostici
6
Giochi di Abilità
7
Giochi Numerici
8
Bingo
9
Lotto e Lotterie
10
Scommesse virtuali





5.8 Tabella dei tipi di gioco



Codice Famiglia
Codice Gioco
Descrizione
0
0
Tutti i Giochi di tutte le Famiglie [*]
1
0
Scommesse Sportive [**]
1
1
Scommesse Sportive a Quota Fissa
1
2
Scommesse Sportive a Quota Fissa con interazione diretta
2
0
Scommesse Ippiche in Agenzia [**]
2
1
Scommesse Ippiche in Agenzia al Totalizzatore
2
2
Scommesse Ippiche in Agenzia a Quota Fissa
2
3
Scommesse Ippiche in Agenzia Multipla a Riferimento
2
4
Scommesse Ippiche in Agenzia Multipla al Totalizzatore
3
0
Scommesse Ippiche in Ricevitoria [**]
3
1
Ippica Nazionale
3
2
Ippica Internazionale
3
3
V7
4
0
Scommesse Sportive in Ricevitoria [**]
4
1
Big Match
4
2
Big Race Auto/Moto
4
3
Big Race Bici
4
4
Big Race Sci
4
5
Big Race Atletica
5
0
Concorsi Pronostici [**]
5
1
Totocalcio
5
2
Totogol
6
0
Giochi di Abilità [**]
6
1
Giochi di Carte a Torneo
6
2
Giochi di Sorte a Quota Fissa
6
3
Giochi di Carte Organizzati in Forma Diversa dal Torneo
7
0
Giochi Numerici [**]
7
1
SuperEnalotto
7
2
Win 4 Life
7
3
Superstar
7
4
Win 4 Life GOLD
7
5
Si vince tutto
7
6
WFL Vivalitalia
7
7
WFL Grattacieli
7
8
WFL Cassaforte
7
9
Eurojackpot
7
10
WFL Classico
7
11
6 x 36
8
0
Bingo [**]
8
1
Bingo a distanza
9
0
Lotterie Telematiche [**]
9
1
Gratta e Vinci Online
9
2
Lotto Online
9
3
10 e LottoOnline
10
0
Scommesse Virtuali [**]
10
1
Scommesse Virtuali a Quota Fissa








- La coppia Codice Famiglia 0 (zero) e Codice Gioco 0 (zero) vale come wildcard ed indica, dove è applicabile, tutti i giochi di tutte le famiglie.
[**] Il Codice Gioco 0 (zero) di ciascuna famiglia vale come wildcard ed indica, dove è applicabile, tutti i giochi della famiglia.


5.9 Tabella dei mezzi di pagamento



Codice
Descrizione
2
Carta di Credito
3
Carta Prepagata
4
Bonifico Bancario/Postale
5
Bollettino Postale
6
Assegno di Conto Corrente
7
Assegno Circolare
8
Vaglia Postale
9
Ricarica Scratch
11
IMEL
12
Conto di Gioco
13
Conversione da Bonus
14
E-Wallet





5.10 Tabella dei codici di causale di operazioni di servizio



Codice
Descrizione
20
Apertura Conto Persona Fisica
21
Apertura Conto Persona giuridica
22
Cambio Stato Conto
23
Saldo Conto
24
Modifica Provincia Residenza
25
Interrogazione Stato Conto
26
Subregistrazione
27
Modifica Dati Documento Titolare Conto
28
Migrazione Conto Di Gioco





5.11 Tabella codici di ritorno



Esito
Descrizione
1024
Esito ok
1025
Operazione momentaneamente interdetta
1026
Richiesta ancora in fase di elaborazione
1027
ID Transazione relativo ad una richiesta già processata
1028
Username Token non valido
1029
Errore generico


1100
Concessionario trasmittente non identificato
1101
Concessionario titolare conto non identificato
1102
Concessionario titolare conto e Partita IVA non congruenti
1103
Rete conto originario appartenente alla rete concessioni GAD
1104
Rete conto destinazione non appartenente alla rete concessioni GAD
1105
Concessionario conto originario non identificato
1106
Concessionario conto destinazione non identificato
1107
Concessionari conto originario e destinazione non correlati
1108
Rete titolare conto non appartenente alla rete concessioni GAD
1109
Concessionario titolare conto non utilizza lo stesso FSC del Concessionario trasmittente


1200
Il soggetto è già titolare di un conto presso il concessionario
1201
Conto esistente
1202
Conto non esistente
1203
Movimentazione conto non consentita: conto chiuso
1204
Movimentazione conto non consentita: conto dormiente
1205
Saldo conto non consentito: conto dormiente
1206
Modifica provincia residenza conto non consentita: conto chiuso
1207
Modifica provincia residenza conto non consentita: conto dormiente
1208
Riapertura conto non consentita: conto aperto
1209
Riapertura conto non consentita: conto chiuso
1210
Riapertura conto non consentita: conto dormiente
1211
Sospensione conto non consentita: conto sospeso
1212
Sospensione conto non consentita: conto chiuso
1213
Sospensione conto non consentita: conto dormiente
1214
Chiusura conto non consentita: conto chiuso
1215
Chiusura conto non consentita: conto dormiente
1216
Importo movimento minore o uguale a zero
1217
Importo saldo negativo
1218
Importo bonus saldo negativo
1219
Somma di importo movimento e importo bonus saldo maggiore di importo saldo
1220
Importo bonus saldo maggiore di importo saldo
1221
Dettaglio bonus saldo non valido: tipo gioco inesistente
1222
Dettaglio bonus saldo non valido: importo minore o uguale a zero
1223
Dettaglio bonus saldo non valido: tipo gioco duplicato
1224
Dettaglio bonus saldo non valido: somma importi diversa da importo bonus saldo
1225
Importo bonus minore o uguale a zero
1226
Importo bonus saldo minore di importo bonus
1227
Dettaglio bonus non valido: tipo gioco inesistente
1228
Dettaglio bonus non valido: importo minore o uguale a zero
1229
Dettaglio bonus non valido: tipo gioco duplicato
1230
Dettaglio bonus non valido: somma importi diversa da importo bonus
1231
Dettaglio bonus non congruente con Dettaglio bonus saldo
1232
Provincia di residenza non valida
1233
Non autorizzato
1234
Causale cambio stato non valida
1235
Storno movimento non possibile: movimento già stornato
1236
ID Ricevuta Storno non presente o non congruente
1237
Storno movimento non possibile: Conto di gioco specificato diverso da quello del movimento
1238
Storno movimento non possibile: importo specificato maggiore di quello del movimento
1239
Storno movimento non possibile: superato il limite di tempo
1260
Aggiorna dati documento titolare conto non consentita: conto chiuso
1261
Aggiorna dati documento titolare conto non consentita: conto dormiente
1262
Conto di gioco originario non esistente
1263
Migrazione conto non consentita: conto originario chiuso
1264
Migrazione conto non consentita: conto originario dormiente
1265
Codice fiscale non associato al conto di gioco originario
1266
Conto di destinazione esistente
1267
Il soggetto è già titolare di un conto presso il concessionario di destinazione
1268
Dati non disponibili
1269
Conto di gioco originario diverso da quello di destinazione


1300
Persona fisica non identificata
1301
Persona fisica deceduta
1302
Persona fisica minorenne
1303
Dati anagrafici persona fisica non validi
1304
Codice fiscale persona fisica non valido





Nota 3 maggio 2013, n. 20822/Giochi/GAD/2013