Differences between revisions 50 and 51
Revision 50 as of 2018-05-14 13:34:17
Size: 14835
Editor: a.santurbano
Comment:
Revision 51 as of 2018-05-17 07:47:18
Size: 13448
Editor: m.secone
Comment:
Deletions are marked like this. Additions are marked like this.
Line 6: Line 6:

== Import da CSV delle Anagrafiche Farmacie e Grossisti ==
Il Sistema Informativo della Farmacosorveglianza permette di caricare massivamente le anagrafiche delle farmacie e grossisti autorizzati alla vendita al dettaglio, attraverso un apposito file in formato CSV.

Il file in formato CSV da importare deve avere la seguente struttura:
||'''tipofarmaciaCodice''' ||'''descrizione''' ||'''numAutorizzazione''' ||'''cap''' ||'''comIstat''' ||'''comProSigla''' ||'''indirizzo''' ||
||FARMVET ||Farmacia IZS ||A123 ||64100 ||041 ||TE ||Via Campo boario 8 ||




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

 * '''tipofarmaciaCodice''': tipologia della farmacia, può avere i seguenti valori:
  * '''FARM''': Farmacia;
  * '''FARMGROS''': Grossista Farmaceutico;
  * '''FARMVET''': Farmacia Veterinaria.
 * '''descrizione''': denominazione della farmacia;
 * '''numAutorizzazione''': numero autorizzazione o codice farmacia;
 * '''cap''': CAP comune;
 * '''comIstat''': codice ISTAT del comune (eclusa la parte della provincia);
 * '''comProSigla''': sigla della provincia;
 * '''indirizzo''': indirizzo della farmacia.

'''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 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.

Import da CSV delle Anagrafiche Scorte Allevamento e Veterinario

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

ALLEVAMENTO

041TE001

RVRCRL62S29D969F

TESTCSVALLEV

01-07-2016

PROPRIA

SCCLDA40R10H811F

TESTCSVPROP

02-07-2016

P106

STRUTTURA

RI-AG000060

TESTCSVSTRUTTURA

02-07-2016

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

  • tiposcortaCodice: tipologia della scorta;

    • ALLEVAMENTO: Scorta dell'allevamento;

    • STRUTTURA: Scorta dell'allevamento;

    • 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: elencoAutorizzazioniScortaMedicinali.csv

Import tramite servizio REST/JSON delle Anagrafiche Scorte Allevamento, Veterinario e Strutture

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

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

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": "error.prodottofornito.non.trovato",
   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:

  • 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.

Import da CSV dei Veterinari responsabili della scorta

Il Sistema Informativo della Farmacosorveglianza permette di caricare massivamente i veterinari responsabili delle scorte in allevamento 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: elencoVeterinariScortaAllevamento.csv

Import tramite servizio REST/JSON dei Veterinari responsabili della scorta

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

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

   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": "error.prodottofornito.non.trovato",
   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:

  • 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.

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: Sinaaf-Ambulatori-Strutture_di_Detenzione_PET.pdf

farmaco/help/gestione_anagrafiche (last edited 2018-12-10 07:19:45 by m.ferella)