L'applicazione integrata con il servizio My Fattura

Transcript

1 L'applicazione integrata con il servizio My Fattura Come funziona einvoicemanger (eim) 2 Per il CICLO ATTIVO 2 Per il CICLO PASSIVO 2 Come può essere utilizzato 2 Installazione di eim 2 Installazione del servizio 3 Prima configurazione 3 Utilizzo tramite interfaccia 6 Scheda Invio Fatture Attive 6 Scheda Download Ricevute 7 Scheda Download Fatture Passive 8 Scheda Logs 10 Utilizzo in background con parametri da linea comando 10 Utilizzo tramite servizio di Windows (einvoicemanager) 12 1

2 Come funziona einvoicemanager (eim) Invia le fatture xml dal tuo PC a SDI Scarica gli esiti delle fatture inviate nella stessa cartella di invio abbinandoli alle fatture Scarica sul tuo PC le fatture passive ricevute tramite il codice univoco di Arthur Per il CICLO ATTIVO L applicazione si preoccuperà di prelevare tutti i file xml o xml.p7m presenti in una cartella di INPUT configurabile, ed inviarli nell area riservata My Fattura dell utente interessato. Per ogni file correttamente inviato verrà generata una sottocartella nominata in questo modo: nome file caricato + nome file inviato.. Per esempio se importo il file fattura.xml la cartella si chiamerà fattura.xml@it _xxxxx dove XXXXX è un valore univoco. Nelle cartelle verranno scaricati gli esiti quando disponibili. Ogni file inviato con errori verrà spostato in una sottocartella chiamata ERRORS nella quale troverete un file nomefilefattura.error con il motivo dell errore. Per il CICLO PASSIVO L applicazione si preoccuperà di scaricare, dall area riservata My Fattura dell utente interessato, le eventuali fatture passive pervenute, in una cartella di OUTPUT configurabile. Come può essere utilizzato eim può essere eseguita in tre modalità: Tramite interfaccia grafica In background con parametri da linea comando Tramite servizio di windows Installazione di eim Estrarre l intero contenuto del file zip fornito da Arthur Informatica in una cartella del PC. 2

3 Installazione del servizio Lanciare con privilegi di amministratore il file install service.bat Verificare nei servizi di Windows la presenza del servizio einvoicemanger Il servizio viene installato con partenza Manuale. Impostarlo in modalità Automatica e avviarlo (tasto dx mouse sul servizio > Avvia) Prima configurazione Lanciare l eseguibile ElectronicInvoiceManager.exe con privilegi da amministratore del PC. Avrete subito un messaggio di mancata configurazione dei campi principali 3

4 Cliccare su OK, si accede nella pagina delle Impostazioni dove sarà necessario configurare Url della piattaforma web MyDataCloud Utente Password utente fornito da Arthur Informatica in fase di prima attivazione password fornita da Arthur Informatica in fase di prima attivazione Cliccare su Verifica per assicurarsi che la connessione funzioni correttamente. Cartella delle fatture attive da inviare Impostare una cartella dove verranno prelevati i file delle fatture da inviare al servizio My Fattura Se il file xml non hanno i dati corretti di emittente e trasmittente barrare le caselle di Integra i dati del trasmittente e Integra i dati del terzo soggetto Impostare un range in giorni per il download delle ricevute relative alle fatture inviate con eim 4

5 Cartella delle fatture passive da ricevere Impostare una cartella dove verranno scaricati i file delle fatture ricevute e presenti sull account di My Fattura Impostare un range in giorni per il download delle fatture ricevute Impostazioni per l utilizzo da servizio Impostare (in ore) un intervallo di tempo per - inviare le fatture attive prelevate dalla cartella configurata per l invio - scaricare le ricevute (le ricevute verranno scaricate nella sottocartella cartella creata dopo il buon esito dell invio. Leggi ) - scaricare le fatture passive nella cartella configurata per la ricezione Inoltre è possibile scaricare, impostando il flag corretto: - solo ricevute non ancora scaricate - solo fatture passive non ancora scaricate - fatture passive già sbustate da un eventuale firma digitale (le fatture con firma embedded verranno scaricate senza sbustamento) Cliccare su Salva per salvare le impostazioni: apparirà il messaggio di conferma. Importante. Ogni volta che vengono modificate le impostazioni è importante riavviare l applicazione e/o il servizio. 5

6 Utilizzo tramite interfaccia Scheda Invio Fatture Attive Cliccare su + per caricare le fatture da inviare Una o più fatture verranno riepilogate nella tabella Cliccare su - dopo aver selezionata le fatture per eliminare dall invio. Cliccare su Invia per spedire tutte le fatture caricate e presenti in video al servizio My Fattura Apparirà il messaggio di conferma prima di inviare le fatture 6

7 Cliccare su SI per inviare Quando le fatture verranno inviate apparirà il nome assegnato alla fattura e un icona colorata che indica l esito: Verde > esito positivo Rosso > esito negativo In caso di esito negativo consultare la scheda dei log per visualizzare il motivo dell errore Alla fine della procedura viene dato un messaggio indicante il risultato. Eventuali dettagli è possibile visualizzarli su ogni fattura dalla relativa icona Esito, viene aperta una finestra con tutte le informazioni. Scheda Download Ricevute Entrando nella scheda una lista visualizza l elenco delle fatture inviate con i valori delle colonne elaborati in base alle cartelle presenti all interno della cartella definita nelle impostazioni. 7

8 Il pulsante Ricevi notifiche consente di effettuare una richiesta al server per il download delle notifiche, se specificato un range di date, scarica le notifiche delle fatture inviate entro quel periodo temporale, altrimenti scarica le notifiche delle fatture inviate nel periodo indicato dalle impostazioni. Le eventuali ricevute vengono copiate nella cartella creata relativa alla fattura di riferimento. Scheda Download Fatture Passive Una lista visualizza l elenco delle fatture ricevute presenti all interno della cartella definita dalle impostazioni. La colonna data ricezione indica la data di ricezione del file. 8

9 Se impostato il flag Scarica fattura xml nel caso sia firmata (p7m) e si riceve una fattura firmata con estensione p7m, viene sbustata e viene copiato nella cartella di output solo il file xml. Il pulsante Ricevi fatture consente di effettuare una richiesta al server per il download delle fatture, se specificato un range di date, scarica le fatture ricevute entro quel periodo temporale, altrimenti scarica le fatture ricevute nel periodo indicato dalle impostazioni. E possibile, tramite apposito flag scaricare le fatture non ancora scaricate. La ricezione delle fatture viene notificata con un messaggio. 9

10 Scheda Logs In questa scheda è possibile consultare i log divisi per ogni singola attività. Dal menù a tendina è possibile scegliere quale log visualizzare tra: - Fatture inviate - Notifiche fatture inviate - Fatture ricevute - Servizio Dopo aver selezionato la voce apparirà sotto il log. E possibile cancellare il log cliccando sul bottone Cancella log. E possibile tenere aggiornato il log dall interfaccia con aggiornamenti ogni 30 secondi impostando il flag sull apposita voce Utilizzo in background con parametri da linea comando dopo aver richiamato in background l eseguibile ElectronicInvociceManager.exe è possibile passare i seguenti parametri: Invio Fatture /Import /FilePath FilePath /Path Path Indica un operazione di importazione fatture Indica il percorso completo del file da importare Indica il percorso della cartella dalla quale importare tutti i files con estensione xml o p7m Valore di ritorno: 10

11 0 Operazione completata con successo -1 Operazione fallita (con dettaglio dell errore nello standard output) La chiamata da linea di comando sposta il file specificato (o i file xml o p7m presenti all interno della cartella specificata) all interno della cartella definita nelle impostazioni. Nel caso di operazione fallita consultare il log ElectronicInvoiceTx.log presente nella cartella \Logs Download Ricevute /GetElectronicInvoiceTxMessages /CheckRequestFlag /StartDate /EndDate Indica un operazione di ricezione delle notifiche relative alle fatture inviate Indica se utilizzare un flag di stato per ricevere solo i dati non ancora richiesti al server Indica la data minima relativa alle fatture inviate. Se non specificata verrà considerata la data corrente meno il numero di giorni specificati nelle impostazioni Indica la data massima relativa alle fatture inviate Valore di ritorno: >=0 Operazione completata con successo (il valore di ritorno indica il numero di notifiche di esito scaricate) -1 Operazione fallita (con dettaglio dell errore nello standard output) Nel caso di operazione fallita consultare il log ElectronicInvoiceTxMessages.log presente nella cartella \Logs Download Fatture Passive 11

12 /GetElectronicInvoiceRx /CheckRequestFlag /ExtractSignedFile /StartDate /EndDate Indica un operazione di ricezione delle fatture Indica se utilizzare un flag di stato per ricevere solo i dati non ancora richiesti al server Indica se scaricare la versione xml delle fatture p7m ricevute Indica la data minima relativa alle fatture ricevute. Se non specificata verrà considerata la data corrente meno il numero di giorni specificati nelle impostazioni Indica la data massima relativa alle fatture ricevute Valore di ritorno: >=0 Operazione completata con successo (il valore di ritorno indica il numero di fatture scaricate) -1 Operazione fallita (con dettaglio dell errore nello standard output) Nel caso di operazione fallita consultare il log ElectronicInvoiceRx.log presente nella cartella \Logs Utilizzo tramite servizio di Windows (einvoicemanager) Dopo aver installato e avviato il servizio, questo: - gestisce l invio in automatico di tutti i file con estensione xml o p7m presenti all interno della cartella definita nelle impostazioni con la tempistica configurata e completa le sue funzionalità ; - gestisce la ricezione delle notifiche di esito (ricevute) all interno della cartella creata dopo l invio della fattura. Le notifiche scaricate saranno quelle relative alle fatture inviate nel periodo indicato dalle impostazioni; - gestisce la ricezione automatica delle fatture all interno della cartella specificata nelle impostazioni 12

13 Nel caso di operazione fallita consultare il log ElectronicInvoiceService.log presente nella cartella \Logs 13