Gestione delle anagrafiche delle Autorizzazioni detenzione Scorta e veterinari responsabili

Sezione relativa alle funzionalità per il caricamento massivo delle anagrafiche delle Autorizzazioni detenzione Scorta e Veterinari responsabili o loro delegati.

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):

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.

Esempio file CSV scorta propria (Veterinario)

Il file in formato CSV da importare deve avere la seguente struttura:

tiposcortaCodice

aziendaCodice

personeIdFiscale

strutturaCodice

scortaNumAutorizzazione

scortaDtInizio

aslCodice

scortaFlDerogaFornitura

PROPRIA

SCCLDA40R10H811F

AP45

02-07-2016

P106

N

PROPRIA

SCNMRC69E22E058V

TE12

02-07-2016

P110

N

Esempio file CSV scorta Allevamento Zootecnico

Il file in formato CSV da importare deve avere la seguente struttura:

tiposcortaCodice

aziendaCodice

personeIdFiscale

strutturaCodice

scortaNumAutorizzazione

scortaDtInizio

aslCodice

scortaFlDerogaFornitura

ALLEVAMENTO

041TE001

RVRCRL62S29D969F

XY67

01-07-2016

N

ALLEVAMENTO

011TE001

00060330677

XX123

01-05-2013

N

Esempio file CSV scorta Struttura non zootecnica

Il file in formato CSV da importare deve avere la seguente struttura:

tiposcortaCodice

aziendaCodice

personeIdFiscale

strutturaCodice

scortaNumAutorizzazione

scortaDtInizio

aslCodice

scortaFlDerogaFornitura

STRUTTURA

RI-AG000060

AG56

02-07-2016

N

STRUTTURA

RI-AG000160

AG34

01-08-2015

N

E' possibile scaricare il file in formato CSV di esempio (da poter utilizzare come template vuoto da compilare) direttamente dall'applicativo, nel seguente modo:

  1. accedere alla sezione "Autorizzazione Detenzione Scorta" e cliccare su uno dei pulsanti posti in fondo alla pagina:
  2. cliccare sul pulsante "Download template CSV".

Step 1

anagrafica_scorta_1.jpg

Step 2

anagrafica_scorta_2.jpg

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:

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

   1     Content-Type: x-www-form-urlencoded
   2     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:

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

Esempio di interrogazione

   1     page:1
   2     rows:50
   3     aziendaCodice:001TE001

Tracciato di output

   1 {
   2     "result": null,
   3     "data": {
   4                 "total": 1,
   5                 "page": 1,
   6                 "records": 29,
   7                 "rows": [...]
   8         }
   9 }

Di seguito la descrizione dei campi:

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:

   1 [
   2         {
   3                 "tiposcortaCodice": "ALLEVAMENTO",
   4                 "aziendaCodice": "039TE508",
   5                 "personeIdFiscale": "DNGVNI59B48B515B",
   6                 "scortaNumAutorizzazione": "TESTJSON",
   7                 "scortaDtInizio": "24-01-2017",
   8                 "aslCodice": "",
   9                 "scortaFlDerogaFornitura": "N"
  10         },
  11         {
  12                 "tiposcortaCodice": "PROPRIA",
  13                 "aziendaCodice": "",
  14                 "personeIdFiscale": "TSCTNN57A17E058B",
  15                 "scortaNumAutorizzazione": "TESTJSON1",
  16                 "scortaDtInizio": "24-01-2017",
  17                 "scortaFlDerogaFornitura": "N",
  18                 "aslCodice": "F118"
  19         },
  20         {
  21                 "tiposcortaCodice": "STRUTTURA",
  22                 "strutturaCodice": "RS-AG000052",
  23                 "scortaNumAutorizzazione": "STRUTACNINA",
  24                 "scortaDtInizio": "24-01-2017",
  25                 "scortaFlDerogaFornitura": "N",
  26                 "aslCodice": ""
  27         }
  28 ]

URL del servizio REST

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

Header

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

   1     Content-Type: application/json
   2     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

   1 {
   2         "result": {
   3                 "1": {
   4                         "errors": [{
   5                                 "field": "",
   6                                 "message": "...",
   7                                 "errorCode": "common.unknownerror"
   8                         }],
   9                         "errorType": null,
  10                         "elencoCodici": null,
  11                         "errore": <Descrizione dell'errore>
  12                 }
  13         },
  14         "data": null
  15 }

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

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:

Esempio aggiornamento scorta struttura:

   1 {
   2     "lovscortaId": 1932228,
   3     "scortaNumAutorizzazione": "012/2018-1",
   4     "scortaDtInizio": "15-04-2018",
   5     "tiposcortaCodice": "STRUTTURA",
   6     "scortaFlDerogaFornitura": "N",
   7     "strutturaCodice": "SV-200CA000790"
   8 }

Esempio aggiornamento scorta allevamento:

   1 {
   2     "lovscortaId": 6432,
   3     "scortaNumAutorizzazione": "PROVA-UP",
   4     "scortaDtInizio": "15-04-2018",
   5     "tiposcortaCodice": "ALLEVAMENTO",
   6     "scortaFlDerogaFornitura": "N",
   7     "propIdFiscale": "00548890409",
   8     "aziendaCodice": "039TE001"
   9 }

Esempio aggiornamento scorta propria del veterinario:

   1 {
   2     "lovscortaId": 6451,
   3     "scortaNumAutorizzazione": "PROVA-UP",
   4     "scortaDtInizio": "15-04-2018",
   5     "tiposcortaCodice": "PROPRIA",
   6     "scortaFlDerogaFornitura": "N",
   7     "vetPersIdFiscale": "RTAFNC75A20C342V",
   8     "aslCodice": "P106"
   9 }

URL del servizio REST

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

Header

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

   1     Content-Type: application/json
   2     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

   1 {
   2         "result": {
   3                 "errors": [{
   4                                 "field": "",
   5                                 "message": "....",
   6                                 "errorCode": "common.unknownerror"
   7                 }],
   8                 "errorType": null,
   9                 "elencoCodici": null,
  10                 "errore": <Descrizione dell'errore>
  11         },
  12         "data": null
  13 }

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

Esempio file CSV scorta Allevamento Zootecnico

Il file in formato CSV da importare deve avere la seguente struttura:

tiposcortaCodice

vetPersIdFiscale

aziendaCodice

propIdFiscale

flResponsabile

ALLEVAMENTO

RTAFNC75A20C342V

041TE001

RVRCRL62S29D969F

S

ALLEVAMENTO

SCNMRC69E22E058V

041TE001

RVRCRL62S29D969F

N

ALLEVAMENTO

BRSGNN52L24C469G

041TE122

SCCLDA40R10H811F

S

Nell'esempio precedente in particolare si ha che sulla scorta dell'allevamento 041TE001 ci sono due veterinari:

  1. il veterinario con CF RTAFNC75A20C342V è il veterinario responsabile della scorta;
  2. il veterinario con CF SCNMRC69E22E058V è un veterinario delegato ad operare sulla scorta dal responsabile della scorta stessa.

Esempio file CSV scorta Struttura non zootecnica

Il file in formato CSV da importare deve avere la seguente struttura:

tiposcortaCodice

vetPersIdFiscale

strutturaCodice

flResponsabile

STRUTTURA

SCCLDA40R10H811F

OV-PE000001

S

STRUTTURA

SCNMRC69E22E058V

OV-PE000022

S

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

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.

E' possibile scaricare il file in formato CSV di esempio (da poter utilizzare come template vuoto da compilare) direttamente dall'applicativo, nel seguente modo:

  1. accedere alla sezione "Autorizzazione Detenzione Scorta", effettuare una ricerca senza specificare filtri e cliccare su uno delle righe risultato della ricerca;
  2. cliccare sul pulsante "Associa Veterinario alla scorta";
  3. cliccare sul pulsante "Download template CSV".

Step 1

anagrafica_scorta_veterinari_1.jpg

Step 2

anagrafica_scorta_veterinari_2.jpg

Step 3

anagrafica_scorta_veterinari_3.jpg

Gestione tramite servizio web REST/JSON

Ricerca

Il sistema offre un metodo REST per la ricerca:

Header

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

   1     Content-Type: x-www-form-urlencoded
   2     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:

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

Esempio di interrogazione

   1     page:1
   2     rows:50
   3     aziendaCodice:001TE001

Tracciato di output

   1 {
   2     "result": null,
   3     "data": {
   4                 "total": 1,
   5                 "page": 1,
   6                 "records": 29,
   7                 "rows": [...]
   8         }
   9 }

Di seguito la descrizione dei campi:

Import

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:

   1 [{
   2         "tiposcortaCodice": "STRUTTURA",
   3         "strutturaCodice": "OV-PE000001",
   4         "vetPersIdFiscale": "SCCLDA40R10H811F",
   5         "flResponsabile": "S"
   6 }, {
   7         "tiposcortaCodice": "ALLEVAMENTO",
   8         "aziendaCodice": "041TE040",
   9         "propIdFiscale": "RVRCRL62S29D969F",
  10         "vetPersIdFiscale": "RTAFNC75A20C342V",
  11         "flResponsabile": "S"
  12 }, {
  13         "tiposcortaCodice": "ALLEVAMENTO",
  14         "aziendaCodice": "041TE122",
  15         "propIdFiscale": "SCCLDA40R10H811F",
  16         "vetPersIdFiscale": "BRSGNN52L24C469G"
  17 }]

URL del servizio REST

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

Header

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

   1     Content-Type: application/json
   2     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

   1 {
   2         "result": {
   3                         "1": {
   4                                 "errors": [{
   5                                         "field": "",
   6                                         "message": "codice",
   7                                         "errorCode": "common.unknownerror"
   8                                 }],
   9                                 "errorType": null,
  10                                 "elencoCodici": null,
  11                                 "errore": <Descrizione dell'errore>
  12                         }
  13         },
  14         "data": null
  15 }

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

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:

   1 {
   2     "scovetId": 178444,
   3     "flResponsabile": "N",
   4     "vetPersIdFiscale": "PSSMRA45E44D542K",
   5     "aziendaCodice": "217BG034",
   6     "tiposcortaCodice": "SCORFITT",
   7     "propIdFiscale": "MRCVCN71H10B157J"
   8 }

URL del servizio REST

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

Header

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

   1     Content-Type: application/json
   2     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

   1 {
   2         "result": {
   3                 "errors": [{
   4                         "field": "",
   5                         "message": "...",
   6                         "errorCode": "common.unknownerror"
   7                 }],
   8                 "errorType": null,
   9                 "elencoCodici": null,
  10                 "errore": <Descrizione dell'errore>
  11         },
  12         "data": null
  13 }

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:

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.

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.

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"

Specifiche servizi WEB

Il seguente documento riporta le specifiche dei servizi WEB esposti per il popolamento e la gestione 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 le specifiche dei servizi, 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: