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

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

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:

   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 }

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

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.

Dal seguente link è possibile scaricare il file in formato CSV di esempio: elencoVeterinariScortaAllevamento.csv

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

   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 }

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

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:

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"