Modulo InWEB di InFarmaClick. Specifiche tecniche per l interfacciamento con i software gestionali di farmacia. Livello API 2005.

Transcript

1 1 di 10 Progetto Specifiche tecniche per l interfacciamento con i software gestionali di farmacia Livello API MODULO MD-DOC05-INFARMA REVISIONE MODULO Rev 0 del 05/02/02 EMESSO DA: Bottaioli A DOCUMENTO Rev 00 del ALLEGATI N 0 NOME FILE ST -Interfacciamento Modulo InWEB - Rev 00doc ARCHIVIATO SU J:\sviluppo\documentazione\InFarmaClick\API SpecificheInterfacciamento\ST - Interfacciamento Modulo InWEB - Rev 00doc

2 2 di 10 Indice dei contenuti INDICE DEI CONTENUTI 2 IL PROGETTO TSINWEB 3 POSSIBILITÀ DI INTERFACCIAMENTO CON I SOFTWARE GESTIONALI PER FARMACIE 4 LOGIN AUTOMATICO 5 RICHIESTA DISPONIBILITÀ E ORDINE7

3 Il progetto TSInWEB 3 di 10 TSInWEB è un modulo di un ampio progetto di comunicazioni, chiamato InFarmaClick ( realizzato da infarma, per standardizzare le comunicazioni tra farmacia e grossista e tra grossista e case farmaceutiche TSInWEB è una piattaforma di commercio elettronico per la farmacia, che consente di avere on-line, 24 ore su 24, le disponibilità dei prodotti del proprio grossista, permettendo al contempo di ordinare i prodotti stessi L interfaccia intuitiva (realizzata secondo le usuali modalità di accesso ad Internet) e le funzionalità molto simili a quelle utilizzate dai principali programmi di gestione farmacia, permettono di accorciare la fase iniziale di apprendimento e di rendere subito operativo questo nuovo strumento in farmacia Si entra nel sito con pochi clic del mouse e si può navigare all interno di esso non solo per reperire la maggior parte delle informazioni che regolano i rapporti commerciali, amministrativi e logistici con il grossista, ma anche per acquistare on-line i prodotti, superando quindi quei limiti imposti dalla classica trasmissione dell ordine via modem o via telefono I servizi attualmente disponibili su TSInWEB sono: - richiesta disponibilità di un prodotto e relativo ordine (nella ricerca viene utilizzata l'anagrafica prodotti del grossista o la banca dati di riferimento della farmacia), - gestione ordini prodotti omeopatici, - possibilità di inserire un ordine come urgente, - possibilità di prenotare un prodotto non disponibile in magazzino, - possibilità di ricerca tra prodotti similari, - visualizzazione della scheda commerciale del prodotto, con numerose informazioni, - possibilità di visualizzare, in formato grafico, le offerte commerciali proposte dal grossista, con relativa gestione dell acquisto on line, - visualizzazione del listino specifico della farmacia, - visualizzazione dello stato degli ordini in portafoglio (sia trasmessi via web che tramite fax o modem), - visualizzazione della situazione dei resi, - estratto conto delle fatture scadute o in scadenza - possibilità di inoltrare comunicazioni al corriere a mezzo SMS In definitiva TSInWEB permette alla farmacia di avere un contatto diretto ed efficace con il grossista, riducendo le attività oggi manuali, ottimizzando le risorse e consentendole di concentrarsi sulla propria missione di servizio al cliente

4 4 di 10 Possibilità di interfacciamento con i software gestionali per farmacie TSInWEB nasce per essere utilizzato all interno di un browser ed è indipendente sia dalla piattaforma hardware e software della farmacia Per venire incontro alle esigenze di integrazione è possibile pilotare il funzionamento di TSInWEB all interno di un gestionale di farmacia, richiamando delle Url opportunamente composte Il livello di interfacciamento che si può raggiungere in questo modalità riguarda: o Login automatico o Richiesta disponibilità o Ordine o Download della conferma d ordine Contenuto della documentazione Il presente documento descrive, nel dettaglio, il protocollo di comunicazione InFarmaClick InWEB Le specifiche fanno riferimento, sempre, ad un livello di API, ossia ad una particolare versione del protocollo di comunicazione Il livello API viene indicato da 4 caratteri che rappresentano la release di InFarmaClick (es: 2005) e da 3 numeri che rappresentano la revisione del protocollo (es: 001) La documentazione oggetto di questo documento è allineata al livello di API Il server InWEB, per garantire la compatibilità con il passato, supporterà sempre, oltre alla versione corrente 1 del protocollo di comunicazione, anche le due versioni precedenti Eventuali errori nella presente documentazione verranno tempestivamente comunicati a tutte le software house che hanno aderito al progetto Ogni modifica della documentazione comporterà il cambiamento del numero di Revisione di documento presente sulla copertina Per facilitare gli sviluppatori verrà inserito, a partire dalle revisioni di documento successive alla 00, un capitolo che descrive le variazioni rispetto alla versione precedente del documento stesso 1 Il livello di API è la prima versione ufficialmente supportata da Infarma

5 5 di 10 Login Automatico E possibile automatizzare la fase di login, liberando il farmacista dall onere di inserire, ogni volta, username e password per accedere a TSInWEB Il grossista, generalmente fornisce alla farmacia, un modulo di attivazione, con indicato: o Url da richiamare o Username o Password La Url da richiamare, per il login automatico, dovrà essere così composta: Url TSInWEB /inweb/html/login/loginphp?user= Username associato alla farmacia &passwd= Password associata alla farmacia (parametro case sensitive) Supponendo che la url del sito TSInWEB del grossista sia: e che nome utente e password siano rispettivamente user1234 e pass1234, la Url da richiamare per il login automatico sarà:

6 6 di 10 Se i dati sono stati inseriti correttamente, comparirà la home page di TSInWEB: TSInWEB permette a più terminali di collegarsi contemporaneamente con le stesse credenziali di accesso (Username e Password) quindi, potenzialmente, tutti i terminali della farmacia possono essere contemporaneamente collegati Per tracciare l attività dei singoli terminali, all interno della stessa farmacia, è possibile richiedere al grossista più utenti, associati alla stessa ragione sociale Dopo un periodo di inattività, TSInWEB scollega l utente, ed è quindi necessario effettuare nuovamente il login

7 7 di 10 Richiesta disponibilità e ordine Componendo opportunamente la url di chiamata di TSInWEB è possibile richiedere la disponibilità di un prodotto ed, eventualmente ordinarlo, dando la possibilità al gestionale di farmacia di effettuare il download di un file XML con il dettaglio dell ordine appena inviato La Url da richiamare, per la richiesta di disponibilità, dovrà essere così composta: Url TSInWEB /inweb/html/login/loginphp?user= Username associato alla farmacia &passwd= Password associata alla farmacia (parametro case sensitive) &deposito= Codice numerico associato al deposito del grossista &action=003 &prodotto= Codice ministeriale oppure EAN del prodotto &quantita= Quantità richiesta del prodotto

8 8 di 10 Supponendo che la url del sito TSInWEB del grossista sia: e che nome utente e password siano rispettivamente user1234 e pass1234 e che si voglia fare la richiesta di disponibilità di 4 aulin, la Url da richiamare dovrà essere così composta: eposito=5&action=003&prodotto= &quantita=4 Se i parametri sono stati inseriti correttamente, comparirà una pagina simile alla seguente: L utente, a questo punto, ha la possibilità di richiedere ulteriori informazioni commerciali sul prodotto, cliccando sull icona ; può chiudere la finestra ed uscire da TSInWEB senza compiere nessuna operazione o può mettere il prodotto nel carrello cliccando sull icona Se l utente conferma l ordine, cliccando sull icona pagina web con il dettaglio dell ordine, viene visualizzata una Il software di farmacia, analizzando la url prodotta da TSInWEB, per la visualizzazione della conferma d ordine può conoscere il numero d ordine web associato (parametro ordineweb della Url)

9 9 di 10 Questo numero può essere utilizzato per effettuare un download in formato XML dell ordine, richiamando una Url così composta: Url TSInWEB /inweb/html/login/loginphp?user= Username associato alla farmacia &passwd= Password associata alla farmacia (parametro case sensitive) &deposito= Codice numerico associato al deposito del grossista &action=004 &ordineweb= Numero Ordine WEB

10 10 di 10 Si otterrà un file XML di risposta con il seguente tracciato: <?xml version="10" encoding="utf-8"?> <TSINWEB> <TITLE>Dettaglio ordine N BFW </TITLE> <DATAORDINE> </DATAORDINE> <ORAORDINE>160000</ORAORDINE> <DATACONSEGNA> </DATACONSEGNA> <ORACONSEGNA>190000</ORACONSEGNA> <CORRIERE>Bottaioli Alessandro</CORRIERE> <DETTAGLIO> <ITEM> <CODICE> </CODICE> <DESCRIZIONE>ZANTAC SOLUB*20CPR 150MG</DESCRIZIONE> <QRICHIESTA>1</QRICHIESTA> <QORDINATA>1</QORDINATA> <QOMAGGIO>0</QOMAGGIO> <SCONTO>3000</SCONTO> <MOTIVAZIONE></MOTIVAZIONE> <PREZZOPUBBLICO>1566</PREZZOPUBBLICO> <PREZZONETTO>99682</PREZZONETTO> <CODICEOMAGGIO></CODICEOMAGGIO> <QALTROOMAGGIO></QALTROOMAGGIO> <IMPORTORIGA>99682</IMPORTORIGA> </ITEM> <ITEM> <CODICE> </CODICE> <DESCRIZIONE>AULIN MITE*OS GRAT 30BUST 50MG</DESCRIZIONE> <QRICHIESTA>4</QRICHIESTA> <QORDINATA>4</QORDINATA> <QOMAGGIO>0</QOMAGGIO> <SCONTO>3000</SCONTO> <MOTIVAZIONE></MOTIVAZIONE> <PREZZOPUBBLICO>615</PREZZOPUBBLICO> <PREZZONETTO>39131</PREZZONETTO> <CODICEOMAGGIO></CODICEOMAGGIO> <QALTROOMAGGIO></QALTROOMAGGIO> <IMPORTORIGA>156523</IMPORTORIGA> </ITEM> </DETTAGLIO> <VALOREORDINE>256205</VALOREORDINE> </TSINWEB>