Pagine Pag. 1 di 22 Intrduzine Il mdul WebCard cnsente la gestine delle card fidelity via web. Tale gestine, se attivata, è alternativa alla gestine inclusa nei prgrammi Gerì/Htel Autmatin e Retail Shp Autmatin e la sstituisce cmpletamente. Essa cnsente un utilizz distribuit delle card su strutture tra di lr NON cllegate che utilizzan il sftware Htel/Gerì Autmatin e/ Retail Shp Autmatin (anche in situazini miste), in quant l anagrafica dei clienti e tutta la mvimentazine vengn registrati in un database sul web. I mvimenti abbinati alle card vengn cmunque stricizzati negli archivi lcali del prgramma di gestine, benché assciati ad un cliente fittizi predefinit, per garantire la cmpatibilità degli archivi cntabili. Nel cas di Gerì/Htel Autmatin, nn sn gestite, in questa cnfigurazine, card a credit card aziendali ma slamente card prmzinali prepagate (cn la pssibilità di abbinare prfili di scnt listin accumul punti). In Retail Shp Autmatin è invece pssibile abbinare il prfil della card remta ad un parallel prfil gestit in Retail. Tutta la gestine delle card (emissine, ricarica, cnsultazine, ecc.) è demandata ad un appsit applicativ (denminat Card Manager) che si interfaccia cn il database nline, applicativ che può risiedere in un uffici lug separat (nel cas in cui, ad esempi, vi sia un uffici chisc appsit per il rilasci delle card). Il database nline cnsente inltre ai pssessri delle card, se l si desidera, di accedere via web ai dati della prpria card effettuandne la cnsultazine (mvimenti effettuati, punti accumulati, ecc.), tramite un appsit mdul Custmer Web. Lasersft frnisce l spazi web cn il database (Micrsft SQL Server 2005 superire), dietr crrespnsine di un canne annuale. Attenzine: nnstante l spazi web preveda backups autmatici girnalieri, è respnsabilità dell utente effettuare peridicamente le cpie di backup del database a tutela dei prpri dati inseriti, tramite l appsita funzine del mdul di Amministrazine del Card Manager. Per quant riguarda la tiplgia delle card gestite, è pssibile utilizzare sia card traspnder che chipcard (mdelli Siemens SLE4442), ppure card in emulazine tastiera. WebCard prevede infine anche una mdalità di utilizz standalne, ciè nn cllegata ai sftware delle linee Lasersft: in quest cas tutte le transazini sulle carte verrann eseguite manualmente tramite il Card Manager. Webcard necessita di una autenticazine nline, che viene verificata all avvi dell applicazine di gestine Card Manager (vedi ltre). Pertant è necessaria sulle pstazini di gestine la cnnessine ad internet. Mduli della gestine WebCard L'applicazine è cmpsta da tre mduli: 1. Mdul WebCard che cntiene il WebService dell'applicazine. Tramite quest mdul viene gestit il salvataggi e il recuper delle infrmazini. Quest mdul viene installat direttamente da LASERSOFT nell area web. 2. Mdul Card Manager cmpst dall'interfaccia di gestine delle card. Il mdul è cnness al web service cn il quale cmunica per l'invi e la ricezine delle infrmazini riguardante le carte. 3. Mdul Custmer Web per l access da parte del pssessre della card per visualizzare l'elenc dei sui mvimenti. Quest mdul viene installat direttamente da LASERSOFT nell area web.
Pagine Pag. 2 di 22 Stric rilasci 21/12/2011: Versine 1.0.3.1 Cambiat indirizz del server per la gestine dell autenticazine della licenza Amministrazine: inserit pulsante per prelevare il backup del database Amministrazine: inserit pulsante per prelevare file CSV cn il database dei clienti Inseriment clienti: ridefiniti i campi bbligatri, ra sn sl il cgnme e il nme Rislte anmalie minri 17/12/2010: Versine 1.0.0.0 - prim rilasci
Pagine Pag. 3 di 22 MODULO CLIENT (Card Manager) E l applicazine di amministrazine delle card, che gestisce l anagrafica clienti, il rilasci e la mvimentazine delle card, le cnsultazini e le stampe. Installazine Card Manager Avviare il file SetupCardManager.exe. Premere avanti e selezinare la cartella di installazine. Cnfermare l'avvi della prcedura di installazine premend avanti.
Pagine Pag. 4 di 22 Attendere la fine della prcedura di installazine.
Impstazini da effettuare dp l'installazine: DOCUMENTAZIONE TECNICA Pagine Pag. 5 di 22 1. Impstazine dell indirizz del Web Service All'avvi del CardManager la prima vlta cmparirà un messaggi del tip: Quest perchè bisgna cnfigurare l'url del Web Card per la cnnessine al server delle card. Premend OK si aprirà la finestra seguente: Impstare l'url del Web Card, frnit da LASERSOFT, e premere il pulsante 'Salva ed Esci'. Al riavvi successiv dell'applicazine se l'indirizz impstat sarà crrett l'applicazine nn mstrerà più l'errre precedente. 2. Attivazine della licenza Nel cas in cui la licenza dell'applicazine nn fsse stata ancra verificata, all'avvi del card manager apparirà la schermata seguente.
Premend OK si aprirà la finestra di attivazine della licenza: DOCUMENTAZIONE TECNICA Pagine Pag. 6 di 22 Inserire il numer della licenza d us frnit da LASERSOFT e premere il pulsante 'Attiva'. Se la licenza è valida l'applicazine si avvierà nrmalmente. 3. Impstazine dell'identificativ dell'azienda per la generazine delle card (cdice circuit) (NB: sl se si utilizzan le chip card): Entrare nella cartella dve è stat installat il card manager, cercare il file cardmanager.exe.cnfig e aprire il file cn un editr di test tip ntepad.exe. All'intern del file mdificare nell'impstazine CardReaderOffSetCdCirc il valre all'intern del tag <value></value>. Tale valre è un prefiss numeric che viene aggiunt quand si genera un cdice card autmaticamente durante la prcedura di scrittura della card tramite un dispsitiv di scrittura su card. Quest serve per evitare che aziende cn strutture diverse generin card cn un id uguale. 4. Cnfigurazine CARD MANAGER e Impstazine utenti Occrre inizialmente prcedere alla cnfiugurazine di Card Manager tramite il pannell di Amministrazine e in particlare definire almen UN UTENTE della prcedura: sarann le impstazini di quest utente (nme e passwrd) che dvrann essere inserite negli appsiti campi di cnfigurazine dei prgrammi Lasersft (LaserCnfig Retail Shp Manager). Cnsultare al riguard il paragraf AMMINISTRAZIONE più avanti nel manuale.
Pagine Pag. 7 di 22 Manuale di utilizz di CARD MANAGER Inseriment card: ChipCard: genera la tessera chipcard, prgrammand la card sul lettre. Traspnder: legge la tessera traspnder dal lettre SmsCard: genera un numer card in base al numer di cellulare e invia la relativa immagine per SMS al cliente La scheda riguardante le card si cmpne di due sezini. La prima si riferisce all'anagrafica del cliente. Si può inserire un cliente nuv utilizzarne un già precedentemente inserit. Per ricercare un cliente il camp sensibile è il 'Cgnme' nella sezine 'Generalità' e si abilità premend su di ess il tast INVIO. Il significat dei campi è facilmente intuibile. Il riquadr Access al sit WEB cnsente l access da parte dell utente finale, tramite un username (crrispndente all indirizz Email) e ad una passwrd frnita inizialmente dal gestre (l utente ptrà pi mdificarla), al servizi web di cnsultazine dei mvimenti della prpria card. La secnda sezine cnsente l inseriment della nuva card, assciata al cliente. Il numer di carta può essere inserit manualmente attravers la lettura delle chip card card traspnder (vedere paragraf Amministrazine).
Pagine Pag. 8 di 22 Mdifica card: Nella scheda mdifica si pssn mdificare i dati sia relativi ad una card che al cliente assciat alla card. La ricerca può essere fatta attravers il cdice card che può essere immess sia manualmente che attravers la lettura di una card da un lettre di smart card ppure attravers il camp cgnme premend il tast Invi. Una vlta trvata, la card può essere mdificata eliminata. Nta bene: eliminare una card significa impstare un flag di eliminat sul database. Eventuali mvimenti relativi alla card rimangan quindi assciati alla card e nn cancellati. L'eliminazine definitiva avviene quand si cerca di ricreare una card cn flag di eliminat attiv. In quest cas l'utente sceglie se prseguire cancelland l stric della card precedente. Se sn abiltiate le SMS Card, è pssibile da questa schermata reinviare per SMS al cliente l immagine della sua card, qualra fsse stata persa.
Pagine Pag. 9 di 22 Mvimenti card Nella scheda mvimenti vengn riepilgati i mvimenti relativi ad una card. La ricerca può essere fatta attravers il cdice card che può essere immess sia manualmente che attravers la lettura di una card da un lettre di smart card ppure attravers il camp cgnme premend il tast Invi Il pulsante 'Reprt mvimenti' crea un reprt sui mvimenti della card selezinata, che può essere stampat.
Pagine Pag. 10 di 22 Il pulsante 'Nuv mviment' permette di inserire un nuv mviment per la carta selezinata: Sn pssibili le seguenti causali: Carica Iniziale: per inserire una carica di prepagat su una card cn zer credit. Ricarica: per inserire una ricarica in valre su una card Spesa: per registrare manualmente un mviment di spesa Trasferiment: per trasferire i fndi da una card ad un altra Rimbrs/Estinzine: estinzine di una card cn rimbrs dell eventuale residu Rettifica punti: per crreggere il sald punti di una card Utilizz Punti: per mdificare il sald punti di una card a seguit di un utilizz (ad esempi per ritir premi). Ogni mviment da lug autmaticamente alla stampa di una ricevuta. La descrizine delle perazini assciati alle causali predefinite è persnalizzabile nel pannell di amministrazine. Se la card è di tip Prmzinale nn sn cnsentiti i mvimenti di tip Carica Iniziale, Ricarica e Trasferiment.
Pagine Pag. 11 di 22 Amministrazine La scheda amministrazine permette di impstare i parametri crrispndenti alla pstazine di lavr. Impstazini Generali: In questa sezine si specifican il nme dell'azienda e il nme della pstazine, ad es. Uffici Tessere. Il nme della pstazine serve per cntraddistinguere l rigine dei mvimenti (e distinguere ad esempi una pstazine che fa le ricariche dalla pstazine Gerì Retail che fa i mvimenti). Impstazini di inseriment: E pssibile definire le impstazini di default della data di scadenza nella creazine di nuve card. Si può scegliere fra le pzini: Scadenza tessera in data fissa prestabilita. Scadenza data dp un perid di temp prestabilit rispett alla data di inseriment. Nn impstare una data prestabilita. Impstazini mvimenti: Si specifican in questa sezine le Descrizini relative alle diverse causali pssibili sui vari mvimenti.
Altre funzini di amministrazine: DOCUMENTAZIONE TECNICA Pagine Pag. 12 di 22 Visualizza lg: permette di mstrare i lg dell'applicazine nel quale si pssn salvare le perazini sulle card effettuate da gni utente. BackUp DB: permette di effettuare un backup del database sul server e di prelevarl lcalmente. Attenzine: nnstante l spazi web preveda backups autmatici girnalieri, è respnsabilità dell utente effettuare peridicamente le cpie di backup del database a tutela dei prpri dati inseriti. Dwnlad BackUp DB: preleva il file di backup generat cn l appsita pzine. Tale file nn è utilizzabile direttamente ma sl cn SQL Management Studi. Mailing list clienti: permette di prelevare un file di tip CSV (test delimitat da ; ) cntenente tutti i dati dell anagrafica dei clienti cn, per ciascun, anche l infrmazine sul numer di card pssedute, il ttale dei punti attivi e il sald glbale prepagat del cliente. Prfili carte: permette di gestire i prfili delle carte mdificand eliminand un prfil esistente creandne un nuv. La gestine del prfil è mlt imprtante per il cllegament cn gli applicativi Lasersft. Vengn richiesti seguenti dati Descrizine della tiplgia Tip: Prmzinale ppure Prepagata Le seguenti impstazini vengn utilizzate in Gerì Autmatin: Scnt %: scnt che la card applica autmaticamente (gestit in Gerì Autmatin) Punti Valre/Sglia Valre: attribuisce X punti gni Y sglia Punti Quantità/Sglia Quantità: attribuisce X punti gni Y sglia Listin Gerì: indicare il NOME del listin presente in Gerì, per applicare alla card un listin specific (ad esempi se in Gerì è cdificat un listin dal nme Listin3 ppure Listin Card, sarà quell nme che va inserit in quest camp. Nta bene: il nme deve crrispndere esattamente (fare attenzine a maiuscle/minuscle). In Retail Shp Autmatin, l applicazine di scnti punteggi è cnfigurata direttamente nel gestinale, tramite l utilizz del prfil card fidelity e/ prfil pagament, pertant essi si attiverann inserend negli appsiti campi Fidelity Retail e Pagament retail i NOMI dei prfili esistenti in Retail Shp Autmatin che si vglin assciare alla presente tiplgia di card.
Pagine Pag. 13 di 22 Lettri Card: permette di cnfigurare l'applicazine per gestire le smart card. Abilita Card Reader: cnfigura le card di tip chip card: per esse impstare La tiplgia di lettre (EZ100) e il nme del lettre di default La 'Tiplgia gestine': individua il cmprtament da adttare in fase di inseriment card quand si preme sul pulsante del lettre smart card. Nel cas di tiplgia lettura il numer di card viene lett dalla smart card inserita nel lettre partend dalla psizine specificata nel camp ffset per il numer di caratteri impstat nel camp numer caratteri. Nel cas di tiplgia scrittura invece il sistema genera il numer di card successiv all'ultim creat e l scrive nella smart card partend dalla psizine specificata nel camp ffset per il numer di caratteri impstat nel camp numer caratteri. Nta Bene: per pter scrivere sulle card bisgna cnscere e impstare il PIN di access alle smart card. Abilita traspnder: cnfigura le card di tip Traspnder: per esse va impstata la tiplgia di lettre (sn gestiti i mdelli AV005 USB e InFrYu) e la prta COM virtuale alla quale è cllegat il lettre. Abilita SMS Card: per utilizzare il sistema di invi tramite SMS dell immagine della card fidelity. Il sistema prevede l interfacciament cn un telefn cellulare cn SIM abilitata all invi dei messaggi e una appsita cnfigurazine. Vedi appendice SmsCard.
Pagine Pag. 14 di 22 Utenti: permette di attivare e gestire gli utenti per accedere ai servizi frniti dall'applicazine La prima vlta che si preme il bttne viene chiest di inserire la passwrd per l'utente ADMIN che è il super user dell'applicazine. Una vlta creat il super user si ha access all'interfaccia per la gestine e la creazine dei nuvi utenti: I permessi dispnibili sn: Lettura: sempre abilitat. Inseriment card. Mdifica card. Inseriment mvimenti. Amministrazine. Cnsultazini. Attiva lg sulle perazini effettuate dall'utente. Il bttne 'Nuv' permette di inserire un nuv utente. Il bttne 'Salva' permette di mdificare l'utente selezinat. Il bttne 'Elimina' permette di eliminare l'utente selezinat (L'utente ADMIN e l'utente crrentemente lggat nn pssn essere eliminati). Il bttne 'Pwd' permette di mdificare la passwrd per l'utente selezinat.
Pagine Pag. 15 di 22 CONSULTAZIONI La scheda di cnsultazini permette di visualizzare le perazini effettuate da una determinata pstazine nell'arc di temp selezinat dall'utente. Le infrmazini sn raggruppate a secnda della tiplgia di mvimenti e la pstazine che li ha effettuati. Il bttne 'crea reprt' mstra un riepilg stampabile delle cnsultazini visualizzate:
Pagine Pag. 16 di 22 MODULO CUSTOMER WEB Il mdul web utente permette al pssessre della card di pter accedere via internet ad un area riservata per visualizzare i prpri mvimenti e le infrmazini sulla sua card. Tale predispsizine viene effettuata direttamente da LASERSOFT nell area web. Manuale di utilizz Custmer Web Accedend all'indirizz internet su cui risiede il web si aprirà la pagina seguente (vviamente sarà pssibile inserire il prpri lg persnalizzat). L'utente inserirà la email cn la quale è stat registrat all'att della creazine della card e la passwrd che gli è stata assegnata. Nel cas in cui la passwrd fsse stata dimenticata l'utente ptrà richiederla cliccand il link appsit. Una vlta effettuat l'access si accederà all'area riservata. In alt a destra è presente un menu che permette di cambiare la passwrd crrente di uscire dall'area riservata.
Pagine Pag. 17 di 22 Per visualizzare i mvimenti della card selezinare la card dal menu a tendina e il perid. Quindi premere il tast visualizza. Verrà creata una pagina in cui vengn mstrati tutti i mvimenti della card, sia relativamente agli imprti, a credit a debit, che ai punti. Per gni mviment è indicata la data, la Causale, la Descrizine, l rigine (ciè il nme della pstazine che ha riginat l addebit), l imprt e gli eventuali punti.
Pagine Pag. 18 di 22 Cnfigurazine Parametri Gestine WebCard su LASERCONFIG (per Htel/Gerì Autmatin) Il sistema di CARD REMOTO è supprtat a partire dalla versine 3.12.0.1372. Nel prgramma di cnfigurazine LASERCONFIG, sezine Dispsitivi Esterni, Gestine Card è pssibile abilitare la Gestine Card Remte I parametri da inserire sn: Tip: indicare WebCard Lasersft Utente: utente dell applicazine Card Manager Passwrd: passwrd dell utente WSDL URL: indirizz pubblic di access al database Cliente Fittizi Card: Abbinare una anagrafica cliente fittizia (ad es. Cliente Generic Card ) alla quale verrann assciati, In Gerì/Htel Autmatin, i mvimenti delle card remte (distinti per card). Il cliente deve essere stat già precedentemente cdificat in anagrafica clienti. Nta: Quand viene utilizzat il tast CARD al termine di un cnt, Gerì visualizza a vide il sald precedente (alla lettura della card) e il sald finale (a cnt stampat). Nn è pssibile stampare sul dcument i dati aggirnati della card, che sn invece dispnibili nline (e cnsultabili dal cliente via web).
Pagine Pag. 19 di 22 Cnfigurazine Parametri Gestine WebCard su Retail Shp Autmatin Il sistema di CARD REMOTO è supprtat a partire dalla versine 2.0.0. In Cnfigurazine Parametri, sezine Card, è pssibile abilitare la Gestine Card Remte. I parametri da inserire sn: Tip: indicare WebCard Lasersft Cliente di appggi: Abbinare una anagrafica cliente fittizia (ad es. Cliente Generic Card ) alla quale verrann assciati, in Retail, i mvimenti delle card remte (distinti per card). Web service: indirizz pubblic di access al database Utente: utente dell applicazine Card Manager Passwrd: passwrd dell utente Nta bene: i prfili di Card Fidelity di Card Pagament (che vann creati dalle appsite vci in Retail) devn pi essere assciati alla card nel Pannell di Amminstrazine Prfili Carte.
Pagine Pag. 20 di 22 APPENDICE: SMS CARD Caratteristiche: L'utilizz del telefnin cellulare al pst della tradizinale card di plastica, sia essa chipcard card traspnder, nasce dall esigenza di dematerializzare il cncett di card, trasfrmandla in una immagine digitale che può essere cnservata sui mderni telefni cellulari. In pratica, cn quest sistema, l utente finale riceverà sul prpri telefnin l immagine cn il cdice a barre della prpria card fidelity e pertant, quand dvrà utilizzarla al punt vendita, al pst di esibire la card mstrerà il crrispndente cdice a barre memrizzat sul telefn, che ptrà essere lett direttamente dal lettre barcde della cassa. Prerequisiti Per utilizzare il mdul per l'invi degli sms è necessari cllegare un telefn cellulare munit di sim al prpri cmputer. Il cmputer deve cnnettere il dispsitiv attravers una COM (tipicamente una prta seriale virtuale) e deve essere vist dal pc cme un mdem. Slitamente nei CD di installazine presenti all'intern delle cnfezini dei cellulari sn presenti i driver che permettn la cnnessine del telefnin cn il sistema perativ del cmputer. Da ntare che questa è una prergativa che frnisce direttamente il prduttre del telefnin. Il servizi che generera l immagine della card risiede su un web server di Lasersft: pertant per il funzinament del sistema è necessaria la cnnessine ad Internet. Il prerequisit per l utente finale è di avere un cellulare cnfigurat per la cnnessine ad Internet, in quant deve effettuare, una tantum, il cllegament per il dwnlad dell immagine barcde della sua card, immagine che dvrà pi salvare nella memria del prpri telefnin. Cnfigurazine All'intern del frm di cnfigurazine delle smart card la sezine 'Abilita SMS Card' permette di gestire l'invi del cdice della card sul telefnin del cliente via SMS. Premend il tast 'Cnfigura' si accede all'interfaccia di cnfigurazine per l'invi degli sms.
La cnfigurazine è suddivisa in tre parti: DOCUMENTAZIONE TECNICA Pagine Pag. 21 di 22 Cnnessine alla sim: questa sezine permette di impstare i dati relativi alla cnnessine cn la sim del telefnin. I parametri da inserire sn: Prta cm: indica la prta cm cn la quale il dispsitiv si è cnness al sistema perativ. Baudrate: indica il baudrate da utilizzare durante la cnnessine. E' cnsigliat di nn mdificare il valre di default (9600). Timeut: indica il timeut di cnnessine al telefnin espress in millisecndi. E' cnsigliabile di nn mdificare il valre di default 5000. Operatre: peratre telefnic della sim. Quest dat nn è essenziale ed è legat al camp SMSC spiegat in seguit. SMSC: indica il numer di telefn del centr messaggi dell'peratre. Quest dat è essenziale per inviare i messaggi. Quand viene selezinat l'peratre il camp impsta autmaticamente il numer predefinit per tale peratre, che va tuttavia verificat press il prvider telefnic. Unicde: indica se inviare i messaggi cn la cdifica unicde. Generazine barcde: in questa sezine si impstan i dati relativi alla generazine del cdice a barre. Intestazine: intestazine da mstrare spra il cdice a barre generat. Tip Barcde: tip di barcde da generare, 3 f 9 Barcde ppure QRCde. Tip Link: tip di link da inviare cme messaggi. Le pssibilità sn image html. Image invia il link dirett all'immagine, mentre html invia un link ad una pagina html cntenente l'immagine. Generali: in questa sezine si impstan alcuni dati relativi all'applicazine. Captin: è il titl della finestra dell'applicazine dell'invi degli sms quand si avvia in mdalità nn silente. URL: è l'url del servizi che genera i barcde. Deve essere http://smsservice.lasersft.it/bcservice.asmx Shw frm: indica se mstrare il frm di invi sms prima di mandare il messaggi. Se nn impstat e la cnfigurazine l permette, l'invi del messaggi sarà silente. Il bttne 'Test invi SMS' invia un messaggi di prva per verificare che le impstazini sian crrette.
UTILIZZO DI SMS CARD cn GERI /BEAUTY AUTOMATION DOCUMENTAZIONE TECNICA Pagine Pag. 22 di 22 ATTENZIONE: Per l attivazine di questa funzine ccrre abilitare il mdul SMS 1) Attivazine della mdalità SMS CARD: nel prgramma LASERCONFIG, Dispsitivi Esterni, Gestine Card, abiltiare la casella SMS Card e prcedere alla cnfigurazine del prgramma di spedizine SMS cme indicat alle pagine precedenti. Abilitare in cntempranea anche la gestine card in Emulazine Tastiera, per la lettura del cdice a barre che verrà inviat sul telefn cellulare del cliente. 2) Durante la generazine di una nuva card, un appsit tast (che appare sl se è stat attivat il mdul SMS) cnsente di determinare il cdice della card, che sarà quell che, trasfrmat in cdice a barre, verrà inviat per SMS al cliente. Requisit necessari è che nell anagrafica del cliente sia presente il numer di telefn cellulare, inserit senza spazi, trattini, barre altri simbli di punteggiatura. Definit il prfil della card a livell di tiplgia, scnti, ecc. premend il tast PROGRAMMA CARD verrà richiesta cnferma per inviare l SMS al cliente. Sul PC devn essere presenti i prerequisiti illustrati nelle pagime precedenti. 3) Qualra si vlesse reinviare l SMS in un secnd mment, è pssibile farl premend l appsit pulsante (che appare sl se è stat attivat il mdul SMS) REINVIA SMS CARD dalla lista delle card del cliente. 4) Durante il pagament di un cnt, premend il tradizinale tast card, per la lettura della card ccrrerà leggere cn il lettre barcde l immagine del cdice a barre che il cliente mstrerà visualizzata sul prpri telefnin.