Comunicazioni Tecniche • 29/07/2026

Nell’ambito delle attività di manutenzione evolutiva e miglioramento continuo, sono stati recentemente completati alcuni interventi sul repository dell'Allegato Tecnico SUE (branch main), finalizzati a consolidare la chiarezza e l’affidabilità del codice per supportare le attività di sviluppo.  

 

In particolare, mediante la Pull Request #26 (issue #23), per colmare l’assenza dei metadati “filename” (nome del file con relativa estensione), “mime_type” (tipo di media/formato del file) e “file_size” (dimensione del file espressa in byte) nelle operazioni di recupero dei documenti:

 

  • è stato introdotto lo schema “Document” nella cartella “components/schemas” nei file OpenAPI/bo_to_et.yaml, OpenAPI/bo_to_fo.yaml, OpenAPI/et_to_bo.yaml e OpenAPI/fo_to_bo.yaml; 

  • è stata aggiornata l’OpenAPI bo_to_et.yaml: in “RequestIntegrationRequest” è stato modificato “integration_document_list” in “items” per utilizzare lo schema “Document”, in “NegativeOutcomeRequired” sono stati sostituiti i campi inline con la proprietà “document” (è stato aggiornato anche l'oggetto “example”), in “PositiveOutcome” sono stati sostituiti i campi inline con la proprietà “document” e in “GenericConclusion” sono sostituiti i campi inline con la proprietà “document”; 

  • è stata aggiornata l’OpenAPI bo_to_fo.yaml: in “InstanceIndex” è stato modificato “items” per referenziare “Document”, in “Resources” è stato modificato “items” per referenziare “Document”; 

  • è stata aggiornata l’OpenAPI et_to_bo.yaml: in “TransferOutcomeNotifyMessage” sono stati sostituiti i campi inline con la proprietà “document”, in “CdssNotifyMessage” sono stati sostituiti i campi inline con la proprietà “document”; 

  • è stata aggiornata l’OpenAPI fo_to_bo.yaml: in “RequestIntegrationRequest” è stato modificato “integration_document_list” in “items” per utilizzare lo schema “Document”, in “TransferOutcomeNotifyMessage” sono stati sostituiti i campi inline con la proprietà “document”; 

  • è stato eseguito lo split di "RequestIntegrationRequest" in due schemi "IntegrationRequest" e "ConformationRequest" e all’interno dei file bo_to_et.yaml e fo_to_bo.yaml. 

Successivamente, con la Pull Request #27 (issue #24): 

 

  • è stato aggiunto il path “/retry” in ri_to_bo.yaml, per garantire l’eventuale ritrasmissione delle informazioni tra il Registro Imprese e il BackOffice SUE. 

Infine, nell’ambito della Pull Request #28 (issue #25), per migliorare la gestione e la classificazione dei documenti e degli allegati istruttori attraverso una tassonomia dedicata è stato aggiornato catalogo-ssu_meta.yaml con nuovi endpoint per la Classificazione Documentale e Tag, in particolare: 

 

  • GET /document_classifications: recupero dell'elenco delle classificazioni documentali filtrabili via query string (coding, class_code, class_description, typology_code, typology_description); 

  • GET /general_index_classifications/{name}: recupero della classificazione associata a un documento del General-Index; 

  • GET /document_classification/form/{form_id_list}: recupero delle classificazioni associate a liste di Form (DocumentEntityClassified); 

  • GET /document_classification/attachment/{attachment_id_list}: recupero delle classificazioni associate a liste di Allegati (DocumentEntityClassified); 

  • GET /tags: recupero dell'elenco dei tag dei procedimenti.

    Sono stati introdotti nuovi schemi: 

  • documentClassification: definizione della struttura per codifica pattern "C[0-9]{1,2}_[a-z]"), classe e tipologia; 

  • documentEntityClassified: estensione di DocumentEntity con l'attributo document_classification_coding; 

  • administrationEntity: schema generico per la rappresentazione dell'amministrazione (id, versione, descrizione, date validità e stato); 

  • sono stati introdotti alcuni vincoli e risolti alcuni bug: 

  • è stato inserito “maxItems: 50” per la validazione delle liste nei parametri di path/query (es. id_proceeding_list , id_component_list , id_form_list , id_attachment_list , ecc.); 

  • è stato reso opzionale (required: false) il parametro “lifeevent” nell'endpoint /typologies-lifeevents/{context}; 

  • è stato aggiunto il campo “id” allo schema ComponentEntity; 

  • sono stati allineati i riferimenti degli schemi in /proceeding-third-party-systems-by-administration/ (passando a AdministrationEntity). 

 

Per maggiori dettagli, è possibile consultare il repository: https://github.com/AgID/SUE-allegato-tecnico.