MOLTI ENTI E SOCIETA’ PUBBLICHE PRODUTTRICI DI SOFTWARE ISTITUZIONALE PER WINDOWS NON HANNO FINORA RITENUTO DI PUBBLICARE VERSIONI ANCHE PER GNU/LINUX O MULTIPIATTAFORMA, ESCLUDENDO DI FATTO PRIVATI CITTADINI, IMPRENDITORI E PROFESSIONISTI DALL’ACCESSO LIBERO AI SISTEMI INFORMATICI DELLA PUBBLICA AMMINISTRAZIONE, PER FAR FRONTE AD ADEMPIMENTI BUROCRATICI E GIURIDICI OBBLIGATORI; PER ESSI INFATTI SONO RICONOSCIUTI, IN MODO ILLEGITTIMO, SOLO SISTEMI OPERATIVI MICROSOFT WINDOWS.
L’AUTORE CONDANNA FERMAMENTE QUESTO SCANDALOSO COMPORTAMENTO DELLA P.A., E SI AUGURA CHE QUESTI ENTI E SOCIETA’ RENDANO FINALMENTE DISPONIBILE L’ACCESSO AI CITTADINI CHE, DI PIENO DIRITTO, UTILIZZANO INVECE SISTEMI OPERATIVI ALTERNATIVI A MS WINDOWS (CHIUSO E PROPRIETARIO).
GLI UTENTI SONO CALOROSAMENTE INVITATI A SOLLECITARE LE AMMINISTRAZIONI PUBBLICHE A CONSENTIRE IL LIBERO ACCESSO ALLE LORO PROCEDURE CON SISTEMI ALTERNATIVI A WINDOWS, NONCHE’ AD UTILIZZARE IN PRIMA BATTUTA, LADDOVE DISPONIBILE, SOFTWARE RILASCIATO ANCHE PER GNU/LINUX.
LA GUIDA SEGUENTE SI RIFERISCE INFATTI A “TRUCCHI” NON UFFICIALI PER I QUALI NON E’ MAI GARANTITA AL 100% LA COMPATIBILITA’ CON LA PROCEDURA UFFICIALE PER WINDOWS STABILITA DAL PRODUTTORE DEL SOFTWARE, NE’ CON IL RISULTATO IN TERMINI DI FORMATO E/O DI CONTENUTO DELLA PROCEDURA IN AMBIENTE WINDOWS, E CHE NON POSSONO MAI CON CERTEZZA E COMPLETEZZA SOSTITUIRE A TUTTI GLI EFFETTI L’AMBIENTE PER I QUALI SONO ORIGINARIAMENTE CONCEPITI.
.
.

***
GUIDA INCOMPLETA – resta da completare:
- l’utilizzo di alcuni controlli che al momento falliscono l’installazione e vanno installati copiando manualmente le parti interessate. Essi non vengono rilevati dal programma di riferimento, ma dovrebbero essere usabili.
***
.
Ora mi occupo della guida passo-passo per i moduli di controllo della SO.GE.I./Agenzia delle Entrate per la verifica formale del contenuto e della struttura dei file di cui è previsto l’invio telematico tramite Entratel o FileInternet-Fisconline, in base alle specifiche tecniche approvate.

Ricordo subito che i moduli di controllo in teoria non sono indispensabili al funzionamento dell’applicazione di invio telematico usata, a meno che non sia stato usato un programma di terze parti (al posto di quelli di tradizionali SO.GE.I./AdE) e se quindi i documenti non necessitano di un ulteriore controllo all’interno di Entratel o FileInternet-Fisconline. Nondimeno si precisa che, ove i documenti spediti non fossero formalmente o sostanzialmente compatibili con il modello-tipo previsto dall’AdE o non rispecchiassero il contenuto minimo obbligatorio secondo le specifiche tecniche, essi verrebbero SCARTATI dal sistema automatizzato del server dell’AdE con conseguente inadempimento degli obblighi tributari relativi: è assolutamente essenziale che l’utente sia conscio di questa eventualità e delle responsabilità che ne derivano.

Si rammenti in ogni caso che i programmi di invio telematico necessitano di versioni coerenti dei moduli di controlli, pertanto verificare che l’aggiornamento dei moduli di controlli avvenga di pari passo con quello del programma cui si riferiscono.
Poiché i moduli di controllo sono molti e non sempre facilmente installabili, ho preso la decisione di limitarmi ad una rassegna non esaustiva descrittiva dei più importanti moduli di controllo, tralasciandone altri. I moduli mancanti in ogni caso dovrebbero potersi installare in modo grossomodo analogo a quelli descritti.

I moduli sono prodotti da Agenzia delle Entrate e SO.GE.I. solo per piattaforma Windows e MacOS; essi dovranno essere adattati in qualche modo per farlo funzionare con il nostro sistema operativo. L’adattamento sarà presumibilmente più complicato di altri programmi, perché in diversi casi l’installazione automatica fallisce.
.
Prima di continuare la lettura si prega di prendere conoscenza delle CONDIZIONI DI UTILIZZO ed accettarle.
.

PREPARAZIONE

Nella guida, per evitare ripetizioni che potrebbero ingenerare confusione e per una migliore manutenibilità della guida stessa, si assumeranno le seguenti condizioni:
- con $HOME si identifica la directory /home/[utente] : dove [utente] è lo user name (senza parentesi) sulla macchina linux dell’operatore;
- la directory temporanea per i moduli e le altre aggiunte (es. applicazioni) (es. $HOME/tmp/modulicontrolloX) sarà indicata genericamente come $MODTEMP.
NOTA: si raccomanda l’utilizzo di nomi diversi di directory per ogni diverso modulo di controllo in modo di non fare confusione e mantenere una continuità negli aggiornamenti.

- la directory di destinazione nella quale i moduli saranno installati, cioè la stessa in cui il programma cui i moduli si riferiscono è già stato installato ($HOME/Entratel o $HOME/UnicoOnLine) sarà indicata come $PROGRDIR

Poiché i moduli di controllo fanno affidamento ai programmi base cui si riferiscono e la presenza quindi di Entratel o di FileInternet-Fisconline è pregiudiziale all’installazione di questi, verificare che siano regolarmente installati, prima di continuare.

La versione corrente dei moduli di controllo oggetto di questa guida è elencata appresso:
Controlli F24: 1.2.0 1.2.1 1.2.2 1.2.3 1.2.4 1.2.5 del 03/12/2007 1.2.6 1.2.7 del 10/01/2008
Moduli di controllo 2007: 1.5.0 1.5.1 1.6.0 1.6.1 1.6.2 1.6.3 1.6.4 1.6.5 del 11/10/2007
Modulo controllo studi 2007: 1.0.1 1.0.2 1.0.3 del 11/09/2007

Creiamo la directory $MODTEMP, e muoviamoci all’interno di essa.

Una volta autenticati con il proprio codice utente e password sul sito dell’Agenzia delle Entrate SERVIZI TELEMATICI scarichiamo in questa directory i file dei controlli sogei di interesse:
controlli_f24_127.exe (controlli per formato documento di invio pagamento per F24),
ModuliControllo2007_165.exe (controlli per dichiarazioni fiscali non ricomprese in altri controlli),
ModuliControlloStudi2007_103_Win_All.exe (controlli per studi di settore),
Controlli_AA7_AA9_160.exe (controllo per attribuzione, variazione o cessazione P.IVA),
LOC00450.exe (controllo contratti di locazione),
DEN00100.exe (controllo denunce cumulative affitto fondi rustici),
RIN00160.exe (controllo per pagamenti successivi alla registrazione),
tutti disponibili nella sezione Software – Pacchetti applicativi.

I moduli, concepiti per Windows, sono binari, con licenza proprietaria, senza disponibilità quindi di sorgenti. Essi utilizzano una macchina virtuale java della serie 1.3.x
E’ comunque assai probabile che anche la serie 1.5.x possa funzionare senza problema con Entratel (usare la versione più recente)

Servono altri utensili per scompattare il contenuto dei moduli, al fine di renderli usabili per GNU/Linux (per tutti si consiglia la versione più recente, verificare sui relativi siti):
upx (che serve a decomprimere un eseguibile)
unzip (che serve a scompattare il contenuto dell’eseguibile decompresso)
Per alcuni moduli di controllo servono invece:
unshield (che serve a scompattare gli archivi .cab prodotto con InstallShield)
cabextract (che serve a scompattare gli archivi .cab di tipo diverso da InstallShield)
Verificare che siano installati nel proprio sistema.
.
.

JAVA

Se si è già installato un altro programma dell’Agenzia delle Entrate/SO.GE.I. è probabile che questo passo sia già stato completato, in tal caso si può passare direttamente al successivo.

Altrimenti è opportuno leggere la guida software per Java
.
.

INSTALLAZIONE MODULI

NOTA: leggere prima tutta la sezione; ogni modulo può avere istruzioni particolari.

Recarsi nella directory $MODTEMP. Decomprimere l’eseguibile con upx -k -d nomeeseguibile.exe (con l’opzione -k si mantiene una copia di sicurezza con lo stesso nome e l’estensione .ex~)
Scompattare l’eseguibile con unzip nomeeseguibile.exe
NOTA: il nomeeseguibile è normalmente il nome del programma senza la .exe (es. controlli_f24_127 o ModuliControllo2007_165 o ModuliControlloStudi2007_103_Win_All, Controlli_AA7_AA9_160 oppure un altro controllo sogei che usa per l’installazione delle versioni recenti di LaunchAnywhere)

I file prodotti dallo scompattamento sono questi:
InstallerData/IAClasses.zip
InstallerData/laxmanifest.txt
InstallerData/uninstallmanifest.txt
Windows/nomeeseguibile.exe
Windows/nomeeseguibile.lax
Windows/resource/iawin32.dll
Windows/resource/iawin64.dll
Windows/resource/iawin64_x64.dll
Windows/resource/jdglue.zip
Windows/resource/remove.exe
Windows/resource/win64_32.exe
Windows/resource/win64_32_x64.exe
Windows/resource/ZGWin32LaunchHelper.exe
Windows/unicows.dll
InstallerData/Execute.zip
InstallerData/Disk1/InstData/Resource1.zip
InstallerData/Disk1/InstData/MediaId.properties
InstallerData/InstalledMedias.properties
InstallerData/MediaFiles.properties


NOTA: a proposito di nomeeseguibile valgono le considerazioni della nota precedente, ma potrebbe avere un nome diverso, verificare la parte iniziale prima del punto nel nome del file con estensione .lax

All’interno della directory $MODTEMP creare, come utente, uno script testuale di shell (es. installaModuloControlloX.sh, per il controllo sogei X, ecc…), da rendere poi eseguibile, con questo contenuto:

1 #!/bin/sh
2 export J2REDIR=/opt/jre1.3.1_20/
3 export PATH=$J2REDIR/bin:$PATH
4 export MANPATH=$J2REDIR/man:$MANPATH
5 export CLASSPATH=$J2REDIR/lib:$CLASSPATH
6 export JAVA_HOME=$J2REDIR
7 LD_LIBRARY_PATH=$J2REDIR java -classpath “InstallerData/IAClasses.zip: Windows/resource/jdglue.zip:InstallerData/Execute.zip: Windows/InstallerData/Execute.zip: InstallerData:Windows/InstallerData: InstallerData/Disk1/InstData/Resource1.zip” com.zerog.lax.LAX “Windows/nomeeseguibile.lax”

Note: a) I numeri in corrispondenza delle righe servono solo a far capire il cambio di riga, e NON vanno riportati nello script.
b) nomeeseguibile ha sempre il significato delle note precedenti.
c) la directory in corrispondenza di J2REDIR è quella dove abbiamo installato la macchina virtuale java della serie 1.3.x
d) il comando che inizia con “LD_LIBRARY_PATH” (fino alla fine) deve essere collocato tutto su una riga o convenientemente posizionato su più righe ognuna delle quali (a parte l’ultima) termina con un carattere di escape (“\”) e un ritorno a capo.

Recandoci nella directory temporanea relativa al programma da installare, eseguiamo lo script creato sopra, seguiamo le istruzioni e indichiamo, se richiesto, come directory di destinazione dell’installazione $PROGDIR, e proseguiamo in avanti fino al termine dell’installazione.

Il controllo controlli_f24 si installa regolarmente, p.es. come plug-in per Entratel, e sembra funzionare almeno per quanto riguarda la funzione Documenti – Controlla. Eseguire semplicemente lo script di installazione automatica.

I controlli ModuliControllo2007 e ModuliControlloStudi2007 non si installano in modo automatico, lamentandosi della mancanza del programma di riferimento, ma non permettono di indicare la directory in cui è effettivamente installato.
E’ assai probabile che copiando nella directory $PROGRDIR/prog la sotto-directory dell’installazione Windows p.es. di Entratel di nome prog/finanze, ovviamente dopo aver installato quei controlli in Windows, possano funzionare anche nel nostro sistema operativo.

Il controllo Controlli_AA7_AA9 si installa, ma sbaglia directory di installazione, creando una serie di file e directory all’interno della sotto-directory \prog (sic) della directory corrente. L’installazione automatica è quindi parziale e va completata come di seguito spiegato per questo controllo.

Un’altra possibilità per quei moduli che non si installano correttamente (indubbiamente molto più complicata), è quella di copiarli a mano, secondo il procedimento che segue.
.
INSTALLAZIONE MANUALE ModuliControllo2007
Dopo lo scompattamento dell’eseguibile ModuliControllo2007 come indicato sopra entrare nella directory $MODTEMP, scompattare con unzip il file InstallerData/Disk1/InstData/Resource1.zip
Creare la directory $PROGRDIR/prog/finanze/IDTE/
Recarsi poi nella sotto-directory (creata dallo scompattamento precedente) $MODTEMP/C_/Clearcase_Storage/CONTROLLI_V2007_svil/GTDDIC_src/Telem/bin/finanze/IDTE/ e copiare i file con cp -R main resources $PROGRDIR/prog/finanze/IDTE
Sempre nella sotto-directory della directory temporanea vi sono diversi file che terminano in _zg_ia_sf.jar (es. generale2007_zg_ia_sf.jar); vanno scompattati con unzip uno a uno in $PROGRDIR/prog/finanze/IDTE, facendo attenzione ad inserirli ognuno in una directory avente come nome la prima parte del nome del file _zg_ia_sf.jar (es. generale2007), e NON alla rinfusa: consiglio di usare unzip con l’opzione -d (es. unzip generale2007_zg_ia_sf.jar -d $PROGRDIR/prog/finanze/IDTE/generale2007).
Un modo più veloce per scompattarli tutti nella directory giusta potrebbe essere questo, su un’unica riga (dovrebbe funzionare, ma fare comunque attenzione, non sono un mago degli script in bash):

for a in *_zg_ia_sf.jar ; do N=$(echo $a|cut -f 1 -d “_”) ; unzip $a -d $PROGRDIR/prog/finanze/IDTE/$N ; done

Recandosi ora nella directory $MODTEMP/C_/Clearcase_Storage/RISORSE_V2007_svil/GTDDIC_src/Risorse/resources/finanze/IDTE/ copiare il contenuto della directory resources con cp resources/* $PROGRDIR/prog/finanze/IDTE/resources (in cui, ricordo, ci sono già dei file copiati prima)

INSTALLAZIONE MANUALE ModuliControlloStudi2007
Dopo lo scompattamento delle eseguibile ModuliControlloStudi2007 come indicato sopra entrare nella directory $MODTEMP, scompattare con unzip il file InstallerData/Disk1/InstData/Resource1.zip
Creare la directory $PROGRDIR/prog/finanze/IDTE/
Recarsi poi nella sotto-directory della $MODTEMP (creata dallo scompattamento precedente) D_/Installazioni/Risorse/2007/Telematico_Studi2007/Versione 1.0.3/Risorse/Completa: vi sono due file che terminano in _zg_ia_sf.jar (finanze_zg_ia_sf.jar e v8e1moto_zg_ia_sf.jar); il file finanze_zg_ia_sf.jar va scompattato con unzip e produrrà una serie di directory a partire da IDTE/Studi2007, copiare la sotto-directory Studi2007 sotto $PROGRDIR/prog/finanze/IDTE/; poi scompattare v8e1moto_zg_ia_sf.jar, e creare una nuova sotto-directory v8e1moto in $PROGRDIR/prog/ e copiare i file prodotti dallo scompattamento in $PROGRDIR/prog/v8e1moto.

INSTALLAZIONE PARZIALMENTE MANUALE Controlli_AA7_AA9
Dopo avere installato Controlli_AA7_AA9 in modo automatico è necessario spostare il contenuto della directory \prog nel luogo adatto:
Dopo aver creato, se necessario, la directory $PROGRDIR/prog/finanze/ si può effettuare la copia:

cp -R \\prog/finanze/anag $PROGRDIR/prog/finanze/

NOTA: si rammenta che il doppio carattere di escape “\\” prima di prog è necessario, poiché a differenza di windows in GNU/Linux il carattere “\” ha un significato speciale di cui tenere conto.

INSTALLAZIONE SEPARATA LOC00450.exe (contratti di locazione).
Alcuni moduli di controllo sogei più risalenti nel tempo non usano l’installazione usuale tramite LaunchAnywhere, bensi un programma prettamente windows basato su archivi .cab e InstallShield (oppure LaunchAnywhere in una versione più datata); in tal caso le istruzioni di installazione riportate sopra non servono e tutto va fatto manualmente seguendo queste altre istruzioni:
Recarsi nella directory $MODTEMP (si ricorda quanto detto sopra: una directory separata per ogni modulo). Eseguire

cabextract LOC00450.exe

Alcuni file tra cui SETUP.EXE, data1.cab ecc.. saranno presenti nella directory corrente. Per scompattare l’archivio .cab eseguire quindi:

unshield x data1.cab

Dopo aver creato, se necessario, la directory $PROGRDIR/prog/finanze/, copiare alcuni file e directory come di seguito:

cp -R Program_Executable_Files/prog/finanze/* $PROGRDIR/prog/finanze/
cp -R Program_Executable_Files/prog/org $PROGRDIR/prog/
cp -R Program_Executable_Files/prog/com $PROGRDIR/prog/

INSTALLAZIONE SEPARATA DEN00100.exe (denunce cumulative affitto).
Alcuni moduli di controllo sogei più risalenti nel tempo non usano l’installazione usuale tramite LaunchAnywhere, bensi un programma prettamente windows basato su archivi .CAB e InstallShield (oppure LaunchAnywhere in una versione più datata); in tal caso le istruzioni di installazione riportate sopra non servono e tutto va fatto manualmente seguendo queste altre istruzioni:
Recarsi nella directory $MODTEMP (si ricorda quanto detto sopra: una directory separata per ogni modulo). Eseguire

cabextract DEN00100.exe

Appariranno alcuni file tra cui SETUP.EXE, data1.cab ecc.. nella directory corrente. Per scompattare l’archivio .cab eseguire quindi:

unshield x data1.cab

Dopo aver creato, se necessario, la directory $PROGRDIR/prog/finanze/, copiare alcuni file e directory come di seguito:

cp -R Program_Executable_Files/prog/finanze/aden $PROGRDIR/prog/finanze/

INSTALLAZIONE SEPARATA RIN00160.exe (pagamenti successivi).
Alcuni moduli di controllo sogei più risalenti nel tempo non usano l’installazione usuale tramite LaunchAnywhere, bensi un programma prettamente windows basato su archivi .CAB e InstallShield (oppure LaunchAnywhere in una versione più datata); in tal caso le istruzioni di installazione riportate sopra non servono e tutto va fatto manualmente seguendo queste altre istruzioni:
Recarsi nella directory $MODTEMP (si ricorda quanto detto sopra: una directory separata per ogni modulo). Eseguire

cabextract RIN00160.exe

Appariranno alcuni file tra cui SETUP.EXE, data1.cab ecc.. nella directory corrente. Per scompattare l’archivio .cab eseguire quindi:

unshield x data1.cab

Dopo aver creato, se necessario, la directory $PROGRDIR/prog/finanze/, copiare alcuni file e directory come di seguito:

cp -R Program_Executable_Files/prog/finanze/arin $PROGRDIR/prog/finanze/