Versions Compared

Old Version 63

changes.mady.by.user Unknown User (e.vaccari@cineca.it)

Saved on

compared with

New Version 64

changes.mady.by.user Unknown User (e.vaccari@cineca.it)

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Expand
titleIntegrazione con sistemi esterni


Stati e Transizioni della FE

EditFullscreen

Gliffy Diagram
displayNameWorkflow trasmisione sistema documentale
nameWorkflow trasmisione sistema documentale
pagePinpageid2239304832

Workflow in presenza di sistema documentale diverso da Titulus

Nota: Questo workflow viene seguito se il parametro [TIPO_SISTEMA_DOCUMENTALE] = Esterno

  1. La fattura viene creata in U-GOV;
  2. Vengono effettuate le registrazioni IVA -> la fattura passa nello stato DA TRASMETTERE;
  3. Il sistema esterno invoca il servizio GetElencoFEDaTrasmettere per estrarre l'elenco delle fatture da trasmettere a SdI;
  4. Il sistema esterno invoca il servizio GetXmlFE per estrarre il file XML associato ad una fattura che passa nello stato IN TRASMISSIONE;
  5. Se la registrazione nel sistema documentale è andata a buon fine:
    1. Il sistema esterno gestisce la firma digitale e l'invio a SdI
    2. Il sistema esterno restituisce ad U-GOV l'esito invocando il servizio  receiveMsgForFTEL
    3. A seconda dei casi la fattura va nello stato TRASMESSO o TRASMISSIONE CON ERRORI
    4. FINE
  6. Se la registrazione nel sistema documentale non è andata a buon fine: 
    1. il sistema documentale esegue il servizio ResetTrasmissionFE che ripristina lo stato DA TRASMETTERE e quindi permette la riesportazione della fattura;
    2. Il flusso riprende al punto 3.

Interfaccia Applicativa (API)

U-GOV espone una interfaccia applicativa basata sull'uso di servizi SOAP.

Una descrizione dettagliata del servizio è descritta nel documento: WSDGACService - Operazioni Speciali e Fatturazione Elettronica


Di seguito è riportato un elenco con una breve descrizione delle operazioni coinvolte.

getElencoFEDaTrasmettere

Parametri in input:intervallo: deve essere un numero compreso tra 1 e 365; indica l'intervallo (in gg) entro cui vengono estratte le fatture da trasmettere. Da tarare in base al periodo di polling adottato. Un intervallo più ampio permette una sincronizzazione meno frequente, ma può richiedere tempi di estrazione più lunghi.

Operazioni:


il sistema estrae i DG che:
- hanno la sotto-FSM Fatturazione Elettronica in stato DA TRASMETTERE;
- hanno data registrazione <= data corrente e >= (data corrente – intervallo)
Output:ID_DG, TIPO_DG, ANNO, CD_UO_NUMERANTE, NUMERO_REGISTRAZIONE_DG


getXmlFE

Parametri in input:ID_DG
Operazioni:

Creazione del file Xml della fattura; esecuzione della transizione che porta la fattura in stato IN TRASMISSIONE

Output:

file XML della fattura

resetTrasmissionFE

Parametri in input:ID_DG, testo messaggio errore
Operazioni:

Inserimento nel file allegato al DG corrente che ha tipo Fattura_Elettronica_Esito_SdI di una stringa ottenuta da questa concatenazione:
Tipo Messaggio: Messaggio Emesso Da Sistema Documentale Esterno / Descrizione: testo del messaggio;

Esecuzione della transizione che riporta la fattura nello stato DA TRASMETTERE;

Output:

Nessuno

receiveMsgForFTEL

Parametri in input:XML esito ritornato da SdI
Operazioni:

Viene elaborato l'esito dell'invio. Viene modificato di conseguenza lo stato della fattura salvato come allegato il messaggio di esito:

se il messaggio ha tipo Notifica Scarto -> TRASMISSIONE CON ERRORI

se il messaggio ha tipo Notifica di Mancata Consegna il sistema sul dg identificato:

se il messaggio ha tipo Ricevuta di Consegna il sistema sul dg identificato

se il messaggio ha tipo Attestazione di Avvenuta Trasmissione con Impossibilità di Recapito -> TRASMESSO

se il messaggio ha tipo Notifica di Decorrenza Termini -> TRASMESSO

se il messaggio ha tipo Notifica Esito e contenuto Rifiuto -> TRASMISSIONE CON ERRORI

se il messaggio ha tipo Notifica Esito e contenuto Accettazione -> TRASMESSO

Output:

Nessuno


Ruoli

Per poter utilizzare i servizi descritti, il client WS deve autenticarsi con un utente che possiede i seguenti diritti (appartenenti alla funzione denominata DG01$WSAC - WSDGACServiceService):



DG01$WSACS_GetElencoFEDaTrasmettereControlla l'accesso al servizio GetElencoFEDaTrasmettere
DG01$WSACS_GetXmlFEControlla l'accesso al servizio GetXmlFE
DG01$WSACS_ResetTrasmissionFEControlla l'accesso al servizio ResetTrasmissionFE
DG01$WSACS_receiveMsgForFTELControlla l'accesso al servizio receiveMsgForFTEL

...