Portale Digital - identificazione di submitter e holder, produttore e titolare

Durante le fasi di versamento sarà necessario indicare la posizione su cui il versamento deve essere effettuato. 

La posizione viene sempre identificata come coppia Produttore - Titolare o come indicato nel payload, Submitter - Holder.

Evidenziamo 2 casi d'uso principali, la monoazienda e lo studio che agisce per conto terzi.

Monoazienda

Le monoaziende sono appunto aziende che decidono di operare in autonomia e agiscono sia come produttore che titolare.

In questi casi il produttore e il titolare coincidono. Anche nei versamenti l'identificativo che dovrà essere fornito sarà lo stesso.

Studi commercialisti / operatori per conto terzi

Gli studi sono entità censite nel sistema come operatori che possono agire per conto terzi, che chiameremo "gestite". In questo caso lo studio funge da produttore (submitter) e le gestite sono i titolari dei documenti (holder).

Individuazione degli ID

Quando si effettua un versamento su archive è necessario comprendere che è "il client chiamante" che si assume il compito di e conoscere la posizione su cui si effettua l'upload. Per questo motivo nel payload delle API chiamate bisogna specificare i due identificativi di submitter e holder.

Nel caso delle monoaziende, submitter = holder, nel caso degli studi che versano su una gestita submitter sarà diverso dall'holder.

Per individuare gli ID "manualmente" è possibile procedere in diversi modi:

Da Front end digital

Nel portale digital, dopo essere entrati nella posizione dell'azienda, è possibile individuare l'id dell'azienda stessa leggendolo nel riquadro in alto a destra, nella sezione sotto evidenziata

In modo automatico tramite software

I servizi della registry di digital sono disponibili per effettuare correttamente la decodifica di un codice fiscale nel relativo identificativo.

Per accedere alla anagrafica digital sono disponibili delle API documentate qui: https://digital-docs.ts-paas.com/books/anagrafica. 

Attraverso le API relative è possibile ricercare una partita iva e decodificarla negli ID di submitterid e holderid da utilizzare nel payload.

Da backoffice

Se si ha accesso al backoffice digital è sufficiente inserire la PIVA della azienda, nella schermata della azienda stessa l'identificativo è presente come da figura