Pay Per Use

Premessa

Anef Ski Lombardia ha sviluppato la possibilità̀ per ogni associato di accettare con i propri sistemi lo Stagionale OpenPass anche in modalità Pay per Use (in seguito denominato PPU), dando ai turisti lombardi l’opportunità di usare una sola card per sciare in tutta la regione, ed estendendo le potenzialità̀ di OpenPass da un utilizzo professionale (stagionale Lombardia) ad un utilizzo diffuso (Skipass Lombardia Pay per Use). La modalità Pay per Use consentirà agli utenti di usufruire di un servizio efficiente e funzionale, capace di semplificare e migliorare l'esperienza di accesso al comprensorio lombardo, ed allo stesso tempo alle stazioni di monitorare e rendicontarne gli accessi. Attraverso lo Skipass PPU si scalerà secondo gli effettivi accessi ai tornelli presenti nelle stazioni sciistiche le relative tariffe, tramite il circuito di carta di credito associato. Il soggetto interessato all’acquisto avrà modo di selezionare la tipologia di tessera di cui necessita tra senior, adulti, junior o bambini, associare i dati della propria carta di credito ed usufruire così di un servizio che gli permetta l'utilizzo della totalità degli impianti funiviari lombardi grazie ad un'unica tessera ed il relativo pagamento delle tariffe, senza sprechi. Attraverso la modalità pay-per-use, che permette di non farsi carico dell'acquisto di un bene, ma semplicemente del costo per il suo utilizzo, sarà possibile fornire agli utenti un unico mezzo pratico, efficiente ed economico, ma soprattutto sicuro, tanto per l'utente quanto per il consorzio stesso che avrà modo di monitorare e verificare accessi e pagamenti. Questa nuova modalità di erogazione dei titoli di viaggio è integrata nel formato OpenPass e a tal proposito sono state adeguate le specifiche, gli standard, l’interazione con i sistemi di accesso.

Aspetti Normativi - finanziamenti

Il progetto OpenPass, nel suo sviluppo relativo al Pay per Use, ha preso vita grazie alla Deliberazione numero X/7234 del 17/10/2017 con oggetto “SOSTEGNO ALLA REALIZZAZIONE DI UN PROGETTO PER LA MANUTENZIONE E L’ADEGUAMENTO DEL SISTEMA OPENPASS E DEL RELATIVO MANUALE D'USO IN FORMATO DIGITALE (LIBRO BIANCO OPENPASS) AI NUOVI SERVIZI “PAY PER USE” ED ALLE INIZIATIVE DI PROMOZIONE AD ESSO COLLEGATE (DI CONCERTO CON L'ASSESSORE PAROLINI)” che ha previsto l’erogazione di finanziamenti per la copertura finanziaria degli interventi previsti dal progetto.

Architettura del sistema

Per rendere operativa la nuova modalità di funzionamento PPU del formato OpenPass devono collaborare attraverso un costante scambio di informazioni diversi attori:

• PIATTAFORMA IT -> deve realizzare:
  • sistema profilazione degli utente
  • sistema di acquisto dei ticket PPU
  • sistema di invio delle vendite ticket PPU al Server OpenPass
  • sistema di calcolo della tariffa più conveniente da associare quotidianamente alla vendita PPU per scalare l'importo dalla carta di credito
  • sistema invio aggiornamento ammount tessere PPU
  • sistema aggiornamento tariffe per stazione da associare al PPU
  • reportistiche per utenti finali
• SERVER OPENPASS -> deve realizzare:
  • sistema acquisizione vendite ticket PPU
  • sistema acquisizione ammount ticket PPU
  • sistema acquisizione passaggi ticket PPU
  • sistema controllo incrociato di verifica congruenza sistema PPU
  • sistema di invio di dati di passaggi e presenze dei ticket PPU a Regione Lombardia
• FORNITORI SISTEMI DI ACCESSO -> devono realizzare:
  • sistema invio passaggi alla piattaforma IT dei ticket PPU
  • sistema invio setup vendite ticket PPU alla piattaforma IT
  • sistema di gestione ticket PPU bloccati o stornati

Di seguito viene riportato il flusso di funzionamento del sistema PPU con i vari STEP:
PRIMO STEP

Primo step

SECONDO STEP

Secondo step

TERZO STEP

Terzo step

QUARTO STEP

Quarto step

Piattaforma IT

Anef Ski Lombardia, tramite un soggetto terzo, ha realizzato una piattaforma IT attraverso cui gli utenti interessati possono profilarsi tramite il portale www.skipasslombardia.it o tramite l’applicazione per smartphone scaricabile dagli store Apple e Android, indicare la Carta di Credito e la propria anagrafica, e richiedere l’invio della tessera Skipass Lombardia PPU a casa (o ritirarla presso una delle stazioni sciistiche indicate).

Procedura d'acquisto PPU

La piattaforma “opziona” sul plafond della carta di credito il prezzo massimo teorico di un giornaliero in Lombardia.

Si è reso necessario un tavolo tecnico tra i fornitori dei sistemi di accesso ed il soggetto terzo che ha sviluppato la piattaforma IT per definire modalità e specifiche di trasmissione dei dati di passaggi e vendite dalle stazioni verso la piattaforma in modo da consentire il calcolo dell’addebito.

Ogni volta che l’utente andrà a sciare in Lombardia presso le stazioni aderenti, la sera, dopo il calcolo da parte della piattaforma, gli verrà̀ addebitato il costo e inviata la ricevuta che riassume i dettagli dell'addebito. Dalla piattaforma www.skipasslombardia.it potrà inoltre rivedere la propria “giornata” e condividerla sui social.

La piattaforma, oltre ad occuparsi del calcolo dei corrispettivi e della gestione degli incassi, mette anche a disposizione dei soci aderenti uno strumento web per variare gli importi degli Skipass Lombardia dei singoli associati e le relative logiche di calcolo degli “Skipass Lombardia Payperuse” durante la stagione (tariffa alta/bassa stagione, festivo/feriale, Promozioni, ecc.).

Giornalmente la piattaforma invia alle stazioni aderenti il resoconto giornaliero del venduto via email; quindicinalmente invia un riassunto; mensilmente invia poi il quadro totale mensile dei corrispettivi che il socio deve inserire nel proprio registro dei corrispettivi e bonifica l’incassato (detratte le spese bancarie) direttamente agli associati. Con un backoffice ogni socio può istantaneamente verificare lo storico ed in tempo reale il venduto e l'incassato.

Piattaforma IT - Registrazione utente

All’interno della piattaforma o tramite l’applicazione, l’utente potrà registrarsi inserendo i propri dati anagrafici e specificando informazioni aggiuntive come residenza, sesso, età che consentiranno di affinare il calcolo delle tariffe da applicare consentendo l’applicazione di scontistiche dedicate per la specifica categoria.

Piattaforma IT - Aggiornamento tariffe

Le stazioni sciistiche devono comunicare alla piattaforma, manualmente o automaticamente tramite sistemi messi a disposizione dei sistemi di accesso quali tipologie di Skipass di stazione decidono di associare al PPU ed in questo modo la piattaforma può selezionare la tariffa migliore in base ai passaggi effettuati ai tornelli dallo sciatore.

Piattaforma IT - Sistema di calcolo

Una volta che l’utente ha attivato la sua card presso una delle stazioni sciistiche partner, può utilizzarla per accedere agli impianti.

Il sistema di calcolo del PPU

Al primo passaggio ai tornelli della giornata, viene registrata l’ora di accesso e sulla carta di credito viene eseguito una pre-autorizzazione della tariffa massima che potrebbe spendere in quella località, in quel giorno. Questa operazione viene eseguita per tutti gli Openpass collegati a quella carta di credito che effettuano un acceso ai tornelli.

A questo punto possono accadere due cose:

• Se la pre-autorizzazione dà esito POSITIVO, l’utente viene abilitato a utilizzare l’openpass in quella località e può continuare a sciare. Riceve un sms e una mail che conferma l’attivazione.
• Se la pre-autorizzazione dà esito NEGATIVO (fondi insufficienti, carta scaduta ecc), l’utente viene bloccato, riceve un sms e una mail che lo avvisa che NON può utilizzare l’Openpass in quella località. A questo punto se prova a passare a qualche altro tornello, questo è bloccato. Non viene fatto nessun addebito sulla carta e se vuole sciare, deve obbligatoriamente acquistare lo skipass alle casse.

L’utente che a questo punto è abilitato a sciare, inizia a prendere gli impianti.

Ogni volta che passa hai tornelli, viene registrato l’orario di accesso. A fine giornata, viene recuperato l’orario di primo accesso e l’orario dell’ultimo accesso e viene calcolato quante ore effettive ha sciato.

In base alle tariffe di ogni singola località, che possono includere prezzi differenti per orari, periodi, età dello sciatore, impianti presi, impianti esclusi dal calcolo delle ore ecc. viene calcolata la migliore tariffa.

A questo punto se la tariffa applicata è minore della pre-autorizzazione effettuata la mattina, viene stornato il valore della pre-autorizzazione e viene addebitata la tariffa. Se la tariffa è uguale alla pre-autorizzazione, viene confermato l’addebito.

Piattaforma IT - Verifica delle performance

Attraverso la ricezione dei passaggi effettuati presso le varie stazioni e disponendo dell’anagrafica di impianti e località, la piattaforma mette a disposizione dello sciatore dei report e dei grafici per verificare i kilometri ed il dislivello percorso

Server OpenPass

Server OpenPass - Periodicità, formato e contenuto delle informazioni gestite nella rete OpenPass per la modalità PPU

Il Server OpenPass prevede l’invio dei dati di passaggio e vendita (ed i dati necessari al completamento dei primi due flussi come ticket e customer) da parte delle stazioni consociate ANEF Ski Lombardia in formato XML attraverso l’utilizzo di WebService in essere anche per i nuovi ticket PPU. L’invio dei dati da parte dei client delle stazioni al server OpenPass dovrà essere giornalieri per i passaggi relativi al PPU in modo da consentire il calcolo giornaliero da parte della piattaforma WEB con la tariffa più conveniente per la stazione da scalare sulla carta di credito.

Il Server OpenPass prevede l'utilizzo di nuovi WebService che saranno utilizzati dai webshop relativi alle WebCompany per l’acquisto online dei ticket PPU e per registrare quotidianamente i valori di ammontare delle vendite.

Il Server OpenPass prevede poi dei WebService potranno essere interrogati ogni giorno, dopo l’elaborazione dei dati presenti sul Server OpenPass, per il recupero dei dati anagrafici, dei passaggi e delle presenze verso Regione Lombardia.

Server OpenPass - Comunicazione tra il server OpenPass e i client delle stazioni per i ticket PPU

Lo standard OpenPass, anche per la modalità PPU, prevede una rete distribuita di centri di raccolta dati collegati via web service al server centrale.

Le informazioni di vendita e passaggio relativi ai ticket PPU raccolte ai varchi e inviate ai centri di raccolta dati, che a loro volta le trasmettono quotidianamente al server centrale.

Il protocollo di scambio tra server e centri di raccolta è REST, basato sul metalinguaggio XML. Il server riceve i dati e li memorizza in un database SQL centralizzato, dove ogni dato di vendita o passaggio è correlato da un codice seriale identificativo univoco e eventuali dati anagrafici del customer.

Per informazioni più dettagliate consultare la sezione: “APPENDICE A - Servizi del Formato 3”.

Server OpenPass - Estensione dei servizi per la vendita online dei ticket PPU

Per consentire la vendita Online dei ticket PPU in formato OpenPass è prevista un’evoluzione dei Servizi WEB esistenti per gestire ricarica e vendita online dei titoli di viaggio e consentire lo scambio dati tra le varie stazioni.

I partner commerciali di AnefSkiLombardia saranno delle WebCompany: aziende accreditate OpenPass che forniranno un servizio di vendita per la company Anef Ski Lombardia per quanto riguarda gli Skipass Lombardia PPU.

Ogni WebCompany realizzerà un WebShop cioè un portale specifico di vendita dei titoli OpenPass Skipass Lombardia per la company Anef Ski Lombardia.

Il WebShop invierà al Server OpenPass le transazioni di vendita degli Skipass Lombardia ed i valori degli ammontare di vendita delle tessere in payperuse.

Per far questo sarà necessario:

• Modificare i servizi Web esistenti del server OpenPass:

Servizio	Specifiche variazioni
RegisterTicket	verrà inserito un TAG aggiuntivo <info></info> 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)
GetTicket	verrà restituito un TAG aggiuntivo <info></info> contenente informazioni utili al produttore dei sistemi di accesso e al fornitore del negozio internet (WebShop)
RegisterCustomer	verranno registrate nuove informazioni relative ai customer

• Implementare nuovi servizi Web del server OpenPass:

Servizio	Specifiche implementazioni
RegisterWebSales	Servizio per inviare le transizioni di vendita dei ticket PPU effettuate dal un WebShop. Ogni transazione di vendita verrà identificata univocamente dal proprio seriale di vendita RegisterWebSaleID fornito dal server OpenPass. Più transazioni di vendita possono essere raggruppate da un unico OrderNumber fornito dal Webshop in fase di invio transazioni. Tra le varie informazioni inviate ci saranno: – OperationType: (0-ritiro, 1 ricarica, 2 registrare rata di denaro, 3 storno), – Payperuse: (1 = si payperuse) – Insurance: Abbinata un’assicurazione (0 = no, 1 = si) – CardPaid: inclusa la card nella transazione di vendita (0 = no, 1 = si)
UpdateWebSalesAmmount	Servizio per aggiornare le vendite Web con il quantitativo economico derivato dal calcolo dell'uso per i ticket PPU
GenerateTicket	Servizio con cui i fornitori dei sistemi di accesso potranno inviare al Server OpenPass i token Root.Workstation e Root.SerialNumberEx2 e la data di creazione della tessera con cui è stato generato il biglietto per ogni specifica transazione di vendita identificata con RegisterWebSaleID
GetWebSales	Servizio con cui i fornitori dei sistemi di accesso potranno scaricare dal server OpenPass tutte le vendite Web relative ai ticket PPU effettuate per ogni dominio. Il servizio viene interrogato passando l’identificativo della stazione) e l'ultimo RegisterWebSaleID in possesso dalla stazione. Il servizio restituisce le informazioni di tutte le transazioni di vendita successive al RegisterWebSaleID passato, relativi a tutti i domini a cui è associata la Company richiesta. In tali informazioni sono presenti gli OpenPassUID che identificano le tessere da ricaricare e i RegisterWebSaleID che permettono di legare le vendite WEB alle tessere ricaricate dai tornelli.
GetPassages	Servizio per recuperare tutti i passaggi effettuati da una tessera ricaricata a seguito di una vendita online di un ticket PPU identificata con RegisterWebSaleID e calcolare l'ammontare della vendita
SetDailyClosing	Servizio 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 PPU ricaricate e conseguentemente l'ammontare della vendita
GetStatusSales	Servizio che dato in ingresso il RegisterWebSaleID restituisce in quale company, data e ora è stato scaricato
GetCustomer	Servizio che restituisce tutti i dati relativi ad uno specifico CustomerIdentifier
Getcustomersstatus	Servizio che restituisce l’ultima data di aggiornamento dei customers collegati ad un determinato dominio
Getcustomersdomain	Servizio che restituisce i dati di tutti i customers aggiornati da una certa data in poi
CreateDomain	Servizio che consente di creare nuovi domini
RegisterDomain	Servizio che permette di associare le company ai domini
GetDomainList	Servizio che restituisce tutti i domini associati ad un company

Per informazioni più dettagliate consultare la sezione: “APPENDICE A - Servizi del Formato 3 - Estensione dei servizi per la vendita online”.

Server OpenPass - Nuovo protocollo di trasferimento dati verso Regione Lombardia

A seguito dell’introduzione del nuova modalità PPU è stato adeguato il debito informativo verso Regione Lombardia nell’ottica del progetto OSM Osservatorio della Montagna.

Sono stati realizzati dei nuovi servizi WEB per l’interrogazione dei dati presenti sul Server OpenPass di Anef Ski Lombardia relativamente a:

• Anagrafiche (WebService GetAnagrafiche)
• Presenze (WebService GetPresenze)
• Passaggi (WebService GetPassaggi)

Get Anagrafiche

Il servizio “GetAnagrafiche” consente l’estrazione dal Server OpenPass di Anef Ski Lombardia delle località sciistiche, dei collegamenti con i gestori presenti nelle località sciistiche e degli impianti collegati ai gestori. Il servizio prevede l’autenticazione HTTP di base tramite username e password

Titolo	GetAnagrafiche
Tipo WS	Rest
URL risorsa	lispaws.openpass.it/GetAnagrafiche
Metodi consentiti	POST

PARAMETRI INPUT

Nome	Tipo	Obbligatorio	Descrizione
Anno	Integer unsigned	Si	Anno di riferimento dei dati anagrafici

PARAMETRI OUTPUT

Nome	Tipo	Descrizione
Località	Array	Array di località

OGGETTO GESTORI

Nome	Tipo	Descrizione
id_gestore	Integer	Identificativo del gestore
nome	Text	Nome del gestore
ragione_sociale	Text	Ragione sociale del gestore
impianti	Array	Array di impianti

OGGETTO GESTORI

Nome	Tipo	Descrizione
id_gestore	Integer	Identificativo del gestore
nome	Text	Nome del gestore
ragione_sociale	Text	Ragione sociale del gestore
impianti	Array	Array di impianti

OGGETTO IMPIANTI

Nome	Tipo	Descrizione
id_impianto_openpass	Integer	Identificativo dell'impianto
nome_impianto	Text	Nome dell'impianto
tipo_impianto	Text	Tipo di impianto

ESEMPIO DI CHIAMATA Clicca su Espandi per visualizzare il codice

$.ajax({
	url: "lispaws.openpass.it/GetAngrafiche",
	dataType: "json",
	data: {
		Anno: 2017,
	},
	type: "POST",
	success: function (r) {
		console.log(r);
	},
	error: function (r) {
		console.log(r.responseText);
	}
});

ESEMPIO DI RISPOSTA CON SUCCESSO

Codice

Contenuto

200

{ "Localita": [ { "id_localita": "1", "descrizione": "Aprica", "sigla_localita": "AP", "gestori": [ { "id_gestore": "1", "nome": "ALPE VAGO", "ragione_sociale": "ALPE VAGO S.R.L.", "impianti": [ { "id_impianto_openpass": "AP-SG4-4", "nome_impianto": "Alpe Vago", "tipo_impianto": "Seggiovia" }, { "id_impianto_openpass": "AP-TP1-10", "nome_impianto": "Fantaski", "tipo_impianto": "Tappeto" } ] }, { "id_gestore": "2", "nome": "BARADELLO", "ragione_sociale": "BARADELLO'S FRIENDS SRL", "impianti": [ { "id_impianto_openpass": "AP-SG4-16", "nome_impianto": "Baradello 2000", "tipo_impianto": "Seggiovia" } ] }, { "id_gestore": "3", "nome": "NEGRI LUCIANA", "ragione_sociale": "NEGRI LUCIANA", "impianti": [ { "id_impianto_openpass": "AP-TP1-8", "nome_impianto": "Cucciolo", "tipo_impianto": "Tappeto" } ] }... ] },...

Get Presenze

Il servizio “GetPresenze” consente l’estrazione dal Server OpenPass di Anef Ski Lombardia del dato aggregato delle presenze per località sciistica e range di date eseguendo il conteggio per tipologia di biglietto e per tipologia di età. Il campo “ flag_data” in ingresso guida il valore delle date inserite:

• FLAG_DATA = E → le date faranno riferimento alla data elaborazione del dato (data di ricezione delle informazioni sul Server OpenPass)
• FLAG_DATA = C → le date faranno riferimento alla data effettiva di calcolo (data del passaggio).

Il servizio prevede l’autenticazione HTTP di base tramite username e password.

Titolo	GetPresenze
Tipo WS	Rest
URL risorsa	lispaws.openpass.it/GetPresenze
Metodi consentiti	POST

PARAMETRI INPUT

Nome	Tipo	Obbligatorio	Descrizione
id_localita_sciistica	Integer unsigned	Si	Id località sciistica (ricavabile dal Ws “GetAnagrafiche”)
data_inizio	Date	Si	Data di inizio estrazione delle presenze (formato 2017-12-01)
data_fine	Date	Si	Data di inizio estrazione delle presenze (formato 2017-12-01)
flag_data	Text	Si	Flag di riferimetno data (E data di elaborazione, C data di calcolo)

PARAMETRI OUTPUT

Nome	Tipo	Descrizione
Presenze	Array	Array di presenze

OGGETTO PRESENZE

Nome	Tipo	Descrizione
id_localita	Text	Identificativo della località
data_inizio	Date	Data di inizio estrazione delle presenze (formato 2017-12-01)
data_fine	Date	Data di fine estrazione delle presenze (formato 2017-12-01)
flag_data	Text	Flag di riferimento data (E data di elaborazione, C data di calcolo)
data_di_riferimento	Date	Data di riferimento presenze
Conteggi	Array	Array di conteggi

OGGETTO CONTEGGI

Nome	Tipo	Descrizione
tipo	Integer	Identificativo del tipo di biglietto
eta	Integer	Identificativo dell'età dello sciatore
presenze	Integer	Conteggio delle presenze

ESEMPIO DI CHIAMATA Clicca su Espandi per visualizzare il codice

$.ajax({
	url: "lispaws.openpass.it/GetPresenze",
	dataType: "json",
	data: {
		id_localita_sciistica: 20,
               data_inizio : 2017-11-12,
               data_fine : 2017-11-12,
               flag_data : C,
	},
	type: "POST",
	success: function (r) {
		console.log(r);
	},
	error: function (r) {
		console.log(r.responseText);
	}
});

ESEMPIO DI RISPOSTA CON SUCCESSO

Codice

Contenuto

200

{ "Presenze": [ { "id_localita": "20", "data_inizio": "2017-11-12", "data_fine": "2017-11-12", "flag_data": "C", "data_di_riferimento": "2017-11-12", "conteggi": [ { "tipo": "0", "eta": "3", "presenze": "1" }, { "tipo": "2", "eta": "1", "presenze": "12" }, { "tipo": "3", "eta": "1", "presenze": "1" }, { "tipo": "3", "eta": "2", "presenze": "18" }, { "tipo": "3", "eta": "3", "presenze": "11" }, { "tipo": "3", "eta": "4", "presenze": "1" }, { "tipo": "4", "eta": "1", "presenze": "46" }, { "tipo": "4", "eta": "2", "presenze": "159" }, { "tipo": "4", "eta": "3", "presenze": "817" }, { "tipo": "4", "eta": "4", "presenze": "13" } ] } ] }

Get Passaggi

Il servizio “GetPassaggi” consente l’estrazione dal Server OpenPass di Anef Ski Lombardia del dato aggregato dei passaggi per impianto e range di date eseguendo il conteggio per tipologia di biglietto e per tipologia di età. Il campo “flag_data” in ingresso guida il valore delle date inserite:

• FLAG_DATA = E -> le date faranno riferimento alla data elaborazione del dato (data di ricezione delle informazioni sul Server OpenPass)
• FLAG_DATA = C → le date faranno riferimento alla data e ettiva di calcolo (data del passaggio).

Il servizio prevede l’autenticazione HTTP di base tramite username e password

Titolo	GetPassaggi
Tipo WS	Rest
URL risorsa	lispaws.openpass.it/GetPassaggi
Metodi consentiti	POST

PARAMETRI INPUT

Nome	Tipo	Obbligatorio	Descrizione
id_impianto_openpass	Text	Si	Identificativo dell’impianto (ricavabile dal Ws “GetAnagrafiche”)
data_inizio	Date	Si	Data di inizio estrazione dei passaggi (formato 2017-12-01)
data_fine	Date	Si	Data di fine estrazione dei passaggi (formato 2017-12-01)
flag_data	Text	Si	Flag di riferimento data (E data di elaborazione, C data di calcolo)

PARAMETRI OUTPUT

Nome	Tipo	Descrizione
Passaggi	Array	Array di passaggi

OGGETTO PASSAGGI

Nome	Tipo	Descrizione
id_impianto_openpass	Text	Identificativo dell'impianto
data_inizio	Date	Data di inizio estrazione dei passaggi (formato 2017-12-01)
data_fine	Date	Data di fine estrazione dei passaggi (formato 2017-12-01)
flag_data	Text	Flag di riferimento data (E data di elaborazione, C data di calcolo)
data_di_riferimento	Date	Data di riferimento passaggi
conteggi	Array	Array di conteggi

OGGETTO CONTEGGI

Nome	Tipo	Descrizione
tipo	Integer	Identificativo del tipo di biglietto
eta	Integer	Identificativo dell'età dello sciatore

ESEMPIO DI CHIAMATA Clicca su Espandi per visualizzare il codice

$.ajax({
	url: "lispaws.openpass.it/GetPassaggi",
	dataType: "json",
	data: {
		id_impianto_openpass: PT-CB15-20,
               data_inizio : 2017-11-12,
               data_fine : 2017-11-12,
               flag_data : C,
	},
	type: "POST",
	success: function (r) {
		console.log(r);
	},
	error: function (r) {
		console.log(r.responseText);
	}
});

ESEMPIO DI RISPOSTA CON SUCCESSO

Codice

Contenuto

200

{ { "Passaggi": [ { "id_impianto_openpass": "PT-CB15-20", "data_inizio": "2017-11-12", "data_fine": "2017-11-12", "flag_data": "C", "data_di_riferimento": "2017-11-12", "conteggi": [ { "tipo": "0", "eta": "3", "passaggi": "2" }, { "tipo": "2", "eta": "1", "passaggi": "24" }, { "tipo": "3", "eta": "1", "passaggi": "2" }, { "tipo": "3", "eta": "2", "passaggi": "36" }, { "tipo": "3", "eta": "3", "passaggi": "22" }, { "tipo": "3", "eta": "4", "passaggi": "2" }, { "tipo": "4", "eta": "1", "passaggi": "90" }, { "tipo": "4", "eta": "2", "passaggi": "316" }, { "tipo": "4", "eta": "3", "passaggi": "1528" }, { "tipo": "4", "eta": "4", "passaggi": "21" } ] } ] }

Codici di riferimento

Di seguito vengono espresse le codifiche dei valori riportati in output dai Webservices esposti per i campi “tipo” ed “eta”.

TIPO
Codice	Valore
0	Non definito
1	Stagionale Regionale
2	Stagionale
3	Plurigiornaliero
4	Giornaliero

ETÀ
Codice	Valore
1	Bambini - <= 11
2	Ragazzi - 12-17
3	Adulti - 18-64
4	Senior - >= 65

Errori

Di seguito vengono espressi i possibili errori riportati iN in output dai Webservices esposti.

ERRORE
Codice	Valore
100	Non esistono anagrafiche per i filtri in ingresso
101	Non esistono passaggi per i filtri in ingresso
102	Non esistono presenza per i filtri in ingresso
200	Il campo anno non è un intero
202	Date non formalmente valide
203	Id località non è presente
204	Id impianto openpass non è presente
205	Valore non ammesso
206	Valore obbligatorio mancante

Server OpenPass - Sistema di controllo incrociato e controllo efficienza PPU

La realizzazione dello skipass PPU, definito come mezzo pratico e sicuro, ha previsto infatti l'attivazione di un sistema di verifica incrociato le cui regole e specifiche sono state riportate nel libro bianco OpenPass. Per la stesura delle specifiche per il controllo incrociato, hanno collaborato i fornitori dei sistemi di accesso e dei server che hanno indicato la modalità/periodicità di comunicazione dei passaggi, dei costi dei titoli di viaggio di stazione, delle anagrafiche e Anef Ski Lombardia che, utilizzando i dati inviati dalle stazioni al Server OpenPass può verificare la “bontà” di questi dati.

Il sistema di controllo è così composto:

• Per Anef Ski Lombardia sarà possibile – in aggiunta al monitoraggio degli accessi e dei dati ad essi relativi come date, orari, stazioni, impianti utilizzati per esempio – controllare:
  • la validità del sistema di pagamento tramite circuito di carta di credito;
  • l'effettivo versamento;
  • i possibili storni al cliente, qualora si dovessero verificare situazioni che ne rendano necessario il risarcimento.
• Per il cliente che usufruisce del servizio reso dalla tessera in modalità PPU, tracciare la sua spesa e verificarne l'effettiva corrispondenza.
• Per le stazioni sciistiche sarà possibile verificare e monitorare gli accessi ed introiti giornalieri delle tessere PPU.
• Per Regione Lombardia
  • L’accesso in maniera aggregata e nei limiti di legge alle informazioni degli utenti che si avvicinano al mondo della neve attraverso gli impianti di risalita.
  • La possibilità di verificare lo sviluppo della tecnologia pay per use basata sul formato openpass anche in altri ambiti