ArcaGesan · Manuale d'uso

Come si usa il programma

Dal prelievo dei file Gesan alla scrittura in Arca Evolution: ogni schermata, ogni pulsante e cosa fa davvero.

1

Cosa fa ArcaGesan

ArcaGesan porta i due file TXT che Web Hospital/Gesan esporta (anagrafiche e movimenti contabili) dentro Arca Evolution, passando per un file Access "ponte" (Gesan_Fatture.accdb) che replica le query della procedura originale.

Il percorso è sempre lo stesso, in quattro tappe:

Esolver (cartella di rete) → Gesan (prelievo e anteprima) → Arca Evolution (scrittura e verifica) → Import Documenti in Arca

L'ultimo passo — "Import Documenti" dentro Arca Evolution stesso — resta manuale, fuori da ArcaGesan: qui ci si ferma alla scrittura nel file ponte e alla sua verifica.

2

Avviare il programma

Doppio click su avvia.bat. Il programma:

  • chiude in automatico una sessione server precedente rimasta aperta sulla stessa porta, così non capita mai di averne due insieme;
  • avvia il server in una finestra dedicata ("ArcaGesan - server");
  • apre da solo il browser sulla pagina del programma, appena il server è pronto.
Da tenere aperta

La finestra "ArcaGesan - server" va lasciata aperta finché si lavora — chiuderla ferma il programma (il browser resta aperto ma non risponde più). Per uscire, basta chiuderla quando si è finito.

3

All'apertura: nuova elaborazione o riprendi

Se ArcaGesan trova qualcosa di non ancora esaminato in questa sessione di lavoro — file Gesan pronti da un avvio precedente, oppure testate già scritte nel file ponte — lo dice subito, prima di mostrare qualunque sezione, e chiede di scegliere:

Nuova elaborazione

Dimentica tutto: azzera i file Gesan pronti e tutte le spunte "già fatto". Usarla quando quei dati non servono più (già importati altrove, o da scartare).

Riprendi quella precedente

Non tocca nulla: segna semplicemente il batch trovato come "esaminato", così le spunte tornano visibili senza dover rifare Analizza o Verifica da capo.

Poi si sceglie liberamente

Dopo aver risposto, non si apre nient'altro in automatico: da lì si decide da soli se andare su Gesan, Arca Evolution, Importazione Diretta o Strumenti.

4

Import Passo-Passo → 1. Gesan

1

Prelievo file da Esolver

Copia tutto dalla cartella di rete a Gesan (locale). Dai file appena copiati isola quelli con "Anagrafica" o "MovCont" nel nome, e li copia sia in Backup (nome originale, per archivio) sia con nome fisso — Anagrafica.txt / ImportCompleto.txt — pronti per l'analisi. Un box mostra il contenuto della cartella di rete: si aggiorna solo cliccando l'icona di refresh, non da solo, per non generare traffico continuo.

Verifica in automatico che ogni file di Esolver abbia una copia di uguale dimensione in Gesan. Se la verifica riesce, compare "Conferma pulizia cartelle di lavoro" con una checkbox opzionale — spuntata di default — per svuotare anche la cartella di rete Esolver.

2

Anteprima normalizzata

Mostra se i due file con nome fisso sono pronti (dimensione, data dell'ultimo prelievo). Il pulsante Analizza resta disabilitato finché mancano.

Se la verifica integrità fallisce

Nessuna cartella viene svuotata — né Gesan né Esolver: i file restano lì per un controllo manuale prima di riprovare. Diversamente dalla vecchia macro Access, che invece svuotava sempre.

Controlli & Verifiche

Dopo Analizza, mostra quattro numeri di riepilogo (Anagrafiche, Documenti, Totale importo, Anomalie) e pannelli a comparsa — chiusi finché non si clicca, aperti solo su richiesta dell'operatore — per ogni tipo di anomalia:

  • Anagrafiche mancanti: codici cliente citati nei documenti ma assenti in Anagrafica.txt;
  • Righe malformate/orfane: righe con meno campi del previsto, o righe di movimento senza la testata corrispondente (file probabilmente troncato);
  • Codici fiscali incoerenti: stesso codice cliente ma codice fiscale diverso da quello in anagrafica;
  • Documenti duplicati: stesso numero documento ripetuto nel file;
  • Riepilogo cassa, totale e per tipo documento (701 Ricevute, 703 Fatture) — ricostruito dai soli dati del file movimenti, utile per un controllo a occhio prima di scrivere in Arca.
5

Import Passo-Passo → 2. Arca Evolution

Sbloccata solo dopo Gesan

Nella sidebar, questa voce resta con un'icona a lucchetto e non si apre finché lo step Gesan non risulta completo (prelievo + anteprima esaminata) in questa sessione.

Import

Due pulsanti: Importa Fatture e Importa Ricevute. Vanno sempre eseguiti in quest'ordine sullo stesso batch — le ricevute si accodano sopra quanto scritto dalle fatture, mentre le fatture azzerano le tabelle native e ripartono da zero.

Ogni pulsante mostra il proprio esito: passi eseguiti, quanti nuovi codici cliente sono stati assegnati (e quanti riusati dal registro locale invece di generarne uno nuovo, per non dare due codici diversi allo stesso paziente in batch successivi non ancora importati).

F Fatture già fatte per questo batch R ultimo tentativo Ricevute fallito F non ancora eseguito

Controlli & Verifiche

Il pulsante Verifica rilegge quello che c'è ora nel file ponte e lo confronta con Arca in sola lettura — si può rifare in qualsiasi momento, anche dopo aver corretto qualcosa direttamente in Arca, senza dover rieseguire l'import. Tre pannelli:

  • DOTes: codici cliente non validi (il codice non inizia per "C" — anagrafica non risolta) e documenti che risultano già presenti in Arca (stesso tipo, divisione, numero, data ed esercizio);
  • DORig: codici cliente non validi, articoli non trovati in Arca (verranno importati comunque ma con conto generico), articoli trovati ma senza conto configurato, aliquote IVA non riconosciute;
  • DORigSpesa: quanti documenti hanno il bollo separato come riga propria (fattura, potenzialmente elettronica) e quanti no.
6

Importazione Diretta

Un solo pulsante esegue in sequenza Preleva → Anteprima → Importa Fatture → Importa Ricevute → Verifica, senza fermarsi a chiedere conferma a ogni passo. Utile per un batch già di routine, dove i controlli manuali non servono ogni volta.

Più prudente dell'originale Access

Si ferma subito al primo passo che fallisce, senza proseguire sui successivi a metà. E non svuota mai da sola la cartella di rete Esolver — solo quella di lavoro Gesan, e solo se il prelievo risulta integro: cancellare gli originali di rete resta sempre un passo manuale, dalla sezione Gesan.

In fondo alla pagina, due pulsanti aprono direttamente i pannelli Controlli Gesan / Controlli Arca Evolution per vedere subito i dettagli di quanto appena eseguito, senza dover ripetere i passaggi manuali.

7

Strumenti

Voce fissa nella sidebar, sempre raggiungibile indipendentemente dal punto del flusso in cui ci si trova. Contiene due strumenti operativi, non legati a un singolo batch:

Azzeramento Dati

Svuota in un solo click le tabelle di lavoro del file ponte (quelle che la procedura normale già svuota e ricrea a ogni batch) ed elimina i due file Anagrafica.txt/ImportCompleto.txt, per ripartire completamente da zero.

Non tocca mai le tabelle collegate ad Arca Evolution (dati live del gestionale) né MaxCliente (il contatore dei codici cliente). Il pulsante resta disabilitato finché non si spunta la conferma esplicita — operazione irreversibile, va usata consapevolmente.

Manuale di installazione

Apre in una nuova scheda la guida per il setup di ArcaGesan su un PC di un nuovo cliente: prerequisiti software (con link diretti agli installer), cosa includere nel pacchetto da trasferire, configurazione del driver ODBC/DSN per Arca Evolution, file .env e processo per mandare aggiornamenti futuri a un PC fuori dalla propria rete.

8

Legenda icone e badge

✓Fatto, nessuna anomalia — su una card o un passo.
!Fatto, ma con cose da controllare (anomalie non bloccanti).
/ Rosso: ci sono problemi da controllare in quel pannello. Verde: nessun problema.
!Avviso non bloccante: nessuno stop, ma vale la pena valutarlo prima di procedere in Arca.
F / RBadge Fatture/Ricevute sulla card Import di Arca Evolution — verde: fatto per questo batch; rosso: ultimo tentativo fallito; grigio: non ancora eseguito.
🔒Sezione bloccata: va completato prima lo step precedente (es. Arca Evolution richiede Gesan completato).
← / →In alto nell'intestazione: tornano alla pagina precedente/successiva già vista, senza dover rifare le azioni.
Manuale d'uso di ArcaGesan (C:\ArcaGesan) — per il setup su un PC nuovo vedi il Manuale di installazione, raggiungibile dalla sezione Strumenti del programma.