Subject Structure Examples

This document provides comprehensive examples of all possible subject types and roles that can be used when uploading documents.

Overview

Subjects can have different types (tipo) and roles (ruolo). The available fields depend on the subject type.

Valid Role and Type Combinations

The following table shows which subject types are valid for each role:

Role	Code	Valid Types
Assegnatario	AS (in tipo field)	AS
Autore	AUTORE	PF, PG
Destinatario	DESTINATARIO	PF, PG, PA (PAI/PAE)
Mittente	MITTENTE	PF, PG, PA (PAI/PAE)
Operatore	OPERATORE	PF
Produttore	PRODUTTORE	SW
Responsabile Gestione Documentale	RGD	PF
Responsabile Servizio Protocollazione	RSP	PF
Autorità Emittente/Ricevente	AER	PA (PAI/PAE)
Responsabile Unico Procedimento	RUP	RUP (special type)
Soggetto Registrazione	SER	PF, PG
Altro	ALTRO	PF, PG, PA (PAI/PAE)

Complete Examples by Type

1. ASSEGNATARIO (AS)

AS - ASSEGNATARIO Role

{
  "ruolo": "ASSEGNATARIO",
  "tipo": "AS",
  "denominazione": "Organization Name",
  "denominazione_ufficio": "Office Name",
  "cognome": "Surname",
  "nome": "Name",
  "ipa_uor": {},
  "indirizzi_digitali_riferimento": []
}

2. PERSONA FISICA (PF)

Natural persons can have multiple roles. Here are examples for each role:

PF - AUTORE (Author)

{
  "ruolo": "AUTORE",
  "tipo": "PF",
  "cognome": "Rossi",
  "nome": "Mario",
  "id_paese": "IT",
  "ipa_amm": {
    "codice_ipa": "admin_ipa_code",
    "denominazione": "Administration Name"
  },
  "ipa_aoo": {},
  "ipa_uor": {},
  "indirizzi_digitali_riferimento": []
}

PF - DESTINATARIO (Recipient)

{
  "ruolo": "DESTINATARIO",
  "tipo": "PF",
  "cognome": "Bianchi",
  "nome": "Laura",
  "id_paese": "IT",
  "ipa_amm": {},
  "ipa_aoo": {},
  "ipa_uor": {},
  "indirizzi_digitali_riferimento": []
}

PF - MITTENTE (Sender)

{
  "ruolo": "MITTENTE",
  "tipo": "PF",
  "cognome": "Verdi",
  "nome": "Giuseppe",
  "codice_fiscale": "codice fiscale ttest 021903",
  "matricola": "ttest 021903",
  "id_paese": "IT",
  "ipa_amm": {
    "codice_ipa": "ttest 021903",
    "denominazione": "ttest 021903"
  },
  "ipa_aoo": {
    "codice_ipa": "ttest 021903",
    "denominazione": "ttest 021903"
  },
  "ipa_uor": {
    "codice_ipa": "ttest 021903",
    "denominazione": "ttest 021903"
  },
  "indirizzi_digitali_riferimento": []
}

PF - OPERATORE (Operator)

{
  "ruolo": "OPERATORE",
  "tipo": "PF",
  "cognome": "Ferrari",
  "nome": "Anna",
  "id_paese": "IT",
  "ipa_amm": {},
  "ipa_aoo": {},
  "ipa_uor": {},
  "indirizzi_digitali_riferimento": []
}

PF - RGD (Document Management Officer)

{
  "ruolo": "RGD",
  "tipo": "PF",
  "cognome": "Romano",
  "nome": "Carlo",
  "id_paese": "IT",
  "ipa_amm": {},
  "ipa_aoo": {},
  "ipa_uor": {},
  "indirizzi_digitali_riferimento": []
}

PF - RSP (Protocol Service Officer)

{
  "ruolo": "RSP",
  "tipo": "PF",
  "cognome": "Colombo",
  "nome": "Elena",
  "id_paese": "IT",
  "ipa_amm": {},
  "ipa_aoo": {},
  "ipa_uor": {},
  "indirizzi_digitali_riferimento": []
}

PF - SER (Registration Subject)

{
  "ruolo": "SER",
  "tipo": "PF",
  "cognome": "Marino",
  "nome": "Francesca",
  "id_paese": "IT",
  "ipa_amm": {},
  "ipa_aoo": {},
  "ipa_uor": {},
  "indirizzi_digitali_riferimento": []
}

PF - ALTRO (Other)

{
  "ruolo": "ALTRO",
  "tipo": "PF",
  "cognome": "Ricci",
  "nome": "Marco",
  "id_paese": "IT",
  "ipa_amm": {},
  "ipa_aoo": {},
  "ipa_uor": {},
  "indirizzi_digitali_riferimento": []
}

3. PERSONA GIURIDICA (PG)

Legal entities can have the following roles:

PG - AUTORE (Author)

{
  "ruolo": "AUTORE",
  "tipo": "PG",
  "denominazione": "ACME Corporation S.p.A.",
  "denominazione_ufficio": "Legal Department",
  "id_paese": "IT",
  "indirizzi_digitali_riferimento": []
}

PG - DESTINATARIO (Recipient)

{
  "ruolo": "DESTINATARIO",
  "tipo": "PG",
  "denominazione": "TechSolutions S.r.l.",
  "denominazione_ufficio": "Administration Office",
  "id_paese": "IT",
  "indirizzi_digitali_riferimento": []
}

PG - MITTENTE (Sender)

{
  "ruolo": "MITTENTE",
  "tipo": "PG",
  "denominazione": "Global Services Ltd.",
  "denominazione_ufficio": "Customer Relations",
  "id_paese": "IT",
  "indirizzi_digitali_riferimento": []
}

PG - ALTRO (Other)

{
  "ruolo": "ALTRO",
  "tipo": "PG",
  "denominazione": "Consulting Partners S.r.l.",
  "denominazione_ufficio": "Operations",
  "id_paese": "IT",
  "indirizzi_digitali_riferimento": []
}

4. PUBBLICHE AMMINISTRAZIONI ESTERE (PAE)

Foreign Public Administrations can have these roles:

PAE - AUTORE (Author)

{
  "ruolo": "AUTORE",
  "tipo": "PAE",
  "denominazione": "French Ministry of Foreign Affairs",
  "denominazione_ufficio": "Diplomatic Office",
  "id_paese": "FR",
  "indirizzi_digitali_riferimento": []
}

PAE - DESTINATARIO (Recipient)

{
  "ruolo": "DESTINATARIO",
  "tipo": "PAE",
  "denominazione": "German Federal Ministry of Finance",
  "denominazione_ufficio": "International Relations",
  "id_paese": "DE",
  "indirizzi_digitali_riferimento": []
}

PAE - MITTENTE (Sender)

{
  "ruolo": "MITTENTE",
  "tipo": "PAE",
  "denominazione": "Spanish Tax Agency",
  "denominazione_ufficio": "International Department",
  "id_paese": "ES",
  "indirizzi_digitali_riferimento": []
}

PAE - ALTRO (Other)

{
  "ruolo": "ALTRO",
  "tipo": "PAE",
  "denominazione": "Swiss Federal Office",
  "denominazione_ufficio": "European Affairs",
  "id_paese": "CH",
  "indirizzi_digitali_riferimento": []
}

5. PUBBLICHE AMMINISTRAZIONI ITALIANE (PAI)

Italian Public Administrations can have these roles:

PAI - AUTORE (Author)

{
  "ruolo": "AUTORE",
  "tipo": "PAI",
  "denominazione": "Ministero dell'Interno",
  "codice_ipa": "m_it",
  "id_paese": "IT",
  "indirizzi_digitali_riferimento": []
}

PAI - DESTINATARIO (Recipient)

{
  "ruolo": "DESTINATARIO",
  "tipo": "PAI",
  "codice_ipa": "agentrate",
  "denominazione": "Agenzia delle Entrate",
  "id_paese": "IT",
  "indirizzi_digitali_riferimento": []
}

PAI - MITTENTE (Sender)

{
  "ruolo": "MITTENTE",
  "tipo": "PAI",
  "denominazione": "Comune di Roma",
  "codice_ipa": "c_h501",
  "id_paese": "IT",
  "indirizzi_digitali_riferimento": []
}

PAI - AER (Issuing/Receiving Authority)

{
  "ruolo": "AER",
  "tipo": "PAI",
  "denominazione": "Regione Lombardia",
  "codice_ipa": "r_lombar",
  "id_paese": "IT",
  "indirizzi_digitali_riferimento": []
}

PAI - ALTRO (Other)

{
  "ruolo": "ALTRO",
  "tipo": "PAI",
  "denominazione": "Università degli Studi di Milano",
  "codice_ipa": "unimi",
  "id_paese": "IT",
  "indirizzi_digitali_riferimento": []
}

6. SOFTWARE (SW)

Software systems can only have the PRODUTTORE role:

SW - PRODUTTORE (Producer)

{
  "ruolo": "PRODUTTORE",
  "tipo": "SW",
  "denominazione": "TeamSystem TS Archive v4.5.2"
}

SW - PRODUTTORE (Producer) - Alternative Example

{
  "ruolo": "PRODUTTORE",
  "tipo": "SW",
  "denominazione": "Enterprise Document Management System v2.1"
}

7. RUP (Responsabile Unico del Procedimento)

The RUP role has a special structure:

RUP Role Example

{
  "ruolo": "RUP",
  "tipo": "RUP",
  "cognome": "Gentile",
  "nome": "Roberto",
  "id_paese": "IT",
  "ipa_amm": {},
  "ipa_aoo": {},
  "ipa_uor": {},
  "indirizzi_digitali_riferimento": []
}

Overview​

Valid Role and Type Combinations​

Complete Examples by Type​

1. ASSEGNATARIO (AS)​

AS - ASSEGNATARIO Role​

2. PERSONA FISICA (PF)​

PF - AUTORE (Author)​

PF - DESTINATARIO (Recipient)​

PF - MITTENTE (Sender)​

PF - OPERATORE (Operator)​

PF - RGD (Document Management Officer)​

PF - RSP (Protocol Service Officer)​

PF - SER (Registration Subject)​

PF - ALTRO (Other)​

3. PERSONA GIURIDICA (PG)​

PG - AUTORE (Author)​

PG - DESTINATARIO (Recipient)​

PG - MITTENTE (Sender)​

PG - ALTRO (Other)​

4. PUBBLICHE AMMINISTRAZIONI ESTERE (PAE)​

PAE - AUTORE (Author)​

PAE - DESTINATARIO (Recipient)​

PAE - MITTENTE (Sender)​

PAE - ALTRO (Other)​

5. PUBBLICHE AMMINISTRAZIONI ITALIANE (PAI)​

PAI - AUTORE (Author)​

PAI - DESTINATARIO (Recipient)​

PAI - MITTENTE (Sender)​

PAI - AER (Issuing/Receiving Authority)​

PAI - ALTRO (Other)​

6. SOFTWARE (SW)​

SW - PRODUTTORE (Producer)​

SW - PRODUTTORE (Producer) - Alternative Example​

7. RUP (Responsabile Unico del Procedimento)​

RUP Role Example​