Glossario

Glossario

ItemId

L'itemId è il riferimento univoco ad una risorsa dell'anagrafica di TsDigital, in particolare può riferirsi a diversi classifiers (vedi Classifier):

All'interno dell'ecosistema TsDigital, lo stesso termine è identificato anche con dei sinonimi più specializzati per il contesto di utilizzo.

Ad oggi ogni azienda ha già un ItemId che, nel caso di aziende (classifier=COMPANY) e studi (classifier=STUDIO) italiane (taxRegion=IT), coincide con il codice fiscale. Condomini e aziende/studi esteri utilizzano già il nuovo formato.

A tendere ogni endpoint di TS-Digital che avrà come input un dato che fa riferimento ad una di queste entità dovrà utilizzare il rispettivo ItemId.

Per recuperare questo id è possibili utiliizare l' API di findItem dell' anagrafica

 

ManagerId

E' l'itemId di un gestore di altri itemId, generalmente inquadrato con il classifier di Studio, non è limitato al solo ruolo di commercialista ma ad esempio potrebbe anche essere un libero professionista consulente di privacy per altre aziende.

 

ManagedId

E' l'itemId dell'azienda gestita. Di solito è utilizzato per indicare la controparte del managerId su API riguardanti il rapporto tra i due.

 

TransmitterId

E' l'itemId di chi sta trasmettendo uno specifico payload (generalmente documenti). Può coincidere con il concetto di managerId ma potrebbe non avere gli stessi gradi di relazione che il managerId implica. Es. Il commercialista invia la fattura per conto del cliente X.

 

SenderId

E' l'itemId che indica il mittente del payload. Può coincidere con il transmitterId nel caso in cui sia lui stesso l'itemId che trasmette per se stesso.

 

RecipientId

E' l'itemId destinatario del payload.

Deadletter

Tutti i processi asyncroni utilizzati in ts digital sfruttano un meccanismo a code di messaggi. Se un messaggio per qualsiasi motivo incontra degli errore per i quali non è possibile implementare un automatismo di risoluzione finiscono in una coda secondaria chiamata Deadletter, spesso abbreviata in "DLQ". Rimarranno in questa coda fino a quando un intervento manuale non li riporterà sulla coda principale. Solitamente questo avviene dopo aver risolto i problemi che l'hanno portata in deadletter.