Modello SOA del Servizio DCR online -...

SIRFARMA Modello SOA del Servizio DCR online

SSW_DDD_DCR_SOA Ver. 2.0 del 29/01/2009

Documento di proprietà di LAit S.p.A. Pagina 1 di 31

Progetto SIRFARMA Modello SOA del Servizio DCR online SSW_DDD_DCR_SOA Versione 2.0 del 29/01/2009

LAIT – LAZIO INNOVAZIONE TECNOLOGICA.

Sede legale: Via Rosa Raimondi Garibaldi, 7 - 00145 Roma

Sede operativa: Via Adelaide Bono Cairoli, 68 – 00145 Roma

Tel: 06/51689800 www.laitspa.it

http://www.laitspa.it/




Redazione Data Firma

Dario D’Antoni 29/01/2009

Verifica e Approvazione Data Firma

Paolo Risso




Registro delle Edizioni e delle Revisioni

Ediz. /Rev. Data Descrizione modifiche

1.0 05/02/08 Prima versione del documento

1.1 27/10/07 sendDCR invia effettivamente una DCR alla ASL

1.2 20/11/07 SSO di tipo xs:String sendDCR aggiunto parametro DCR_IN

1.3 29/11/07 Completata la descrizione testuale introduttiva

1.4 30/11/07

- cambiato tipi dati da PositiveInteger a nonNegativeInteger - eliminato getAliquote - eliminato getDCRAnnoList - eliminato getDCRCompetenza

1.5 03/12/07 Da PositiveInteger a nonNegativeInteger

1.6 10/12/07 Modificati gli stati della DCR

2.0 29/01/09 Aggiunto il capitolo 5 Reimpostato il layout del documento

Lista di distribuzione

Nome Organizzazione Ruolo

Fabio Cerqua LAit S.p.A. Project Manager Area “Tariffazione e Contenzioso” del Settore Farmaceutica

Dario D’Antoni Project Leader Area “Sviluppo ed Esercizio” del Settore Farmaceutica

Giuseppe Leone LAit S.p.A. Project Manager Area “Sviluppo ed Esercizio” del Settore Farmaceutica

Paolo Risso LAit S.p.A. Responsabile “Settore Farmaceutica”




Riferimenti Cod. Oggetto del documento Data Nome file/URL Originatore

01

Linee guida sulla qualità dei beni e dei servizi ICT per la definizione ed il governo dei contratti della Pubblica Amministrazione

08/05 CNIPA

02 Modelli per la qualità delle forniture ICT 01/06 CNIPA

03 UML 2.1 http://www.omg.or/uml OMG

04 PIM httpp://www.omg.org/mda OMG

05 WSDL 1.1 http://www.w3.org/TR/wsdl W3

06 XSD http://www.w3.org/TR/xmlschema-0/ W3

07 SOAP 1.1 http://www.w3.org/TR/2000/NOTE-SOAP-20000508/ W3

08 WS-I 1.1 http://www.ws-i.org/

09

10

11

12




Indice

Indice .................................................................................................................................................................. 5 1 INTRODUZIONE ......................................................................................................................................... 6

1.1 Scopo ................................................................................................................................................ 6 1.2 Struttura del documento .................................................................................................................... 6 1.3 Approccio .......................................................................................................................................... 6

2 I WSDL ........................................................................................................................................................ 7 3 IL SERVIZIO DCR_Business_Object_Model ............................................................................................. 8

3.1 Servizi per la DCROnLine ................................................................................................................. 8 3.2 DCR ................................................................................................................................................... 9 3.3 DCR_in ............................................................................................................................................ 10 3.4 RigaMazzetta .................................................................................................................................. 11 3.5 Sconto ............................................................................................................................................. 12 3.6 Aifa .................................................................................................................................................. 12 3.7 FD_in ............................................................................................................................................... 13 3.8 DCR_out .......................................................................................................................................... 13 3.9 FA_rigaMazzetta ............................................................................................................................. 16 3.10 FB_Sconto ....................................................................................................................................... 16 3.11 FB_riga ............................................................................................................................................ 17 3.12 FC .................................................................................................................................................... 17 3.13 FD .................................................................................................................................................... 18 3.14 FD_AssistenzaIntegrativaRegionale ............................................................................................... 20 3.15 FD_SpecialitaMedicinaliGalenici ..................................................................................................... 22 3.16 ScontoPayBack ............................................................................................................................... 23 3.17 StatoDCR ........................................................................................................................................ 24 3.18 TipoFarmacoList .............................................................................................................................. 25 3.19 Commons ........................................................................................................................................ 25 3.20 Credential ........................................................................................................................................ 25 3.21 Fault................................................................................................................................................. 26 3.22 Others .............................................................................................................................................. 26 3.23 AliquotaList ...................................................................................................................................... 26 3.24 DCRList ........................................................................................................................................... 26

4 IL SERVIZIO SendRettifiche ..................................................................................................................... 28 4.1 Servizi per la DCROnLine ............................................................................................................... 28 4.2 SendRettifiche ................................................................................................................................. 28 4.3 TotaliRettificheWs ........................................................................................................................... 28 4.4 SendRettificheResponse ................................................................................................................. 30 4.5 boolean ............................................................................................................................................ 31




1 INTRODUZIONE

1.1 Scopo Il servizio descritto in questo documento si inserisce all'interno del progetto Sirfarma. La DCR ONLine nel rispetto di un Maturity Model quale il sistema S.I.R.FARMA va ad instaurarsi e dove il sottosistema DCROnLine ne è parte integrante, espone un certo numero di servizi atti all’invio e al reperimento di una o più DCR. Il servizio “DCR on line” attraverso un'interfaccia Web Service viene offerto al software delle farmacie e agli enti da essi delegati. L'obiettivo è di facilitare la creazione della DCR, centralizzare la sua validazione, fornire I dati per la tariffazione ed il contenzioso ed inviarla in forma elettronica alla ASL di competenza. Questo sistema permetterà un più celere rimborso favorendo una rendicontazione in tempo reale. Il sistema quindi alleggerisce il carico implementativo dei software attualmente esistenti in quanto le regole di validazione e di tariffazione sono fornite direttamente dalle ASL. In questo modo si evitano errori e ritardi nei processi di rimborso.

1.2 Struttura del documento Questo documento descrive in modalità Platform Specific (PSM) la struttura dati ed i servizi che saranno esporti per il servizio di creazione di una DCR. Da questo modello è stato generato il file WSDL che contiene anche lo schema dei tipi di dato usati. E' rilevante evidenziare che la struttura dati ha due principali gerarchie: una quando si usa la DCR in output (DCR_out) ed una input (DCR_in). Mentre la prima è più articolata e complessa perchè contiene tutti i dati calcolati e i dati non disponibili all'utente come gli importi delle rettifiche, il secondo è più elementare contenendo solo i dati essenziali per la redazione. Il documento è organizzato per package, “DCR_Business_Object_Model” contiene l'intero modello della “DCR on line”, il diagramma successivo contiene le entità più significative. “DCR_online” è l'interfaccia dei servizi esposti. DCR_in_model e DCR_out_model sono i package che contengono I tipi di dato che sono usati rispettivamente come parametri di input e di output dei servizi.

1.3 Approccio La DCR durante il processo di lavorazione, cioè dalla sua creazione alla sua approvazione, transita per diversi stati che ne caratterizzano i passaggi all’interno del sistema informatico. La DCR, viene creata ed inviata con una sola operazione, “sendDCR”, se l'operazione è andata a buon fine, cioè se tutte le regole di validazione sono eseguite con successo, la DCR viene creata e ad essa viene assegnato lo stato di “INVIATA”. Dopo l'eventuale approvazione del funzionario della ASL, passerà in stato “APPROVATA”. Tutte le operations tornano un oggetto di tipo “Fault”, che contiene la descrizione dell'eventuale errore. I servizi esposti richiedono l'autenticazione che viene realizzata tramite I meccanismi e gli strumenti di Single Sign On (SSO), per questo il token di autenticazione deve essere inviato per ogni operazione all'interno del parametro “Credentials”. Il SSO non è descritto in questo document ma si rimanda per esso alla specifica documentazione Sun Microsystem.




2 I WSDL I servizi che la DCRONLine espone e contenuti negli XML descrittivi, sono reperibili agli indirizzi sotto riportati. Ogni servizio viene nel dettaglio spiegato nei capitoli successivi. Il loro WSDL per l’invio dei una DCR è reperibile dall’indirizzo: http://www.regione.lazio.it/sirfarmatest/WEBDCROnLine/services/DCR_Business_Object_Model?wsdl Il loro WSDL per l’invio delle rettifiche è reperibile dall’indirizzo: http://www.regione.lazio.it/sirfarmatest/WEBDCROnLine/services/SendRettifiche?wsdl Le modalità di caricamento del WSDL sono dipententi dal tools di sviluppo. Al manuale di quest’ultimo si rimanda per poter caricare il WSDL ed implementare il client di chiamata.

http://www.regione.lazio.it/sirfarmatest/WEBDCROnLine/services/DCR_Business_Object_Model?wsdl

http://www.regione.lazio.it/sirfarmatest/WEBDCROnLine/services/DCR_Business_Object_Model?wsdl

http://www.regione.lazio.it/sirfarmatest/WEBDCROnLine/services/SendRettifiche?wsdl




3 IL SERVIZIO DCR_BUSINESS_OBJECT_MODEL

3.1 Servizi per la DCROnLine È l'nterfaccia del servizio SOA, che sarà stateless, quindi ogni chiamata non conserva lo stato della sessione quindi l'implementazione non distingue tra chiamate successive originanti dalla stessa applicazione. Questo garantisce maggiore velocità e maggio semplicità. Il servizio serve per creare delle DCR e, una volta corrette, inviarle al sistema. Di seguito vengono elencate le operazioni possibili per questo servizio. Operazioni Metodo Note Parametri sendDCR() void Public

La DCR, viene creata ed inviata con una sola operazione, se l'operazione è andata a buon fine, cioè se tutte le regole di validazione sono eseguite con successo, la DCR viene creata e prende lo stato di Inviata. Dopo l'eventuale approvazione del funzionario della ASL, passerà in stato Chiusa. Una volta quindi eseguita con successo l'operazione la DCR non potrà più essere modificata ulteriormente. Torna l'ID della DCR solo se questa è corretta.

Credentials [in] user_cred DCR_in [in] DCR ID [out] DCR_id E' l'ID della DCR, viene tornato solo se la DCR è corretta, il suo valore altrimenti è vuoto. Fault [out] sendFault Il dato di ritorno di tipo Fault conterrà eventualmente la descrizione dell'errore oppure un messaggio di successo nel caso la DCR era corretta ed è stata salvata con successo.

getDCR() void Public

Questo Servizio torna una DCR completa con tutti i campi. Questa operazione può essere eseguita dalla farmacia designata oppure da Federfarma o chi per lei delegata, i controlli vengono fatti attraverso i dati del "credential",

Credentials [in] user_cred ID [in] DCR_id DCR_out [out] DCR

getDCRPDF() void Public

Questo servizio torna una DCR in formato PDF. I controlli sull’utente vengono fatti attraverso i dati del "credential",

Credentials [in] user_cred ID [in] DCR_id base64Binary [out] pdf

getFasceMedicinaliList() void Public

Questo servizo riporta l'elenco dei tipi farmaci. Esso sarà utilizzato dall'applicazione client che deve redigere la sezione A "Distinta delle mazzette". Questa operazione può essere eseguita dalla farmacia designata oppure da Federfarma o chi per lei delegata. I controlli vengono fatti attraverso i dati del "credential",

Credentials [in] user_credential TipoFarmacoList [out] tipoFarmaci




c l a s s D C R _ B u s i n e s s _ O b j e c t_ M o d e l

« W S D L se rvi ce »D C R _ B u s i n e s s _ O b j e c t_ M o d e l

« W S D L b i n d i n g »B i n d i n g s :: D C R _ o n l i n e

+ g e t D C R (g e t D C R R e q u e st , g e t D C R R e sp o n se * )+ g e t D C R P D F (g e t D C R P D F R e q u e st , g e t D C R P D F R e sp o n se * )+ g e t F a sce M e d i ci n a l i L i st (g e t F a sce M e d i ci n a l i L i st R e q u e st , g e t F a sce M e d i ci n a l i L i st R e sp o n se * )+ se n d D C R (se n d D C R R e q u e st , se n d D C R R e sp o n se * )

D C R _ o n l i n e

3.2 DCR Sono stati creati due tipi di dato, uno per la DCR come viene vista per l'inserimento ed una per la lettura. Il primo contiene solo i dati essenziali per la creazione, senza alcun campo calcolato, nel secondo caso tutti dati, anche quelli calcolati per, necessary alla comprensione di una distinta.

c l a s s Ty p e s

« X S D co m p l e xT yp e »D C R _ o u t

« X S D e l e m e n t »+ a i f a : a i f a+ d a t a i n vi o : d a t e T i m e+ d c r_ i d : I D+ F A _ r i g a M a zze t t a : F A _ r i g a M a zze t t a [ 1 . . * ]+ F B _ S co n t o : F B _ S co n t o+ F C : F C+ F D : F D+ st a t o : S t a t o D C R

« X S D co m p l e xT yp e »D C R _ i n

« X S D e l e m e n t »+ a i f a : a i f a+ F D _ i n : F D _ i n [ 0 . . 1 ]+ r i g a M a zze t t a : R i g a M a zze t t a [ 1 . . * ]+ S c o n t o : S c o n t o [ 1 . . * ]

« X S D co m p l e xT yp e »D C R

« X S D e l e m e n t »+ i d _ f a rm a ci a : I D R E F+ n u m p a cch i : n o n N e g a t i ve I n t e g e r+ p e r i o d o co m p e t e n za : g Y e a rM o n t h

« X S D e xt e n si o n »« X S D e xt e n si o n »

Connections




Connector Source Target Notes Generalization Source -> Destination

Public DCR_out

Public DCR

Generalization Source -> Destination

Public DCR_in

Public DCR

Attributes Attribute Notes Constraints and tags id_farmacia IDREF Public «XSDelement»

l'id della farmacia a cui la DCR si riferiesce

Default: [maxOccurs = 1 ]

numpacchi nonNegativeInteger Public «XSDelement»

il numero di pacchi di ricette che saranno consegnati alla ASL assieme alla DCR


periodocompetenza gYearMonth Public «XSDelement»

Il periodo di competenza corrisponde ad un mese di un anno


3.3 DCR_in Diagramma delle classi per la DCR_in, usata per essere inviata al sistema

c lass Types

«X S Dco m p lexT yp e»FD_ in

«X S De lem en t»+ acco n toanno : deci m a l [0 ..1 ]+ anno tazi on i : string [0 ..1 ]+ ce ssioneCred i to : string [0 ..1 ]+ desca nnoacco n to : string [0 ..1 ]

«X S Dco m p lexT yp e»DCR _in

«X S De lem en t»+ a i fa : a i fa+ FD_ in : FD _ in [0 ..1 ]+ rigaM azze tta : Ri gaM azze tta [1 ..*]+ S co n to : S c on to [1 ..*]

«X S Dco m p lexT yp e»RigaM a zze tta

«X S De lem en t»+ fasci a : NM T O K E N+ lo rdo : deci m a l+ num rice tte : nonNega ti ve In tege r+ ti ck e t: deci m a l

«X S Dco m p lexT y. ..S co nto

«X S De lem en t»+ a l iquo ta : deci m a l+ lo rdo : deci m a l

«X S Dco m p lexT yp e»a ifa

«X S De lem en t»+ em ode riva ti : deci m a l+ fasci ac: deci m a l+ im po rto : deci m a l+ l i sta trasp : deci m a l+ ossigeno : deci m a l

Connections Connector Source Target Notes





Public DCR_in

Public DCR

Association Unspecified

Public FA_rigaMazzetta

Public DCR_in


Public DCR_in

Public FD_in


Public DCR_in

Public Sconto


Public DCR_in

Public aifa

Dependency Source -> Destination

Public sendDCRRequest

Public DCR_in

Attributes Attribute Notes Constraints and tags aifa aifa Public «XSDelement»


FD_in FD_in Public [0..1] «XSDelement»


rigaMazzetta RigaMazzetta Public [1..*] «XSDelement»

Default: [minOccurs = 1 ] [maxOccurs = unbounded ]

Sconto Sconto Public [1..*] «XSDelement»


3.4 RigaMazzetta Rappresenta la riga mazzetta

Connections Connector Source Target Notes Generalization Source -> Destination

Public RigaMazzetta

Public DCR_in

Attributes Attribute Notes Constraints and tags fascia NMTOKEN Public «XSDelement»

Ill codice che corrisponde al tipo di farmaco nella mazzetta, i codici da usare vengono dal servizio GetTipoFarmaco


lordo decimal Public «XSDelement»

valore totate in euro di una mazzetta





numricette nonNegativeInteger Public «XSDelement»

il numero di ricette contenute in una mazzetta


3.5 Sconto Corrisponde al form B della DCR Connections Connector Source Target Notes Generalization Source -> Destination

Public DCR_in

Public Sconto

Attributes Attribute Notes Constraints and tags aliquota decimal Public «XSDelement»

Percentuale dell'aliquota Default: [maxOccurs = 1 ]


importo in euro Default: [maxOccurs = 1 ]

3.6 Aifa Corrisponde al forum sub-B della DCR


Public DCR_in

Public aifa

Attributes Attribute Notes Constraints and tags emoderivati decimal Public «XSDelement»

valore in euro Default: [maxOccurs = 1 ]

fasciac decimal Public «XSDelement»


importo decimal Public «XSDelement»

importo minore o uguale a 5,00 euro,


listatrasp decimal Public «XSDelement»

lista trasparenza, importo in euro


ossigeno decimal importo in euro Default:




Public «XSDelement»

[maxOccurs = 1 ]

3.7 FD_in Rappresenta i campi da compilare per la form D della distinta.


Public DCR_in

Public FD_in

Attributes Attribute Notes Constraints and tags accontoanno decimal Public [0..1] «XSDelement»


annotazioni string Public [0..1] «XSDelement»


cessioneCredito string Public [0..1] «XSDelement»


descannoacconto string Public [0..1] «XSDelement»

Descrizione dell'anno per l'acconto


3.8 DCR_out Diagramma della DCR completa, quando viene usata per inviare una DCR all'applicazione richiedente


Public DCR_out

Public DCR

Association Destination -> Source


Public DCR_out


Public FB_Sconto

Public DCR_out

Association Source -> Destination

Public DCR_out

Public FC

Association Source -> Destination

Public DCR_out

Public FD

Dependency Public Public




Source -> Destination DCR_out StatoDCR Dependency Source -> Destination

Public DCR_out

Public DCRdto


Public DCR_out

Public UtenteDTO


Public getDCRResponse

Public DCR_out

Attributes Attribute Notes Constraints and tags aifa aifa Public «XSDelement»


datainvio dateTime Public «XSDelement»

data in cui la DCR è stata inviata alla ASL


dcr_id ID Public «XSDelement»

identificativo della DCR Default: [maxOccurs = 1 ]

FA_rigaMazzetta FA_rigaMazzetta Public [1..*] «XSDelement»


FB_Sconto FB_Sconto Public «XSDelement»


FC FC Public «XSDelement»


FD FD Public «XSDelement»


stato StatoDCR Public «XSDelement»

stato corrente della DCR Default: [maxOccurs = 1 ]




c l a s s Ty p e s

« e n u m e ra t i o n »S ta t o D C R

I n _ l a vo ra zi o n e I n vi a t a A p p ro va t a S b l o c ca t a A p p ro va t a _ C a rt a ce a I n _ l i q u i d a zi o n e L i q u i d a t a

« X S D co m p l e xT yp e »D C R _ o u t

« X S D e l e m e n t »+ a i f a : a i f a+ d a t a i n vi o : d a t e T i m e+ d c r_ i d : I D+ F A _ ri g a M a zze t t a : F A _ ri g a M a zze t t a [ 1 . . * ]+ F B _ S co n t o : F B _ S co n t o+ F C : F C+ F D : F D+ st a t o : S t a t o D C R

« X S D co m p l e xT yp e »F A _ r i g a M a zze tta

« X S D e l e m e n t »+ f a sci a : N M T O K E N+ l o rd o : d e ci m a l+ n u m e ro m a zze t t a : sh o rt+ t i ck e t : d e ci m a l

« X S D co m p l e xT y. . .F B _ r i g a

« X S D e l e m e n t »+ a l i q u o t a : d e ci m a l+ d e i va t o : d e ci m a l+ l o rd o : d e ci m a l+ sco n t o ssn : d e ci m a l

« X S D co m p l e xT yp e »F B _ S c o n to

« X S D e l e m e n t »+ a l i q u o t a m e d i a : d e ci m a l+ F B _ ri g a : F B _ ri g a [ 1 . . * ]+ l o rd o a sso g : d e ci m a l+ S c o n t o P a yB a ck : S co n t o P a yB a ck+ t o t a l e f a rm e scl : d e ci m a l+ t o t a l e sco n t o : d e ci m a l+ t o t a l e sco n t o ssn : d e ci m a l

« X S D co m p l e xT yp e »F C

« X S D e l e m e n t »+ l o rd o sm g : d e ci m a l+ n u m ri cs m g : n o n N e g a t i ve I n t e g e r+ t i ck e t sm g : d e ci m a l+ t o t a l e l o rd o ri ce t t e : d e ci m a l+ t o t a l e l o rd o ri ce t t e a ssi n t re g : d e ci m a l+ t o t a l e ri ce t t e : n o n N e g a t i ve I n t e g e r+ t o t a l e ri ce t t e a ssi n t re g : n o n N e g a t i ve I n t e g e r+ t o t a l e t i ck e t ri ce t t e : d e ci m a l+ t o t a l e t i ck e t ri ce t t e a ssi n t re g : d e ci m a l

« X S D co m p l e xT yp e »F D

« X S D e l e m e n t »+ a c co n t o a n n o : d e ci m a l+ a n n o t a zi o n i : st r i n g+ d c p co m p e n so l o rd o : d e ci m a l+ d c p i m p l o rd o : d e ci m a l+ d e sca n n o a cco n t o : st r i n g+ d e sca n n o re ca cc o n t o : st r i n g+ d p cn ri ce t t e : n o n N e g a t i ve I n t e g e r+ d p cr e t t i f i c a : d e ci m a l+ d p ct o t n e t t o : d e ci m a l+ F D _ A ssi st e n za I n t e g ra t i va R e g i o n a l e : F D _ A ssi st e n za I n t e g ra t i va R e g i o n a l e+ F D _ S p e ci a l i t a M e d i ci n a l i G a l e n i ci : F D _ S p e ci a l i t a M e d i ci n a l i G a l e n i ci+ i m p o rt o n e t t o a cc o n t o : d e ci m a l+ re cu p e ro a cco n t o : d e ci m a l+ t o t a l e n e t t o m e se : d e ci m a l

« X S D co m p l e xT yp e »F D _ A s s i s te n za I n te g r a ti v a R e g i o n a l e

« X S D e l e m e n t »+ d a t a n o t a re t t : d a t e [ 0 . . 1 ]+ l o rd o co n t e n z: d e ci m a l+ l o rd o re t t i f i c h e : d e ci m a l+ l o rd o t i ck e t i n t re g : d e ci m a l+ l o rd o t o t g e n 6 _ 1 0 : d e ci m a l+ l o rd o t o t i n t r e g : d e ci m a l+ m e se co n t e n z: g Y e a rM o n t h [ 0 . . 1 ]+ n e t t o re t t : d e ci m a l+ n e t t o t i ck e t i n t re g : d e ci m a l+ n e t t o t o t g e n 6 _ 1 0 : d e ci m a l+ n u m e ro ri ce t t e : n o n N e g a t i ve I n t e g e r+ n u m n o t a re t t : n o n N e g a t i ve I n t e g e r [ 0 . . 1 ]+ p e ri o d o re t t i f i ca : g Y e a rM o n t h [ 0 . . 1 ]+ p e ri o d o re t t i f i ca t ra t t : g Y e a rM o n t h [ 0 . . 1 ]+ re t t ra t t m e se c o n v: d e ci m a l+ re t t ra t t m e se e m p a f : d e ci m a l+ re t t ra t t m e se si n d : d e ci m a l+ t i ck e t co n t e n z: d e ci m a l+ t i ck e t re t t i f i ch e : d e ci m a l+ t i ck e t t o t g e n 6 _ 1 0 : d e ci m a l+ t o t a l e l o rd o : d e ci m a l+ t o t a l e n e t t o : d e ci m a l+ t o t a l e t i ck e t : d e ci m a l+ t o t a ssi n t e g ra t re g : d e ci m a l+ t ra t t r i g o 6 l o rd o co n v: d e ci m a l+ t ra t t r i g o 6 l o rd o e n p a f : d e ci m a l+ t ra t t r i g o 6 l o rd o si n d : d e ci m a l

« X S D co m p l e xT yp e »F D _ S p e c i a l i ta M e d i c i n a l i G a l e n i c i

« X S D e l e m e n t »+ d e scm e se re t t co n t : g Y e a rM o n t h [ 0 . . 1 ]+ d e scm e se re t t i f i ch e : g Y e a rM o n t h [ 0 . . 1 ]+ l o rd o re t t co n t e n z: d e ci m a l+ l o rd o re t t i f i c h e : d e ci m a l+ l o rd o t o t sp e cg a l re t t : d e ci m a l+ n e t t o t o t sp e cg a l re t t : d e ci m a l+ n u m ri ce t t e : n o n N e g a t i ve I n t e g e r+ t i ck e t re t t co n t e n z: d e ci m a l+ t i ck e t re t t i f i ch e : d e ci m a l+ t i ck e t t o t sp e cg a l re t t : d e ci m a l+ t o t a l e n e t t o t ra t t e n u t e : d e ci m a l+ t o t l o rd o re t t : d e ci m a l+ t o t l o rd o sp e cg a l e n i ci n o re t t : d e ci m a l+ t o t n e t t o sp e cg a l e n i ci n o re t t : d e ci m a l+ t o t t i ck e t sp e cg a l e n i ci n o re t t : d e ci m a l

« X S D co m p l e xT yp e »S c o n to P a y B a c k

« X S D e l e m e n t »+ l o rd o f a sci a c_ o ssi g : d e ci m a l+ l o rd o ssn : d e ci m a l+ p a yb a ck : d e ci m a l+ sco n t o 0 6 0 : d e ci m a l+ t o t a l e l o rd o : d e ci m a l+ t o t a l e l o rd o 0 6 0 : d e ci m a l+ t o t a l e l o rd o p a yb a ck : d e ci m a l+ t o t a l e l o rd o ssn : d e ci m a l+ va l o re re t t i f i ca 0 6 0 : d e ci m a l+ va l o re re t t i f i ca p a yb a ck : d e ci m a l+ va l o re re t t i f i ca ssn : d e ci m a l




3.9 FA_rigaMazzetta Riga di una mazzetta Connections Connector Source Target Notes Generalization Source -> Destination


Public DCR_out



Public DCR_in

Attributes Attribute Notes Constraints and tags fascia NMTOKEN Public «XSDelement»

Ill codice che corrisponde al tipo di farmaco nella mazzetta, i codici da usare vengono dal servizio GetTipoFarmaco




numeromazzetta short Public «XSDelement»

numero sequenziale di una mazzetta per tipo farmaco


ticket decimal Public «XSDelement»


3.10 FB_Sconto Corrisponde ai campi calcolati del form B


Public FB_Sconto

Public DCR_out


Public FB_Sconto

Public ScontoPayBack


Public FB_Sconto

Public FB_riga

Attributes Attribute Notes Constraints and tags aliquotamedia decimal Public «XSDelement»


FB_riga FB_riga Public [1..*] «XSDelement»


lordoassog decimal Public

diff tra totale et Farm esclusi Default:




«XSDelement»

[maxOccurs = 1 ]

ScontoPayBack ScontoPayBack Public «XSDelement»


totalefarmescl decimal Public «XSDelement»

totale da subForm Default: [maxOccurs = 1 ]

totalesconto decimal Public «XSDelement»


totalescontossn decimal Public «XSDelement»


3.11 FB_riga Corrisponde ad una righa del form B


Public FB_Sconto

Public FB_riga

Attributes Attribute Notes Constraints and tags aliquota decimal Public «XSDelement»

aliquota in % Default: [maxOccurs = 1 ]

deivato decimal Public «XSDelement»

importo in euro senza IVA Default: [maxOccurs = 1 ]


importo in euro del loro per aliquota


scontossn decimal Public «XSDelement»


3.12 FC Corrisponde al form C completamente calcolato

Connections Connector Source Target Notes





Public DCR_out

Public FC

Attributes Attribute Notes Constraints and tags lordosmg decimal Public «XSDelement»

Importo lordo Default: [maxOccurs = 1 ]

numricsmg nonNegativeInteger Public «XSDelement»


ticketsmg decimal Public «XSDelement»

Importo Tickets Default: [maxOccurs = 1 ]

totalelordoricette decimal Public «XSDelement»


totalelordoricetteassintreg decimal Public «XSDelement»

importo ticket in euro Default: [maxOccurs = 1 ]

totalericette nonNegativeInteger Public «XSDelement»

numero totale delle ricette associate alla DCR


totalericetteassintreg nonNegativeInteger Public «XSDelement»

numero totale delle ricette dell’assistenza integrativa regionale


totaleticketricette decimal Public «XSDelement»


totaleticketricetteassintreg decimal Public «XSDelement»

importo Lordo in euro dell’assistenza integrativa regionale


3.13 FD Form D della DCR, completamente calcolato


Public DCR_out

Public FD


Public FD

Public FD_AssistenzaIntegrativaRegionale

Generalization Public Public




Source -> Destination FD FD_SpecialitaMedicinaliGalenici Attributes Attribute Notes Constraints and tags accontoanno decimal Public «XSDelement»


annotazioni string Public «XSDelement»


dcpcompensolordo decimal Public «XSDelement»

Compenso lordo DPC Default: [maxOccurs = 1 ]

dcpimplordo decimal Public «XSDelement»

Importo lordo DPC Default: [maxOccurs = 1 ]

descannoacconto string Public «XSDelement»

Descrizione dell'anno per l'acconto


descannorecacconto string Public «XSDelement»

Descrizione dell'anno per il recupero acconto


dpcnricette nonNegativeInteger Public «XSDelement»

numero totale delle ricette DPC


dpcrettifica decimal Public «XSDelement»

Rettifica DPC Default: [maxOccurs = 1 ]

dpctotnetto decimal Public «XSDelement»

Totale netto DPC Default: [maxOccurs = 1 ]

FD_AssistenzaIntegrativaRegionale FD_AssistenzaIntegrativaRegionale Public «XSDelement»


FD_SpecialitaMedicinaliGalenici FD_SpecialitaMedicinaliGalenici Public «XSDelement»


importonettoacconto decimal Public «XSDelement»


recuperoacconto decimal Public «XSDelement»





totalenettomese decimal Public «XSDelement»


3.14 FD_AssistenzaIntegrativaRegionale Corrisponde alla sezione riguardante l’assistenza integrativa regionale presente nella form D


Public FD

Public FD_AssistenzaIntegrativaRegionale

Attributes Attribute Notes Constraints and tags datanotarett date Public [0..1] «XSDelement»

data nota rettifiche Default: [maxOccurs = 1 ]

lordocontenz decimal Public «XSDelement»

Lordo del mese di contenzioso


lordorettifiche decimal Public «XSDelement»

Totale lordo delle rettifiche Default: [maxOccurs = 1 ]

lordoticketintreg decimal Public «XSDelement»

Ticket del mese di contenzioso


lordototgen6_10 decimal Public «XSDelement»

Lordo totale generale rigo 6+10


lordototintreg decimal Public «XSDelement»

Lordo Totale integrativa Regionale


mesecontenz gYearMonth Public [0..1] «XSDelement»

Rettifiche del mese di contenzioso


nettorett decimal Public «XSDelement»

Nette delle rettifiche varie Default: [maxOccurs = 1 ]

nettoticketintreg decimal Public «XSDelement»

netto del mese di contenzioso Default: [maxOccurs = 1 ]

nettototgen6_10 decimal Public «XSDelement»

netto totale generale rigo 6+10


numeroricette numero delle ricette Default:




nonNegativeInteger Public «XSDelement»

[maxOccurs = 1 ]

numnotarett nonNegativeInteger Public [0..1] «XSDelement»

Numero nota rettifiche Default: [maxOccurs = 1 ]

periodorettifica gYearMonth Public [0..1] «XSDelement»


periodorettificatratt gYearMonth Public [0..1] «XSDelement»


rettrattmeseconv decimal Public «XSDelement»

Totale trattenute mese 0.02% CONV


rettrattmeseempaf decimal Public «XSDelement»

Totale trattenute mese 0.90% ENPAF


rettrattmesesind decimal Public «XSDelement»

Totale trattenute mese 0.00% SIND:


ticketcontenz decimal Public «XSDelement»

Ticket mese di contenzioso Default: [maxOccurs = 1 ]

ticketrettifiche decimal Public «XSDelement»

ticket delle rettifiche Default: [maxOccurs = 1 ]

tickettotgen6_10 decimal Public «XSDelement»

Ticket totale generale rigo 6+10


totalelordo decimal Public «XSDelement»


totalenetto decimal Public «XSDelement»


totaleticket decimal Public «XSDelement»


totassintegratreg decimal Public «XSDelement»

Totale netto assistenza integrativa regionale


trattrigo6lordoconv decimal Trattenute sul rigo 6 (lordo) Default:




Public «XSDelement»

0.02% CONV [maxOccurs = 1 ]

trattrigo6lordoenpaf decimal Public «XSDelement»

Trattenute sul rigo 6 (lordo) 0.90% ENPAF


trattrigo6lordosind decimal Public «XSDelement»

Trattenute sul rigo 6 (lordo) 0.00% SIND


3.15 FD_SpecialitaMedicinaliGalenici Form D della DCR, completamente calcolato, per la parte di specialità e galenici Connections Connector Source Target Notes Generalization Source -> Destination

Public FD

Public FD_SpecialitaMedicinaliGalenici

Attributes Attribute Notes Constraints and tags descmeserettcont gYearMonth Public [0..1] «XSDelement»

Mese ed anno di riferimento delle rettifiche di Contenzioso


descmeserettifiche gYearMonth Public [0..1] «XSDelement»

Mese ed anno di riferimento delle rettifiche


lordorettcontenz decimal Public «XSDelement»

Lordo rettifiche contenzioso Default: [maxOccurs = 1 ]

lordorettifiche decimal Public «XSDelement»

Lordo rettifiche Default: [maxOccurs = 1 ]

lordototspecgalrett decimal Public «XSDelement»

Totale lordo delle specialità rettificate


nettototspecgalrett decimal Public «XSDelement»

Totale netto delle specialità rettificate


numricette nonNegativeInteger Public «XSDelement»

Numero ricette delle spec. Medicinali e galenici


ticketrettcontenz decimal Public

Ticket rettifiche contenzioso Default:




«XSDelement»

[maxOccurs = 1 ]

ticketrettifiche decimal Public «XSDelement»

Ticket rettifiche Default: [maxOccurs = 1 ]

tickettotspecgalrett decimal Public «XSDelement»

Totale ticket delle specialità rettificate


totalenettotrattenute decimal Public «XSDelement»

Totale importo netto trattenute


totlordorett decimal Public «XSDelement»

Totale lordo rettificato Default: [maxOccurs = 1 ]

totlordospecgalenicinorett decimal Public «XSDelement»

Totale lordo senza rettifiche delle specialità medicinali e galenici


totnettospecgalenicinorett decimal Public «XSDelement»

Totale netto senza rettifiche delle specialità medicinali e galenici


totticketspecgalenicinorett decimal Public «XSDelement»

Totale ticket senza rettifiche delle specialità medicinali e galenici


3.16 ScontoPayBack Connections Connector Source Target Notes Generalization Source -> Destination

Public FB_Sconto

Public ScontoPayBack

Attributes Attribute Notes Constraints and tags lordofasciac_ossig decimal Public «XSDelement»


lordossn decimal Public «XSDelement»


payback decimal Public «XSDelement»

0.6%' Sconto Payback Default: [maxOccurs = 1 ]

sconto060 decimal Public

Sconto 0.60% Default:




«XSDelement»

[maxOccurs = 1 ]

totalelordo decimal Public «XSDelement»


totalelordo060 decimal Public «XSDelement»

Totale Lordo 060 applicata la rettifica


totalelordopayback decimal Public «XSDelement»

Totale Lordo Payback applicata la rettifica


totalelordossn decimal Public «XSDelement»

Totale Lordo SSN applicata la rettifica


valorerettifica060 decimal Public «XSDelement»

Rettifica da aggiungere o togliere allo sconto 0.60%


valorerettificapayback decimal Public «XSDelement»

Rettifica da aggiungere o togliere allo sconto payback


valorerettificassn decimal Public «XSDelement»

Rettifica da aggiungere o togliere allo sconto ssn


3.17 StatoDCR Connections Connector Source Target Notes Generalization Source -> Destination

Public DCR_out

Public StatoDCR

Attributes Attribute Notes Constraints and tags In_lavorazione NCName Public

Default:

Inviata NCName Public

Default:

Approvata NCName Public

Default:

Sbloccata NCName Public

Default:

Approvata_Cartacea NCName Public

Default:

In_liquidazione NCName Public

Default:




Liquidata NCName Public

Default:

3.18 TipoFarmacoList Elenco dei tipo di farmaci Connections Connector Source Target Notes Generalization Source -> Destination

Public getFasceMedicinaliListResponse

Public TipoFarmacoList

Attributes Attribute Notes Constraints and tags tipofarmaco NMTOKEN Public [1..*] «XSDelement»


3.19 Commons Classi commons, hanno caratteristiche funzionali che sono orizzontali al problema funzionala della DCR.

c la s s Type s

co m m o n s

« X S D co m p l e x. . .C re de n tia ls

« X S D e l e m e n t»+ sso to ke n : stri n g

« X S D co m p l e xT y. ..Fa u lt

« X S D e l e m e n t»+ d e scr i p t i o n : stri n g+ n a m e : stri n g

3.20 Credential Connections Connector Source Target Notes Generalization Source -> Destination

Public sendDCRRequest

Public Credentials

Attributes Attribute Notes Constraints and tags ssotoken string Public

token di autenticazione Default:




«XSDelement»

[maxOccurs = 1 ]

3.21 Fault Attributes Attribute Notes Constraints and tags description string Public «XSDelement»


name string Public «XSDelement»


3.22 Others Questo package contiene altre classi di utilità

c la s s Typ e s

O th e rs

« X S D co m p l e xT yp e »A l iq u o ta L is t

« X S D e l e m e n t»+ a l i q u o ta : d e ci m a l [ 1 . . * ]

« X S D co m p l e xT yp e »Tip o F a r m a c o L is t

« X S D e l e m e n t»+ t i p o fa rm a co : N M T O K E N [1 . . * ]

3.23 AliquotaList Rappresenta la lista della aliquote per una data farmacia. Attributes Attribute Notes Constraints and tags aliquota decimal Public [1..*] «XSDelement»


3.24 DCRList Rappresenta la lista della DCR per una data farmacia. Attributes




Attribute Notes Constraints and tags dcr DCR_out Public [1..*] «XSDelement»





4 IL SERVIZIO SENDRETTIFICHE

4.1 Servizi per la DCROnLine Di seguito vengono elencate le operazioni possibili di cui il servizio dispone. Operazioni Metodo Note Parametri sendRettifiche() boolean Public

La DCR cartacea, già acquisita, che ha lo stato di “Approvata” viene riportata allo stato di “In lavorazione” per essere modificata nuovamente. Una volta quindi eseguita con successo l'operazione la DCR conterrà le rettifiche inviate tramite il servizio.. Torna il risultato del successo o meno dell’operazione.

TotaliRettificheWs[in] SendRettificheResponse [out] Fault [out] sendFault Il dato di ritorno di tipo Fault conterrà eventualmente la descrizione dell'errore oppure un messaggio di successo nel caso la DCR era corretta ed è stata salvata con successo.

4.2 SendRettifiche Tramite l’invocazione di questo servizio, è possibile inviare le rettifiche inerenti una DCR.

c l a s s Ty p e s

« X S D t o p L e ve l E l e m e n t »S e n d R e t t i f i c h e

To ta l i R e tt i f i c h e W s

# a n n o R e t t A I : I n t e g e r# a n n o R e t t C o n t A I : I n t e g e r# a n n o R e t t C o n t S M G : I n t e g e r# a n n o R e t t S M G : I n t e g e r# a n n o R e t t T ra t t : I n t e g e r# b a rco d e : S t r i n g# l o ca l U se r_ cr e d : i t . l a i t . sch e m a s. d cr . C re d e n t i a l s# l o rd o C o n t M e se R e t A I : B i g D e ci m a l# l o rd o C o n t M e se R e t S M G : B i g D e ci m a l# l o rd o M e se R e t A I : B i g D e ci m a l# l o rd o M e se R e t S M G : B i g D e ci m a l# m e se R e t t A I : I n t e g e r# m e se R e t t C o n t A I : I n t e g e r# m e se R e t t C o n t S M G : I n t e g e r# m e se R e t t S M G : I n t e g e r# m e se R e t t T ra t t : I n t e g e r# p a yb a ck : B i g D e ci m a l# p e r i o d o R e t t i f i ca : D a t e# re t D P C : B i g D e ci m a l# re t t S S N : B i g D e ci m a l# re t V a r i e : B i g D e ci m a l# sco n t o : B i g D e ci m a l# t i ck e t C o n t M e se R e t A I : B i g D e ci m a l# t i ck e t C o n t M e se R e t S M G : B i g D e ci m a l# t i ck e t M e se R e t A I : B i g D e ci m a l# t i ck e t M e se R e t S M G : B i g D e ci m a l# t ra t C O N V : B i g D e ci m a l# t ra t E N P A F : B i g D e ci m a l# t ra t S I N D : B i g D e ci m a l

4.3 TotaliRettificheWs




Questa classe è il bean di contenimento che viene usato per essere inviato al servizio SendRettifiche. Il

valore che agli attributi verrà dato prima dell’invio, servirà al servizio per attribuire le rettifiche ad una

specifica DCR precedentemente inviata.


Public SendRettifiche

Public TotaliRettificheWs

Attributes Attribute Notes Constraints and tags annoRettAI Integer Protected

Default:

annoRettContAI Integer Protected

Default:

annoRettContSMG Integer Protected

Default:

annoRettSMG Integer Protected

Default:

annoRettTratt Integer Protected

Default:

barcode String Protected

il barcode della DCR Default:

localUser_cred it.lait.schemas.dcr.Credentials Protected

Default:

lordoContMeseRetAI BigDecimal Protected

Rettifica del Lordo del mese (RIGA 9)

Default:

lordoContMeseRetSMG BigDecimal Protected


Default:

lordoMeseRetAI BigDecimal Protected


Default:

lordoMeseRetSMG BigDecimal Protected


Default:

meseRettAI Integer Protected

Default:

meseRettContAI Integer Protected

Default:

meseRettContSMG Integer Protected

Default:

meseRettSMG Integer Protected

Default:




meseRettTratt Integer Protected

Default:

payback BigDecimal Protected

Rettifica dello sconto pay back (RIGA 5)

Default:

periodoRettifica Date Protected

data relativa alla rettifica (mmm/yyyy)

Default:

retDPC BigDecimal Protected

Rettifica DPC (RIGA 19b) Default:

rettSSN BigDecimal Protected

Rettifica dello sconto SSN (RIGA 5)

Default:

retVarie BigDecimal Protected

Rettifiche varie (RIGA12) Default:

sconto BigDecimal Protected

Rettifica dello sconto 0,60 (RIGA 5)

Default:

ticketContMeseRetAI BigDecimal Protected

Rettifica del Ticket del mese (RIGA 9)

Default:

ticketContMeseRetSMG BigDecimal Protected


Default:

ticketMeseRetAI BigDecimal Protected


Default:

ticketMeseRetSMG BigDecimal Protected


Default:

tratCONV BigDecimal Protected

Rettifica della trattenuta CONV (RIGA 14)

Default:

tratENPAF BigDecimal Protected

Rettifica della trattenuta ENPAF (RIGA 14)

Default:

tratSIND BigDecimal Protected

Rettifica della trattenuta SIND (RIGA 14)

Default:

4.4 SendRettificheResponse Questa classe rappresenta la risposta del servizio.




c la s s Typ e s

« X S D to p L e ve l E l e m .. .S e n d R e tti fi c h e R e s p o n s e

« X S D co m p l e xT yp e »b o o le a n

« X S D e l e m e n t»+ o u t : b o o l e a n

4.5 boolean Tramite questa classe è possibile verificare l’esito dell’invio delle rettifiche. Verificando il valore dell’attributo dell’XSDElement, sarà possibile verificare il risultato dell’operazione richiesat al servizio. Attributes Attribute Notes Constraints and tags out boolean Public «XSDelement»

Rappresenta il successo o meno dell’operazione invocata.


Modello SOA del Servizio DCR online -...

Documents

Transcript of Modello SOA del Servizio DCR online -...