Differences between revisions 50 and 72 (spanning 22 versions)
Revision 50 as of 2018-06-14 11:52:37
Size: 24463
Editor: a.santurbano
Comment:
Revision 72 as of 2021-12-15 16:38:39
Size: 3696
Editor: a.deruvo
Comment:
Deletions are marked like this. Additions are marked like this.
Line 2: Line 2:
'''Ultimo aggiornamento: <<Date()>>'''
Line 4: Line 6:
= Gestione delle anagrafiche Farmacie, Grossisti, Scorte e Mangimi =
Sezione relativa alle funzionalità per il caricamento massivo delle anagrafiche di Farmacie, Grossiti autorizzati alla vendita al dettaglio, Scorte e Mangimi.

== Anagrafiche Scorte Allevamento, Strutture e Veterinario ==

=== Import da CSV ===
Il Sistema Informativo della Farmacosorveglianza permette di caricare massivamente le anagrafiche delle scorte in allevamento e le scorte proprie del veterinario attraverso un apposito file in formato CSV.

Il file in formato CSV da importare deve avere la seguente struttura:
||'''tiposcortaCodice''' ||'''aziendaCodice''' ||'''personeIdFiscale''' ||'''strutturaCodice''' ||'''scortaNumAutorizzazione''' ||'''scortaDtInizio''' ||'''aslCodice''' ||'''scortaFlDerogaFornitura''' ||
||ALLEVAMENTO ||041TE001 ||RVRCRL62S29D969F || ||TESTCSVALLEV ||01-07-2016 || || N ||
||PROPRIA || ||SCCLDA40R10H811F || ||TESTCSVPROP ||02-07-2016 ||P106 || N ||
||STRUTTURA || || ||RI-AG000060 ||TESTCSVSTRUTTURA ||02-07-2016 || || N ||

Descrizione dei campi previsti dal file in formato CSV (in '''grassetto '''i campi obbligatori):

 * '''tiposcortaCodice''': tipologia della scorta;
  * '''ALLEVAMENTO''': Scorta dell'allevamento;
  * '''STRUTTURA''': Scorta della Struttura non Zootecnica (Ospedale Veterinario, Canile, Ambulatorio Veterinario, ecc...);
  * '''PROPRIA''': Scorta del veterinario.
 * '''aziendaCodice''': ('''obbligatorio se tiposcortaCodice = ALLEVAMENTO''')''' '''codice dell’azienda zootecnica per la quale si sta autorizzando la scorta;
 * '''strtutturaCodice''': ('''obbligatorio se tiposcortaCodice = STRUTTURA''')''' '''codice della struttura non zootecnica per la quale si sta autorizzando la scorta;
 * '''personeIdFiscale''': dipende dal valore di tiposcortaCodice, se:
  * '''ALLEVAMENTO '''(CF/PIVA) del proprietario dell'azienda zootecnica
  * '''PROPRIA''': Codice Fiscale del Veterinario.

 * '''scortaNumAutorizzazione''': numero di autorizzazione alla detenzione della scorta;
 * '''scortaDtInizio''': data di autorizzazione della scorta;
 * '''scortaFlDerogaFornitura''': indica se per l'allevamento, struttura o veterinario non si vuole la privacy sulle ricette;
  * '''N''': per la visualizzazione e accesso alla ricetta, da parte del farmacista od operatore OSM, sono sempre richiesti codice e PIN;
  * '''S''': per la visualizzazione e accesso alla ricetta non è richiesto il PIN, è possibile cercare e accedere alla ricetta tramite il codice azienda o id fiscale del proprietario degli animali.
 * '''aslCodice''': asl di appartenza del Veterinario. E' necessario solo nel caso di tiposcortaCodice "PROPRIA", per identificare a quale ASL associare la scorta. Per gli allevamenti non è necessario, in quanto è un'informazione già presente in BDN.

'''Attenzione''': nel file CSV non devono essere modificati i nomi (intestazioni) delle colonne. Fare attenzione alle minuscole e alle maiuscole. L'ordine delle colonne può essere variato.

Dal seguente link è possibile scaricare il file in formato CSV di esempio: [[attachment:elencoAutorizzazioniScortaMedicinali.csv]]

=== Gestione tramite servizio REST/JSON ===
Di seguito le specifiche per la cooperazione applicativa attraverso i servizi WEB REST/JSON messi a disposizione.

==== Ricerca ====
Il sistema offre un metodo REST per la ricerca:

 * '''<url_server>/lov/scortaronly/ws/search/''' (dove <url_server> varia in base all'ambiente: test o produzione).

=== Header ===
L’invocazione del servizio WEB REST deve avere i seguenti headers:

{{{#!highlight bash
    Content-Type: x-www-form-urlencoded
    Accept: application/json
}}}
=== Tracciato di input ===
Di seguito la descrizione dei campi da inviare.

Il risultato della ricerca è "paginato": il risultato della ricerca viene restituito in N pagine da X righe. Il numero massimo "x" di righe da restituire per pagina (gruppo di risultati) e la pagina da visualizzare vengono pilotati da chi invoca il servizio di ricerca, quindi i seguenti campi sono obbligatori:

 * '''page''': pagina ritornata dalla ricerca (nella prima invocazione del servizio tale campo è da valorizzare con il valore "1") | Numerico;
 * '''rows''': numero massimo di righe tornate dalla ricerca (valore compreso tra 1 e 100) | Numerico.

Si seguito la descrizione dei campi dell'entita '''scortaronly''' gestiti in input/output:

 * '''lovscortaId''': id del record | Numerico;
 * '''scortaNumAutorizzazione''': numero di autorizzazione alla scorta | Stringa;
 * '''scortaDtInizio''': data di inizio validità della scorta | Stringa (formato dd-mm-aaaa);
 * '''scortaDtFine''': data di fine validità della scorta | Stringa (formato dd-mm-aaaa);
 * '''aziendaCodice''': codice dell'azienda zootecnica a cui fa riferimento la scorta | Stringa;
 * '''propIdFiscale''': ID fiscale (Codice o P.IVA) del proprietario dell'azienda zootecnica a cui fa riferimento la scorta | Stringa;
 * '''tiposcortaCodice''': tipologia della scorta | Stringa; possibili valori:
  * '''STRUTTURA''': Scorta della Struttura non Zootecnica;
  * '''SCORFITT''': Registro delle rimanenze della struttura zootecnica senza scorta;
  * '''PROPRIA''': Scorta del veterinario;
  * '''DETENTORE''': Scorta del detentore;
  * '''ALLEVAMENTO''': Scorta per allevamento.
 * '''scortaFlDerogaFornitura''': indica se per l'allevamento, struttura o veterinario non si vuole la privacy sulle ricette | Stringa:
  * '''N''': per la visualizzazione e accesso alla ricetta, da parte del farmacista od operatore OSM, sono sempre richiesti codice e PIN;
  * '''S''': per la visualizzazione e accesso alla ricetta non è richiesto il PIN, è possibile cercare e accedere alla ricetta tramite il codice azienda o id fiscale del proprietario degli animali.
 * '''strutturaCodice''': codice della Struttura non Zootecnica a cui fa riferimento la scorta | Stringa;
 * '''vetPersIdFiscale''': ID fiscale (Codice o P.IVA) del veterinario a cui fa riferimento la scorta | Stringa;
 * '''aslCodice''': Codice dell'ASL a cui fa riferimento la scorta (obbligatorio se tiposcortaCodice = PROPRIA) | Stringa;

===== Esempio di interrogazione =====
{{{#!highlight
    page:1
    rows:50
    aziendaCodice:001TE001
}}}

===== Tracciato di output =====
{{{#!highlight
{
    "result": null,
    "data": {
  "total": 1,
  "page": 1,
  "records": 29,
  "rows": [...]
 }
}
}}}

Di seguito la descrizione dei campi:

 * '''total''': numero totale di pagine;
 * '''page''': pagina che si sta interrogando;
 * '''records''': numero totale di records;
 * '''rows''': elementi di scortaronly;

==== Import ====
Il Sistema Informativo della Farmacosorveglianza permette di gestire le anagrafiche delle scorte in allevamento e le scorte proprie del veterinario attraverso un apposito servizio REST/JSON.

I campi previsti dal tracciato JSON sono gli stessi del file in formato CSV.

Viene di seguito riportato l'esempio tracciato dati JSON da utilizzare:

{{{#!highlight json
[
        {
                "tiposcortaCodice": "ALLEVAMENTO",
                "aziendaCodice": "039TE508",
                "personeIdFiscale": "DNGVNI59B48B515B",
                "scortaNumAutorizzazione": "TESTJSON",
                "scortaDtInizio": "24-01-2017",
                "aslCodice": "",
                "scortaFlDerogaFornitura": "N"
        },
        {
                "tiposcortaCodice": "PROPRIA",
                "aziendaCodice": "",
                "personeIdFiscale": "TSCTNN57A17E058B",
                "scortaNumAutorizzazione": "TESTJSON1",
                "scortaDtInizio": "24-01-2017",
                "scortaFlDerogaFornitura": "N",
                "aslCodice": "F118"
        },
        {
                "tiposcortaCodice": "STRUTTURA",
                "strutturaCodice": "RS-AG000052",
                "scortaNumAutorizzazione": "STRUTACNINA",
                "scortaDtInizio": "24-01-2017",
                "scortaFlDerogaFornitura": "N",
                "aslCodice": ""
        }
]
}}}

===== URL del servizio REST =====
Il servizio REST JSON è esposto al seguente URL (endpoint):

 * '''<url_server>/autorizzazione/detenzione/ws/insert/''' (dove <url_server> varia in base all'ambiente: test o produzione)

===== Header =====
L’invocazione del servizio WEB REST deve avere i seguenti headers:

{{{#!highlight bash
    Content-Type: application/json
    Accept: application/json
}}}

===== Autenticazione =====
Le modalità di autenticazione per l'invocazione dei servizi REST sono descritte nell'apposito paragrafo della sezione del manuale con le informazioni base e tecnologie adottate dal Sistema Informativo Nazionale della Farmacosorveglianza per l'integrazione con i sistemi esterni, accedibile tramite il seguente URL: [[farmaco/help/integrazione]]

===== Tracciato di output =====
{{{#!highlight json
{
 "result": {
  "1": {
   "errors": [{
    "field": "",
    "message": "...",
    "errorCode": "common.unknownerror"
   }],
   "errorType": null,
   "elencoCodici": null,
   "errore": <Descrizione dell'errore>
  }
 },
 "data": null
}
}}}

Viene di seguito riportata la descrizione dei due campi del JSON restituito:

 * '''data''': lista di elementi che non hanno problemi nella registrazione della fornitura;
 * '''result''': in questo campo, di tipo json, verranno collezionati i vari errori contenuti nei singoli elementi dell'array di importazione:
  * tale item è “null” se non si sono verificati errori;
  * nel caso in cui nel corso dell'elaborazione si fossero verificati errori, la chiave del json corrisponde all'errore avvenuto nell'i-esimo elemento inviato nel caso documentato l'errore è relativo all'elemento di indice i nel json di input.

Logica di elaborazione ATTENZIONE: La logica di elaborazione del tracciato JSON inviato al servizio REST è di tipo “transazionale”, e prevede quindi che in caso di errori tutti i dati inviati vengano scartati.

==== Update ====
Viene di seguito riportato l'esempio tracciato dati JSON da utilizzare:

{{{#!highlight json
{
    "lovscortaId": 1932228,
    "scortaNumAutorizzazione": "012/2018-1",
    "scortaDtInizio": "15-04-2018",
    "tiposcortaCodice": "STRUTTURA",
    "scortaFlDerogaFornitura": "N",
    "strutturaCodice": "SV-200CA000790"
}
}}}

===== URL del servizio REST =====
Il servizio REST JSON è esposto al seguente URL (endpoint):

 * '''<url_server>/autorizzazione/detenzione/ws/update/''' (dove <url_server> varia in base all'ambiente: test o produzione)

===== Header =====
L’invocazione del servizio WEB REST deve avere i seguenti headers:

{{{#!highlight bash
    Content-Type: application/json
    Accept: application/json
}}}

===== Autenticazione =====
Le modalità di autenticazione per l'invocazione dei servizi REST sono descritte nell'apposito paragrafo della sezione del manuale con le informazioni base e tecnologie adottate dal Sistema Informativo Nazionale della Farmacosorveglianza per l'integrazione con i sistemi esterni, accedibile tramite il seguente URL: [[farmaco/help/integrazione]]

===== Tracciato di output =====
{{{#!highlight json
{
 "result": {
  "errors": [{
    "field": "",
    "message": "....",
    "errorCode": "common.unknownerror"
  }],
  "errorType": null,
  "elencoCodici": null,
  "errore": <Descrizione dell'errore>
 },
 "data": null
}
}}}

== Import Veterinari responsabili della scorta ==
Il Sistema Informativo della Farmacosorveglianza permette di caricare massivamente i veterinari responsabili delle scorte.

=== Caricamento file CSV ===
Il sistema permette il caricamento massivo attraverso un apposito file in formato CSV. Il file CSV con l'elenco dei veterinari responsabili della scorta deve essere caricato dopo aver caricato l'elenco delle autorizzazioni alla detenzione della scorta in allevamento (import da CSV della anagrafiche Scorte Allevamento e Veterinario).

Il file in formato CSV da importare deve avere la seguente struttura:
||'''tiposcortaCodice''' ||'''vetPersIdFiscale''' ||'''aziendaCodice''' ||'''propIdFiscale''' ||'''strutturaCodice''' ||'''flResponsabile''' ||
||STRUTTURA ||SCCLDA40R10H811F || || ||OV-PE000001 ||S ||
||ALLEVAMENTO ||RTAFNC75A20C342V ||041TE001 ||RVRCRL62S29D969F || ||S ||
||ALLEVAMENTO ||BRSGNN52L24C469G ||041TE122 ||SCCLDA40R10H811F || || ||

Descrizione dei campi previsti dal file in formato CSV (in '''grassetto ''' i campi obbligatori):

 * '''tiposcortaCodice''': tipologia della scorta, valori ammessi:
  * '''STRUTTURA''': scorta della struttura non zootecnica
  * '''ALLEVAMENTO''': scorta dell'allevamento zootecnico
 * '''aziendaCodice''': codice dell'azienda zootecnica con scorta autorizzata ('''obbligatorio se tiposcortaCodice = ALLEVAMENTO ''');
 * '''propIdFiscale''': ID Fiscale del proprietario dell'azienda zootecnica ('''obbligatorio se tiposcortaCodice = ALLEVAMENTO ''');
 * '''strutturaCodice''': codice della struttura con scorta autorizzata ('''obbligatorio se tiposcortaCodice = STRUTTURA''');
 * '''vetPersIdFiscale''': Codice Fiscale del Veterinario;
 * '''flResponsabile''': flag che indica se il veterinario è il responsabile o il delegato, se non specificato il valore di default è '''N''', possibili valori:
  * '''S''': responsabile;
  * '''N''': delegato

'''Attenzione''': nel file CSV non devono essere modificati i nomi (intestazioni) delle colonne. Fare attenzione alle minuscole e alle maiuscole. L'ordine delle colonne può essere variato.

Dal seguente link è possibile scaricare il file in formato CSV di esempio: [[attachment:elencoVeterinariScortaAllevamento.csv]]
= Sito Informativo =
Al seguente [[https://www.ricettaveterinariaelettronica.it/|link]] è disponibile il sito informativo del Sistema della Farmaco Sorveglianza.
Line 271: Line 10:
=== Gestione tramite servizio web REST/JSON === = Manuale Utente =
Di seguito si riportano sezione per sezione le risorse per la gestione del sistema informativo.
Line 273: Line 13:
==== Ricerca ====
Il sistema offre un metodo REST per la ricerca:
== Funzionalità base dell'Interfaccia Utente ==
L'elenco delle funzionalità di base messe a disposizione dall'interfaccia utente dell'applicativo è consultabile al seguente [[webapp/help|indirizzo]].
Line 276: Line 16:
 * '''<url_server>/lov/scortavet/ws/search/''' (dove <url_server> varia in base all'ambiente: test o produzione). == Gestione dell'account Utente ==
L'elenco delle funzionalità di base messe a disposizione degli utenti dell'applicativo la ga gestione del proprio account/profilo [[farmaco/help/gestioneprofilo]].
Line 278: Line 19:
=== Header ===
L’invocazione del servizio WEB REST deve avere i seguenti headers:
== Diagrammi di flusso gestione del medicinale veterinario attraverso la ricetta veterinaria elettronica ==
Al seguente link è possibile accedere ai diagrammi di flusso della gestione del medicinale veterinario attraverso la ricetta veterinaria elettronica: [[farmaco/help/flussi]]
Line 281: Line 22:
{{{#!highlight bash
    Content-Type: x-www-form-urlencoded
    Accept: application/json
}}}
 * gestione medicinali per gli animali da reddito (DPA) [[http://demo.izs.it/help/farmaco/help/flussi#Diagramma_di_flusso_gestione_medicinali_per_gli_animali_da_reddito_.28DPA.29_attraverso_la_ricetta_veterinaria_elettronica|link]]
 * gestione medicinali per gli animali d'affezione (PET) [[http://demo.izs.it/help/farmaco/help/flussi#Diagramma_di_flusso_per_gli_animali_d.27affezione_.28PET.29_e_cavalli_NDPA_attraverso_la_ricetta_veterinaria_elettronica|link]]
 * emissione ricetta veterinaria elettronica [[http://demo.izs.it/help/farmaco/help/flussi#Diagramma_di_flusso_emissione_ricetta_veterinaria_elettronica|link]]
Line 286: Line 26:
=== Tracciato di input ===
Di seguito la descrizione dei campi da inviare.
== Funzionalità dell'applicativo ==
 * [[farmaco/help/emissionericetta|Emissione Ricetta]]
 * [[farmaco/help/richiestafornitura|Richiesta Fornitura]]
 * [[farmaco/help/fornitura|Fornitura Medicinali]]
  * [[farmaco/help/fornitura/autorizzazione|Autorizzazione delle forniture]]
 * [[farmaco/help/fornitura_mangimi|Fornitura Mangimi Medicati]]
 * [[farmaco/help/trattamenti_granulare|Trattamento]]
 * [[farmaco/help/indicazione_terapeutica|Indicazione terapeutica]]
 * [[farmaco/help/protocolli|Protocolli terapeutici]]
 * [[farmaco/help/scorta_granulare|Gestione della Scorta]]
 * [[farmaco/help/farmaci_preferiti|Gestione dei farmaci preferiti]]
 * [[farmaco/help/mangimi_preferiti|Gestione dei mangimi preferiti]]
 * [[farmaco/help/gestione_numero_aziendale_bovini|Gestione numero aziendale capi bovini]]
 * [[farmaco/help/gestione_anagrafiche|Gestione delle anagrafiche]]
 * [[farmaco/help/reports|Reports per SSN]]
 * [[farmaco/help/controlliUfficiali|Indicatori ed estrazioni dati a supporto dei Controlli Ufficiali]]
 * [[farmaco/help/farmacovigilanza|Farmacovigilanza Veterinaria]]
Line 289: Line 44:
Il risultato della ricerca è "paginato": il risultato della ricerca viene restituito in N pagine da X righe. Il numero massimo "x" di righe da restituire per pagina (gruppo di risultati) e la pagina da visualizzare vengono pilotati da chi invoca il servizio di ricerca, quindi i seguenti campi sono obbligatori: = Domande Frequenti (FAQ) =
Al seguente link sono fornite risposte ufficiali ad alcune domande frequenti [[farmaco/help/faq|Frequently Asked Questions]].
Line 291: Line 47:
 * '''page''': pagina ritornata dalla ricerca (nella prima invocazione del servizio tale campo è da valorizzare con il valore "1") | Numerico;
 * '''rows''': numero massimo di righe tornate dalla ricerca (valore compreso tra 1 e 100) | Numerico.
= APP per dispositivi mobili (Smartphone&Tablet) =
Tutte le informazioni relative all'app sono disponbili al seguente [[https://ricettaveterinariaelettronica.it/app.html|indirizzo]]
Line 294: Line 50:
Si seguito la descrizione dei campi dell'entita '''scortavet''' gestiti in input/output: = Materiale utilizzato durante i corsi di formazione =
L'elenco delle presentazioni utilizzate nei principali corsi di formazione o eventi divulgativi è consultabile al seguente [[farmaco/help/materiale_corsi|indirizzo]].
Line 296: Line 53:
 * '''scovetId''': id del record | Numerico;
 * '''vetPersIdFiscale''': ID fiscale (Codice o P.IVA) del veterinario responsabile o delegato alla gestione della scorta | Stringa;
 * '''flResponsabile''': flag che indica se il veterinario è o meno il responsabile della scorta; possibili valori | Stringa:
  * '''S''': responsabile;
  * '''N''': delegato.
 * '''aziendaCodice''': codice dell'azienda zootecnica a cui fa riferimento la relazione | Stringa;
 * '''propIdFiscale''': ID fiscale (Codice o P.IVA) del proprietario dell'azienda zootecnica a cui fa riferimento la relazione | Stringa;
 * '''tiposcortaCodice''': tipologia della scorta; possibili valori | Stringa:
  * '''STRUTTURA''': Scorta della Struttura non Zootecnica;
  * '''SCORFITT''': Registro delle rimanenze della struttura zootecnica senza scorta;
  * '''PROPRIA''': Scorta del veterinario;
  * '''DETENTORE''': Scorta del detentore;
  * '''ALLEVAMENTO''': Scorta per allevamento.
 * '''strutturaCodice''': codice della Struttura non Zootecnica a cui fa riferimento la relazione | Stringa;

===== Esempio di interrogazione =====
{{{#!highlight
    page:1
    rows:50
    aziendaCodice:001TE001
}}}

===== Tracciato di output =====
{{{#!highlight
{
    "result": null,
    "data": {
  "total": 1,
  "page": 1,
  "records": 29,
  "rows": [...]
 }
}
}}}

Di seguito la descrizione dei campi:

 * '''total''': numero totale di pagine;
 * '''page''': pagina che si sta interrogando;
 * '''records''': numero totale di records;
 * '''rows''': elementi di scortavet;

=== Import tramite servizio REST/JSON ===
Il Sistema Informativo della Farmacosorveglianza permette di gestire i veterinari responsabili delle scorte in allevamento attraverso un apposito servizio REST/JSON. I veterinari responsabili della scorta possono essere inseriti solo dopo aver caricato l'autorizzazione alla detenzione della scorta in allevamento.

I campi previsti dal tracciato JSON sono gli stessi del file in formato CSV.

Viene di seguito riportato l'esempio tracciato dati JSON da utilizzare:

{{{#!highlight json
[{
        "tiposcortaCodice": "STRUTTURA",
        "strutturaCodice": "OV-PE000001",
        "vetPersIdFiscale": "SCCLDA40R10H811F",
        "flResponsabile": "S"
}, {
        "tiposcortaCodice": "ALLEVAMENTO",
        "aziendaCodice": "041TE040",
        "propIdFiscale": "RVRCRL62S29D969F",
        "vetPersIdFiscale": "RTAFNC75A20C342V",
        "flResponsabile": "S"
}, {
        "tiposcortaCodice": "ALLEVAMENTO",
        "aziendaCodice": "041TE122",
        "propIdFiscale": "SCCLDA40R10H811F",
        "vetPersIdFiscale": "BRSGNN52L24C469G"
}]
}}}

==== URL del servizio REST ====
Il servizio REST JSON è esposto al seguente URL (endpoint):

 * '''<url_server>/crudcommon/scortavet/ws/insert/''' (dove <url_server> varia in base all'ambiente: test o produzione)

==== Header ====
L’invocazione del servizio WEB REST deve avere i seguenti headers:

{{{#!highlight bash
    Content-Type: application/json
    Accept: application/json
}}}

==== Autenticazione ====
Le modalità di autenticazione per l'invocazione dei servizi REST sono descritte nell'apposito paragrafo della sezione del manuale con le informazioni base e tecnologie adottate dal Sistema Informativo Nazionale della Farmacosorveglianza per l'integrazione con i sistemi esterni, accedibile tramite il seguente URL: [[farmaco/help/integrazione]]

==== Tracciato di output ====
{{{#!highlight json
{
        "result": {
   "1": {
    "errors": [{
     "field": "",
     "message": "codice",
     "errorCode": "common.unknownerror"
    }],
    "errorType": null,
    "elencoCodici": null,
    "errore": <Descrizione dell'errore>
   }
        },
        "data": null
}
}}}

Viene di seguito riportata la descrizione dei due campi del JSON restituito:

 * '''data''': lista di elementi che non hanno problemi nella registrazione della fornitura;
 * '''result''': in questo campo, di tipo json, verranno collezionati i vari errori contenuti nei singoli elementi dell'array di importazione:
  * tale item è “null” se non si sono verificati errori;
  * nel caso in cui nel corso dell'elaborazione si fossero verificati errori, la chiave del json corrisponde all'errore avvenuto nell'i-esimo elemento inviato nel caso documentato l'errore è relativo all'elemento di indice i nel json di input.

Logica di elaborazione ATTENZIONE: La logica di elaborazione del tracciato JSON inviato al servizio REST è di tipo “transazionale”, e prevede quindi che in caso di errori tutti i dati inviati vengano scartati.

==== Update ====
Viene di seguito riportato l'esempio tracciato dati JSON da utilizzare:

{{{#!highlight json
{
    "scovetId": 178444,
    "flResponsabile": "N",
    "vetPersIdFiscale": "PSSMRA45E44D542K",
    "aziendaCodice": "217BG034",
    "tiposcortaCodice": "SCORFITT",
    "propIdFiscale": "MRCVCN71H10B157J"
}
}}}

===== URL del servizio REST =====
Il servizio REST JSON è esposto al seguente URL (endpoint):

 * '''<url_server>/crudcommon/scortavet/ws/update/''' (dove <url_server> varia in base all'ambiente: test o produzione)

===== Header =====
L’invocazione del servizio WEB REST deve avere i seguenti headers:

{{{#!highlight bash
    Content-Type: application/json
    Accept: application/json
}}}

===== Autenticazione =====
Le modalità di autenticazione per l'invocazione dei servizi REST sono descritte nell'apposito paragrafo della sezione del manuale con le informazioni base e tecnologie adottate dal Sistema Informativo Nazionale della Farmacosorveglianza per l'integrazione con i sistemi esterni, accedibile tramite il seguente URL: [[farmaco/help/integrazione]]

===== Tracciato di output =====
{{{#!highlight json
{
 "result": {
  "errors": [{
   "field": "",
   "message": "...",
   "errorCode": "common.unknownerror"
  }],
  "errorType": null,
  "elencoCodici": null,
  "errore": <Descrizione dell'errore>
 },
 "data": null
}
}}}

== Import da CSV dei mangimi ==
Il Sistema Informativo della Farmacosorveglianza permette ai veterinari libero professionisti di caricare massivamente l'elenco dei mangimi da utilizzare nelle presc attraverso un apposito file in formato CSV. Tale funzionalità è accessibile attraverso la voce di menu '''Altro''' -> '''Mangimi.'''

Il file in formato CSV da importare deve avere la seguente struttura:
||'''denominazione''' ||'''flTipomangime''' ||'''codice''' ||
||Mangime 1 ||X ||ALS123 ||
||Mangime 2 ||I ||ALS124 ||

Descrizione dei campi previsti dal file in formato CSV (in '''grassetto '''i campi obbligatori):

 * '''denominazione''': denominazione commerciale del mangime;
 * '''flTipomangime''': tipologia del mangime:
  * '''C''': Mangime completo;
  * '''I''': Prodotto intermedio;
  * '''X''': Mangime complementare;
 * '''codice''': codice del mangime (max 13 caratteri)

'''Attenzione''': nel file CSV non devono essere modificati i nomi (intestazioni) delle colonne. Fare attenzione alle minuscole e alle maiuscole. L'ordine delle colonne può essere variato.

= Gestione delle anagrafiche degli ambulatori veterinari e strutture di detenzione dei PET =
Sezione relativa alle funzionalità per l'importazione e il caricamento massivo delle anagrafiche degli ambulatori veterinari e strutture di detenzione dei PET.

== Tracciati importazione dati ==
Il seguente documento riporta i tracciati necessari al popolamento delle anagrafiche delle strutture di detenzione ed ambulatori veterinari gestiti nell’'''Anagrafe Ministeriale Centralizzata delle Strutture PET'''.

Dal seguente link è possibile scaricare il file con la descrizione dei tracciati, nel quale vengono illustrate le entità gestite e le informazioni necessarie per consentire una corretta alimentazione del sistema relativamente alle strutture di detenzione ed ambulatori veterinari:

 * [[attachment:Sinaaf-Ambulatori-Strutture_Di_Detenzione-v1.2.pdf]] (versione 1.2 - aggiornato al 01/06/2018)


Per il caricamento massivo delle strutture veterinarie bisogna predisporre un apposito file in formato CSV, per agevolarne la compilazione è possibile utilizzare il Template_SV appositamente preconfezionato.

 * [[attachment:Sinaaf-Template_SV.xlsx]]

Il Template è strutturato nel seguente modo:
 1. primo foglio denominato "Template_SV": deve essere compilato con i dati delle strutture veterinarie
 2. secondo foglio denominato "Tracciato_SV": è il tracciato delle strutture veterinarie in cui sono esplicitati i valori predefiniti e i vincoli sui dati
 3. terzo foglio denominato "COMUNI": è l'elenco dei comuni da cui leggere i valori delle colonne "comIstat" e "proSigla"

Per il caricamento massivo delle strutture di detenzione bisogna predisporre un apposito file in formato CSV, per agevolarne la compilazione è possibile utilizzare il Template_SD appositamente preconfezionato.

 * [[attachment:Sinaaf-Template_SD.xlsx]]

Il Template è strutturato nel seguente modo:
 1. primo foglio denominato "Template_SD": deve essere compilato con i dati delle strutture di detenzione
 2. secondo foglio denominato "Tracciato_SD": è il tracciato delle strutture di detenzione in cui sono esplicitati i valori predefiniti e i vincoli sui dati
 3. terzo foglio denominato "COMUNI" : è l'elenco dei comuni da cui leggere i valori delle colonne "prpComIstat" , "perProSigla", "comIstat" e "proSigla"
= Integrazione con sistemi informativi esterni (guida per le software house) =
La guida su come richiedere ed integrare i propri sistemi informativi con il Sistema Informativo Nazionale della Farmacosorveglianza è consultabile al seguente [[https://ricettaveterinariaelettronica.it/softwarehouse.html|indirizzo]].

Ultimo aggiornamento: 2024-03-29

Sito Informativo

Al seguente link è disponibile il sito informativo del Sistema della Farmaco Sorveglianza.

Manuale Utente

Di seguito si riportano sezione per sezione le risorse per la gestione del sistema informativo.

Funzionalità base dell'Interfaccia Utente

L'elenco delle funzionalità di base messe a disposizione dall'interfaccia utente dell'applicativo è consultabile al seguente indirizzo.

Gestione dell'account Utente

L'elenco delle funzionalità di base messe a disposizione degli utenti dell'applicativo la ga gestione del proprio account/profilo farmaco/help/gestioneprofilo.

Diagrammi di flusso gestione del medicinale veterinario attraverso la ricetta veterinaria elettronica

Al seguente link è possibile accedere ai diagrammi di flusso della gestione del medicinale veterinario attraverso la ricetta veterinaria elettronica: farmaco/help/flussi

  • gestione medicinali per gli animali da reddito (DPA) link

  • gestione medicinali per gli animali d'affezione (PET) link

  • emissione ricetta veterinaria elettronica link

Funzionalità dell'applicativo

Domande Frequenti (FAQ)

Al seguente link sono fornite risposte ufficiali ad alcune domande frequenti Frequently Asked Questions.

APP per dispositivi mobili (Smartphone&Tablet)

Tutte le informazioni relative all'app sono disponbili al seguente indirizzo

Materiale utilizzato durante i corsi di formazione

L'elenco delle presentazioni utilizzate nei principali corsi di formazione o eventi divulgativi è consultabile al seguente indirizzo.

Integrazione con sistemi informativi esterni (guida per le software house)

La guida su come richiedere ed integrare i propri sistemi informativi con il Sistema Informativo Nazionale della Farmacosorveglianza è consultabile al seguente indirizzo.

farmaco/help (last edited 2021-12-15 16:38:39 by a.deruvo)