Tipologie di Connessione

A seconda delle condizioni di gestore e gestita, una connessione viene creata con una di 3 tipologie: USER, AUTO e SYS.

Connessioni USER

Una connessione di tipo USER è una connessione effettuata fra 2 item indipendenti all'interno di TS Digital. La connessione viene creata disattiva con status UNVERIFIED.

Per connessioni di questo tipo, l'azienda gestita riceve una notifica, visibile ad amministratori ed owner, la quale informa dell'avvenuta richiesta e propone la possibilità di accettarla o rifiutarla. Se la richiesta di connessione viene accettata, la connessione diventa immediatamente attiva e il suo status passa a VALIDATED. Se, in caso contrario, viene rifiutata, la connessione rimane inattiva e il suo stato passa a REJECTED. Una connessione rifiutata non può più essere attivata, ma rimarrà visibile fino all'arrivo di una nuova richiesta di connessione per lo stesso servizio.

Una volta che la connessione è in stato VALIDATED è possibile procedere con la sua certificazione tramite il caricamento di un Atto d'Affidamento. La certificazione non è necessaria per l'utilizzo della connessione, ma potrebbe essere necessaria per l'utilizzo di alcune funzionalità del servizio connesso (es: firma Teamsystem per il servizio di fatturazione).

Connessioni AUTO

Una connessione di tipo AUTO è una connessione nella quale l'item gestito non ha alcun utente owner (questi item sono noti anche come aziende orfane). L'item non deve inoltre aver mai avuto nessun altro gestore per lo specifico servizio connesso, o deve già esistere un AdA certificato sotto lo stesso appId per la coppia gestore/gestita.

La connessione viene creata già attiva ed in stato VALIDATED, è immediatamente utilizzabile ed è possibile procedere con la sua certificazione.

Connessioni SYS

Una connessione SYS è un caso particolare della connessione AUTO; si verifica nel caso in cui l'item gestito è un'azienda orfana che ha già avuto in passato un gestore (differente dall'attuale) per lo stesso servizio.

La connessione viene creata disattiva con status UNVERIFIED. Per attivare la connessione è necessario caricare un AdA ed attendere che venga certificato. Post certificazione la connessione viene attivata, il suo stato passa a VALIDATED e il suo certificationStatus passa a CERTIFIED.

Flussi di stato

Flusso di validazione

Il flusso di validazione influenza lo status di una connessione segue un flusso che ha due possibli stati finali: VALIDATED e REQUEST_REJECTED.

Le connessioni di tipologia USER vengono create con lo status PENDING_REQUEST. L'accettazione della notifica di richiesta connessione da parte della gestita porta lo status a VALIDATED, il suo rifiuto a REQUEST_REJECTED. Contestualmente al passaggio allo stato VALIDATED, la connessione viene anche attivata.

Le connessioni di tipo AUTO vengono create già attive, ma possono iniziare in uno di due stati a seconda del servizio a cui fanno riferimento:

• Le connessioni per SDI partono dallo stato UNVERIFIED e, per poter diventare VALIDATED devono necessariamente effettuare l'upload di un Atto D'Affidamento e seguire il relativo flusso di accettazione/rifiuto
• Le connessioni per ogni altro servizio partono direttamente dallo stato VALIDATED. Hanno comunque la possibilità di caricare un AdA e rientreranno nelle logiche del flusso di certificazione.

Le connessioni di tipo SYS partono dallo stato di UNVERIFIED ma, al contrario delle AUTO, nascono non attive. L'attivazione della connessione avviene alla fine del processo di convalida dell'AdA, il quale è quindi necessario per poterla utilizzare.

Flusso di Certificazione

Il flusso di certificazione influenza il certificationStatus della connessione, ed è interamente pilotato da eventi relativi all'AdA della connessione.

La condizione iniziale del certificationStatus dipende dalla tipologia di connessione considerata e dall'esistenza o meno di un AdA per una connessione esistente sotto lo stesso appId per la coppia gestore/gestita:

• Se la connessione è di tipo SYS partirà sempre dallo status NULL
• Se, per la coppia gestore/gestita, esiste già un AdA che si trovi almeno in AWAITING_APPROVAL, la nuova connessione viene creata allo stesso stato. Da quel momento in poi, modifiche a quell'AdA avranno effetto su tutte le connessioni ad esso collegate
• In ogni altro caso, lo stato di certificazione parte da NULL

Se una connessione ha stato di certificazione NULL ma il suo stato di validazione non è ancora VALIDATED, lo stato di certificazione rimarrà NULL fino al termine della convalida dell'AdA, quando passerà regolarmente allo stato di CERTIFIED.

Il flusso di certificazione è infinitamente ripetibile: in qualunque momento, se l'AdA dovesse venir invalidato (manualmente da backoffice, o come conseguenza di una rettifica di codice fiscale), lo stato di certificazione verrà riportato ad AWAITING_APPROVAL.