# Integrazione con il gestionale atti {% hint style="warning" %} L'integrazione è attualmente disponibile per **Maggioli (JIRIDE)**. OpenCity Italia è disponibile a valutare integrazioni con altri sistemi gestionali. {% endhint %} Attraverso il connettore con il gestionale atti dell'ente, delibere e determine non devono più essere caricate manualmente sul sito. Gli atti vengono importati automaticamente nella sezione Documenti, insieme ai principali metadati, e resi immediatamente disponibili per l'utilizzo da parte del sistema. Questo elimina la necessità di duplicare il lavoro su due piattaforme diverse e riduce sensibilmente il rischio di errori nella pubblicazione. ## **Come funziona il connettore** {% hint style="info" %} L'importazione è periodica, con **aggiornamento ogni 12 ore** (la finestra temporale è configurabile, con valore predefinito di 48 ore). La strategia adottata è di tipo insert-only: gli atti già presenti nel sito vengono riconosciuti e saltati automaticamente, **evitando duplicazioni**. {% endhint %} Il connettore utilizza le API REST di Sicraweb con autenticazione Bearer token. Il recupero degli atti avviene tramite la funzione `listaAtti` (con paginazione e filtro per data di aggiornamento) e la funzione `dettaglioAtto` per i campi estesi.
## **Mappatura con supporto AI** La mappatura dei dati importati avviene anche con il supporto dell'intelligenza artificiale, secondo le seguenti logiche: * **selezione del tipo documento, dell'ufficio responsabile e degli argomenti tematici** tra quelli già presenti nel sito di destinazione, garantendo coerenza con la tassonomia in uso; * **generazione automatica di titolo sintetico, abstract e descrizione strutturata** a partire dall'oggetto dell'atto e dal testo estratto dal PDF allegato. La descrizione è articolata in tre punti: azione principale, eventuali acronimi e impatto per i cittadini. ## Arricchimento e leggibilità degli atti Oltre alla mappatura, il sistema migliora la qualità e la trovabilità di ogni atto importato. Il titolo viene riscritto in modo sintetico e comprensibile, partendo dall'oggetto originale dell'atto che spesso contiene sigle, abbreviazioni o linguaggio burocratico. L'abstract generato automaticamente offre ai cittadini un'anteprima chiara del contenuto senza dover aprire il PDF. La classificazione per **argomento tematico** rende ogni atto raggiungibile anche dalle altre sezioni del sito — non solo dall'Albo pretorio o dall'Amministrazione Trasparente, ma da qualsiasi pagina tematica correlata. {% hint style="info" %} Puoi verificare il risultato dell'arricchimento AI direttamente sulla scheda del documento, prima che l'atto venga reso pubblico. Se necessario, puoi modificare manualmente titolo, abstract e classificazioni. {% endhint %} I documenti importati tramite il connettore riportano automaticamente, nella pagina pubblica, il seguente avviso ai cittadini: > *Questa scheda sintetica è stata generata tramite sistemi di intelligenza artificiale per facilitare la lettura. Per i dettagli completi e il valore legale dell'atto, si rimanda al documento originale allegato.* L'avviso viene impostato dal sistema e non richiede alcun intervento da parte del redattore. ### Esempio pratico Un atto con oggetto "LIQ. LAVORO STRAORDINARIO PERSONALE DIP. 1° TRIM. 2026" viene importato con: * **titolo sintetico**: "Liquidazione lavoro straordinario al personale dipendente — 1° trimestre 2026"; * **abstract**: descrizione breve accessibile ai cittadini; * **argomenti**: classificazione automatica che collega l'atto alle sezioni tematiche del sito. --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.opencityitalia.it/manuale-opencity-italia-sito-web-istituzionale-v3/moduli-integrativi-della-piattaforma/gestire-gli-atti-e-lalbo-pretorio/integrazione-con-il-gestionale-atti.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.