SERVIZIO TELEMATICO ENTRATEL Applicazine Cntrll Multifile per le cmunicazini relative alla cstituzine dell Anagrafe dei Rapprti versine 1.0.0 Aprile 2007
1. Premessa...1 2. Installazine...1 3. Cnfigurazine dell ambiente e dei parametri per l esecuzine... 2 3.1. Denminazine del lg... 3 4. Esecuzine dell applicazine... 3 4.1. Anmalie all avvi della prcedura di cntrll...4 5. Esit del cntrll... 4 6. Cntrll dei file da trasmettere all Agenzia delle Entrate...5
1. Premessa L applicazine Cntrll Multifile per le Cmunicazini all Anagrafe dei Rapprti (nel seguit Cntrll Multifile CCB ) è stata predispsta per cnsentire agli utenti del servizi telematic Entratel di sttprre a cntrll, cn un elabrazine di tip batch, i file cntenenti le cmunicazini all Anagrafe dei Rapprti da trasmettere all Agenzia delle Entrate. L utilizz è pertant cnsigliat esclusivamente a clr che hann necessità di elabrare cntestualmente un numer significativ di file. L applicazine Cntrll Multifile CCB richiede necessariamente la presenza, sulla pstazine di lavr, della JVM 1.3.1_13 e dell'applicazine Entratel (versine 4.2.2 superiri) e del mdul di cntrll per le Cmunicazini Anagrafe dei Rapprti (versine 1.0.0 superiri). 2. Installazine Per predisprre l ambiente di lavr per il cntrll in mdalità batch, lanciare il file MuxCCBBat.exe per avviare la prcedura guidata dell installazine al termine della quale l applicazine Cntrll Multifile CCB sarà dispnibile nella cartella dell applicazine Entratel. Pertant, la prcedura nn andrà a bun fine se: nn risulta installat l applicativ Entratel la versine è precedente alla 4.2.2 nn risulta installat il pacchett per il cntrll delle Cmunicazini all Anagrafe dei Rapprti. In tal cas prvvedere all installazine degli applicativi mancanti. Se l installazine avviene crrettamente, nella cartella prg della directry di installazine di Entratel, \Entratel\prg, sn presenti: - un file di cnfigurazine dei parametri dell applicazine, cntrllamfccb.txt - un file.bat cntenente la sequenza di cmandi per l avvi dell applicazine, ctrlmfccb.bat.
3. Cnfigurazine dell ambiente e dei parametri per l esecuzine Prima di avviare la prcedura di cntrll è necessari predisprre l ambiente, creand: una cartella dve memrizzare i file da sttprre al cntrll. Nn è ammess l us di sttcartelle. Nn è ammess assegnare ai file da cntrllare nmenclature cn caratteri nn ammessi, cn lunghezza superire a 26 caratteri; una cartella nella quale sarann registrati i file risultanti dall elabrazine. Nella cartella prg della directry di installazine di Entratel, \Entratel\prg, è dispnibile cntrllamfccb.txt, un file di test nel quale impstare cntestualmente i parametri utili alla cnfigurazine del cntrll multifile. Su gni riga è presente un parametr da valrizzare in md pprtun ed il cui identificativ (ARG1, ARG2, ARG3) nn deve essere mdificat: 1. ARG1 deve riprtare il percrs cmplet della cartella, precedentemente creata, che cntiene i file da sttprre a cntrll (ad esempi, in ambiente Windws: C:\file_da_cntrllare, ppure in ambiente Macintsh: /file_da_cntrllare); 2. ARG2 deve indicare il percrs cmplet della cartella, precedentemente creata, nella quale sarann creati i file diagnstici e i file telematici (dcm) prdtti dalla prcedura di cntrll (ad esempi, in ambiente Windws: C:\file_cntrllati, ppure in ambiente Macintsh: /file_cntrllati); 3. ARG3 rappresenta il nme del file di lg dve sarà riprtat l esit dell elabrazine. L applicazine Cntrll Multifile CCB, infatti, prdurrà, nella cartella...entratel\prg, un file cn il nme indicat nel parametr ARG3, nel quale sarann segnalati: a) eventuali mtivi che impediscn l avvi della prcedura di cntrll (ad esempi, file di cnfigurazine nn cmplet); b) eventuali mtivi che impediscn di prcedere al cntrll di un più file (ad esempi, nme del file da cntrllare cntenente caratteri nn cnsentiti); c) lista dei file per i quali è stata avviata la funzine di cntrll ed il relativ esit; d) riepilg cmplessiv.
Tra l identificativ del parametr ed il valre impstat, a cura dell utente, è bbligatria la presenza di un carattere spazi. 3.1. Denminazine del lg Il nme del file di lg che verrà utilizzat è quell indicat dall utente nel parametr ARG3. Nell eventualità che vengan riscntrati errri prpri sul file di cnfigurazine anmalie precedenti all acquisizine dei parametri ARG1, ARG2, ARG3, sarà utilizzat un nme file di default lgmfccb.txt. Inltre, se nella cartella prg della directry di installazine di Entratel risulta già presente un file denminat cme il lg, al nme del file sarà aggiunta, in cda, la data e l ra crrente della pstazine sulla quale è eseguit il cntrll. Ad esempi, se l utente indica in ARG3 esit ed esiste già un file di nme esit.txt, suppnend che la data e l ra crrente sian 04/04/2007 re 17:30:15, il file di lg sarà definit cme esit04042007173015.txt. 4. Esecuzine dell applicazine Per avviare l applicazine aprire il prmpt dei cmandi di Windws il terminale di MAC OS X, psizinarsi nella cartella prg della directry di installazine di Entratel, \Entratel\prg ed eseguire il cmand Ambiente Windws C:\Prgrammi\JavaSft\JRE\1.3.1_13\bin\java.exe -ms30m -mx150m -cp.;v9tju000.jar finanze.multifileccbbatch.main.multifile Ambiente Macintsh System/Library/Framewrks/JavaVM.framewrk/Versins/1.3.1/Cmmands/java -ms30m -mx150m -cp.;v9tju000.jar finanze.multifileccbbatch.main.multifile
impstand i parametri di utilizz della memria ms mx in md pprtun. L esit delle elabrazini viene riprtat nella finestra di sistema (dei cmandi di Windws del terminale di MAC OS X) e riassunt nel file di lg indicat dall utente. In alternativa alla mdalità ra prpsta, nella cartella prg della directry di installazine di Entratel è dispnibile un file.bat ctrlmfccb.bat che autmatizza la prcedura di avvi. 4.1. Anmalie all avvi della prcedura di cntrll Gli eventuali mtivi che impediscn di prcedere al cntrll di un più file sn i seguenti: 1. Il file di cnfigurazine cntrllamfccb.txt è stat rimss dalla cartella prg risulta nn valrizzat crrettamente incmplet. 2. Le directry designate cme cntenitri dei file da cntrllare e dei file prdtti dalla prcedura di cntrll nn sn state create. 3. Directry cntenente i file da elabrare vuta. 4. Nella directry dve sarann memrizzati i file prdtti dalla prcedura di cntrll sn già presenti le cartelle crretti, errati (l applicazine usa denminare le cartelle in quest md per schematizzare il risultat dell elabrazine). Prvvedere a rimuverle rinminarle. 5. Nn è pssibile indicare più di 200 file da cntrllare. 5. Esit del cntrll La prcedura di cntrll prduce le seguenti tiplgie di file, identificabili dall estensine: -.dgn: file di test cntenente l esit dell elabrazine in frma cdificata, elabrabile attravers l applicazine Entratel. -.wri: file di test, frmat Micrsft WrdPad, cntenente l esit dell elabrazine, cn la descrizine degli errri eventualmente rilevati nella cmunicazine. -.dcm: file telematic (da sttprre alle perazini di autentica).
L applicazine Cntrll Multifile CCB rganizza i file prdtti creand due directry nel percrs indicat dall utente nel parametr ARG2 (cartella di destinazine impstata nel file di cnfigurazine) distinguend i file in base all esit delle elabrazini. In particlare, crea le seguenti cartelle: - crretti: cntiene a sua vlta tre sttcartelle: wri: Cntiene i file di test che i riprtan l esit dell elabrazine e l eventuale descrizine degli errri riscntrati nella frnitura; dcm: Cntiene i file telematici (da sttprre alle perazini di autentica); dgn: Cntiene file in frma cdificata dell esit del cntrll. Si fa presente che nelle sttcartelle crretti sn registrati i file che hann superat il cntrll, anche quelli che presentan errri nell indicazine dei rapprti in misura inferire ad un terz del ttale. - errati: cntiene a sua vlta due sttcartelle: wri: Cntiene i file di test che i riprtan l esit dell elabrazine e l eventuale descrizine degli errri riscntrati nella frnitura; dgn: Cntiene file in frma cdificata dell esit del cntrll. Un file dal nme avente una lunghezza superire ai 26 caratteri cn caratteri nn cnsentiti (segni di interpunzine, ad esempi) nn verrà elabrat pertant per ess nn sarà presente nessun.dgn,.wri,.dcm. L stess dicasi per un file per il quale sia stata riscntata un anmalia durante la prcedura di cntrll che abbia cmprmess il cmpletament dell analisi. Al nme del file cn estensine.wri è assciat un suffiss della frma _CXXX_SXXX che indica il numer di rapprti crretti e scartati dalla prcedura di cntrll per la frnitura analizzata: ad esempi, se il file è denminat rapprticcb.txt e in ess sn presenti 1500 rapprti crretti e 3000 scartati, il file sarà presente nella frma rapprticcb_c1500_s3000.wri. 6. Cntrll dei file da trasmettere all Agenzia delle Entrate Per il cntrll dei file da trasmettere seguire i seguenti passi:
1. psizinare i file da cntrllare in un unica cartella. Si cnsiglia di nn utilizzare le cartelle dell applicazine, ma creare un appsita cartella esterna alla struttura di Entratel. Il numer massim di file che pssn essere cntenuti in tale cartella è 200. 2. Impstare nel file di cnfigurazine cntrllamfccb.txt, che viene installat autmaticamente stt la cartella \prg della directry di installazine dell applicazine Entratel, i 3 parametri cn identificativ ARG1, ARG2, ARG3. Ad esempi: Ambiente Windws ARG1 C:\filedacntrllare ARG2 C:\filecntrllati ARG3 lg Ambiente Macintsh ARG1 /filedacntrllare ARG2 /filecntrllati ARG3 lg 3. Aprire il prmpt dei cmandi di Windws il terminale di MAC OS X, psizinarsi nella cartella \Entratel\prg ed eseguire il cmand di seguit riprtat a secnda del sistema perativ che si sta utilizzand: Ambiente Windws C:\Prgrammi\JavaSft\JRE\1.3.1_13\bin\java.exe -ms30m -mx150m -cp.;v9tju000.jar finanze.multifileccbbatch.main.multifile Ambiente Macintsh System/Library/Framewrks/JavaVM.framewrk/Versins/1.3.1/Cmmands/ja va -ms30m -mx150m -cp.;v9tju000.jar finanze.multifileccbbatch.main.multifile 4. Verificare se la prcedura è stata eseguita crrettamente, cnsultand il file di lg prdtt, le cartelle crretti, errati presenti nella directry di destinazine.