Visualizza wikitesto di Migrazione a VHNG

== Introduzione ==

La nuova procedura di invio e ricezione delle fatture/notifiche VHNG utilizza gli stessi formati dei file di interscambio e lavora utilizzando le stesse cartelle già previste per la precedente versione, semplificandone la gestione.<br>
La nuova procedura puo' coesistere con la vecchia, permettendo di poter ricevere anche le fatture passive che potrebbero, nel periodo della migrazione, continuare ad arrivare alla vecchia piattaforma VH.<br>
La nuova piattaforma VHNG utilizza il codice destinatario '''RR66BDG''' , che dovrà essere comunicato a tutti i fornitori e/o cambiato nel cassetto fiscale del cliente (soluzione questa sempre consigliabile).<br>

== Fase transitoria ==

La migrazione, dal punto di vista tecnico, non presenta particolari difficoltà.<br>

Si tratta sostanzialmente di installare una nuova procedura per l'invio delle fatture attive e per la ricezione delle notifiche e delle fatture passive.<br>
E’ possibile che nei primi giorni successivi all'attivazione possano essere presenti alcune fatture e/o notifiche nella vecchia piattaforma VH che non sono ancora state scaricate.<br>
In ogni caso, per un certo periodo di tempo l’ambiente nella vecchia piattaforma VH rimane attivo e pertanto il cliente continuerà a ricevere le fatture che vengono indirizzate al vecchio codice destinatario (quello di VH). <br>
Mantenendo attivo fe-in-out saranno tranquillamente ricevute anche queste fatture/notifiche.<br> 

{{vedi nota|Dp-edit|Le due procedure possono tranquillamente '''coesistere'''; nel periodo transitorio si possono mantenere attive '''contemporaneamente''' le due procedure di invio/ricezione.<br>}}<br>

== Passaggi operativi per eseguire la migrazione a VHNG ==
Vediamo nel dettaglio i passaggi operativi da seguire per migrare alla nuova procedura Var hub Ng.<br> 

=== Operazioni da compiere prima di installare la nuova procedura Datum Agent ===

*'''TEST PRE-INSTALLAZIONE'''
Per verificare che tutti i prerequisiti per l'installazione ed il corretto funzionamento della procedura è dispobile un apposito programma '''PreInstallationChecker''', che esegue automaticamente la verifica e ne mostra i risultati evidenziando le criticità con apposite icone ''rosse''.<br> 

[[Image:Dp-Prei1.png|thumb|link=|center|1100x710px|Figura '''1''':PreInstallation Checker di Var Hub NG]]

Segnala inoltre le componenti del sistema operativo mancanti o da aggiornare.<br> 

{{vedi nota|Dp-edit|è molto importante che siano installate tutte le fix disponibili in Windows Update avendo cura di riavviare il PC/Server prima di procedere al test pre-installazione.}}<br>

Di seguito i sistemi operativo utilizzabili:<br> 
*Windows Server 2008 R2 (anno 2010)<br> 
*Windows Server 2012 (anno 2012)/Windows Server 2012 Foundation (anno 2012)<br> 
*Windows 7 SP1 (tutte le versioni)<br> 
Consigliati almeno:<br> 
*Windows Server 2012 R2 (anno 2014)<br> 
*Windows 8<br> 

Per maggiori dettagli si rimanda al manuale di installazione della nuova procedura di invio/ricezione.

Se tutte le verifiche hanno esito positivo le icone sono tutte ''verdi'' ed è possibile procedere all'installazione del software.<br> 

[[Image:Dp-preinstallationchecker.png|thumb|link=|center|870x510px|Figura '''2''':PreInstallation Checker di Var Hub NG]]

L'utilizzo di questo programma serve a pianificare al meglio l'operazione di migrazione, individuando in anticipo i clienti che possono necessitare di un intervento sistemistico, ottimizzando cosi' il tempo impiegato per la migrazione del cliente alla nuova piattaforma.<br> 

*'''ARRESTARE IL SERVIZIO FE-IN-OUT'''

{{Vedi link esterno|www.deltaphi.it/rivenditori/index.php/aggiornamenti/fattura-elettronica-pro|Documentazione FE-IN-OUT||||}}


*'''CREARE LA CARTELLA C:\TEMP''' (nel caso non esista)<br>


*'''MODIFICARE LA CONFIGURAZIONE DI FE-IN-OUT'''
Procedere nel seguente modo:<br>
*'''Rinominare''' la cartella ''out'' in '''out_old'''<br>
*Creare la cartella ''out''<br>
{{vedi nota|Dp-edit|Se esistono delle fatture attive non ancora spedite in out_old spostare i relativi file xml nella cartella out '''solo al completamento''' dell’installazione della nuova procedura.}}<br>
*Accedere al programma ''config_fe_pdv.exe'' (configurazione di fe-in-out) e modificare il percorso della ''Cartella locale per Upload'' in modo che sia ''out_old'' invece di ''old''<br>
*Salvare la nuova configurazione<br>

La modifica della configurazione di fe-in-out indicata consente di mantenere '''contemporaneamente''' attive le due procedure di invio/ricezione in modo che possano essere ricevute eventuali fatture e notifiche che siano recapitate alla vecchia piattaforma.<br>

Cambiando la cartella di upload di fe-in-out si ha la garanzia che le fatture non saranno più spedite con la vecchia piattaforma VH.<br>

[[Image:Dp-Prei2.png|thumb|link=|center|815x474px|Figura '''3''':L'albero delle cartelle]]


{{vedi anche|Modulo_FEP_con_integrazione_a_Var_Hub#Configurazione_della_procedura_FE-IN-OUT|Configurazione di FE-IN-OUT.}}<br>

*'''ATTIVARE IL BACKUP dei pacchetti elaborati dal connettore DPSHubSvc'''

Se non fosse gia' stato fatto, ricordiamo che è possibile attivare il backup dei pacchetti scaricati ed elaborati dal connettore DPSHubSvc, in modo da avere una copia locale dei pacchetti ricevuti. <br>
Per attivarlo e' necessario selezionare l'apposita voce dal programma ''DPSHubSvcCfg.exe''

[[Image:Dp-Prei3.png|thumb|link=|center|515x274px|Figura '''4''':Configurazione DpSHubSvc]]

{{vedi nota|Dp-edit|Il connettore '''DPSHubSvc''' non deve essere aggiornato, è in grado di processare i pacchetti scaricati da entrambe le procedure (i formati sono gli stessi). La cartella dove vengono scaricati i pacchetti con le fatture passive e le notifiche delle fatture attive è la stessa per entrambe le procedure (''hdir''), così come la cartella dove sono scaricati i file di esito degli invii (''vdir'').
}}<br>

{{vedi anche|Modulo_FEP_con_integrazione_a_Var_Hub#Configurazione_del_servizio_DPSHubSvc|Configurazione del connettore DPSHubSvc}}<br>

=== Installazione e configurazione del nuovo servizio di invio e ricezione Datum Agent ===
Una volta eseguite le operazioni sopra descritte, e' possibile installare il nuovo servizio Datum Agent.<br> 
La procedura di setup richiede semplicemente di procedere premendo sempre il tasto ''Avanti'' senza modificare alcun parametro.<br> 

{{vedi nota|Dp-edit|L'applicazione è un servizio sviluppato in .Net Framework e NON è possibile installarlo come applicazione stand-alone.}}<br>

Al termine dell'istallazione viene avviato il programma centrale che permette di gestire l'Agent, cioè la '''Agents Dashboard''' (brevemente ''Dashboard'').<br> 

[[Image:Dp-Prei4.png|thumb|link=|center|1100x710px|Figura '''5''':Agents Dashboard]]

Vediamo il significato dei bottoni presenti nella pagina ''In/Out Folders'' della Dashboard:<br>
 
'''Add New Agent''': serve per aggiungere un nuovo Agent nel caso in cui nello stesso PC si vogliano gestire più ditte.<br>
Con la nuova procedura di invio/ricezione l'ambiente multi-ditta si configura aggiungendo un nuovo Agent (e quindi un nuovo servizio dedicato).<br>
'''Update Agent''': serve per aggiornare un Agent. In caso di installazione multi-Agent il programma di setup aggiorna solo il primo Agent mentre gli altri devono essere aggiornati manualmente, singolo Agent per singolo Agent (con Update Agent) oppure tutti gli Agent contemporaneamente (con Update All Agents).<br>

E' necessario configurare le seguenti cartelle:<br>
1) '''Local Input Folder''': è la cartella che contiene le fatture da inviare e corrisponde in FEP alla cartella '''out''' <br>
2) '''Local Output Folder1''': è la cartella che contiene i pacchetti scaricati con le fatture/notifiche e corrisponde alla cartella '''hdir'''<br>
3) '''Local Output Folder2''': è la cartella che contiene i file degli esiti degli invii alla piattaforma e corrisponde in FEP alla cartella '''vdir'''<br>

[[Image:Dp-Prei5.png|thumb|link=|center|615x374px|Figura '''6''':Configurazione delle cartelle di upload/download]]


Il nuovo servizio non utilizza utente e password né indirizzo del server, ma molto più semplicemente una stringa di configurazione chiamata '''NOME del NODO (NodeName)''' o '''LICENZA del NODO (NodeLicense)''' che viene fornita al momento dell'attivazione del contratto e che deve essere inserita nel folder ''Automatic Registrazione Agent'' della Dashboard.<br>
E' importante ricordare che lo stesso ''NodeName'' non può essere utilizzato su più di un PC.<br>
In sostanza è una sorta di licenza che si lega al PC dove è installata e per poterla riutilizzare occorre deregistrare il nodo e disinstallare l'Agent (la deregistrazione è un'operazione questa eseguita direttamente dalla Dashboard degli Agent).<br>

Non sarà quindi possibile avere due PC che contemporaneamente scaricano i pacchetti (se necessario è possibile farlo richiedendo una licenza - NodeName - aggiuntiva ed in questo caso entrambi gli Agent scaricano esattamente gli stessi file).<br>


[[Image:Dp-Prei6.png|thumb|link=|center|1100x710px|Figura '''7''':Configurazione della licenza (nome del nodo)]]


Nel folder ''Manage Agent Service'' è possibile registrare il servizio, personalizzarne il ''display name'', utile nel caso di installazione multi-agent (multi ditta) ,o avviarlo/arrestarlo.<br>
Ovviamente sia l' avvio che l' arresto sono anche possibili dall'applet del ''Pannello di Controllo'' di Windows.<br>

[[Image:Dp-Prei7.png|thumb|link=|center|1100x710px|Figura '''8''':Configurazione del servizio]]


Nell' ultima pagina della Dashboard è possibile utilizzare la funzione di ''COLLAUDO''.<br>

L’operazione di collaudo può essere effettuata a completamento della configurazione dell’Agent per eseguire l’invio di una fattura fittizia, volutamente malformata, che sarà scartata dalle procedure di controllo del server VHNG.<br>
Elaborando la risposta del server la Dashboard può verificare che l’invio e la ricezione siano eseguite senza errori ed evidenziarlo colorando di verde l’indicatore di attività presente a video.<br>

L’operazione di collaudo richiede un po’ di tempo perché corrisponde ad un reale ciclo di invio, controllo del documento, predisposizione dell’esito intermediario (scarto in questo caso) e sua ricezione.<br>

La funzione di collaudo non invia alcun documento a SdI.<br>

[[Image:Dp-Prei8.png|thumb|link=|center|1100x710px|Figura '''9''':Collaudo]]

Nell’area di ''LOG'' invece sono evidenziate le operazioni eseguite e gli eventuali errori.<br>
*'''I LOG della DashBoard''' sono presenti nella cartella C:\Program Files (x86)\DiTech Solutions\Common\Log; <br>
*'''I LOG dell’Agent''' sono presenti nella cartella C:\Program Files (x86)\DiTech Solutions\DATUM Agent\Logs; <br>
*'''Nel caso di multi-Agent (multi ditta)''' i log sono presenti nella cartella C:\Program Files (x86)\DiTech Solutions\DATUM Agent1\Logs.<br>  

I file contenuti in queste cartelle sono utilizzati dal supporto tecnico VHNG per la risoluzione di problemi che possono sorgere nell’utilizzo della procedura. Vengono mantenuti in linea 2 mesi di log.<br> 
In futuro la creazione dei LOG sarà configurabile, per il momento il team di sviluppo di VHNG ha preferito avere sempre attiva questa funzione di tracing.<br> 

Per ulteriori dettagli si rimanda al manuale di installazione della procedura di invio/ricezione DATUM Agent.<br> 

{{Vedi link esterno|www.deltaphi.it/rivenditori/index.php/aggiornamenti/fattura-elettronica-pro/|Documentazione FE-IN-OUT NG||||}}

==== De-registrazione del NodeLicence ====

A partire dalla versione 2.1.5 del DATUM Agent (fe-in-out-ng) non è più necessario richiedere un nuovo '''Nodo''' (NodeLicence) in caso di cambio PC/server.<br>
Sarà sufficiente de-registrare il nodo sulla macchina originaria e riutilizzarlo per l'installazione su una nuova macchina.<br>

{{vedi nota|Dp-edit| Per poter de-registrare il NodeLicence (Nodo), il servizio DATUM Agent NON deve essere registrato tra i servizi di Windows.}}<br>

=== Passaggi operativi per la deregistrare il Nodo ===

Vediamo nel dettaglio le azioni da compiere:<br>

* deregistrare il servizio DATUM Agent agendo sull'apposito pulsante '''UnRegister on Windows''' della pagina '''Manage Agent Service''' della Dashboard.<br>
<br>
[[Image:Dp-DRG1.png|thumb|link=|center|806x523px|Figura '''1''': UnRegister on Windows]]<br>

* utilizzare il tasto '''Start UNRegistration''' della pagina '''Automatic Registration Agent''' della Dashboard per deregistrare il ''Nodo''.<br>

{{vedi nota|Dp-edit|Il tasto ''Start UNRegistration'' è attivo solo se il servizio DATUM Agent NON è registrato tra i Servizi del PC/server.}}<br>

[[Image:Dp-DRG2.png|thumb|link=|center|1019x523px|Figura '''2''': Start UNRegistration]]<br>

Una volta deregistrato, il NodeLicense potrà essere riutilizzato per una nuova installazione.<br>

=== Configurazione di SIGLA ===

Operando con VHNG non occorre inserire particolari informazioni nelle impostazioni '''Ditta''' della configurazione di SIGLA<sup>®</sup>  per la creazione dei file XML delle fatture da inviare.<br>
Vediamo in  sintesi i dati richiesti nella finestra di dialogo che si apre premendo il bottone '''FatturaPA''' nella pagina '''Dati''':<br>

*nella sezione '''Dati Trasmittente''' non è necessario inserire la partita IVA/codice fiscale di Var Hub srl.<br>
L'inserimento dell'informazione e' opzionale;<br>


[[Image:Dp-configvhng1.png|thumb|link=|center|375x123px|Figura '''10''':Ditte/pagina Dati/Dati trasmittente]]
<br>

*il campo '''Soggetto Emittente''' deve essere valorizzato con CP (cedente prestatore) sia che utilizzi la firma digitale di Var Hub per la firma delle fatture emesse, sia che non la si utilizzi.<br>

[[Image:Dp-configvhng2.png|thumb|link=|center|404x34px|Figura '''11''':Ditte/pagina Dati/Soggetto emittente CP]]

*nella sezione '''Terzo Intermediario o Soggetto Emittente''' non deve essere inserita alcuna informazione;<br>

[[Image:Dp-Prei10.png|thumb|link=|center|575x345px|Figura '''12''':Ditte/pagina Altri/Terzo Intermediario o Soggetto Emittente]]




{{Vedi link esterno|www.deltaphi.it/rivenditori/index.php/aggiornamenti/fattura-elettronica-pro/Installazione_connettore|Installazione connettore FEP/ Var Hub||||}}


{{vedi anche|Modulo_FEP_con_integrazione_a_Var_Hub_NG|Modulo FEP con integrazione a Var Hub.}}<br>

=== Avvio del servizio FE_IN_OUT ===
Ultimo passaggio a conclusione della migrazione a VHNG e' l'avvio del servizio attraverso l'applet del pannello di controllo di Windows.<br>

== Bibliografia ==
*[http://www.agenziaentrate.gov.it/wps/portal/entrate/home Agenzia delle Entrate]
*[http://it.wikipedia.org/wiki/Posta_elettronica_certificata PEC]
*[http://it.wikipedia.org/wiki/Portable_Document_Format PDF]
*[http://www.fatturapa.gov.it/export/fatturazione/it/sdi.htm Sistema di Inserscambio]
*[http://it.wikipedia.org/wiki/TAG#Informatica Tag]
*[http://it.wikipedia.org/wiki/XML XML]

== Voci Correlate ==

[[Configurazione]]<br>
[[Configurazione/Ditte]]<br>
{{Portale|Acquisti e vendite}}
[[Categoria:Gestione documenti]][[Categoria:Contabilità]][[Categoria:Configurazione]]

{{Pubblicazione|PUBBLICARE|SM}}