Differences between revisions 1 and 131 (spanning 130 versions)
Revision 1 as of 2015-08-27 15:15:05
Size: 3659
Editor: a.santurbano
Comment:
Revision 131 as of 2023-02-28 11:25:19
Size: 12007
Editor: r.sciamanna
Comment:
Deletions are marked like this. Additions are marked like this.
Line 2: Line 2:
<<TableOfContents(3)>> <<TableOfContents>>

= Regole generali =
Per la fornitura dei medicinali attraverso la ricetta elettronica valgono le seguenti regole generali, applicabili alle funzionalità disponibili tramite le maschere online e alle funzionalità disponibili tramite servizi web esposti:

 1. per l’erogazione dei medicinali veterinari la ricetta elettronica potrà essere recuperata tramite:
  1. il numero identificativo e pin della stessa;
  1. intestatario della ricetta (codice azienda zootecnica, codice fiscale persona, ecc.) e pin della stessa.
 1. i medicinali sono identificati in maniera univoca tramite il loro AIC;
 1. nella fornitura dei medicinali vanno riportati il codice di lotto e la data di scadenza dei medicinali movimentati;
 1. a seguito di evasione parziale, utilizzando sempre lo stesso numero identificativo di prescrizione e PIN è possibile completare la fornitura (farmaci mancanti).
Line 14: Line 24:
Il sistema permette di effettuare la ricerca della ricetta sulla base di numero e pin o per quelle aziende che hanno effettuato espressa richiesta di rendere visibile a chiunque le proprie ricette. Di seguito sono evidenziate le due modalita operative nel caso si operi direttamente dal sistema informativo.

{{attachment:flusso_fornitura_medicinali.jpg}}

=== Ricerca ricetta mediante numero e pin ===
Line 15: Line 30:
Line 17: Line 33:
E' possibile procedere alla fornitura dei farmaci inserendo nella maschera di ricerca della ricetta facendo attenzione alla scrittura del numero della ricetta affinché non contenga caratteri ''sporchi'' tipo ad esempio spazio che potrebbero impedire la corretta ricerca.
Una volta inserito il numero è possibile procedere con la ricerca cliccando sul relativo bottone.
Se la ricerca avrà esito positivo la tabella sottostante la form di ricerca restituirà un risultato, come nell'immagine di seguito
Line 21: Line 34:
{{attachment:fornitura-ricerca.PNG}} E' possibile procedere alla fornitura dei farmaci inserendo nella maschera di ricerca della ricetta facendo attenzione alla scrittura del numero della ricetta affinché non contenga caratteri ''sporchi'' tipo ad esempio spazio che potrebbero impedire la corretta ricerca. Una volta inserito il numero è possibile procedere con la ricerca cliccando sul relativo bottone. Se la ricerca avrà esito positivo la tabella sottostante la form di ricerca restituirà un risultato, come nell'immagine di seguito

{{attachment:fornitura-ricerca-semplice.PNG}}
Line 24: Line 39:
Line 25: Line 41:
 2. Selezione della riga e click sul bottone '''Visualizza Dettaglio'''  1. Selezione della riga e click sul bottone '''Visualizza Dettaglio'''
Line 31: Line 47:
Una volta inserito il PIN, se questo risulta corretto, avremo accesso alla maschera di dettaglio della fornitura che si presenta nel seguente modo: Una volta inserito il PIN, se questo risulta corretto, avremo accesso alla maschera di dettaglio della fornitura
Line 33: Line 49:
=== Ricerca ricetta per azienda con deroga sulla privacy ===
Le aziende zootecniche possono far richiesta di andare in deroga sulla gestione della privacy delle proprie ricette e rendere quindi queste visibili a chiunque; in questo caso se si sta effettuando una fornitura per un'azienda del genere bisogna cambiare il flag '''Deroga fornitura farmaci''' da ''No'' a ''Si'', di conguenza la maschera cambierà come nell'immagine di sotto e sarà necessario inserire semplicemente il codice dell'azienda zootecnica in modo da aver accesso all'elenco delle ricette che è possibile fornire.

{{attachment:fornitura-ricerca-deroga.PNG}}

Dopo aver cliccato su ricerca è possiible selezionare un ricetta per la fornitura nel seguente modo:

 1. Doppio click sulla riga
 1. Selezione della riga e click sul bottone '''Visualizza Dettaglio'''

=== Maschera fornitura ricetta ===
Line 36: Line 63:
Line 37: Line 65:
 2. Area verde: zona di vendita dei farmaci, dov'è inoltre possibile avere il dettaglio da ricetta
 3. Area rossa: zona relativa al dettaglio della vendita in caso siano state effettuate forniture parziali, utile nel caso ci si accorga che si è appena sbagliato ad effettuare la fornitura
 1. Area verde: zona di vendita dei farmaci, dov'è inoltre possibile avere il dettaglio da ricetta
 1. Area rossa: zona relativa al dettaglio della vendita in caso siano state effettuate forniture parziali, utile nel caso ci si accorga che si è appena sbagliato ad effettuare la fornitura. Nel caso siano gia presenti forniture parziali effettuate dalla vostra farmacia, alla selezione del farmaco queste appariranno nella tabella evidenziata, come nella figura di seguito

Con il pulsante "Visualizza ricetta" è possibile aprire il PDF della ricetta emessa.

{{attachment:fornitura-parziale.PNG}}

E' possibile che la ricetta sia stata parzialmente fornita anche da altre farmacie. In tal caso non sarà possibile visualizzare il dettaglio di tali forniture. E' possibile pero' notare che una ricetta è stata parzialmente fornita, confrontando la quantità del prodotto da fornire con la richiesta iniziale della ricetta (visibile tramite il pulsante "Visualizza ricetta")
Line 42: Line 76:
Line 43: Line 78:
 2. Selezione della riga e click sul bottone '''Vendita'''  1. Selezione della riga e click sul bottone '''Vendita'''
Line 49: Line 85:
Line 50: Line 87:
 2. Area gialla: zona di vendita dei farmaco
Una volta inseriti i campi obbligatori contraddistinti da un '''asterisco (*) rosso''' è possibile procedere alla fornitura del farmaco 
 1. Area gialla: zona di vendita dei farmaco

Una volta inseriti i campi obbligatori contraddistinti da un '''asterisco (*) rosso''' è possibile procedere alla fornitura del farmaco
Line 55: Line 93:
 1. Procedere alla ricerca di eventuali Farmaci compatibili, facendo click sul bottone '''Vai al prontuario'''. Verrete spostati nel '''''Prontuario Farmaceutico Veterinario''''' gestito dal Ministero della Salute.
 2. Una volta scelto il farmaco tornate sulla popup di vendita del farmaco, facendo click sul bottone evidenziato dal cerchio azzurro nell'immagine di sopra procedete alla cancellazione del farmaco prescritto dal Veterinario e inserite il nuovo farmaco da voi scelto digitandone il nome.

1. Procedere alla ricerca di eventuali Farmaci compatibili. Eventualmente facendo click sul bottone '''Vai al prontuario''', verrete spostati nel '''''Prontuario Farmaceutico Veterinario''''' gestito dal Ministero della Salute, dal quale è possibile effettuare delle ricerche avanzate (es. Ricerca per principio attivo, ecc...). La ricerca sul prontuario è facoltativa, nel caso si è già a conoscenza della denominazione del farmaco da sostituire passare direttamente al punto 2;
 1. Una volta scelto il farmaco tornate sulla popup di vendita del farmaco, facendo click sul bottone evidenziato dal cerchio azzurro nell'immagine di sopra procedete alla cancellazione del farmaco prescritto dal Veterinario e inserite il nuovo farmaco da voi scelto digitandone il nome.
Line 60: Line 99:
A parità di Farmaco, identificato dalle prime sei cifre dell'AIC, è possibile effettuare una maggiorazione relativamente al numero di scatole fornite. Il sistema prima richiederà se siete sicuri di effettuare la sostituzione:

{{attachment:fornitura-conferma-sostituzione.png}}

Dopo di che chiederà una seconda conferma come nella popup seguente:

{{attachment:fornitura-conferma-maggiorazione.png}}
Line 61: Line 108:
Oltre alle funzionalità online per la fornitura manuale delle ricette elettroniche (vendita dei medicinali), il sistema informativo permette di effettuare la registrazione “massiva” dei medicinali forniti tramite un file in formato ''CSV''.

=== Tracciato del file CSV ===
Il file CSV deve avere la seguente struttura:

||numero ||pin ||prodAic ||flTipomedicinale ||galenico ||fornProdAic ||quantitaFornita ||dtScadenza ||numLotto ||gtinCodice ||tipodocumentoCodice ||numDocumento ||dtFornitura ||flStatoSostituzione ||
||1456923503953 ||4186 ||104862127 ||N || || ||1 ||21/12/2030 ||testimportRidotto || || || || || ||




'''''E' obbligatorio passare l'intestazione delle colonne'''''

=== Descrizione dei campi del tracciato ===
Vengono di seguito riportate le descrizioni dei campi obbligatori:

 * '''numero''': numero della ricetta | Numerico, Lunghezza(14);
 * '''pin''': pin della ricetta | Numerico, Lunghezza(4,0);
 * '''prodAic''': AIC del medicinale veterinario da fornire (è il prodotto prescritto dal veterinario) | Alfanumerico, Lunghezza(9,0);
  * '''NB''': nel caso di sostituzione del medicinale questo campo non deve essere modificato, ma deve essere lasciato l’AIC del farmaco prescritto dal veterinario, bisogna inserire l’AIC del farmaco effettivamente fornito nel campo fornProdAic;
  * Non deve essere valorizzato nel caso di mangime medicato;
 * '''flTipomedicinale''': flag che indica il tipo di medicinale fornito, i cui possibili valori sono:
  * "N": medicinale veterinario (prodotto autorizzato non galenico);
  * "S": galenico;
  * "C": mangime completo;
  * "X": mangime complementare;
  * "I": prodotto intermedio;
 * '''galenico''': nel caso in cui il flTipomedicinale = ‘S’ questo campo deve essere popolato con la descrizione del galenico | Alfanumerico, Lunghezza(2000);
 * '''fornProdAic''': AIC del prodotto fornito in sostituzione del medicinale prescritto | Alfanumerico, Lunghezza(9,0);
  * '''NB''': da valorizzare solo se si stà effettuando una sostituzione del medicinale prescritto;
  * Non deve essere valorizzato nel caso di mangime medicato;
 * '''quantitaFornita''': quantità di medicinale o kg di mangime medicato fornito (il vecchio campo numConfezioni rimane gestito per compatibilità) | Numerico, Lunghezza(9,0);
 * '''dtScadenza''': data di scadenza | Stringa, formati ammessi gg-mm-aaaa oppure gg/mm/aaaa;
  * NB: Se si forniscono medicinali con differenti lotti e con differenti date di scadenza è sufficiente compilare due distinte righe per lo stesso medicinale;
 * '''numLotto''': numero di lotto | Alfanumerico, Lunghezza(50).
 * '''flStatoSostituzione''': in caso di sostituzione di farmaco, indica se la sostituzione necessita di autorizzazione del veterinario. Valori possibili (default S):
  * "S": la sostituzione necessita di approvazione da parte del veterinario prescrittore;
  * "F": la sostituzione NON necessita di approvazione da parte del veterinario prescrittore;

Vengono di seguito riportate le descrizioni dei campi non obbligatori:

 * '''gtinCodice''': codice GTIN del medicinale venduto | Numerico, Lunghezza(14,0);
 * '''tipodocumentoCodice''': tipologia di documento collegato alla fornitura; i possibili valori di questo campo sono i seguenti:
  * '''R''': Ricetta;
  * '''F''': Fattura;
  * '''A''': Altro documento;
  * '''D''': Documento di trasporto;
 * '''numDocumento''': numero del documento collegato alla fornitura | Alfanumerico, Lunghezza(100,0);
 * '''dtFornitura''': la data di fornitura | Stringa, formati ammessi gg-mm-aaaa oppure gg/mm/aaaa;
  * Se non inserita il sistema considera la data odierna;

=== Invio del file CSV ===
Per procedere all'import massivo delle forniture è sufficienete cliccare sul bottone “Import CSV forniture” nella maschera di fornitura dei medicinali. Verrà quindi aperta una popup come nell'immagine:

{{attachment:fornitura-popup-import-massivo.png}}

Nella popup si potrà scegliere il file da importare. Spuntare il flag “Consenti fornitura maggiorata” se nel csv che si va ad importare sono presenti delle sostituzioni dei medicinali prescritti, con numero di confezioni fornite maggiorate rispetto al numero di confezioni originariamente prescritte.

=== Logica di elaborazione ===
ATTENZIONE: la logica di elaborazione del file CSV inviato è di tipo “transazionale”, e prevede quindi che in caso di errori tutti i dati inviati vengano scartati.



== 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]].

Regole generali

Per la fornitura dei medicinali attraverso la ricetta elettronica valgono le seguenti regole generali, applicabili alle funzionalità disponibili tramite le maschere online e alle funzionalità disponibili tramite servizi web esposti:

  1. per l’erogazione dei medicinali veterinari la ricetta elettronica potrà essere recuperata tramite:
    1. il numero identificativo e pin della stessa;
    2. intestatario della ricetta (codice azienda zootecnica, codice fiscale persona, ecc.) e pin della stessa.
  2. i medicinali sono identificati in maniera univoca tramite il loro AIC;
  3. nella fornitura dei medicinali vanno riportati il codice di lotto e la data di scadenza dei medicinali movimentati;
  4. a seguito di evasione parziale, utilizzando sempre lo stesso numero identificativo di prescrizione e PIN è possibile completare la fornitura (farmaci mancanti).

Flusso di fornitura dei medicinali

Quanto di seguito va a descrivere il seguente flusso operativo relativamente alle operazioni effettuabili da un utente con profilo Farmacista:

farmacia-fornitura-flow.PNG

La fornitura di una ricetta avviene selezionando dal bottone Menu la voce Fornitura ricetta.

farmacia-menu.PNG

Fornitura mediante applicativo

Il sistema permette di effettuare la ricerca della ricetta sulla base di numero e pin o per quelle aziende che hanno effettuato espressa richiesta di rendere visibile a chiunque le proprie ricette. Di seguito sono evidenziate le due modalita operative nel caso si operi direttamente dal sistema informativo.

flusso_fornitura_medicinali.jpg

Ricerca ricetta mediante numero e pin

Una volta ottenuti:

  • Il NUMERO della ricetta

  • Il PIN della ricetta

E' possibile procedere alla fornitura dei farmaci inserendo nella maschera di ricerca della ricetta facendo attenzione alla scrittura del numero della ricetta affinché non contenga caratteri sporchi tipo ad esempio spazio che potrebbero impedire la corretta ricerca. Una volta inserito il numero è possibile procedere con la ricerca cliccando sul relativo bottone. Se la ricerca avrà esito positivo la tabella sottostante la form di ricerca restituirà un risultato, come nell'immagine di seguito

fornitura-ricerca-semplice.PNG

A questo punto è possibile accedere al dettaglio della fornitura in due modi:

  1. Doppio click sulla riga
  2. Selezione della riga e click sul bottone Visualizza Dettaglio

Verremo dunque spostati su una nuova maschera dove verrà richiesto l'inserimento del PIN della ricetta

fornitura-pin.PNG

Una volta inserito il PIN, se questo risulta corretto, avremo accesso alla maschera di dettaglio della fornitura

Ricerca ricetta per azienda con deroga sulla privacy

Le aziende zootecniche possono far richiesta di andare in deroga sulla gestione della privacy delle proprie ricette e rendere quindi queste visibili a chiunque; in questo caso se si sta effettuando una fornitura per un'azienda del genere bisogna cambiare il flag Deroga fornitura farmaci da No a Si, di conguenza la maschera cambierà come nell'immagine di sotto e sarà necessario inserire semplicemente il codice dell'azienda zootecnica in modo da aver accesso all'elenco delle ricette che è possibile fornire.

fornitura-ricerca-deroga.PNG

Dopo aver cliccato su ricerca è possiible selezionare un ricetta per la fornitura nel seguente modo:

  1. Doppio click sulla riga
  2. Selezione della riga e click sul bottone Visualizza Dettaglio

Maschera fornitura ricetta

fornitura-maschera.PNG

Com'è possibile evidenziare dall'immagine precedente possiamo suddividere l'area di lavoro in tre zone:

  1. Area blu: zona di riepilogo della ricetta
  2. Area verde: zona di vendita dei farmaci, dov'è inoltre possibile avere il dettaglio da ricetta
  3. Area rossa: zona relativa al dettaglio della vendita in caso siano state effettuate forniture parziali, utile nel caso ci si accorga che si è appena sbagliato ad effettuare la fornitura. Nel caso siano gia presenti forniture parziali effettuate dalla vostra farmacia, alla selezione del farmaco queste appariranno nella tabella evidenziata, come nella figura di seguito

Con il pulsante "Visualizza ricetta" è possibile aprire il PDF della ricetta emessa.

fornitura-parziale.PNG

E' possibile che la ricetta sia stata parzialmente fornita anche da altre farmacie. In tal caso non sarà possibile visualizzare il dettaglio di tali forniture. E' possibile pero' notare che una ricetta è stata parzialmente fornita, confrontando la quantità del prodotto da fornire con la richiesta iniziale della ricetta (visibile tramite il pulsante "Visualizza ricetta")

Fornitura di un farmaco

Per procedere con la fornitura di un farmaco è necessario selezionare il farmaco di interesse facendo:

  1. Doppio click sulla riga
  2. Selezione della riga e click sul bottone Vendita

Tale azione comporterà l'apertura di una popup come nell'immagine di seguito

fornitura-vendita.PNG

Com'è possibile evidenziare dall'immagine precedente possiamo suddividere l'area di lavoro in due zone:

  1. Area viola: zona di riepilogo della prescrizione relativa al farmaco che ci accingiamo a vendere
  2. Area gialla: zona di vendita dei farmaco

Una volta inseriti i campi obbligatori contraddistinti da un asterisco (*) rosso è possibile procedere alla fornitura del farmaco

Caso particolare: Sostituzione di un farmaco

Nel caso il farmaco richiesto dalla fornitura non risulti disponibile e si vuole procedere con una sostituzione è possibile:

  1. Procedere alla ricerca di eventuali Farmaci compatibili. Eventualmente facendo click sul bottone Vai al prontuario, verrete spostati nel Prontuario Farmaceutico Veterinario gestito dal Ministero della Salute, dal quale è possibile effettuare delle ricerche avanzate (es. Ricerca per principio attivo, ecc...). La ricerca sul prontuario è facoltativa, nel caso si è già a conoscenza della denominazione del farmaco da sostituire passare direttamente al punto 2;

  2. Una volta scelto il farmaco tornate sulla popup di vendita del farmaco, facendo click sul bottone evidenziato dal cerchio azzurro nell'immagine di sopra procedete alla cancellazione del farmaco prescritto dal Veterinario e inserite il nuovo farmaco da voi scelto digitandone il nome.

Per concludere la fornitura del farmaco è possibile far click sul bottone Vendi in basso a destra nella popup.

A parità di Farmaco, identificato dalle prime sei cifre dell'AIC, è possibile effettuare una maggiorazione relativamente al numero di scatole fornite. Il sistema prima richiederà se siete sicuri di effettuare la sostituzione:

fornitura-conferma-sostituzione.png

Dopo di che chiederà una seconda conferma come nella popup seguente:

fornitura-conferma-maggiorazione.png

Fornitura massiva mediante CSV

Oltre alle funzionalità online per la fornitura manuale delle ricette elettroniche (vendita dei medicinali), il sistema informativo permette di effettuare la registrazione “massiva” dei medicinali forniti tramite un file in formato CSV.

Tracciato del file CSV

Il file CSV deve avere la seguente struttura:

numero

pin

prodAic

flTipomedicinale

galenico

fornProdAic

quantitaFornita

dtScadenza

numLotto

gtinCodice

tipodocumentoCodice

numDocumento

dtFornitura

flStatoSostituzione

1456923503953

4186

104862127

N

1

21/12/2030

testimportRidotto

E' obbligatorio passare l'intestazione delle colonne

Descrizione dei campi del tracciato

Vengono di seguito riportate le descrizioni dei campi obbligatori:

  • numero: numero della ricetta | Numerico, Lunghezza(14);

  • pin: pin della ricetta | Numerico, Lunghezza(4,0);

  • prodAic: AIC del medicinale veterinario da fornire (è il prodotto prescritto dal veterinario) | Alfanumerico, Lunghezza(9,0);

    • NB: nel caso di sostituzione del medicinale questo campo non deve essere modificato, ma deve essere lasciato l’AIC del farmaco prescritto dal veterinario, bisogna inserire l’AIC del farmaco effettivamente fornito nel campo fornProdAic;

    • Non deve essere valorizzato nel caso di mangime medicato;
  • flTipomedicinale: flag che indica il tipo di medicinale fornito, i cui possibili valori sono:

    • "N": medicinale veterinario (prodotto autorizzato non galenico);
    • "S": galenico;
    • "C": mangime completo;
    • "X": mangime complementare;
    • "I": prodotto intermedio;
  • galenico: nel caso in cui il flTipomedicinale = ‘S’ questo campo deve essere popolato con la descrizione del galenico | Alfanumerico, Lunghezza(2000);

  • fornProdAic: AIC del prodotto fornito in sostituzione del medicinale prescritto | Alfanumerico, Lunghezza(9,0);

    • NB: da valorizzare solo se si stà effettuando una sostituzione del medicinale prescritto;

    • Non deve essere valorizzato nel caso di mangime medicato;
  • quantitaFornita: quantità di medicinale o kg di mangime medicato fornito (il vecchio campo numConfezioni rimane gestito per compatibilità) | Numerico, Lunghezza(9,0);

  • dtScadenza: data di scadenza | Stringa, formati ammessi gg-mm-aaaa oppure gg/mm/aaaa;

    • NB: Se si forniscono medicinali con differenti lotti e con differenti date di scadenza è sufficiente compilare due distinte righe per lo stesso medicinale;
  • numLotto: numero di lotto | Alfanumerico, Lunghezza(50).

  • flStatoSostituzione: in caso di sostituzione di farmaco, indica se la sostituzione necessita di autorizzazione del veterinario. Valori possibili (default S):

    • "S": la sostituzione necessita di approvazione da parte del veterinario prescrittore;
    • "F": la sostituzione NON necessita di approvazione da parte del veterinario prescrittore;

Vengono di seguito riportate le descrizioni dei campi non obbligatori:

  • gtinCodice: codice GTIN del medicinale venduto | Numerico, Lunghezza(14,0);

  • tipodocumentoCodice: tipologia di documento collegato alla fornitura; i possibili valori di questo campo sono i seguenti:

    • R: Ricetta;

    • F: Fattura;

    • A: Altro documento;

    • D: Documento di trasporto;

  • numDocumento: numero del documento collegato alla fornitura | Alfanumerico, Lunghezza(100,0);

  • dtFornitura: la data di fornitura | Stringa, formati ammessi gg-mm-aaaa oppure gg/mm/aaaa;

    • Se non inserita il sistema considera la data odierna;

Invio del file CSV

Per procedere all'import massivo delle forniture è sufficienete cliccare sul bottone “Import CSV forniture” nella maschera di fornitura dei medicinali. Verrà quindi aperta una popup come nell'immagine:

fornitura-popup-import-massivo.png

Nella popup si potrà scegliere il file da importare. Spuntare il flag “Consenti fornitura maggiorata” se nel csv che si va ad importare sono presenti delle sostituzioni dei medicinali prescritti, con numero di confezioni fornite maggiorate rispetto al numero di confezioni originariamente prescritte.

Logica di elaborazione

ATTENZIONE: la logica di elaborazione del file CSV inviato è di tipo “transazionale”, e prevede quindi che in caso di errori tutti i dati inviati vengano scartati.

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/fornitura (last edited 2023-02-28 11:25:19 by r.sciamanna)