Subject Structure

For each type of document, it is possible to specify a series of subjects when uploading the document. The subjects have a variable structure depending on the type of the latter. Below you will find detailed documentation and examples for all subject types (soggetti). Each section includes the JSON schema structure with required and optional fields for the respective subject type. For practical examples of how to use these structures, see the Subject Structure Examples.

Subject types

The possible types of subjects are as follows:

AS: ASSEGNATARIO
PF: PERSONA FISICA
PG: PERSONA GIURIDICA
PAE: PUBBLICHE AMMINISTRAZIONI ESTERE
PAI: PUBBLICHE AMMINISTRAZIONI ITALIANE
RUP: RESPONSABILE UNICO PROCEDIMENTO
SW: SOFTWARE

Subject Roles

The subjects also provide for the indication of the role held, the values of which are piloted by the subject.tipo

ASSEGNATARIO
AUTORE
DESTINATARIO
MITTENTE
OPERATORE
PRODUTTORE
RGD: RESPONSABILE GESTIONE DOCUMENTALE
RSP: RESPONSABILE SERVIZIO PROTOCOLLO
SER: SOGGETTO CHE EFFETTUA LA REGISTRAZIONE
AER: AMMINISTRAZIONE CHE EFFETTUA LA REGISTRAZIONE
RUP: RESPONSABILE UNICO PROCEDIMENTO
ALTRO

Subject structures

ASSIGNEE - AS

{
  "properties": {
    "ruolo": { "type": "string", "enum": ["ASSEGNATARIO"] },
    "tipo": {
      "type": "string",
      "enum": ["AS"]
    },
    "denominazione": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "denominazione_ufficio": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "cognome": {
      "type": "string",
      "maxLength": 200
    },
    "nome": {
      "type": "string",
      "maxLength": 200
    },
    "codice_fiscale": {
      "type": "string",
      "maxLength": 200
    },
    "indirizzi_digitali_riferimento": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "codice_sdi": {
      "type": "string",
      "pattern": "^[a-zA-Z0-9]{6,7}$"
    }
  },
  "required": ["ruolo", "tipo", "denominazione", "denominazione_ufficio"]
}

NATURAL PERSON - PF

{
  "properties": {
    "ruolo": {
      "type": "string",
      "enum": [
        "AUTORE",
        "DESTINATARIO",
        "MITTENTE",
        "OPERATORE",
        "RGD",
        "RSP",
        "SER",
        "ALTRO"
      ]
    },
    "tipo": {
      "type": "string",
      "enum": ["PF"]
    },
    "cognome": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "nome": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "codice_fiscale": {
      "type": "string",
      "maxLength": 200
    },
    "partita_iva": {
      "type": "string",
      "maxLength": 200
    },
    "indirizzi_digitali_riferimento": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "codice_sdi": {
      "type": "string",
      "pattern": "^[a-zA-Z0-9]{6,7}$"
    },
    "id_paese": { "type": "string", "pattern": "^[A-Z]{2}$" },
    "matricola": { "type": "string", "maxLength": 200 }
  },
  "required": ["ruolo", "tipo", "cognome", "nome"]
}

LEGAL ENTITY - PG

{
  "properties": {
    "ruolo": {
      "type": "string",
      "enum": ["AUTORE", "DESTINATARIO", "MITTENTE", "ALTRO"]
    },
    "tipo": {
      "type": "string",
      "enum": ["PAE"]
    },
    "denominazione": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "denominazione_ufficio": {
      "type": "string",
      "maxLength": 200
    },
    "indirizzi_digitali_riferimento": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "id_paese": { "type": "string", "pattern": "^[A-Z]{2}$" }
  },
  "required": ["ruolo", "tipo", "denominazione"]
}

ITALIAN PUBLIC ADMINISTRATION - PAI

{
  "properties": {
    "ruolo": {
      "type": "string",
      "enum": ["AUTORE", "DESTINATARIO", "MITTENTE", "ALTRO"]
    },
    "tipo": {
      "type": "string",
      "enum": ["PAI"]
    },
    "denominazione": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "codice_ipa": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "denominazione_amministrazione_aoo": {
      "type": "string",
      "maxLength": 200
    },
    "denominazione_amministrazione_uor": {
      "type": "string",
      "maxLength": 200
    },
    "codice_ipa_aoo": { "type": "string", "maxLength": 200 },
    "codice_ipa_uor": { "type": "string", "maxLength": 200 },
    "codice_fiscale": {
      "type": "string",
      "maxLength": 200
    },
    "partita_iva": {
      "type": "string",
      "maxLength": 200
    },
    "indirizzi_digitali_riferimento": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "id_paese": { "type": "string", "pattern": "^[A-Z]{2}$" }
  },
  "required": ["ruolo", "tipo", "denominazione", "codice_ipa"]
}

SOFTWARE - SW

{
  "properties": {
    "ruolo": {
      "type": "string",
      "enum": ["PRODUTTORE"]
    },
    "tipo": {
      "type": "string",
      "enum": ["SW"]
    },
    "denominazione": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    }
  },
  "required": ["ruolo", "tipo", "denominazione"]
}

RUP - RUP

{
  "properties": {
    "ruolo": {
      "type": "string",
      "enum": [
        "RUP"
      ]
    },
    "tipo": {
      "type": "string",
      "enum": ["PF"]
    },
    "cognome": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "nome": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "codice_fiscale": {
      "type": "string",
      "maxLength": 200
    },
    "indirizzi_digitali_riferimento": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "id_paese": { "type": "string", "pattern": "^[A-Z]{2}$" }
  },
  "required": ["ruolo", "tipo", "cognome", "nome"]
}