Visualizza wikitesto di Modulo FEP con integrazione a Var Hub

== Introduzione ==

Il modulo Fatturazione Elettronica Pro ('''FEP''') permette la gestione dell’invio e della ricezione delle fatture elettroniche ('''FE''') tramite [http://www.fatturapa.gov.it/export/fatturazione/it/sdi.htm SdI].<br>


{{Vedi pdf|manualepdf/Manuale_FEP.pdf|Installazione FEP|page=4}}

{{Vedi anche|Fattura_PA#Gestione_della_fattura_PA_.28B2G.29_attraverso_il_modulo_FEP|Gesione delle fatture elettroniche PA con FEP}}

{{Vedi anche|Fatturazione_Elettronica_B2B_verso_Soggetti_Privati#Gestione_della_fattura_B2B.2FB2C_attraverso_il_modulo_FEP_.28Fatture_Elettroniche_Pro.29|Gesione della fattura elettronica B2B con FEP}}<br>

Le funzioni del modulo FEP consentono, attraverso una serie di automatismi, la spedizione e ricezione delle fatture a mezzo [http://it.wikipedia.org/wiki/Posta_elettronica_certificata PEC] o intermediario autorizzato Var Hub o altro intermediario e il ricevimento delle notifiche inviate dal [http://www.fatturapa.gov.it/export/fatturazione/it/sdi.htm SdI] relative alle fatture inviate.<br>

{{Vedi anche|Procedura_di_indirizzamento_della_fattura_elettronica|Procedura di indirizzamento della fattura elettronica}}


Per integrare ''SIGLA/FEP'' a ''Var Hub'' occorre installare nello stesso PC/Server di due procedure distinte:<br>
*il connettore '''DPSHubSvc''', sviluppato e distribuito da Delta Phi SIGLA<br> 
*la procedura di Invio/Ricezione fatture e notifiche '''FE-IN-OUT''', sviluppato e distribuito da Var Hub<br> 


__TOC__

== Prerequisiti, Installazione e Configurazione del connettore ==

Il connettore è una procedura automatizzata che ha il compito di elaborare i pacchetti, contenenti notifiche da SdI e fatture passive, scaricati da Var Hub in modo da estrarre i file XML per permetterne l’acquisizione da parte del modulo FEP.<br>

=== Prerequisiti ===
Il connettore richiede l'installazione dei seguenti prerequisiti:<br> 
* Windows 7 o successivo<br>
* Microsoft Visual C++ 2017 runtime a 32 bit<br>
Il runtime di Visual C++ 2017 può essere scaricato al seguente indirizzo: https://aka.ms/vs/15/release/VC_redist.x86.exe.<br>

{{vedi nota|Dp-edit|Il connettore è compatibile con le versioni di SIGLA Ultimate/Sigla Start Edition e Cloud dalla versione 4.38.1 e successive.<br>}}


=== Installazione del servizio DPSHubSvc ===

Dopo aver scaricato e scompattato il ''DPSHUBSVC.ZIP'' in una cartella del PC/Server, (ad esempio C:\Program Files (x86)\DeltaPhiSIGLA\DPSHubSvc) utilizzare il Prompt dei Comandi come Amministratore ed eseguire lo script '''installa_connettore.cmd'''.<br>
Il sevizio DPSHubSvc deve essere installato su di una sola postazione di lavoro (server) a cui devono fare riferimento tutte le installazioni FEP.<br>
Lo script è contenuto nel file zip ed esegue l’installazione del servizio DPSHubSvc (connettore SIGLA/FEP – Var Hub), registra una dll utilizzata dal servizio e lo avvia.<br>
Durante l’esecuzione dello script di installazione sono mostrati alcuni messaggi relativi alle varie operazioni eseguite.<br>
E' possibile verificare lo stato del servizio attraverso l’apposita applet del Pannello di Controllo, come mostra la figura seguente.<br>

[[Image:Dp-conn1.png|thumb|link=|center|866x583px|Figura '''1''':''Applet Servizi'']]

=== Configurazione del servizio DPSHubSvc ===

Dopo aver installato il connettore occorre creare la struttura delle cartelle necessarie al funzionamento del connettore stesso.<br>
I nomi delle varie cartelle sono fissi tranne ovviamente quelli indicati come ''serial'' (che dovrà essere uguale al serial della licenza) e ''codice ditta'' (che dovrà essere uguale al codice della ditta nella tabella ditte della Configurazione di SIGLA<sup>®</sup>.<br>

La struttura delle cartelle deve partire necessariamente dal disco C del PC/Server e deve essere fissa.<br>
La prima cartella da creare è la cartella '''C:\FepData''' al cui interno saranno poi create ulteriori cartelle il cui nome corrisponde rispettivamente al '''SERIAL''' della licenza ed al '''CODICE DITTA''' utilizzato in SIGLA/START.<br>

Nel caso in cui non fosse possibile creare la cartella ''C:\FepData'' è necessario definire questa cartella come una ''junction''<ref>Hard links and junctions: https://docs.microsoft.com/en-us/windows/desktop/fileio/hard-links-and-junctions</ref> ad una cartella fisica creata sempre nel disco locale.<br>
A partire dalla versione 1.0.1 del servizio ''DPSHubSvc'' è possibile comunque indicare in uno specifico file di configurazione, il percorso da utilizzare al posto del percorso fisso ''C:\FepData'', che ovviamente deve essere un percorso locale al ''PC/Server'' dove è installato il servizio.<br>
Illustriamo la struttura delle cartelle attraverso la figura seguente:<br>

[[Image:Dp-conn2.png|thumb|link=|center|522x518px|Figura '''2''':''Albero delle cartelle'']]

All’interno della cartella corrispondente al codice della ditta dovranno essere create quattro cartelle il cui nome deve necessariamente essere quello indicato, come da dettaglio:<br>

*'''cartella out''': dove SIGLA/FEP copia i file XML che Var Hub invierà a SdI (cartella di upload)e da dove saranno prelevati i file delle fatture emesse<br>
*'''cartella hdir''': dove vengono copiati i pacchetti ZIP scaricati da Var Hub contenenti i file XML delle fatture ricevute e delle notifiche delle fatture emesse<br>
*'''cartella vdir''': dove la procedura di upload/download di Var Hub deposita i pacchetti di notifica degli esiti degli upload che il server Var Hub rende disponibili<br>
*'''cartella sdir''': dove la procedura di upload/download di Var Hub deposita i pacchetti di notifica degli esiti degli upload che il server Var Hub rende disponibili<br>

Tre di queste cartelle così create dovranno essere condivise in rete locale affinché siano accessibili in lettura e scrittura da parte di tutti i client che hanno SIGLA/START installato.<br>
In caso di ambiente multiditta è opportuno condividere la cartella corrispondente al codice della ditta, oppure al serial della licenza, così da poter configurare velocemente e semplicemente le varie ditte interessate.<br> 
In ambiente Cloud se il connettore è installato nell’ ''application server'' non è necessario condividere alcuna cartella poiché si utilizzano in Configurazione di FEP i percorsi locali.<br>
Anche in caso di monoutenza non è necessario condividere alcuna cartella poiché si utilizzano in Configurazione di FEP i percorsi locali.<br>
A partire dalla versione 1.0.1 del servizio è possibile eseguire un backup locale dei pacchetti ZIP scaricati da Var Hub e le notifiche di Var Hub che altrimenti sarebbero cancellati dopo la loro elaborazione.<br>
I file in oggetto vengono copiati rispettivamente nelle sottocartelle backup delle cartelle '''hdir''' e '''vdir'''.<br>
Anche queste cartelle per i backup devono essere preventivamente create.<br> 

Il servizio ''DPSHubSvc'' colloquia in rete locale con SIGLA/FEP attraverso il protocollo TCPIP sulla porta 9229. È pertanto necessario prevedere una specifica eccezione nella configurazione del firewall per consentire la comunicazione.<br>
Il colloquio avviene in rete locale e nessuna comunicazione è effettuata verso l’esterno. L’eccezione del firewall pertanto riguarda solo la comunicazione nell’ambito della rete locale.<br>

=== Procedura per eseguire il log delle operazioni del servizio DPSHubSvc ===
Il connettore SIGLA/FEP e Var Hub può registrare in un file di log le operazioni eseguite e i dettagli degli eventuali errori incontrati.<br>
Vediamo nel dettaglio i passaggi per ottenere il [[Procedura_per_eseguire_il_log_delle_operazioni_del_servizio_DPSHubSvc|log]].<br>

== Prerequisiti, Installazione e Configurazione della procedura FE-IN-OUT ==

===Prerequisiti===

La procedura di invio/ricezione di Var Hub FE-IN-OUT richiede l'installazione dei seguenti prerequisiti:<br> 
*Microsoft .Net Framework 4.5 (o successiva)
*Microsoft Visual C++ Redistributable per Visual Studio 2012 (32 bit) 
*Microsoft Visual C++ Redistributable per Visual Studio 2017 (32 bit)

=== Installazione della procedura FE-IN-OUT ===
La procedura di Invio e Ricezione di Var Hub ''FE-IN-OUT'' deve essere installata nello stesso PC/Server dove è installato il connettore ''DPSHubSvc''.<br>  
Il dettaglio delle operazioni da eseguire si può reperire dall’apposito manuale, fornito da Var Hub, scaricabile nell'area riservata del sito Deltaphi.<br>


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

=== Configurazione della procedura FE-IN-OUT ===

In fase di configurazione dell'FE-IN-OUT E' necessario indicare i percorsi locali delle cartelle e non va inserito niente nei campi ''Nome utente'' e ''Password'':<br>
*'''cartella out''': dove SIGLA/FEP copia i file XML che Var Hub invierà a SdI (cartella di upload)e da dove saranno prelevati i file delle fatture emesse<br>
*'''cartella hdir''': dove vengono copiati i pacchetti ZIP scaricati da Var Hub contenenti i file XML delle fatture ricevute e delle notifiche delle fatture emesse<br>
*'''cartella vdir''': dove la procedura di upload/download di Var Hub deposita i pacchetti di notifica degli esiti degli upload che il server Var Hub rende disponibili.<br>


[[Image:Dp-conn3.png|thumb|link=|center|806x523px|Figura '''3''':Cartelle upload/download di Var Hub]]


Per il corretto funzionamento del connettore alcune opzioni di configurazione devono essere inizializzate come mostrato di seguito:<br> 

*l’opzione '''Unzip dei file ricevuti''', presente nella sezione ''Parametri generali'', non deve essere selezionata<br>


[[Image:Dp-conn4.png|thumb|link=|center|806x523px|Figura '''4''':Opzione "Unzip dei file ricevuti]]


*l’opzione '''Download''', presente nella sezione ''Proprietà Doc.'', deve essere selezionata. La proprietà ''Doc. Firmati'' deve essere selezionata solo se per le fatture emesse non si intende utilizzare la firma digitale di Var Hub<br> 


[[Image:Dp-conn5.png|thumb|link=|center|806x523px|Figura '''5''':Opzioni Doc. Firmati e Download]]


*i campi '''Tipo Doc.''' presenti nelle sezioni ''VdV Tipo Documento'' e ''Cartelle per Upload'' devono essere entrambi uguali a FTV<br> 

[[Image:Dp-conn6.png|thumb|link=|center|806x523px|Figura '''6''':Campo Tipo Doc.]]   [[Image:Dp-conn6b.png|thumb|link=|center|806x523px|Figura '''6''':Campo Tipo Doc.]]

*nella sezione '''Server''' devono essere indicati i dati per la connessione al server Var Hub, il ''campo Url'' deve contenere l’indirizzo ''api.varhub.it'' mentre ''Utente'' e ''Password'' sono quelli comunicati da Var Hub nella lettera di conferma di attivazione del servizio<br>


[[Image:Dp-conn7.png|thumb|link=|center|806x523px|Figura '''7''':Sezione Server]]


*nel campo '''Ambiente''' della sezione ''Azienda'' deve essere inserito l’ID azienda comunicato da Var Hub nella lettera di conferma di attivazione del servizio<br>


[[Image:Dp-conn8.png|thumb|link=|center|806x523px|Figura '''8''':Campo Ambiente]]


*nella sezione '''Produttore PdV''' inserire gli stessi dati già inseriti nei corrispondenti campi della sezione Azienda<br>


[[Image:Dp-conn9.png|thumb|link=|center|806x523px|Figura '''9''':Sezione Produttore PdV]]


*nella sezione '''Software''' inserire i dati riportati come in figura<br>


[[Image:Dp-conn10.png|thumb|link=|center|806x523px|Figura '''10''':Sezione Software]]

== Configurazione in SIGLA/START del modulo FEP con l'integrazione al Var Hub ==

=== Menù Gestione Fattura Elettronica ===

Accedendo al programma di Configurazione di SIGLA<sup>®</sup> nel menù '''Gestione Fattura Elettronica''' pagina '''Generale''' è possibile attivare in FEP l’utilizzo di Var Hub come servizio di invio e ricezione delle fatture elettroniche selezionando l’opzione '''Abilita gestione tramite Var Hub'''.<br>

[[Image:DP-FEP2.png|thumb|link=|center|806x523px|Figura '''11''':Gestione Fattura Elettronica/pagina Generale]]

Nella pagina '''Var Hub''' occorre inserire i percorsi delle cartelle condivise utilizzate dal connettore.<br>
Le impostazioni di esempio mostrate nella figura seguente prevedono che il PC/Server dove è installato il connettore sia ''server01'', che il codice della ditta sia ''10000'' e che sia stata condivisa proprio questa cartella.<br>

Vediamo nel dettaglio il dettaglio delle opzioni e dei percorsi richiesti:<br>
*'''Abilita gestione firma Var Hub''' deve essere selezionata qualora si voglia che i file XML delle fatture emesse siano firmati digitalmente con il certificato di Var Hub.<br>
*'''Abilita l’invio automatico fatture emesse''' consente, se abilitato, che, le fatture emesse, siano rese disponibili per il trasferimento a Var Hub contestualmente all’inserimento in FEP (estrazione fatture da SIGLA).<br>
Questa opzione lavora in sincrono con le opzioni ''Abilita invio fatture (B2B) non firmate'' e ad ''Abilita gestione firma Var Hub.''<br>
In particolare, considerando il flag Abilita l’invio automatico fatture emesse attivo, le fatture saranno gestite così:<br>
- ''fatture PA'': saranno inviate solo se Abilita gestione firma Var Hub è attivo<br>
- ''fatture B2B/B2C'': saranno inviate se Abilita gestione firma Var Hub è attivo oppure se lo è Abilita invio fatture (B2B) non firmate<br> 

*'''Percorso di deposito delle fatture emesse (xml da inviare a Var Hub)''' è il percorso dove il modulo FEP deposita le fatture emesse da inviare a Var Hub. Il connettore di scambio dati di Var Hub preleva direttamente i file xml da questa cartella. Deve essere quindi correttamente configurato.<br>
*'''Percorso del deposito notifiche Var Hub''' è la cartella di deposito delle notifiche emesse direttamente da Var Hub. Anche per questa directory, dove crearla, valgono le indicazioni evidenziate per il percorso di deposito delle fatture emesse.<br>
*'''Percorso di deposito notifiche SdI e fatture ricevute (tramite Var Hub)''' è il percorso in cui il connettore di scambio dati di Var Hub deposita le fatture ricevute e le notifiche emesse dallo SdI. 
Anche per questa cartella valgono le indicazioni evidenziate per il percorso di deposito delle fatture emesse.<br>

Nel riquadro '''Dati connessione servizio di gestione pacchetti Var Hub''' occorre indicare l’indirizzo simbolico o numerico del PC/Server dove è installato il connettore DPSHubSvc.<br>
La comunicazione tra SIGLA/FEP e il connettore avviene via ''TCPIP'' sulla porta ''9229''. Qualora per esigenze di configurazione del firewall sia necessario utilizzare una porta diversa da quella di default è possibile variarla.<br>
In caso di variazione della porta è necessario applicare la stessa modifica anche alla configurazione del servizio DPSHubSvc inserendo lo stesso valore nel file di configurazione ''DPSHubSvc.cfg''.<br>

[[Image:Dp-conn12.png|thumb|link=|center|806x523px|Figura '''12''':Gestione Fattura Elettronica/pagina Var Hub]]

=== Menù Ditte ===

Nel menù '''Ditte''' della configurazione di SIGLA<sup>®</sup> occorre inserire i dati di Var Hub per la creazione dei file XML delle fatture da inviare.<br>
Per questa operazione è necessario premere il bottone '''FatturaPA''' presente nella pagina '''Dati''' e inserire:

*nella sezione '''Dati Trasmittente''' occorre inserire la partita IVA/codice fiscale di Var Group SpA;<br>

[[Image:Dp-conn13.png|thumb|link=|center|806x523px|Figura '''13''':Ditte/pagina Dati/Dati trasmittente]]

*nella sezione '''Terzo Intermediario''' o '''Soggetto Emittente''' occorre inserire la partita IVA, il codice fiscale e la ragione sociale di Var Group;<br>

[[Image:Dp-conn14.png|thumb|link=|center|806x523px|Figura '''14''':Ditte/pagina Dati/Terzo intermediario o Soggetto emittente]]

*il campo '''Soggetto Emittente''' deve essere valorizzato con TZ (soggetto terzo) nel caso in cui si utilizzi la firma digitale di Var Hub per la firma delle fatture emesse.<br>
Nel caso in cui non si utilizzi la firma di Var Hub invece si può lasciare il valore di default (''Cedente/Prestatore'').<br>

[[Image:Dp-conn15.png|thumb|link=|center|806x523px|Figura '''15''':Ditte/pagina Dati/Soggetto emittente TZ]]

== Note  ==
<references />

== 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}}