Differenze tra le versioni di "Appendice A"

Da Libro Bianco OpenPass.
[versione verificata][versione di qualità]
(Modificata l'intestazione e rimossa sezione introduttiva)
(GETTICKET - Versione 2 attiva dalla stagione 2016/2017)
 
(18 versioni intermedie di 2 utenti non mostrate)
Riga 2: Riga 2:
  
 
=== LOGIN ===
 
=== LOGIN ===
Consente l’autenticazione di un utente che desidera collegarsi. Ad ogni stazione è associata una login specifica fornita da ANEF SKI Lombardia. L’autenticazione vale per tutta la durata della sessione di scambio dati.
+
Per una spiegazione più dettagliata vedi la pagina: [[Web_Service_-_Login|Web Service: Login]]
 
 
==== Parametri input ====
 
{| class="wikitable"
 
! Parametro !! Tipo !! Obbligatorio !! Descrizione
 
|-
 
| Username || testo || si || Username della stazione
 
|-
 
| Password || testo || si || Password della stazione
 
|}
 
==== Parametri output ====
 
{| class="wikitable"
 
! Parametro !! Tipo !! Descrizione
 
|-
 
| Group|| numerico || Codice univoco di identificazione del gruppo
 
|-
 
| Company|| numerico || Codice univoco di identificazione del gruppo
 
|}
 
  
 
=== REGISTERTOKEN ===
 
=== REGISTERTOKEN ===
Consente di registrare un token personalizzato. I tokens che cominciano con ‘Root.’ richiedono l’accesso di un amministratore. Ogni token ha un tipo associato (es. numerico, data, ora etc.). Il token non dipende dalla Stazione che ne fa richiesta.
+
Per una spiegazione più dettagliata vedi la pagina: [[Web_Service_-_RegisterToken|Web Service: RegisterToken]]
==== Parametri input ====
 
{| class="wikitable"
 
! Parametro !! Tipo !! Obbligatorio !! Descrizione
 
|-
 
| Name|| testo || si || Nome del token
 
|-
 
| Description || testo || si || Descrizione del significato di token
 
|-
 
| Type || numerico || si || Tipo assegnato (0=numerico, 1=data, 2=ora)
 
|}
 
==== Parametri output ====
 
{| class="wikitable"
 
! Parametro !! Tipo !! Descrizione
 
|-
 
| CreatedNew|| boolean|| Booleano che indica se il token è stato aggiunto
 
|}
 
  
 
=== REGISTERFORMAT ===
 
=== REGISTERFORMAT ===
Consente di registrare un formato di registrazione da utilizzare per la produzione e l’interpretazione di biglietti. Ritorna un codice identificativo univoco per il formato. La chiamata può essere effettuata tutte le volte che si vuole, il sistema ritornerà sempre lo stesso codice. Il codice di formato è quindi uguale per tute le stazioni che ne fanno richiesta. Lo stesso formato può essere condiviso tra più biglietti (es. Stagionale Adulti, Ridotto, FISI etc.).
+
Per una spiegazione più dettagliata vedi la pagina: [[Web_Service_-_RegisterFormat|Web Service: RegisterFormat]]
==== Parametri input ====
 
{| class="wikitable"
 
! Parametro !! Tipo !! Obbligatorio !! Descrizione
 
|-
 
| Description || testo || si || Descrizione del formato
 
|-
 
| Creator || testo || si || Nome del creatore del formato
 
|-
 
| Fixed area || oggetto || no || Oggetto contenente gli oggetti TokenAllocation della fixed area
 
|-
 
| Variable area || oggetto || no || Oggetto contenente gli oggetti TokenAllocation della variable area
 
|}
 
====== Oggetto Fixed area ======
 
{| class="wikitable"
 
! Parametro !! Tipo !! Obbligatorio !! Descrizione
 
|-
 
| TokenAllocation || oggetto || si || Oggetto contenente i valori dei Token
 
|}
 
====== Oggetto Variable area ======
 
{| class="wikitable"
 
! Parametro !! Tipo !! Obbligatorio !! Descrizione
 
|-
 
| TokenAllocation || oggetto || si || Oggetto contenente i valori dei Token
 
|}
 
====== Oggetto TokenAllocation ======
 
{| class="wikitable"
 
! Parametro !! Tipo !! Obbligatorio !! Descrizione
 
|-
 
| Name || testo || si || Nome del Token precedentemente salvato
 
|-
 
| BitAdress || numerico || no || BitAdreass
 
|-
 
| BitWidth || numerico || no || BitWidth
 
|-
 
| ConstantValue || numerico || no || ConstantValue
 
|}
 
  
==== Parametri output ====
 
{| class="wikitable"
 
! Parametro !! Tipo !! Descrizione
 
|-
 
| FormatIdentifier || numerico || Codice numerico univoco di identificazione del formato
 
|-
 
|}
 
 
=== ENUMERATEFORMATS ===
 
=== ENUMERATEFORMATS ===
Restituisce l'elenco esaustivo dei codici identificativi dei formati noti al server.
+
Per una spiegazione più dettagliata vedi la pagina: [[Web_Service_-_EnumerateFormats|Web Service: EnumerateFormats]]
==== Parametri input ====
+
 
Nessuno
 
==== Parametri output ====
 
{| class="wikitable"
 
! Parametro !! Tipo !! Descrizione
 
|-
 
| FormatIdentifiers || oggetto || Lista dei codici identificativi dei formati noti al server
 
|}
 
====== Oggetto FormatIdentifiers ======
 
{| class="wikitable"
 
! Parametro !! Tipo !! Descrizione
 
|-
 
| Int || numerico || Codice numerico univoco di identificazione dei formati noti al server
 
|}
 
 
=== GETFORMAT ===
 
=== GETFORMAT ===
Dato un codice identificativo di formato ottiene la definizione dello stesso
+
Per una spiegazione più dettagliata vedi la pagina: [[Web_Service_-_GetFormat|Web Service: GetFormat]]
==== Parametri input ====
+
 
{| class="wikitable"
 
! Parametro !! Tipo !! Obbligatorio !! Descrizione
 
|-
 
| FormatIdentifier || numerico || si || Codice numerico univoco di identificazione del formato
 
|}
 
==== Parametri output ====
 
{| class="wikitable"
 
! Parametro !! Tipo !! Descrizione
 
|-
 
| Identifier || numerico || Codice numerico univoco di identificazione del formato
 
|-
 
| Description || testo || Descrizione del formato
 
|-
 
| Creator || testo || Nome del creatore del formato
 
|-
 
| LastTouch || data || Data e ora di creazione
 
|-
 
| Fixed area || oggetto || Oggetto contenente gli oggetti token allocation della fixed area
 
|-
 
| Variable area || oggetto || Oggetto contenente gli oggetti toke allocation della variable area
 
|}
 
====== Oggetto Fixed area ======
 
{| class="wikitable"
 
! Parametro !! Tipo !! Descrizione
 
|-
 
| TokenAllocation || oggetto || Oggetto contenente i valori dei Token
 
|}
 
====== Oggetto Variable area ======
 
{| class="wikitable"
 
! Parametro !! Tipo !! Descrizione
 
|-
 
| TokenAllocation || oggetto || Oggetto contenente i valori dei Token
 
|}
 
====== Oggetto TokenAllocation  ======
 
{| class="wikitable"
 
! Parametro !! Tipo !! Descrizione
 
|-
 
| Name || testo || Nome del Token precedentemente salvato
 
|-
 
| BitAdress || numerico || BitAdress
 
|-
 
| BitWidth || numerico || BitWidth
 
|-
 
| ConstantValue || numerico || ConstantValue
 
|}
 
 
=== REGISTERTICKET ===
 
=== REGISTERTICKET ===
Consente di registrare un set di valori di tokens costanti per una certa categoria di biglietti al fine di poterla identificare con rapidità nelle elaborazioni dati. (Es. Stagionale adulti, Stagionale ridotto). Ritorna un codice identificativo univoco per il biglietto che è identico al valore passato per il token “TicketID” obbligatorio. La chiamata può essere effettuata tutte le volte che si vuole; a parità di valori il sistema ritornerà sempre lo stesso codice. La chiamata consente una registrazione diversa per ogni Stazione, ma il codice numerico ritornato sarà a parità di set di valori lo stesso su più stazioni. Due biglietti uguali non possono né devono avere codici identificativi differenti.
+
Per una spiegazione più dettagliata vedi la pagina: [[Web_Service_-_RegisterTicket|Web Service: RegisterTicket]]
==== Parametri input ====
+
 
{| class="wikitable"
+
=== REGISTERTICKET - Versione 2 attiva dalla stagione 2016-2017 ===
! Parametro !! Tipo !! Obbligatorio !! Descrizione
+
Per una spiegazione più dettagliata vedi la pagina: [[Web_Service_-_RegisterTicket_-_Versione_2|Web Service: RegisterTicket - Versione 2]]
|-
+
 
| Description || testo || si || Descrizione del ticket
 
|-
 
| CustomerAge || numerico || si || Classe di età del destinatario del biglietto (1=”Bambini <=11”, 2=”Ragazzi 12-17”, 3=”Adulti 18-64”, 4=”Senior >= 65”)
 
|-
 
| CustomerType || numerico || no || Tipologia del destinatario del biglietto (1=”Non Residenti”, 2=”Residenti”)
 
|-
 
| Values || oggetto || si || oggetto contenente i TokenValue
 
|}
 
====== Oggetto Values ======
 
{| class="wikitable"
 
! Parametro !! Tipo !! Obbligatorio !! Descrizione
 
|-
 
| TokenValue || oggetto || si || Oggetto che contiene i dati dei token
 
|}
 
====== Oggetto TokenValue ======
 
{| class="wikitable"
 
! Parametro !! Tipo !! Obbligatorio !! Descrizione
 
|-
 
| Name || testo || si || Nome del token. (Il Token “Root.TicketID” è obbligatorio)
 
|-
 
| Value || testo || si || Valore del token. (Il valore del Token “Root.TicketID” è obbligatorio)
 
|}
 
==== Parametri output ====
 
{| class="wikitable"
 
! Parametro !! Tipo !! Descrizione
 
|-
 
| TicketIdentifier || numerico || Codice numerico univoco di identificazione del biglietto. Il codice restituito sarà quello che viene passato con il Token “Root. TicketID”
 
|}
 
 
=== ENUMERATETICKETS ===
 
=== ENUMERATETICKETS ===
Ottieni l’elenco esaustivo dei codici identificativi dei biglietti noti al server per la stazione specificata.
+
Per una spiegazione più dettagliata vedi la pagina: [[Web_Service_-_EnumerateTickets|Web Service: EnumerateTickets]]
==== Parametri input ====
+
 
{| class="wikitable"
 
! Parametro !! Tipo !! Obbligatorio !! Descrizione
 
|-
 
| Company || numerico || si || Codice numerico univico di identificazione della stazione
 
|}
 
==== Parametri output ====
 
{| class="wikitable"
 
! Parametro !! Tipo !! Descrizione
 
|-
 
| TicketIdentifiers || oggetto || Lista dei codici identificativi dei ticket noti al server
 
|}
 
====== Oggetto TicketIdentifiers ======
 
{| class="wikitable"
 
! Parametro !! Tipo !! Descrizione
 
|-
 
| Int || numerico || Codice numerico univoco di identificazione dei ticket noti al server
 
|}
 
 
=== GETTICKET ===
 
=== GETTICKET ===
Dato un codice identificativo di biglietto, ottiene la definizione dello stesso
+
Per una spiegazione più dettagliata vedi la pagina: [[Web_Service_-_GetTicket|Web Service: GetTicket]]
==== Parametri input ====
+
 
{| class="wikitable"
+
=== GETTICKET - Versione 2 attiva dalla stagione 2016-2017 ===
! Parametro !! Tipo !! Obbligatorio !! Descrizione
+
Per una spiegazione più dettagliata vedi la pagina: [[Web_Service_-_GetTicket_-_Versione_2|Web Service: GetTicket - Versione 2]]
|-
+
 
| Company || numerico || si || Codice numerico univoco di identificazione della stazione
 
|-
 
| TicketIdentifier || numerico || si || Codice numerico univoco di identificazione del biglietto
 
|}
 
==== Parametri output ====
 
{| class="wikitable"
 
! Parametro !! Tipo !! Descrizione
 
|-
 
| Identifier || numerico || Codice numerico univoco di identificazione del biglietto
 
|-
 
| Description || testo || Descrizione del biglietto
 
|-
 
| CustomerAge || numerico || Classe di età del destinatario del biglietto (1=”Bambini <=11”, 2=”Ragazzi 12-17”, 3=”Adulti 18-64”, 4=”Senior >= 65”)
 
|-
 
| CustomerType || numerico || Tipologia del destinatario del biglietto (1=”Non Residenti”, 2=”Residenti”)
 
|-
 
| LastTouch || data || Data e ora di creazione
 
|-
 
| Values || oggetto || Oggetto contenente i TokenValue
 
|}
 
====== Oggetto Values ======
 
{| class="wikitable"
 
! Parametro !! Tipo !! Descrizione
 
|-
 
| TokenValue || oggetto || Oggetto che contiene i dati dei token
 
|}
 
====== Oggetto TokenValue ======
 
{| class="wikitable"
 
! Parametro !! Tipo !! Descrizione
 
|-
 
| Name || testo || Nome del token
 
|-
 
| Value || testo || Valore del token
 
|}
 
 
=== ENUMERATEGROUPS ===
 
=== ENUMERATEGROUPS ===
Ottieni l'elenco esaustivo dei codici identificativi dei gruppi noti al server.
+
Per una spiegazione più dettagliata vedi la pagina: [[Web_Service_-_EnumerateGroups|Web Service: EnumerateGroups]]
==== Parametri input ====
+
 
Nessuno
 
==== Parametri output ====
 
{| class="wikitable"
 
! Parametro !! Tipo !! Descrizione
 
|-
 
| GroupIdentifies || oggetto || Lista dei codici identificativi dei gruppi noti al server
 
|}
 
====== Oggetto GroupIdentifies ======
 
{| class="wikitable"
 
! Parametro !! Tipo !! Descrizione
 
|-
 
| Int || numerico || Codice numerico univoco di identificazione dei gruppi noti al server
 
|}
 
 
=== ENUMERATECOMPANIES ===
 
=== ENUMERATECOMPANIES ===
Ottieni l’elenco esaustivo delle stazioni note al server appartenenti al gruppo specificato.
+
Per una spiegazione più dettagliata vedi la pagina: [[Web_Service_-_EnumerateCompanies|Web Service: EnumerateCompanies]]
==== Parametri input ====
+
 
{| class="wikitable"
 
! Parametro !! Tipo !! Obbligatorio !! Descrizione
 
|-
 
| Group || numerico || si || Codice numerico univoco di identificazione del gruppo
 
|}
 
==== Parametri output ====
 
{| class="wikitable"
 
! Parametro !! Tipo !! Descrizione
 
|-
 
| Companies || oggetto || Lista dei codici identificativi delle stazioni appartenenti al gruppo
 
|}
 
====== Oggetto Companies ======
 
{| class="wikitable"
 
! Parametro !! Tipo !! Descrizione
 
|-
 
| Int || numerico || Codice numerico univoco di identificazione delle stazioni note al server
 
|}
 
 
=== ENUMERATEWORKSTATIONS ===
 
=== ENUMERATEWORKSTATIONS ===
Ottieni l’elenco esaustivo delle postazioni di vendita note al server appartenenti alla società specificata.
+
Per una spiegazione più dettagliata vedi la pagina: [[Web_Service_-_EnumerateWorkstations|Web Service: EnumerateWorkstations]]
==== Parametri input ====
+
 
{| class="wikitable"
 
! Parametro !! Tipo !! Obbligatorio !! Descrizione
 
|-
 
| Company || numerico || si || Codice numerico univoco di identificazione della stazione
 
|}
 
==== Parametri output ====
 
{| class="wikitable"
 
! Parametro !! Tipo !! Descrizione
 
|-
 
| Workstations || oggetto || Lista dei codici identificativi delle workstations appartenenti alla stazione
 
|}
 
====== Oggetto Workstation ======
 
{| class="wikitable"
 
! Parametro !! Tipo !! Descrizione
 
|-
 
| Int || numerico || Codice numerico univoco di identificazione delle workstations note al server
 
|}
 
 
=== REGISTERWORKSTATIONKEY ===
 
=== REGISTERWORKSTATIONKEY ===
Registra una chiave pubblica appartenente ad una postazione emittente
+
Per una spiegazione più dettagliata vedi la pagina: [[Web_Service_-_RegisterWorkstationKey|Web Service: RegisterWorkstationKey]]
==== Parametri input ====
+
 
{| class="wikitable"
 
! Parametro !! Tipo !! Obbligatorio !! Descrizione
 
|-
 
| Group || numerico || si || Codice numerico univoco di identificazione del group
 
|-
 
| Company || numerico || si || Codice numerico univoco di identificazione della stazione
 
|-
 
| Workstation || numerico || si || Codice numerico univoco di identificazione della workstation
 
|-
 
| KeyIdentifier || numerico || si || Codice di identificazione della chiave
 
|-
 
| Expiri || data || si || Data di fine validità della chiave
 
|-
 
| KeyLength || numerico || si || Lunghezza della chiave
 
|-
 
| Modulus || testo || si || Modulo della chiave
 
|-
 
| Exponent|| testo || si || Esponente della chiave
 
|}
 
==== Parametri output ====
 
{| class="wikitable"
 
! Parametro !! Tipo !! Descrizione
 
|-
 
| CreatedNew || boolean || Booleano che indica se la chiave è stata aggiunta
 
|}
 
 
=== ENUMERATEKEYS ===
 
=== ENUMERATEKEYS ===
Ottieni l’elenco esaustivo delle chiavi pubbliche della postazione emittente specificata
+
Per una spiegazione più dettagliata vedi la pagina: [[Web_Service_-_EnumerateKeys|Web Service: EnumerateKeys]]
==== Parametri input ====
+
 
{| class="wikitable"
 
! Parametro !! Tipo !! Obbligatorio !! Descrizione
 
|-
 
| Group || numerico || si || Codice numerico univoco di identificazione del gruppo
 
|-
 
| Workstation || numerico || si || Codice numerico univoco di identificazione della workstation
 
|}
 
==== Parametri output ====
 
{| class="wikitable"
 
! Parametro !! Tipo !! Descrizione
 
|-
 
| KeyIdentifiers || oggetto || Lista dei codici identificativi delle chiavi appartenenti alle workstation
 
|}
 
====== Oggetto KeyIdentifiers ======
 
{| class="wikitable"
 
! Parametro !! Tipo !! Descrizione
 
|-
 
| Int || numerico || Codice numerico univoco di identificazione delle chiavi
 
|}
 
 
=== GETKEY ===
 
=== GETKEY ===
Ottieni la chiave pubblica specificata
+
Per una spiegazione più dettagliata vedi la pagina: [[Web_Service_-_GetKey|Web Service: GetKey]]
==== Parametri input ====
+
 
{| class="wikitable"
 
! Parametro !! Tipo !! Obligatorio !! Descrizione
 
|-
 
| Group || numerico || si || Codice numerico univoco di identificazione del group
 
|-
 
| Workstation || numerico || si || Codice numerico univoco di identificazione della workstation
 
|-
 
| KeyIdentifier || numerico || si || Codice di identificazione della chiave richiesta
 
|}
 
==== Parametri output ====
 
{| class="wikitable"
 
! Parametro !! Tipo !! Descrizione
 
|-
 
| Group || numerico || Codice numerico univoco di identificazione del group
 
|-
 
| Company|| numerico || Codice numerico univoco di identificazione della stazione
 
|-
 
| Workstation || numerico || Codice numerico univoco di identificazione della workstation
 
|-
 
| KeyIdentifier || numerico || Codice di identificazione della chiave
 
|-
 
| Expiri || data || Data di fine validità della chiave
 
|-
 
| KeyLength || numerico || Lunghezza della chiave
 
|-
 
| Modulus || testo || Modulo della chiave
 
|-
 
| Exponent || testo || Esponente della chiave
 
|}
 
 
=== REGISTERCUSTOMER ===
 
=== REGISTERCUSTOMER ===
Permette la registrazione di un cliente sul sistema ottenendo un codice numerico identificativo
+
Per una spiegazione più dettagliata vedi la pagina: [[Web_Service_-_RegisterCustomer|Web Service: RegisterCustomer]]
==== Parametri input ====
+
 
{| class="wikitable"
+
=== REGISTERCUSTOMER - Versione 2 attiva dalla stagione 2016-2017 ===
! Paramentro !! Tipo !! Obbligatorio !! Descrizione
+
Per una spiegazione più dettagliata vedi la pagina: [[Web_Service_-_RegisterCustomer_-_Versione_2|Web Service: RegisterCustomer - Versione 2]]
|-
+
 
| Name || numerico || si || Nome del cliente
 
|-
 
| Name || numerico || si || Numero cliente attribuito localmente dalle casse emittenti
 
|-
 
| Name || numerico || no || CRSIdentifier
 
|-
 
| Name || testo || no || CRSData
 
|-
 
| Name || testo || no || Info1
 
|-
 
| Name || testo || no || Info2
 
|-
 
| Name || numerico || no || Codice Postale
 
|-
 
| Name || testo || no || Immagine
 
|-
 
| Name || data || no || Data di fine validità del record
 
|}
 
==== Parametri output ====
 
{| class="wikitable"
 
! Paramentro !! Tipo !! Descrizione
 
|-
 
| CustomerIdentifier || numerico || Codic enumerico univoco di identificazione del cliente identico al codice attribuito localmente dalle casse emittenti
 
|-
 
| CreatedNew || boolean || Booleano che indica se il nuovo cliente è stato aggiunto
 
|}
 
 
=== REGISTERSALES ===
 
=== REGISTERSALES ===
Registra un insieme di vendite di biglietti di consorzio in formato comune sul server per il gruppo, la società e le postazioni specificate. Ogni chiamata può contenere una o più registrazioni di vendita. Ogni vendita è associata ad un cliente, il cui codice identificativo va ottenuto con l'invocazione del servizio RegisterCustomer. Il CustomerIdentifier è a 0 per i biglietti non nominativi. All’interno di ogni vendita, unitamente al ticket identifier (che specifica i valori costanti), vengono specificati i valori rilevanti dei tokens ‘dinamici’, ovvero quelli assegnati al momento dell’edizione di un biglietto.
+
Per una spiegazione più dettagliata vedi la pagina: [[Web_Service_-_RegisterSales|Web Service: RegisterSales]]
==== Parametri input ====
+
 
{| class="wikitable"
 
! Parametro !! Tipo !! Obbligatorio !! Descrizione
 
|-
 
| Group || numerico || si || Codice numerico univoco di identificazione del gruppo
 
|-
 
| Company || numerico || si || Codice numerico di identificazione della stazione
 
|-
 
| Sales || oggetto || si || Oggetto che contiene i SaleTransaction
 
|}
 
====== Oggetto Sales ======
 
{| class="wikitable"
 
! Parametro !! Tipo !! Obbligatorio !! Descrizione
 
|-
 
| SaleTransaction || oggetto || si || Oggetto che contiene i dati delle vendite
 
|}
 
====== Oggetto SaleTransaction ======
 
{| class="wikitable"
 
! Paramentro !! Tipo !! Obbligatorio !! Descrizione
 
|-
 
| Workstation || numerico || si || Codice numerico univoco di identificazione della workstation
 
|-
 
| OperationType || numerico || si || Specifica il tipo di operazione (0=vendite, 1=annullamenti)
 
|-
 
| CreationTime || data || si || Data e ora di creazione e vendita del biglietto
 
|-
 
| Amount || numerico || si || Prezzo
 
|-
 
| CustomerIdentifier || numerico || si || Identificativo del cliente ottenuto registrando il cliente con il servizio RegisterCustomer (0 per biglietti non nominativi)
 
|-
 
| TicketIdentifier || numerico || si || Codice identificativo univoco del biglietto
 
|-
 
| ChipID || testo || no || ChipID dei dati di vendita
 
|-
 
| Values || oggetto || si || Oggetto che contiene i TokenValue
 
|}
 
====== Oggetto Values ======
 
{| class="wikitable"
 
! Paramentro !! Tipo !! Obbligatorio !! Descrizione
 
|-
 
| TokenValue || oggetto || si || Oggetto che contiene i dati dei token
 
|}
 
====== Oggetto TokenValue ======
 
{| class="wikitable"
 
! Parametro !! Tipo !! Obbligatorio !! Descrizione
 
|-
 
| Name || testo || si || Nome del token
 
|-
 
| Value || testo || si || Valore del token
 
|}
 
==== Parametri output ====
 
{| class="wikitable"
 
! Paramentro !! Tipo !! Descrizione
 
|-
 
| InsertedRecordsCount || numerico || Numero dei record effettivamente inseriti
 
|}
 
 
=== REGISTERPASSAGES ===
 
=== REGISTERPASSAGES ===
Registra un insieme di passaggi agli impianti di biglietti di consorzio in formato comune sul server per il gruppo, la società e gli impianti specificati. Ogni chiamata può contenere una o più registrazioni di passaggio. Ogni passaggio è opzionalmente associato ad un cliente, il cui codice identificativo va ottenuto con la RegisterCustomer. Ricordiamo che il CustomerIdentifier è a 0 per i biglietti non nominativi. All’interno di ogni passaggio, unitamente al ticket identifier (che specifica i valori costanti), vengono specificati i valori rilevanti dei tokens ‘dinamici’, ovvero quelli assegnati al momento dell’edizione di un biglietto e che si modificano durante l’utilizzo.
+
Per una spiegazione più dettagliata vedi la pagina: [[Web_Service_-_RegisterPassages|Web Service: RegisterPassages]]
==== Parametri input ====
+
 
{| class="wikitable"
 
! Parametro !! Tipo !! Obbligatorio !! Descrizione
 
|-
 
| Group || numerico || si || Codice numerico univoco di identificazione del gruppo
 
|-
 
| Company || numerico || si || Codice numerico univoco di identificazione del gruppo
 
|-
 
| Passages || oggetto || si || Oggetto che contiene i PassageTransaction
 
|}
 
====== Oggetto Passages ======
 
{| class="wikitable"
 
! Parametro !! Tipo !! Obbligatorio !! Descrizione
 
|-
 
| PassageTransaction || oggetto || si || Oggetto che contiene i dati dei passaggi
 
|}
 
====== Oggetto PassageTransaction ======
 
{| class="wikitable"
 
! Parametro !! Tipo !! Obbligatorio !! Descrizione
 
|-
 
| CustomerIdentifier || numerico || si || Identificativo del cliente ottenuto registrando il cliente con il servizio RegisterCustomer (0 per biglietti non nominativi)
 
|-
 
| TicketIdentifier || numerico || si || Codice identificativo del biglietto
 
|-
 
| LogTime || data || si || Data e ora del passaggio
 
|-
 
| CheckpointName || testo || si || Identificativo testuale univoco (case sensitive) dell’impianto di risalita all’interno della società specificata
 
|-
 
Values || oggetto || si || Oggetto che contiene i TokenValue
 
|}
 
====== Oggetto Values ======
 
{| class="wikitable"
 
! Parametro !! Tipo !! Obbligatorio !! Descrizione
 
|-
 
| TokenValue || oggetto || si || Oggetto che contiene i dati dei token
 
|}
 
====== Oggetto Token Value ======
 
{| class="wikitable"
 
! Parametro !! Tipo !! Obbligatorio !! Descrizione
 
|-
 
| Name || testo || si || Nome del token
 
|-
 
| Value || testo || si || Valore del token
 
|}
 
==== Parametri output ====
 
{| class="wikitable"
 
! Parametro !! Tipo !! Descrizione
 
|-
 
| InsertedRecordsCount || numerico || Numero dei record effettivamente inseriti
 
|}
 
 
=== SETDAILYFIRSTPASSAGESCOUNT ===
 
=== SETDAILYFIRSTPASSAGESCOUNT ===
Invia al server, ai fini statistici, il conteggio indistinto dei primi passaggi di tutti i biglietti di stazione e di consorzio e non obbligatoriamente il conteggio distinto dei primi passaggi categorizzati.
+
Per una spiegazione più dettagliata vedi la pagina: [[Web_Service_-_SetDailyFirstPassagesCount|Web Service: SetDailyFirstPassagesCount]]
==== Parametri input ====
+
 
{| class="wikitable"
 
! Parametro !! Tipo !! Obbligatorio !! Descrizione
 
|-
 
| Group || numerico || si || Codice numerico univoco di identificazione del gruppo
 
|-
 
| Company || numerico || si || Codice numerico univoco di identificazione della stazione
 
|-
 
| Values || oggetto || si || Oggetto che contiene i DailyFirstPassagesCount
 
|}
 
====== Oggetto Values ======
 
{| class="wikitable"
 
! Parametro !! Tipo !! Obbligatorio !! Descrizione
 
|-
 
| DailyFirstPassagesCount || oggetto || si || Oggetto che contiene i conteggi dei passaggi
 
|}
 
====== Oggetto DailyFirstPassagesCount ======
 
{| class="wikitable"
 
! Paramentro !! Tipo !! Obbligatorio !! Descrizione
 
|-
 
| Day || data || si || Data del giorno a cui si riferisce il conteggio dei passaggi
 
|-
 
| Count || numerico || si || Numero dei passaggi
 
|}
 
==== Parametri output ====
 
Nessun parametro.
 
 
=== ERRORI ===
 
=== ERRORI ===
{| class="wikitable"
+
Per una spiegazione più dettagliata vedi la pagina: [[Web_Service_-_Errori|Web Service: Errori]]
! Sigla !! Significato
+
 
|-
+
== Servizi del Formato 3 -  Estensione dei servizi per la vendita online ==
| 200 Bad credentials || Le credenziali fornite sono errate
+
 
|-
+
=== Authenticate ===
| 201 Must login first || Non è stato eseguito il login
+
Per una spiegazione più dettagliata vedi la pagina: [[Web_Service_-_Authenticate|Web Service: Authenticate]]
|-
+
 
| 202 Bad request  || Errore generico nella richiesta
+
=== RegisterWebSales ===
|-
+
Per una spiegazione più dettagliata vedi la pagina: [[Web_Service_-_RegisterWebSales|Web Service: RegisterWebSales]]
| 203 Unknown token || Un token menzionato nel formato non è conosciuto
+
 
|-
+
=== GenerateTicket ===
| 204 Unknown format || Il formato richiesto è sconosciuto
+
Per una spiegazione più dettagliata vedi la pagina: [[Web_Service_-_GenerateTicket|Web Service: GenerateTicket]]
|-
+
 
| 205 Unknown ticket || Il biglietto richiesto è sconosciuto
+
=== GetCustomerStatus ===
|-
+
Per una spiegazione più dettagliata vedi la pagina: [[Web_Service_-_GetCustomerStatus|Web Service: GetCustomerStatus]]
| 206 Unknown company || La società non è nell’elenco del server
+
 
|-
+
=== GetCustomersDomain ===
| 210 Unknown group || Il gruppo specificato non è noto al server
+
Per una spiegazione più dettagliata vedi la pagina: [[Web_Service_-_GetCustomersDomain|Web Service: GetCustomerDomain]]
|-
+
 
| 211 Unknown Company || La società specificata non è nota al server
+
=== GetCustomer ===
|-
+
Per una spiegazione più dettagliata vedi la pagina: [[Web_Service_-_GetCustomer|Web Service: GetCustomer]]
| 212 Unknown workstation || La postazione specificata non è nota al server
+
 
|-
+
=== GetWebSales ===
| 220 Unknown key || La chiave richiesta non è stata registrata
+
Per una spiegazione più dettagliata vedi la pagina: [[Web_Service_-_GetWebSales|Web Service: GetWebSales]]
|-
+
 
| 301 Root.TicketID can not be empty or text || Si è inviata la registrazione di un biglietto sprovvisto di numero di identificazione o con numero di identificazione non numerico
+
=== GetStatusSales ===
|-
+
Per una spiegazione più dettagliata vedi la pagina: [[Web_Service_-_GetStatusSales|Web Service: GetStatusSales]]
| 302 CustomerAge can not be empty || Si è inviata la registrazione di un biglietto sprovvisto di informazione relativa alla fascia di età, oppure con un codice relativo alla fascia di età errato
+
 
|}
+
=== SetDailyClosing ===
 +
Per una spiegazione più dettagliata vedi la pagina: [[Web_Service_-_SetDailyClosing|Web Service: SetDailyClosing]]
 +
 
 +
=== UpdateWebSalesAmmount ===
 +
Per una spiegazione più dettagliata vedi la pagina: [[Web_Service_-_UpdateWebSalesAmmount|Web Service: UpdateWebSalesAmmount]]
 +
 
 +
=== CreateDomain ===
 +
Per una spiegazione più dettagliata vedi la pagina: [[Web_Service_-_CreateDomain|Web Service: CreateDomain]]
 +
 
 +
=== RegisterDomain ===
 +
Per una spiegazione più dettagliata vedi la pagina: [[Web_Service_-_RegisterDomain|Web Service: RegisterDomain]]
 +
 
 +
=== GetDomainList ===
 +
Per una spiegazione più dettagliata vedi la pagina: [[Web_Service_-_GetDomainList|Web Service: GetDomainList]]
 +
 
 +
=== GetPassages ===
 +
Per una spiegazione più dettagliata vedi la pagina: [[Web_Service_-_GetPassages|Web Service: GetPassages]]
 +
 
 +
=== Errori ===
 +
Per una spiegazione più dettagliata vedi la pagina: [[Web Service: Errori dei servizi per la vendita online]]

Versione attuale delle 14:28, 14 ott 2016

Servizi del Formato 3

LOGIN

Per una spiegazione più dettagliata vedi la pagina: Web Service: Login

REGISTERTOKEN

Per una spiegazione più dettagliata vedi la pagina: Web Service: RegisterToken

REGISTERFORMAT

Per una spiegazione più dettagliata vedi la pagina: Web Service: RegisterFormat

ENUMERATEFORMATS

Per una spiegazione più dettagliata vedi la pagina: Web Service: EnumerateFormats

GETFORMAT

Per una spiegazione più dettagliata vedi la pagina: Web Service: GetFormat

REGISTERTICKET

Per una spiegazione più dettagliata vedi la pagina: Web Service: RegisterTicket

REGISTERTICKET - Versione 2 attiva dalla stagione 2016-2017

Per una spiegazione più dettagliata vedi la pagina: Web Service: RegisterTicket - Versione 2

ENUMERATETICKETS

Per una spiegazione più dettagliata vedi la pagina: Web Service: EnumerateTickets

GETTICKET

Per una spiegazione più dettagliata vedi la pagina: Web Service: GetTicket

GETTICKET - Versione 2 attiva dalla stagione 2016-2017

Per una spiegazione più dettagliata vedi la pagina: Web Service: GetTicket - Versione 2

ENUMERATEGROUPS

Per una spiegazione più dettagliata vedi la pagina: Web Service: EnumerateGroups

ENUMERATECOMPANIES

Per una spiegazione più dettagliata vedi la pagina: Web Service: EnumerateCompanies

ENUMERATEWORKSTATIONS

Per una spiegazione più dettagliata vedi la pagina: Web Service: EnumerateWorkstations

REGISTERWORKSTATIONKEY

Per una spiegazione più dettagliata vedi la pagina: Web Service: RegisterWorkstationKey

ENUMERATEKEYS

Per una spiegazione più dettagliata vedi la pagina: Web Service: EnumerateKeys

GETKEY

Per una spiegazione più dettagliata vedi la pagina: Web Service: GetKey

REGISTERCUSTOMER

Per una spiegazione più dettagliata vedi la pagina: Web Service: RegisterCustomer

REGISTERCUSTOMER - Versione 2 attiva dalla stagione 2016-2017

Per una spiegazione più dettagliata vedi la pagina: Web Service: RegisterCustomer - Versione 2

REGISTERSALES

Per una spiegazione più dettagliata vedi la pagina: Web Service: RegisterSales

REGISTERPASSAGES

Per una spiegazione più dettagliata vedi la pagina: Web Service: RegisterPassages

SETDAILYFIRSTPASSAGESCOUNT

Per una spiegazione più dettagliata vedi la pagina: Web Service: SetDailyFirstPassagesCount

ERRORI

Per una spiegazione più dettagliata vedi la pagina: Web Service: Errori

Servizi del Formato 3 - Estensione dei servizi per la vendita online

Authenticate

Per una spiegazione più dettagliata vedi la pagina: Web Service: Authenticate

RegisterWebSales

Per una spiegazione più dettagliata vedi la pagina: Web Service: RegisterWebSales

GenerateTicket

Per una spiegazione più dettagliata vedi la pagina: Web Service: GenerateTicket

GetCustomerStatus

Per una spiegazione più dettagliata vedi la pagina: Web Service: GetCustomerStatus

GetCustomersDomain

Per una spiegazione più dettagliata vedi la pagina: Web Service: GetCustomerDomain

GetCustomer

Per una spiegazione più dettagliata vedi la pagina: Web Service: GetCustomer

GetWebSales

Per una spiegazione più dettagliata vedi la pagina: Web Service: GetWebSales

GetStatusSales

Per una spiegazione più dettagliata vedi la pagina: Web Service: GetStatusSales

SetDailyClosing

Per una spiegazione più dettagliata vedi la pagina: Web Service: SetDailyClosing

UpdateWebSalesAmmount

Per una spiegazione più dettagliata vedi la pagina: Web Service: UpdateWebSalesAmmount

CreateDomain

Per una spiegazione più dettagliata vedi la pagina: Web Service: CreateDomain

RegisterDomain

Per una spiegazione più dettagliata vedi la pagina: Web Service: RegisterDomain

GetDomainList

Per una spiegazione più dettagliata vedi la pagina: Web Service: GetDomainList

GetPassages

Per una spiegazione più dettagliata vedi la pagina: Web Service: GetPassages

Errori

Per una spiegazione più dettagliata vedi la pagina: Web Service: Errori dei servizi per la vendita online