Visualizza wikitesto di Vendita e ricarica online del titolo di viaggio

__TOC__
L’attuale '''sistema OpenPass''' è stato predisposto per gestire ricarica e vendita online dei titoli di viaggio, per far questo è necessario:
* '''Modificare i servizi Web'''  esistenti del server OpenPass:
** RegisterTicket
** GetTicket
** RegisterCustomer
* '''Implementare nuovi servizi Web''' del server OpenPass:
** RegisterWebSales
** UpdateWebSalesAmmount
** GenerateTicket
** GetWebSales
** GetPassages
** SetDailyClosing
** GetStatusSales
** GetCustomer
** Getcustomerstatus
** Getcustomerdomain
** CreateDomain
** RegisterDomain
** GetDomainList

È stato introdotto il concetto di '''WebCompany''': azienda accreditata OpenPass che fornirà servizio di vendita per le stazioni (company).

È stato introdotto il concetto di '''WebShop''': portale specifico di vendita dei titoli OpenPass per una determinata Company. Una WebCompany può avere uno o più WebShop. Ogni WebShop è legato univocamente alla propria company (stazione). Nel caso di WebShop di comprensorio, una stazione (company) dovrà farsi carico di gestire il WebShop a cui è collegato il comprensorio.

I WebShop inviano al server le transazioni di vendita, che possono avere tre tipi di stato:
* pay per use; (stazione) - Prezzo standard.
* ricarica
* ritiro presso biglietteria di nuova tessera.

Ogni transazione di vendita verrà identificata univocamente attraverso l’identificativo incrementale della tabella delle transazioni chiamato '''''<span style="color: blue">RegisterWebSaleID</span>''''' generato dal server OpenPass.

Più transazioni di vendita possono essere raggruppate da un univo '''''<span style="color: blue">OrderNumber</span>''''' fornito dal WebShop in fase di invio di transazioni.

Ogni transazione di vendita inviata al Server OpenPass da parte del WebShop sarà composta da:
* <span style="color: blue">Identificativo di transazione '''''RegisterWebSaleID'''''</span> (seriale assegnato dal server OpenPass e chiave univoca della transazione di vendita);
* <span style="color: blue">Identificativo di ordine '''''OrderNumber''''</span> (identificativo gestito dal WebShop);
* '''DomainID''' (Identificativo del Dominio a cui è destinata la transazione di vendita);
* '''WebShopID''' (Identificativo del WebShop che ha generato la vendita);
* '''OpenPassUID''' (OpenPass UID della tessera da ricarica, valorizzato a NULL in caso di ritiro presso la biglietteria);
* '''TicketID''' (identificativo della tipologia di biglietto venduto, recuperata dal server OpenPass attraverso il servizio GetTicket);
* '''DataInizioValidità''' (data e orario di inizio validità del biglietto venduto);
* '''CustomerIdentifier''' (identificativo del soggetto a cui è stato venduto il biglietto, recuperato dal server OpenPass attraveso il servizio GetCustomer);
* '''Info''' (informazione aggiuntiva codificata in base64 gestita tra WebShop e Company);
* '''TipoTransazione''' (0=ritiro, 1=ricarica, 2=registrare rata di denaro, 3=storno), 
* '''payperuse''' (0=no pay per use; 1=si pay per use)
* '''Insurance Assicurazione''' (0=no; 1=si)
* '''amount''' (valori in € della transazione di vendita)
* '''RecordOpenPass''' (settore del biglietto firmato alla fonde dal server OpenPass che avrà la sua chiave)
* '''Root.Group''' (Gruppo di appartenenza del server OpenPass)
* '''Root.Workstation''' (Identificativo dell’emettitrice legata al server OpenPass)
* '''Root.SerialNumberEx2''' (numero seriale del biglietto generato dall’emettitrice legata al server OpenPass)

Ogni transazione di vendita viene scaricata dalla stazione (dominio) a cui è destinata e una volta effettuata la ricarica/consegna della tessera.

I gestori dei sistemi di accesso hanno la possibilità di:
* caricare il settore firmato dal server OpenPass;
* generare il settore con i dati della transazione di vendita con una propria Workstation.

In entrambi i casi, la stazione deve comunicare l’avvenuta generazione del biglietto sul supporto inviando i dati al server OpenPass attraverso il servizio sotto illustrato GenerateTicket. Il server OpenPass deve conoscere gli identificativi per rintracciare i passaggi del biglietto nel sistema OpenPass. Gli identificati sono costituiti dalla copia di valori:
* '''Root.Workstation''' (numero identificativo della emittente Workstation nel sistema OpenPass);
* '''Root.SerialNumberEx2''' (numero seriale interno alla emittente Workstation),
generati dalla workstation del server oppure dalla workstation della stazione.

== Vendita e ricarca online delle tessere in formato OpenPass ==
Per permettere la gestione particolareggiata dei Ticket verrà inserito un TAG aggiuntivo '''<info></info>''' nel servizio '''RegisterTicket''', con contenuto serializzato (base64), utilizzabile dal produttore a piacere (Company di vendita). Questo campo conterrà informazioni utili al produttore dei sistemi di accesso e al fornitore del negozio internet (WebShop).

Verrà creato un nuovo servizio '''RegisterWebSales''' per inviare le transazioni di vendita effettuate dal un WebShop. Ogni transazione di vendita verrà identificata univocamente dal proprio seriale di vendita RegisterWebSaleID fornito dal server OpenPass.

Verrà creato un nuovo servizio '''UpdateWebSales''' per aggiornare le vendite Web con il quantitativo economico derivato dal calcolo dell'uso.

Verrà creato un nuovo servizio '''GetWebSales''' con cui i fornitori dei sistemi di accesso potranno scaricare dal server OpenPass tutte le vendite Web effettuate per ogni dominio.

Verrà creato un nuovo servizio '''GenerateTicket''' con cui i fornitori dei sistemi di accesso potranno inviare al Server OpenPass la '''Root.Workstation''' e '''Root.SerialNumberEx2''' con cui è stato generato il biglietto per ogni specifica transazione di vendita identificata con RegisterWebSaleID.
Verrà creato un nuovo servizio '''GetPassages''' per recuperare tutti i passaggi effettuati da una tessera ricaricata a seguito di una vendita online identificata con RegisterWebSaleID.

Verrà creato un nuovo servizio '''SetDailyClosing''' per inviare al server OpenPass lo stato di chiusura di una stazione indicante che tutti i passaggi sono stati inviati al server. Tale informazione sarà utile al fornitore di WebShop in quanto potrà da quel momento calcolare gli usi delle tessere ricaricate.

Gli step per giungere alla ricarica dei titoli di viaggio attraverso internet prevedono i seguenti passi:
=== (STEP 1) - Codifica Ticket ===
Le stazioni (Company) inviano al Server OpenPass i biglietti (ticket) vendibili attraverso il servizio già attivo ('''RegisterTicket''') che verrà esteso con il '''tag aggiuntivo <info>'''

{| class="wikitable"
|- 
| bgcolor="Gray" | <span style="color: white">Nome servizio</span> || '''RegisterTicket'''
|- 
| bgcolor="Gray" | <span style="color: white">Servizio utilizzato da</span> || Fornitori dei sistemi di accesso per ogni company
|}

==== Parametri in ingresso ====
{| class="wikitable"
|- 
| colspan="4" bgcolor="LightGrey" style="text-align: center" | <span style="color: white;">Oggetto: RegisterTicket</span>
|- bgcolor="LightGrey" style="text-align: center" 
| <span style="color: white;">Parametro</span> || <span style="color: white;">Tipo</span> || <span style="color: white;">Obbligatorio</span> || <span style="color: white">Descrizione</span>
|-
| Description || text || Si || Descrizione del ticket
|-
| CustomerAge || integer || Si || Classe di età del destinatario del biglietto (1=”Bambini <=11”, 2=”Ragazzi 12-17”, 3=”Adulti 18-64”, 4=”Senior >= 65”)
|-
| CustomerType || integer || No || Tipologia del destinatario del biglietto (1="Non residenti", 2="Residenti")
|-
| Info || text || No || Informazione aggiuntiva codificata in Base64 gestita tra WebShop e Company
|-
| Values || OBJ || Si || Oggetto contenente i TokenValue
|}

{| class="wikitable"
|-
| colspan="4" bgcolor="LightGrey" style="text-align: center" | <span style="color: white;">Oggetto: Values</span>
|- bgcolor="LightGrey" style="text-align: center"
| <span style="color: white;">Parametro</span> || <span style="color: white;">Tipo</span> || <span style="color: white;">Obbligatorio</span> || <span style="color: white">Descrizione</span>
|-
| TokenValue || OBJ || Si || Oggetto che contiene i dati dei token
|}

{| class="wikitable"
|-
| colspan="4" bgcolor="LightGrey" style="text-align: center" | <span style="color: white;">Oggetto: TokenValue</span>
|- bgcolor="LightGrey" style="text-align: center"
| <span style="color: white;">Parametro</span> || <span style="color: white;">Tipo</span> || <span style="color: white;">Obbligatorio</span> || <span style="color: white">Descrizione</span>
|-
| Name || text || Si || Nome del token. (Il Token “Root.TicketID” è obbligatorio)
|-
| Value || text || Si || Valore del token. (Il Token “Root.TicketID” è obbligatorio)
|}

==== Parametri in uscita ====
{| class="wikitable"
|-
| colspan="4" bgcolor="SeaGreen" style="text-align: center" | <span style="color: white;">Oggetto: RegisterTicketResult</span>
|- bgcolor="SeaGreen" style="text-align: center"
| <span style="color: white;">Parametro</span> || <span style="color: white;">Tipo</span> || <span style="color: white">Descrizione</span>
|-
| TicketIdentifier || integer || Codice numerico univoco di identificazione del biglietto. Il codice restituito sarà quello che viene passato con il Token “Root.TicketID”
|}

=== (STEP 2) - Lettura Ticket ===
Le WebCompany fornitori di Webshop leggono i biglietti (ticket) dal Server OpenPass con il servizio esistente '''GetTicket''' che verrà ampliato con l'informazione del '''tag aggiuntivo <info>'''

{| class="wikitable"
|- 
| bgcolor="Gray" | <span style="color: white">Nome servizio</span> || '''GetTicket'''
|- 
| bgcolor="Gray" | <span style="color: white">Servizio utilizzato da</span> || WebCompany
|}

==== Parametri in ingresso ====
{| class="wikitable"
|- 
| colspan="4" bgcolor="LightGrey" style="text-align: center" | <span style="color: white;">Oggetto: GetTicket</span>
|- bgcolor="LightGrey" style="text-align: center" 
| <span style="color: white;">Parametro</span> || <span style="color: white;">Tipo</span> || <span style="color: white;">Obbligatorio</span> || <span style="color: white">Descrizione</span>
|-
| TicketIdentifier || integer || Si || Codice numerico univoco di identificazione del biglietto
|-
| Company || integer || Si || Codice numerico univoco identificativo della stazione
|}

==== Parametri in uscita ====
{| class="wikitable"
|-
| colspan="4" bgcolor="SeaGreen" style="text-align: center" | <span style="color: white;">Oggetto: GetTicket</span>
|- bgcolor="SeaGreen" style="text-align: center"
| <span style="color: white;">Parametro</span> || <span style="color: white;">Tipo</span> || <span style="color: white">Descrizione</span>
|-
| Identifier || integer || Codice numerico univoco di identificazione del biglietto
|-
| Description || text || Descrizione del biglietto
|-
| CustomerAge || integer || Classe di età del destinatario del biglietto (1=”Bambini <=11”, 2=”Ragazzi 12-17”, 3=”Adulti 18-64”, 4=”Senior >=65”)
|-
| CustomerType || integer || Tipologia del destinatario del biglietto (1="Non residenti", 2="Residenti")
|-
| LastTouch || dateTime || Data e ora di creazione
|-
| Info || text || Informazione aggiuntiva codificata in Base64 gestita tra WebShop e Company
|-
| Values || OBJ || Oggetto contenente i TokenValue
|}

{| class="wikitable"
|-
| colspan="4" bgcolor="SeaGreen" style="text-align: center" | <span style="color: white;">Oggetto: GetTicket</span>
|- bgcolor="SeaGreen" style="text-align: center"
| <span style="color: white;">Parametro</span> || <span style="color: white;">Tipo</span> || <span style="color: white">Descrizione</span>
|-
| TokenValue || OBJ || Oggetto che contiene i dati dei token
|}

{| class="wikitable"
|-
| colspan="4" bgcolor="SeaGreen" style="text-align: center" | <span style="color: white;">Oggetto: GetTicket</span>
|- bgcolor="SeaGreen" style="text-align: center"
| <span style="color: white;">Parametro</span> || <span style="color: white;">Tipo</span> || <span style="color: white">Descrizione</span>
|-
| Name || text || Nome del token
|-
| Value || text || Valore del token
|}

=== (STEP 3) - Codifica Customer ===
* Codice numerico univoco di identificazione del customer [*]
* Dominio di ultima vendita (ricavato dal server) [*]
* openpassuid
* nome del customer [*]
* cognome del custorm [*]
* titolo del customer
* data di nascita del customer [*]
* sesso del customer
* codice fiscale del customer
* lavoro del customer
* email del customer
* Sociale del customer
* Cellulare del customer
* Telefono fisso del customer
* indirizzo del customer
* C.A.P. del customer
* Città del customer
* Provincia del customer
* Nazione del customer
* Note
* Consenso per la divulgazione dei dati personali verso terzi
* Fotografia (limitare dimensioni 100k e rapporto immagine definito (360x480) 50k
* Data ripresa foto
* Data e ora di fine validità dei dati relativi al customer
* <span style="color: blue">LogTime</span>: data o ora di inserimento all’interno del database OpenPass

Il server OpenPass registrerà la data e l’ora corrente al momento della registrazione dei dati del customer all’interno del database ('''LogTime''').

Prima di inviare i dati del customer il WebShop potrà verificare la base dati sul serve rOpenPass per ereditare i dati aggiornati del customer attraverso i servizi '''GetCustomersStatus''', '''GetCustomersDomain''', '''GetCustomer'''
* '''GetCustomersStatus''': è il servizio Web che restituisce l’ultima data di aggiornamento dei customers collegati ad un determinato dominio.
* '''GetCustomersDomain''': è il servizio Web che restituisce i dati di tutti i customers aggiornati da una certa data in poi <u>e che hanno acquistato almeno una volta un ticket in un determinato domain</u>
* '''GetCustomer''': è il servizio Web che restituisce tutti i dati del customer relativi ad uno specifico CustomerIdentifier

{| class="wikitable"
|- 
| bgcolor="Gray" | <span style="color: white">Nome servizio</span> || '''RegisterCustomer'''
|- 
| bgcolor="Gray" | <span style="color: white">Servizio utilizzato da</span> || Fornitori dei sistemi di accesso per ogni company, WebCompany
|}

==== Parametri in ingresso ====
{| class="wikitable"
|- 
| colspan="4" bgcolor="LightGrey" style="text-align: center" | <span style="color: white;">Oggetto: RegisterTicket</span>
|- bgcolor="LightGrey" style="text-align: center" 
| <span style="color: white;">Parametro</span> || <span style="color: white;">Tipo</span> || <span style="color: white;">Obbligatorio</span> || <span style="color: white">Descrizione</span>
|-
| CustomerIdentifier || integer || Si || Codice numerico univoco di identificazione del customer
|-
| Domain || integer || Si || Codice numerico univoco di identificazione del dominio
|-
| OpenPassUID || text || No || Codice identificativo univoco della tessera RFID come definito dalle specifiche del formato OpenPass
|-
| Name || text || Si || Nome del customer
|-
| Surname || text || Si || Cognome del customer
|-
| BirthDate || date || Si || Data di nascita del customer
|-
| Sex || text || No || Sesso del customer
|-
| CFCode || text || No || Codice fiscale del customer
|-
| Job || text || No || Occupazione del customer
|-
| Email || text || No || Indirizzo email del customer
|-
| Social || text || No || Sociale del customer
|-
| Cellular || text || No || Numero di cellulare del customer
|-
| Phone || text || No || Numero di telefono del customer
|-
| Adress || text || No || Indirizzo del customer
|-
| PostCode || text || No || CAP del customer
|-
| City || text || No || Città del customer
|-
| State || text || No || Provincia del customer
|-
| Country || text || No || Nazione del customer
|-
| Note || text || No || Note
|-
| Privacy || boolean || No || Booleano che indica se è stato compilato il modulo per la divulgazione dei dati personali verso terzi
|-
| JPGImage || text || No || Immagine codificata in Base64
|-
| DateJPGImage || date || No || Data dell'immagine
|-
| RecordExpiry || Date || No || Data di fine validità del record
|}

==== Parametri in uscita ====

=== (STEP 4) - Codifica WebSales ===
=== (STEP 5) - Lettura WebSales (per dominio) ===
=== (STEP 6) - Generazione della tessere relativa alla vendita ===
=== (STEP 7) - Lettura generazione tessera ===
=== (STEP 8) - Invio dei passaggi ===
=== (STEP 9) - Chiusura giornata ===
=== (STEP 10) - Lettura passaggi ===
=== (STEP 11) - Registrazione ammontare valori ricarica ===

== Servizi Web relativi ai domini ==
=== Create Domain ===
=== Register Domain ===
=== Get Domain List ===