Fisiodate

Ultimo aggiornamento: 18 set 2026fisiodate.md

Panoramica

Fisiodate è un software gestionale per studi fisioterapici e medici; questa migrazione legge file CSV esportati dal sistema sorgente e li importa in Alfadocs.
La migrazione copre: pazienti, appuntamenti, prestazioni (con listini e prezzi), piani di cura con voci di trattamento, referti testuali, fatture con righe di dettaglio e pagamenti.
Non sono presenti file companion per immagini o documenti allegati: le immagini e i documenti binari non vengono importati.

Entità importate

Pazienti
Operatori
Appuntamenti
Listini prezzi
Categorie prestazioni
Prestazioni (con prezzi per listino)
Piani di cura
Voci di piano di cura
Referti testuali (come documenti)
Fatture
Righe di fattura
Pagamenti (transazioni)
Metodi di pagamento
Colori operatore
Conto cassa (dummy)

Campi importati

Pazienti

Campo	Note
Codice paziente	Identificativo interno del CSV
Nome	Importato dal campo nome; se esiste già un paziente con lo stesso codice fiscale, viene aggiunto un suffisso numerico progressivo per distinguerli
Cognome	Importato dal campo cognome
Email	Importato così come appare nel CSV
Indirizzo	Via/piazza di residenza
Comune	Città di residenza
Provincia	Sigla provincia
CAP	Codice postale
Codice fiscale	Importato dal CSV; usato come chiave di deduplicazione
Data di nascita	Formato sorgente `gg/mm/aaaa`
Comune di nascita	Luogo di nascita
Consenso comunicazioni commerciali	SI/NO
Professione	Impiego dichiarato
Telefono	Importato come numero di telefono fisso
Cellulare	Importato come numero di cellulare

Operatori

Campo	Note
Identificativo	Cognome e nome del dottore; viene creato al primo appuntamento incontrato
Nome	Ricavato dalla divisione del nome completo
Cognome	Ricavato dalla divisione del nome completo
Colore agenda	Assegnato da una mappa fissa fornito dal cliente; gli altri operatori non ricevono un colore

Appuntamenti

Campo	Note
Paziente	Associato tramite codice paziente
Operatore	Associato tramite nome del dottore
Colore	Colore dell'operatore (vedi sezione Operatori)
Nome/trattamento	Testo del trattamento indicato nell'appuntamento
Data e ora di inizio	Formato sorgente `gg/mm/aaaa HH:MM`
Durata	Calcolata in minuti come differenza tra ora fine e ora inizio
Data di creazione	Data e ora di inserimento dell'appuntamento

Listini prezzi

Campo	Note
Identificativo e nome	i nomi vanno verificati rispetto alle intestazioni effettive del file export-trattamenti.csv

Categorie prestazioni

Campo	Note
Identificativo e nome	Ricavato dalla colonna categoria del CSV delle prestazioni; la categoria viene creata la prima volta che viene incontrata

Prestazioni

Campo	Note
Identificativo e nome	Nome della prestazione
Categoria	Associata alla categoria della prestazione
Durata predefinita	Letta dalla colonna "Durata Default"
Prezzi per listino	Per ciascuno dei listini viene creato un prezzo se il valore è diverso da `0,00`

Piani di cura

Campo	Note
Identificativo	Corrisponde all'identificativo del paziente (un piano per paziente)
Paziente	Associato tramite codice paziente
Branca	Sempre "generale"
Nome	Sempre "Piano cura"
Stato	"chiuso" per default; promosso a ""accettato se almeno una voce ha stato `APERTO` nel file sorgente
Data di creazione	Data del pacchetto della prima voce incontrata

Voci di piano di cura

Campo	Note
Piano di cura	Associato tramite identificativo paziente
Prestazione	Nome del trattamento dal CSV
Prezzo	Costo totale del pacchetto per la voce principale; `0` per le singole sedute
Etichetta seduta	Per le sedute: "Nome pacchetto - Nome trattamento N/Totale"
Completato	"SI/NO"
Data completamento	Data corrente se completato, altrimenti assente
Data di creazione	Data del pacchetto
Voci senza pacchetto	Le righe con campo pacchetto vuoto vengono saltate

Referti testuali (documenti)

Campo	Note
Identificativo	Riferimento del CSV
Paziente	Associato tramite numero paziente; le righe con paziente `0` (pazienti fittizi) vengono saltate
Nome	Nome del referto
Operatore	Costruito come "Cognome dottore" + spazio + "Nome dottore"
Contenuto	Testo del referto
Data	Formato sorgente `gg/mm/aaaa`

Fatture

Campo	Note
Identificativo	Numero documento
Direzione	Sempre "in uscita"
Tipo	Sempre "saldo
Piano di cura	Associato tramite identificativo paziente; se il paziente non ha ancora un piano di cura, ne viene creato uno automaticamente
Importo netto	Somma di competenze + IVA
Marca da bollo	`0` se il campo è `NO`, altrimenti importo della rivalsa marca da bollo
Numero progressivo	Numero progressivo della fattura
Data	Formato sorgente `gg/mm/aaaa`
Controparte cognome/nome
Controparte indirizzo	Via/piazza
Controparte CAP	Codice postale
Controparte comune	Città
Controparte provincia	Sigla provincia
Controparte codice fiscale	Se assente nel CSV, viene impostato il valore "Sconosciuto"
Fatture non abbinate	Se il paziente non viene trovato per codice fiscale + nome completo, la fattura viene saltata

Righe di fattura

Campo	Note
Fattura	Associata tramite numero documento
Descrizione	Testo della riga
Importo netto	Importo totale della riga
Aliquota IVA	Sempre `0`

Pagamenti (transazioni)

Campo	Note
Fattura	Associata tramite numero documento
Metodo di pagamento	Creato automaticamente se non esiste; nome preso dal CSV
Conto	Sempre il conto di default
Tipo	Sempre "in entrata"
Importo	Netto a pagare
Data	Data pagamento, formato `gg/mm/aaaa`
Condizione	Importato solo se lo stato del record è `Pagata`

Metodi di pagamento

Campo	Note
Identificativo e nome	Ricavato dal tipo di pagamento presente nelle fatture pagate; creato al primo utilizzo

Conto cassa

Campo	Note
Identificativo	`dummy`
Tipo	`cash`
Nome	"Sconosciuto"

Colori operatore

Campo	Note
Identificativo	Nome completo dell'operatore
Colore di sfondo	Valore fissa per gli operatori nominati; altri operatori non hanno colore

Limitazioni note

Un solo piano di cura per paziente: l'identificativo del piano di cura coincide con quello del paziente; se un paziente ha più pacchetti, tutti confluiscono in un unico piano.
Colori operatore hardcoded: solo cinque operatori specifici ricevono un colore agenda; tutti gli altri no.
Nomi listino hardcoded: i nomi dei tre listini sono fissi nel codice. Se le intestazioni del file CSV differiscono (anche per maiuscole/minuscole o spazi), i prezzi non vengono importati correttamente.
Pazienti non trovati nelle voci di piano di cura: quando un paziente non è univocamente identificabile e non è presente nella mappa fatture, la voce viene saltata con un avviso; un commento nel codice segnala che alcuni pazienti rimarranno non importati.
Pazienti duplicati: se più pazienti condividono lo stesso codice fiscale, viene aggiunto un suffisso numerico al nome. Nelle fatture, la presenza di duplicati abbinati per codice fiscale + nome completo causa un'eccezione bloccante.
Referti di pazienti fittizi o assenti: le righe paziente non presente nell'anagrafica importata vengono silenziosamente saltate.
Fatture senza corrispondenza paziente: se il paziente non viene trovato per codice fiscale + nome completo, la fattura viene ignorata senza avviso.
Data completamento voci piano di cura: quando una voce risulta completata, la data di completamento viene impostata alla data corrente dell'esecuzione della migrazione, non a una data storica.
Immagini e documenti allegati: non esistono file companion per le immagini o i documenti binari; questi dati non vengono importati.
Copertura temporale fatture: i file CSV delle fatture coprono il periodo gennaio 2017 – maggio 2024; dati al di fuori di questo intervallo non sono inclusi nell'export atteso.
Nessuna relazione appuntamento–voce piano di cura: gli appuntamenti non vengono collegati alle voci del piano di cura.