> For the complete documentation index, see [llms.txt](https://docs.opencityitalia.it/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.opencityitalia.it/sito-web/moduli-integrativi-della-piattaforma/gestire-gli-atti-e-lalbo-pretorio/integrazione-con-il-gestionale-atti.md). # 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; * **normalizzazione della descrizione breve**: l'oggetto dell'atto viene uniformato applicando il sentence case — solo la prima lettera in maiuscolo — mantenendo in maiuscolo acronimi (es. CIG, IVA, ANAC), sigle di province italiane, numeri romani e nomi propri di persona o geografici. Il testo non viene troncato né parafrasato; * **generazione automatica di 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. La descrizione breve viene normalizzata a partire dall'oggetto originale dell'atto: viene applicato il sentence case (solo la prima lettera in maiuscolo), mantenendo in maiuscolo acronimi come CIG, IVA o ANAC, le sigle di province italiane, i numeri romani e i nomi propri di persona o geografici. Il testo non viene modificato nel significato né troncato. 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: * **descrizione breve**: "Liq. lavoro straordinario personale dip. 1° trim. 2026"; * **abstract**: descrizione breve accessibile ai cittadini; * **argomenti**: classificazione automatica che collega l'atto alle sezioni tematiche del sito. ### Sintesi mappatura campi Maggioli → OpenCity Italia | Campo Maggioli | Valore esempio | Campo OpenCity Italia | Valore esempio | Note | | ------------------------------------- | ------------------------------------------------ | ----------------------------------- | ----------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Categoria + Sottocategoria | `ATTI AMMINISTRATIVI / DETERMINA IN TRASPARENZA` | ✨ Tipologia di documento | `Atto amministrativo / Determinazione` | Mappatura tramite [vocabolario controllato "Documenti Albo pretorio"](https://gitlab.com/opencity-labs/docs/-/blob/Redattori_ripristinato/manuale-opencity-italia-sito-web-istituzionale-v3/modello-comuni/pubblicare-la-documentazione-del-comune/README.md). Per le **Pubblicazioni di Matrimonio**, il tipo documento viene sempre impostato a `Pubblicazione di matrimonio`. | | Anno atto + Numero atto | `2026` + `215` | Numero atto | `215/2026` | Visualizzato come stringa: "Determina n. 215 del 2026" | | Data documento / Data atto | `27/05/2026` | Data del documento | `27/05/2026` | | | Data esecutività | `27/05/2026` | Data inizio validità/efficacia | `27/05/2026` | | | Data di registro | `27/05/2026` | Data di inizio pubblicazione | `27/05/2026` | | | | | Data di rimozione dalla trasparenza | `27/05/2032` | Calcolata automaticamente: data di inizio pubblicazione + 5 anni | | Data di protocollazione | `27/05/2026` | Data di protocollazione | `27/05/2026` | | | Numero di protocollo | `3444454` | Numero di protocollo | `3444454` | | | Anno di registro + Numero di registro | `2026` + `916` | Numero registro albo | `2026/916` | | | Proponente | `Ufficio Ambiente` | ✨ Unità organizzativa responsabile | `Ufficio Ambiente` | | | Oggetto | `AFFIDAMENTO INCARICO...` | Descrizione breve | `Affidamento incarico...` | Sentence case: prima lettera maiuscola, acronimi e nomi propri mantenuti in maiuscolo, testo non modificato né troncato | | Dirigente/Firmatario | `Mario Rossi` | Dirigente/Firmatario | `Mario Rossi` | | | Allegati del gestionale | `(file PDF + P7M)` | Documenti | `(file PDF + P7M)` | I file allegati vengono importati così come sono | | | | ✨ Descrizione estesa | *(testo generato)* | L'AI legge il PDF allegato e genera la descrizione estesa | | | | ✨ Argomenti | `Lavoro`, `Economia`, `Politica` | L'AI legge il PDF allegato e assegna gli argomenti | | | | ✨ Formati disponibili | `PDF` | Rilevati automaticamente dai file allegati | | | | Licenza di distribuzione | `CC-BY 4.0` | Sempre CC-BY 4.0 per tutti gli atti importati da Maggioli | | | | Nota in calce | `"Questa scheda sintetica è stata generata..."` | Aggiunta automaticamente a tutti gli atti con descrizione generata da AI | {% hint style="info" %} I campi contrassegnati con ✨ sono generati o compilati tramite il supporto dell'intelligenza artificiale. {% endhint %} --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## 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, and the optional `goal` query parameter: ``` GET https://docs.opencityitalia.it/sito-web/moduli-integrativi-della-piattaforma/gestire-gli-atti-e-lalbo-pretorio/integrazione-con-il-gestionale-atti.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. 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.