OPESSAN
Direzione Salute
VERSIONE
V02
V01
VERSIONE
V02
V01
DESCRIZIONE SERVIZI
VERIFICHE E APPROVAZIONI
CONTROLLO
REDAZIONE
APPROVAZIONE
NOME
DATA
NOME
DATA
A.Cottura
29/04/10
L. Neri
26/02/2010 C. Audisio
08/03/10
PARAGRAFO O
PAGINA
Tutto il documento
Tutto il documento
OPES--SER-01-V02-Dettaglio Operatore.doc
OPES--SER-01-V02Dettaglio Operatore.doc
Pag. 1 di 10
AUTORIZZAZIONE
EMISSIONE
NOME
DATA
M.Rosati
09/03/10
STATO DELLE VARIAZIONI
DESCRIZIONE DELLA VARIAZIONE
Aggiunti tra gli output il codice regionale e l'ASL dell'ambulatorio
Versione iniziale del documento
USO: Interno ed Esterno CSI-Piemonte
OPESSAN
DESCRIZIONE SERVIZI
Direzione Salute
OPES--SER-01-V02Dettaglio Operatore.doc
Pag. 2 di 10
Informazioni generali
Il presente servizio esposto dal sistema informativo OpeSSan, fornisce le informazioni di
dettaglio relative ad un operatore sanitario in base ai seguenti parametri di ricerca:
• Id Aura per identificare l’operatore;
• Azienda (non obbligatoria);
Quando è indicato il parametro Azienda, l’elenco dei rapporti è limitato alla specifica Azienda
selezionata, altrimenti l’elenco è riferito all’ambito regionale.
Le informazioni che vengono restituire sono relative a:
• Profilo anagrafico: dati primari, dati di residenza, dati di domicilio e dati utili per i
contatti;
• Rapporti di lavoro ed eventuali incarichi;
• Massimali (se MMG/PLS);
• Studi Medici (se MMG/PLS);
• Posizione accademica e professionale;
• Associazioni/aggregazioni territoriali.
Al fine di ottenere le suddette informazioni, il presente servizio riutilizza i seguenti servizi
esposti dal sistema informativo OpeSSan:
• Acquisizione Puntuale profilo anagrafico operatore sanitario: il servizio ricava anche i
dati relativi alla posizione accademica e professionale
• Elenco Rapporti di lavoro;
• Elenco associazioni/aggregazioni dell’operatore;
• Elenco Studi Medici;
L’immagine, riportata di seguito, descrive il flusso logico delle informazioni1.
sd Dettaglio Operatore
S i ste m a este rn o
ge n eri co
O P E SS A N
A URA
1. Ri chi ed e Dettagl i o O pe ra to re(ID A ura)
2. V eri fica
Crede n zi al i ()
3. V eri fica co rrettezza d ati d i
i npu t()
4 . Ri cerca
De tta gl i o
O pe ra tore()
5 . Ri cerca profi l o an agra fi co op eratore ()
6 . Resti tui sce P ro fil o A n agra fi co()
7 . Re sti tu i sce i nfo di de tta gl io ope ra to re()
1
Per semplicità, si assume che le interazioni tra i sistemi abbiano sempre esito positivo.
OPES--SER-01-V02-Dettaglio Operatore.doc
USO: Interno ed Esterno CSI-Piemonte
OPESSAN
OPES--SER-01-V02Dettaglio Operatore.doc
Pag. 3 di 10
DESCRIZIONE SERVIZI
Direzione Salute
Composizione del messaggio di richiesta da un sistema esterno generico
Il messaggio utilizzato per implementare sotto forma di Web Services i servizi esposti da
OPESSAN, si compone di due parti principali:
Testata del messaggio (header)
#
Header del messaggio
Contenuto e regole
Nome campo
1
idAsr
2
sender
3
receiver
Contiene l’identificativo dell’azienda sanitaria regionale.
Es. 010201
Contiene il codice fiscale dell’operatore dell’ASR.
Qualora non fosse possibile inviare tale codice si
richiede in alternativa il codice fiscale del responsabile
della Sicurezza dell’ASR.
Identifica il sistema a cui è indirizzata la richiesta.
Tipo
Obbl
string
obbligatorio
string
obbligatorio
string
obbligatorio
Corpo del messaggio (body)
Le informazioni contenute nel body sono strutturate nel seguente modo:
Parametri di input
La sezione “Parametri di input” è costituita da una tabella con le seguenti informazioni:
nome campo
Identifica il nome del parametro di input input riportato
nel WSDL
contenuto e regole
Descrive le modalità di gestione del parametro
Tipo
Descrive la tipologia del dato (string, decimal, ecc.)
Obbl
Indica l’eventuale obbligatorietà del campo all’interno
del WSDL
Parametri di input
#
Nome campo
Contenuto e regole
Tipo
Obbl
1
IdAura
Identificativo univoco assegnato da AURA
decimal
Obbligatorio
2
Azienda
Azienda di appartenenza dell’operatore sanitario
string
Facoltativo
OPES--SER-01-V02-Dettaglio Operatore.doc
USO: Interno ed Esterno CSI-Piemonte
OPESSAN
DESCRIZIONE SERVIZI
Direzione Salute
OPES--SER-01-V02Dettaglio Operatore.doc
Pag. 4 di 10
Composizione del messaggio di risposta (comunicazione sincrona)
Il messaggio utilizzato per implementare sotto forma di Web Services i servizi esposti da
OpeSSan, si compone delle parti seguenti:
“Header del messaggio”
Contiene i riferimenti relativi a chi richiede
l’esecuzione del servizio, chi riceve la richiesta e
l’esito del servizio
“Informazioni restituite”
(Body del messaggio)
Contiene i dati di dettaglio restituiti dal servizio
“Elenco Errori” (Footer)
Descrive l’eventuale elenco di messaggi di errore che
si sono verificati a seguito dei controlli formali/logici.
Testata del messaggio (header)
Header del messaggio
# Nome campo
1
2
sender
idAsr
3
receiver
4
codiceRitorno
Contenuto
Tipo
Identifica il sistema da cui proviene la richiesta.
Contiene l’identificativo dell’azienda sanitaria regionale
presente nel campo id del header della richiesta sopra-indicato.
Es. 010201
Contiene il codice fiscale presente nel campo sender del header
della richiesta sopra-indicato.
Contiene l’esito del servizio. Può assumere i seguenti valori:
1  servizio eseguito correttamente;
0  servizio fallito
string
string
string
int
Corpo del messaggio (body)
#
Nome campo
Contenuto e regole
1
IdAura
Identificativo univoco assegnato da AURA
Tipo
2
CodiceFiscaleAura
Codice fiscale del soggetto presente in AURA
decimal
string
infoRappLavoro - Dati rapporto di lavoro (sono previste una o più occorrenze)
2
105
codiceRegionale
3
azienda
4
5
Il codice regionale che identifica l'operatore sanitario
Azienda di competenza per il rapporto di lavoro
dataInizioRappLavor Data inizio rapporto o posizione lavorativa.
o
Formato ggmmaaaa.
posContrattuale
Posizione Contrattuale: può assumere i seguenti valori:
1 = Dipendente
2 = Incarico
3 = Consulente
4 = Convenzionato
9 = Altro
string
string
date
string
2
Possono essere presenti più occorrenze di rapporto di lavoro per lo stesso operatore sanitario anche presso Aziende
diverse, se non è stato specificato in input il parametro Azienda. .
OPES--SER-01-V02-Dettaglio Operatore.doc
USO: Interno ed Esterno CSI-Piemonte
OPESSAN
DESCRIZIONE SERVIZI
Direzione Salute
OPES--SER-01-V02Dettaglio Operatore.doc
Pag. 5 di 10
Per gli operatori convenzionati il valore è fisso: 4-Convenzionato.
6
rapportoSSN
Rapporto con il SSN.Può assumere i seguenti valori:
1 = Libero professionista
2 = Dipendente pubblico
3 = Dipendente privato
4 = Rapporto convenzionale
9 = Altro
string
Per gli operatori convenzionati il valore è fisso: 4-Rapporto
Convenzionale.
7
tipoRuolo
8
tipoContratto
9
qualifica
10
tipoRappLavoro
11
indicatoreDisp
13
distrettoCompetenz
a
ambitoCompetenza
14
dataScadenza
15
dataFine
16
causa
17
dataInizioSosp
18
dataFineSosp
19
motivo
12
Tipo Ruolo dell’operatore. Può assumere i seguenti valori:
1 = Amministrativo
2 = Professionale
3 = Sanitario
4 = Tecnico
Per gli operatori convenzionati il valore è fisso: 3-Sanitario.
Rappresenta una categoria di operatori, spesso coincide con il tipo
di Convenzione Nazionale applicata alla figura professionale
string
string
Indica il tipo di attività dell’operatore sanitario
Tipo rapporto di lavoro. Può assumere i seguenti valori:
1 = tempo determinato
2 = tempo indeterminato
3 = redditi assimilati
0 = altro
Indicatore piena disponibilità. Può assumere i seguenti valori:
S = Sì
N = No
Non valorizzato in caso di informazione non gestita; il dato è
significativo solo per i Medici di Medicina dei Servizi
Distretto di Competenza. Significativo solo per MMG/PLS
string
Ambito di competenza. Significativo solo per MMG/PLS
data scadenza del rapporto di lavoro/posizione lavorativa,
valorizzata solo per rapporto o attività a tempo determinato
Formato ggmmaaaa.
Data di fine rapporto di lavoro / posizione lavorativa o data
annullamento
Formato ggmmaaaa
string
Motivo di fine rapporto di lavoro / posizione lavorativa (in caso di
annullamento assume il valore “cancellazione logica”)
string
string
string
dateTime
dateTime
string
Data di inizio della sospensione del rapporto di lavoro/attività.
Formato ggmmaaaa
dateTime
Data di fine sospensione rapporto di lavoro/attività. Formato
ggmmaaaa
dateTime
Motivo di fine rapporto di lavoro/attività
string
infoRappLavoro - infoMassimali (massimali per ogni rapporto di lavoro. Presenti solo
per MMG e PLS)
OPES--SER-01-V02-Dettaglio Operatore.doc
USO: Interno ed Esterno CSI-Piemonte
OPESSAN
DESCRIZIONE SERVIZI
Direzione Salute
OPES--SER-01-V02Dettaglio Operatore.doc
Pag. 6 di 10
20
massimale
Massimale
string
21
massInDeroga
Massimale in deroga
string
22
massScelteTemp
Massimale per scelte temporanee
string
23
massScelta03anni
Massimale scelte 0-3 anni. Valorizzato solo per PLS
string
infoRappLavoro – incarichi (per ogni rapporto di lavoro possono essere presenti più
occorrenze)
Nota: La sezione è presente solo per specialisti ambulatoriali, medici dei servizi, professionisti,
veterinari, medici ATP
Data di inizio dell’incarico
24
dataInizio
dateTime
Formato ggmmaaaa
25
brancaSpec
26
unitaOperativa
27
totOreSett
28
dataFine
29
flagAnnullato
Branca specialistica. Deve essere un valore previsto dal catalogo
regionale delle specialità (base dati Anagrafe Strutture Sanitarie).
Valorizzabile solo per gli specialisti ambulatoriali.
Unità Operativa. Individua il poliambulatorio in cui lavora
l’operatore sanitario o la struttura di afferenza per lo specifico
incarico
Totale ore settimanali. E’ il numero totale di ore di lavoro previste
dallo specifico incarico.
Data di fine incarico o annullamento.
Formato ggmmaaaa
Indica se l’incarico è stato cancellato in seguito ad un inserimento
errato.
Valori possibili: True o False. Default = False. Viene posto a True
in caso di cancellazione logica dell’incarico
string
string
int
dateTime
boolean
associazioniAggregazioni (Adesioni associazioni / aggregazioni territoriali – sono
previste una o più occorrenze)
30
31
32
codAzienda
codice
denominazione
tipo
33
34
35
36
37
38
39
40
41
42
cognomeRef
nomeRef
indirizzo
numCivico
cap
comune
tel
dataCessazione
dataInizioAdesione
Codice dell’Azienda che ha autorizzato l’associazione o di riferimento per
l’aggregazione
Codice, assegnato dall'Azienda, per identificare l'associazione/aggregazione
territoriale.
Nome dell’associazione / aggregazione
Tipo associazione / aggregazione. Codice che identifica la forma associativa
dell’assistenza primaria o di integrazione professionale.
Può assumere i seguenti valori:
01 = medicina in associazione
02 = medicina in rete
03 = medicina di gruppo
04 = équipe territoriale
05 = gruppi di cure primarie
06 = case della salute
Cognome del referente dell’associazione / aggregazione
Nome del referente dell’associazione / aggregazione
Indirizzo dell’associazione / aggregazione
Numero civico riferito all’indirizzo dell’associazione / aggregazione
comprensivo di eventuale bis/ter, interno, scala, numero secondario
Codice di avviamento postale riferito all’indirizzo dell’associazione /
aggregazione
Codice ISTAT del comune italiano riferito all’indirizzo dell’associazione /
aggregazione
Riferimento telefonico dell’associazione / aggregazione
Data di cessazione dell’associazione / aggregazione
Data di inizio adesione dell’operatore sanitario all’associazione /
OPES--SER-01-V02-Dettaglio Operatore.doc
string
string
string
string
string
string
string
string
string
string
string
dateTime
dateTime
USO: Interno ed Esterno CSI-Piemonte
OPESSAN
DESCRIZIONE SERVIZI
Direzione Salute
43
dataFineAdesione
44
45
46
cognome
Nome
sesso
dataNascita
OPES--SER-01-V02Dettaglio Operatore.doc
Pag. 7 di 10
aggregazione.
Formato ggmmaaaa
Data di fine adesione dell’operatore sanitario all’associazione /
aggregazione.
Formato ggmmaaaa
dateTime
infoAnag - datiPrimari (Informazioni anagrafiche primarie)
47
codComuneNascita
48
49
50
51
52
53
54
55
56
descComuneNascita
siglaProvNascita
codStatoNascita
descStatoNascita
codCittadinanza
descCittadinanza
dataDecesso
codiceFiscale
statoCodiceFiscale
57
Cognome del soggetto
Nome del soggetto
Sesso del soggetto
Data di nascita del soggetto.
Formato ggmmaaaa
Contiene il codice ISTAT.
Il campo non è valorizzato se il comune di nascita è italiano, ma
non ha codice ISTAT, oppure il profilo anagrafico risulta nato
all’estero.
Contiene la denominazione del comune di nascita italiano o estero
Sigla della provincia di nascita (es. RM=Roma, EE=estero)
Contiene il codice stato (es. 100=Italia)
Contiene la denominazione dello stato di nascita
Contiene il codice stato della cittadinanza (es. 100=Italia)
Contiene la denominazione dello stato di cittadinanza
Formato ggmmaaaa
Codice Fiscale del soggetto
Contiene lo stato di verifica del codice fiscale con il Ministero
dell’Economia e delle Finanze.
Valori possibili:
2=da verificare;
3 = verificato
string
string
string
date
string
string
string
string
string
string
string
date
date
int
InfoAnag – residenza - datiSecondari (Residenza)
63
64
65
codComune
descComune
codStato
descStato
indirizzo
numCivico
cap
telefono
66
statoResidenza
58
59
60
61
62
Codice ISTAT del comune di residenza
Contiene la denominazione del comune di residenza
Codice dello stato di residenza (es. 100 = Italia)
Contiene la denominazione dello stato di residenza
Indirizzo di residenza
Numero civico di residenza
CAP di residenza
Recapito telefonico di residenza
Contiene lo stato di verifica del contatto di residenza con il
comune.
Valori possibili:
2=da verificare;
3 = verificato
string
string
string
string
string
string
string
string
int
InfoAnag – domicilio - datiSecondari (Domicilio sanitario)
67
68
69
70
71
72
73
74
codComune
descComune
codStato
descStato
indirizzo
numCivico
cap
telefono
Codice ISTAT del comune di domicilio
Contiene la denominazione del comune di domicilio
Codice dello stato di domicilio (es. 100 = Italia)
Contiene la denominazione dello stato di domicilio
Indirizzo di domicilio
Numero civico di domicilio
CAP di domicilio
Recapito telefonico di domicilio
string
string
string
string
string
string
string
string
altreInfo – Informazioni (è possibile la presenza di più occorrenze)
75
76
codInformazione
descInformazione
Contiene il codice che identifica l’informazione trattata
Contiene la descrizione testuale dell’informazione (ad esempio
OPES--SER-01-V02-Dettaglio Operatore.doc
string
string
USO: Interno ed Esterno CSI-Piemonte
OPESSAN
DESCRIZIONE SERVIZI
Direzione Salute
77
valInformazione
OPES--SER-01-V02Dettaglio Operatore.doc
Pag. 8 di 10
“indirizzo di posta elettronica”)
Contiene il valore dell’informazione
string
infoProf – Informazioni Posizione accademica e Professionale
78
79
80
81
82
83
84
85
dataLaurea
Data di laurea dell’operatore sanitario.
Formato ggmmaaaa
dataSpecializzazione Data di specializzazione dell’operatore sanitario.
Formato ggmmaaaa
dataTitolarita
Data di titolarità del primo incarico.
Formato ggmmaaaa
nomeAlboProf
Nome dell’Albo Professionale a cui è iscritto l’operatore sanitario.
siglaProvAlboProf
Sigla della provincia dell’Albo Professionale
numIscrizioneAlbo Numero di iscrizione dell’operatore sanitario all’Albo Professionale
dataIscrizAlbo
dataCancAlbo
dataInizioInformat
86
87
dataInizioSospAlbo
dataFineSospAlbo
88
Data di iscrizione dell’operatore sanitario all’Albo Professionale.
Formato ggmmaaaa
Data di cancellazione dell’operatore sanitario dall’Albo
Professionale.
Formato ggmmaaaa
Data inizio informatizzazione
Significativa solo per MMG e PLS.
Formato ggmmaaaa
Data inizio sospensione dell’operatore sanitario dall’Albo
Professionale.
Formato ggmmaaaa
Data fine sospensione dell’operatore sanitario dall’Albo
Professionale.
Formato ggmmaaaa
date
date
date
string
string
string
date
date
date
date
date
elencoStudiMedici - studioMedico (solo in caso di MMG/PLS può contenere n
occorrenze)
89
90
91
92
denominazione
tipo
qualifica
indicatoreAmbCon
diviso
93
indicatoreAmbPub
blico
94
indirizzo
95
numCivico
96
comune
97
cap
Denominazione ambulatorio. Lunghezza massima 100 caratteri.
string
Tipo ambulatorio. Indica se ambulatorio principale o secondario.
Può assumere i seguenti valori:
1 = ambulatorio principale
0 = altro ambulatorio
Deve essere una qualifica prevista da OpeSSan
int
Indicatore ambulatorio condiviso. Indica se lo studio medico è
condiviso.
Può assumere i seguenti valori:
S = ambulatorio condiviso
N = ambulatorio non condiviso.
Indicatore ambulatorio pubblico. Indica se lo studio medico è
pubblico o privato.
Può assumere i seguenti valori:
S = ambulatorio pubblico
N = ambulatorio privato
Indirizzo ambulatorio. Contiene l’indirizzo dell’ambulatorio in
forma descrittiva comprensivo del toponimo.
Numero civico comprensivo di eventuale bis/ter, interno, scala,
numero secondario.
Comune ambulatorio. Codice ISTAT del comune in cui è ubicato
l’ambulatorio.
CAP ambulatorio. Codice di avviamento postale dell’ambulatorio.
Lunghezza fissa 5 caratteri.
OPES--SER-01-V02-Dettaglio Operatore.doc
string
string
string
string
string
string
string
USO: Interno ed Esterno CSI-Piemonte
OPESSAN
DESCRIZIONE SERVIZI
Direzione Salute
OPES--SER-01-V02Dettaglio Operatore.doc
Pag. 9 di 10
106
codASL
Codice dell'ASL in cui ricade lo studio medico
string
107
ASL
Denominazione dell'ASL in cui ricade lo studio medico
string
98
email
E’ l’indirizzo e-mail del medico per lo specifico ambulatorio.
string
99
telPrimario
Riferimento telefonico principale del medico per lo specifico
ambulatorio
Riferimento telefonico secondario del medico per lo specifico
ambulatorio
string
100
telSecondario
string
elencoStudiMedici - studioMedico - giorniApertura (Giorni e orari di apertura Studio
Medico) - contiene n occorrenze
101
giorno
Giorno della settimana di apertura studio. Indica il giorno della
settimana di apertura dello studio .
Può assumere i seguenti caratteri:
1 = Lunedì
2 = Martedì
3 = Mercoledì
Ecc…
string
elencoStudiMedici - studioMedico – giorniApertura - orari (Orari di apertura) –
contiene n occorrenze
102
orarioInizio
Ora inizio apertura.
Time
103
orarioFine
Ora fine apertura.
Time
104
note
Note relative ad orari di ricevimento e modalità di accesso
string
Coda del messaggio (footer)
La coda del messaggio riporta una serie di eventuali segnalazioni ad uso dei sottoscrittori. Tale
coda e valorizzata solo se codiceRitorno = 0. Per ogni segnalazione sono riportate le seguenti
informazioni:
#
1
2
3
messages (MessageArray: sono previste zero o più occorrenze)
Nome campo
Contenuto e regole
Codice
Descrizione
Tipo
Codice del messaggio
Descrizione del messaggio
Può assumere il valore I (informativa), E (errore bloccante)
Tipo
string
string
string
Descrizione del servizio di dettaglio operatore
Il servizio consente di ricercare le informazioni di dettaglio relative ad uno specifico operatore
sanitario.
Il servizio deve essere firmato digitalmente (user e password o certificato digitale) e inviato su
un canale https.
Si prevede che vengano effettuate le seguenti attività:
1. verifica delle credenziali del sistema richiedente (user e password o certificato
digitale);
2. verifica della correttezza formale delle informazioni (presenza di tutti i campi
obbligatori e, dove possibile, verifica della loro correttezza formale);
3. richiamo dei servizi di
OPES--SER-01-V02-Dettaglio Operatore.doc
USO: Interno ed Esterno CSI-Piemonte
OPESSAN
Direzione Salute
DESCRIZIONE SERVIZI
OPES--SER-01-V02Dettaglio Operatore.doc
Pag. 10 di 10
o Acquisizione puntuale profilo anagrafico operatore sanitario
o Elenco rapporti di lavoro
o Elenco studi medici di un MMG/PLS (se MMG/PLS)
o Elenco associazioni / aggregazioni dell'operatore
4. Se uno o più servizi non rispondono (es. scade il timeout) vengono comunque
fornite le altre informazioni che è stato possibile recuperare.
5. Restituzione delle occorrenze relative al profilo anagrafico di dettaglio dell’operatore,
rapporti di lavoro ed eventuali incarichi e massimali associati, posizione accademica
e professionale, eventuali studi medici ed eventuali associazioni/aggregazioni
territoriali.
Allegati
Il presente documento include i seguenti allegati:
• Elenco degli errori elencati nel file OPES--LST-01-VU-Elenco messaggi.xls
• WSDL del servizio nel file OPES--SSI-01-V01-DettaglioOperatore.wsdl
OPES--SER-01-V02-Dettaglio Operatore.doc
USO: Interno ed Esterno CSI-Piemonte