servizio telematico entratel - Servizi Telematici

SERVIZIO TELEMATICO ENTRATEL
Applicazione “Controllo Multifile”
per le comunicazioni relative alla costituzione
dell’Anagrafe dei Rapporti
versione 1.0.0
Aprile 2007
1. Premessa.................................................................................................................................................1
2. Installazione...........................................................................................................................................1
3. Configurazione dell’ambiente e dei parametri per l’esecuzione............................................................2
3.1. Denominazione del log..................................................................................................................3
4. Esecuzione dell’applicazione.................................................................................................................3
4.1. Anomalie all’avvio della procedura di controllo...........................................................................4
5. Esito del controllo..................................................................................................................................4
6. Controllo dei file da trasmettere all’Agenzia delle Entrate....................................................................5
1. Premessa
L’applicazione “Controllo Multifile per le Comunicazioni all’Anagrafe dei Rapporti” (nel seguito
“Controllo Multifile CCB”) è stata predisposta per consentire agli utenti del servizio telematico Entratel di
sottoporre a controllo, con un’elaborazione di tipo batch, i file contenenti le comunicazioni all’Anagrafe dei
Rapporti da trasmettere all’Agenzia delle Entrate.
L’utilizzo è pertanto consigliato esclusivamente a coloro che hanno necessità di elaborare contestualmente
un numero significativo di file.
L’applicazione “Controllo Multifile CCB” richiede necessariamente la presenza, sulla postazione di
lavoro, della JVM 1.3.1_13 e dell'applicazione “Entratel” (versione 4.2.2 o superiori) e del modulo di
controllo per le “Comunicazioni Anagrafe dei Rapporti” (versione 1.0.0 o superiori).
2. Installazione
Per predisporre l’ambiente di lavoro per il controllo in modalità batch, lanciare il file MuxCCBBat.exe per
avviare la procedura guidata dell’installazione al termine della quale l’applicazione “Controllo Multifile
CCB” sarà disponibile nella cartella dell’applicazione “Entratel”. Pertanto, la procedura non andrà a buon
fine se:
non risulta installato l’applicativo Entratel o la versione è precedente alla 4.2.2
non risulta installato il pacchetto per il controllo delle Comunicazioni all’Anagrafe dei Rapporti.
In tal caso provvedere all’installazione degli applicativi mancanti.
Se l’installazione avviene correttamente, nella cartella “prog” della directory di installazione di Entratel,
“…\Entratel\prog”, sono presenti:
-
un file di configurazione dei parametri dell’applicazione, controllaMFCCB.txt
-
un file .bat contenente la sequenza di comandi per l’avvio dell’applicazione, ctrlMFCCB.bat.
3. Configurazione dell’ambiente e dei parametri per l’esecuzione
Prima di avviare la procedura di controllo è necessario predisporre l’ambiente, creando:
•
una cartella dove memorizzare i file da sottoporre al controllo. Non è ammesso l’uso di
sottocartelle. Non è ammesso assegnare ai file da controllare nomenclature con caratteri non
ammessi, o con lunghezza superiore a 26 caratteri;
•
una cartella nella quale saranno registrati i file risultanti dall’elaborazione.
Nella cartella “prog” della directory di installazione di Entratel, “…\Entratel\prog”, è disponibile
controllaMFCCB.txt, un file di testo nel quale impostare contestualmente i parametri utili alla
configurazione del controllo multifile. Su ogni riga è presente un parametro da valorizzare in modo
opportuno ed il cui identificativo (ARG1, ARG2, ARG3) non deve essere modificato:
1. ARG1 – deve riportare il percorso completo della cartella, precedentemente creata, che
contiene
i
file
da
sottoporre
a
controllo
(ad
esempio,
in
ambiente
Windows:
C:\file_da_controllare, oppure in ambiente Macintosh: /file_da_controllare);
2. ARG2 – deve indicare il percorso completo della cartella, precedentemente creata, nella quale
saranno creati i file diagnostici e i file telematici (dcm) prodotti dalla procedura di controllo
(ad esempio, in ambiente Windows: C:\file_controllati, oppure in ambiente Macintosh:
/file_controllati);
3. ARG3 – rappresenta il nome del file di log dove sarà riportato l’esito dell’elaborazione.
L’applicazione “Controllo Multifile CCB”, infatti, produrrà, nella cartella “...Entratel\prog”, un
file con il nome indicato nel parametro ARG3, nel quale saranno segnalati:
a) eventuali motivi che impediscono l’avvio della procedura di controllo (ad esempio,
file di configurazione non completo);
b) eventuali motivi che impediscono di procedere al controllo di uno o più file (ad
esempio, nome del file da controllare contenente caratteri non consentiti);
c) lista dei file per i quali è stata avviata la funzione di controllo ed il relativo esito;
d) riepilogo complessivo.
Tra l’identificativo del parametro ed il valore impostato, a cura dell’utente, è obbligatoria la presenza di
un carattere spazio.
3.1. Denominazione del log
Il nome del file di log che verrà utilizzato è quello indicato dall’utente nel parametro ARG3.
Nell’eventualità che vengano riscontrati errori proprio sul file di configurazione o anomalie precedenti
all’acquisizione dei parametri ARG1, ARG2, ARG3, sarà utilizzato un nome file di default
logMFCCB.txt.
Inoltre, se nella cartella “prog” della directory di installazione di Entratel risulta già presente un file
denominato come il log, al nome del file sarà aggiunta, in coda, la data e l’ora corrente della postazione
sulla quale è eseguito il controllo. Ad esempio, se l’utente indica in ARG3 “esito” ed esiste già un file di
nome esito.txt, supponendo che la data e l’ora corrente siano 04/04/2007 ore 17:30:15, il file di log sarà
definito come esito04042007173015.txt.
4. Esecuzione dell’applicazione
Per avviare l’applicazione aprire il prompt dei comandi di Windows o il terminale di MAC OS X,
posizionarsi nella cartella “prog” della directory di installazione di Entratel, “…\Entratel\prog” ed
eseguire il comando
Ambiente Windows
C:\Programmi\JavaSoft\JRE\1.3.1_13\bin\java.exe
-ms30M
-mx150M
-cp
.;V9TJU000.jar
finanze.multifileccbbatch.main.MultiFile
Ambiente Macintosh
System/Library/Frameworks/JavaVM.framework/Versions/1.3.1/Commands/java -ms30M -mx150M
-cp .;V9TJU000.jar finanze.multifileccbbatch.main.MultiFile
impostando i parametri di utilizzo della memoria –ms –mx in modo opportuno.
L’esito delle elaborazioni viene riportato nella finestra di sistema (dei comandi di Windows o del terminale
di MAC OS X) e riassunto nel file di log indicato dall’utente.
In alternativa alla modalità ora proposta, nella cartella “prog” della directory di installazione di Entratel è
disponibile un file .bat “ctrlMFCCB.bat” che automatizza la procedura di avvio.
4.1. Anomalie all’avvio della procedura di controllo
Gli eventuali motivi che impediscono di procedere al controllo di uno o più file sono i seguenti:
1. Il file di configurazione controllaMFCCB.txt è stato rimosso dalla cartella “prog” o risulta non
valorizzato correttamente o incompleto.
2. Le directory designate come contenitori dei file da controllare e dei file prodotti dalla procedura di
controllo non sono state create.
3. Directory contenente i file da elaborare vuota.
4. Nella directory dove saranno memorizzati i file prodotti dalla procedura di controllo sono già
presenti le cartelle “corretti”, “errati” (l’applicazione usa denominare le cartelle in questo modo
per schematizzare il risultato dell’elaborazione). Provvedere a rimuoverle o rinominarle.
5. Non è possibile indicare più di 200 file da controllare.
5. Esito del controllo
La procedura di controllo produce le seguenti tipologie di file, identificabili dall’estensione:
-
.dgn: file di testo contenente l’esito dell’elaborazione in forma codificata, elaborabile attraverso
l’applicazione Entratel.
-
.wri: file di testo, formato Microsoft WordPad, contenente l’esito dell’elaborazione, con la
descrizione degli errori eventualmente rilevati nella comunicazione.
-
.dcm: file telematico (da sottoporre alle operazioni di autentica).
L’applicazione “Controllo Multifile CCB” organizza i file prodotti creando due directory nel percorso
indicato dall’utente nel parametro ARG2 (cartella di destinazione impostata nel file di configurazione)
distinguendo i file in base all’esito delle elaborazioni. In particolare, crea le seguenti cartelle:
-
corretti: contiene a sua volta tre sottocartelle:
o wri: Contiene i file di testo che i riportano l’esito dell’elaborazione e l’eventuale descrizione
degli errori riscontrati nella fornitura;
o dcm: Contiene i file telematici (da sottoporre alle operazioni di autentica);
o dgn: Contiene file in forma codificata dell’esito del controllo.
Si fa presente che nelle sottocartelle “corretti” sono registrati i file che hanno superato il controllo,
anche quelli che presentano errori nell’indicazione dei rapporti in misura inferiore ad un terzo del
totale.
-
errati: contiene a sua volta due sottocartelle:
o wri: Contiene i file di testo che i riportano l’esito dell’elaborazione e l’eventuale descrizione
degli errori riscontrati nella fornitura;
o dgn: Contiene file in forma codificata dell’esito del controllo.
Un file dal nome avente una lunghezza superiore ai 26 caratteri o con caratteri non consentiti (segni di
interpunzione, ad esempio) non verrà elaborato pertanto per esso non sarà presente nessun .dgn, .wri,
.dcm. Lo stesso dicasi per un file per il quale sia stata riscontata un’anomalia durante la procedura di
controllo che abbia compromesso il completamento dell’analisi.
Al nome del file con estensione .wri è associato un suffisso della forma _CXXX_SXXX che indica il
numero di rapporti corretti e scartati dalla procedura di controllo per la fornitura analizzata: ad
esempio, se il file è denominato rapportiCCB.txt e in esso sono presenti 1500 rapporti corretti e 3000
scartati, il file sarà presente nella forma rapportiCCB_C1500_S3000.wri.
6. Controllo dei file da trasmettere all’Agenzia delle Entrate
Per il controllo dei file da trasmettere seguire i seguenti passi:
1. posizionare i file da controllare in un’unica cartella. Si consiglia di non utilizzare le cartelle
dell’applicazione, ma creare un’apposita cartella esterna alla struttura di “Entratel”. Il numero
massimo di file che possono essere contenuti in tale cartella è 200.
2. Impostare nel file di configurazione “controllaMFCCB.txt”, che viene installato automaticamente
sotto la cartella “…\prog” della directory di installazione dell’applicazione “Entratel”, i 3 parametri
con identificativo ARG1, ARG2, ARG3. Ad esempio:
Ambiente Windows
ARG1 C:\filedacontrollare
ARG2 C:\filecontrollati
ARG3 log
Ambiente Macintosh
ARG1 /filedacontrollare
ARG2 /filecontrollati
ARG3 log
3. Aprire il prompt dei comandi di Windows o il terminale di MAC OS X, posizionarsi nella cartella
“…\Entratel\prog” ed eseguire il comando di seguito riportato a seconda del sistema operativo che
si sta utilizzando:
Ambiente Windows
C:\Programmi\JavaSoft\JRE\1.3.1_13\bin\java.exe
-ms30M
-mx150M
-cp
.;V9TJU000.jar finanze.multifileccbbatch.main.MultiFile
Ambiente Macintosh
System/Library/Frameworks/JavaVM.framework/Versions/1.3.1/Commands/ja
va
-ms30M
-mx150M
-cp
.;V9TJU000.jar
finanze.multifileccbbatch.main.MultiFile
4. Verificare se la procedura è stata eseguita correttamente, consultando il file di log prodotto, le
cartelle corretti, errati presenti nella directory di destinazione.