> 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/sviluppatori-e-partner-tecnologici/integrazioni.md). # Integrazioni - [Integrazione Widget servizio (FormIO)](https://docs.opencityitalia.it/sviluppatori-e-partner-tecnologici/integrazioni/integrazione-widget-servizio-formio.md): Widget Formio – Servizio permette di integrare i form registrati all’interno del portale servizi del Comune. Di seguito la guida all’installazione e configurazione. - [Integrazioni con il flusso delle pratiche](https://docs.opencityitalia.it/sviluppatori-e-partner-tecnologici/integrazioni/integrazioni-con-il-flusso-delle-pratiche.md) - [API ReST](https://docs.opencityitalia.it/sviluppatori-e-partner-tecnologici/integrazioni/integrazioni-con-il-flusso-delle-pratiche/api-rest.md) - [Webhooks](https://docs.opencityitalia.it/sviluppatori-e-partner-tecnologici/integrazioni/integrazioni-con-il-flusso-delle-pratiche/webhooks.md): Sono un meccanismo di comunicazione tra sistemi che consentono una comunicazione in tempo reale tra due API - [Utilizzare le API delle pratiche per inviare messaggi](https://docs.opencityitalia.it/sviluppatori-e-partner-tecnologici/integrazioni/integrazioni-con-il-flusso-delle-pratiche/utilizzare-le-api-delle-pratiche-per-inviare-messaggi.md): In questa pagina discuteremo di un caso d'uso che può utilizzare entrambi le integrazioni. - [Modello di integrazione con l'area personale](https://docs.opencityitalia.it/sviluppatori-e-partner-tecnologici/integrazioni/modello-di-integrazione-con-larea-personale.md): Questo documento descrive gli aspetti tecnici dell'importazione delle Pratiche Lite, uno strumento che permette di integrare le pratiche provenienti da altri gestionali. - [Integrazione con Intermediari di pagamento PagoPA](https://docs.opencityitalia.it/sviluppatori-e-partner-tecnologici/integrazioni/integrazione-con-intermediari-di-pagamento-pagopa.md) - [Requisiti per l'integrazione](https://docs.opencityitalia.it/sviluppatori-e-partner-tecnologici/integrazioni/integrazione-con-intermediari-di-pagamento-pagopa/requisiti-per-lintegrazione.md) - [Il Pagamento](https://docs.opencityitalia.it/sviluppatori-e-partner-tecnologici/integrazioni/integrazione-con-intermediari-di-pagamento-pagopa/il-pagamento.md): In questa sezione viene descritto in dettaglio il json del pagamento e la definizione dettagliata dei campi - [Versione 1.0](https://docs.opencityitalia.it/sviluppatori-e-partner-tecnologici/integrazioni/integrazione-con-intermediari-di-pagamento-pagopa/il-pagamento/versione-1.0.md) - [Versione 2.0](https://docs.opencityitalia.it/sviluppatori-e-partner-tecnologici/integrazioni/integrazione-con-intermediari-di-pagamento-pagopa/il-pagamento/versione-2.0.md) - [Schema di Funzionamento](https://docs.opencityitalia.it/sviluppatori-e-partner-tecnologici/integrazioni/integrazione-con-intermediari-di-pagamento-pagopa/schema-di-funzionamento.md): Panoramica dei ciclo di funzionamento dei pagamenti di Opencity Italia - Area Personale. - [Configurazione dei pagamenti](https://docs.opencityitalia.it/sviluppatori-e-partner-tecnologici/integrazioni/integrazione-con-intermediari-di-pagamento-pagopa/configurazione-tenant-e-servizi.md) - [API v1 (deprecate)](https://docs.opencityitalia.it/sviluppatori-e-partner-tecnologici/integrazioni/integrazione-con-intermediari-di-pagamento-pagopa/configurazione-tenant-e-servizi/api-v1.md) - [Accesso tramite Payments API](https://docs.opencityitalia.it/sviluppatori-e-partner-tecnologici/integrazioni/integrazione-con-intermediari-di-pagamento-pagopa/configurazione-tenant-e-servizi/accesso-tramite-payments-api.md) - [API v2](https://docs.opencityitalia.it/sviluppatori-e-partner-tecnologici/integrazioni/integrazione-con-intermediari-di-pagamento-pagopa/configurazione-tenant-e-servizi/api-v2.md) - [Un pagamento in dettaglio](https://docs.opencityitalia.it/sviluppatori-e-partner-tecnologici/integrazioni/integrazione-con-intermediari-di-pagamento-pagopa/un-pagamento-in-dettaglio.md): Descrizione dettagliata di tutti i passaggi che portano alla creazione e alla chiusura di un pagamento a partire da una pratica. - [Gli stati di un pagamento](https://docs.opencityitalia.it/sviluppatori-e-partner-tecnologici/integrazioni/integrazione-con-intermediari-di-pagamento-pagopa/gli-stati-di-un-pagamento.md): Dettaglio degli stati che attraversa un pagamento nel suo ciclo di vita - [Processo di sviluppo](https://docs.opencityitalia.it/sviluppatori-e-partner-tecnologici/integrazioni/integrazione-con-intermediari-di-pagamento-pagopa/processo-di-sviluppo.md) - [Implementazione di un proxy](https://docs.opencityitalia.it/sviluppatori-e-partner-tecnologici/integrazioni/integrazione-con-intermediari-di-pagamento-pagopa/implementazione-di-un-proxy.md): Molti aspetti implementativi dipendono più dalla normativa che da nostre scelte progettuali, in questa pagina si evidenziano gli uni e le altre. - [Cambio certificati SSL](https://docs.opencityitalia.it/sviluppatori-e-partner-tecnologici/integrazioni/integrazione-con-intermediari-di-pagamento-pagopa/cambio-certificati-ssl.md) - [Integrazione con Protocollo Informatico](https://docs.opencityitalia.it/sviluppatori-e-partner-tecnologici/integrazioni/integrazione-con-protocollo-informatico.md) - [Requisiti per l'integrazione](https://docs.opencityitalia.it/sviluppatori-e-partner-tecnologici/integrazioni/integrazione-con-protocollo-informatico/requisiti-per-lintegrazione.md) - [Excursus Generale](https://docs.opencityitalia.it/sviluppatori-e-partner-tecnologici/integrazioni/integrazione-con-protocollo-informatico/excursus-generale.md) - [Documento digitale](https://docs.opencityitalia.it/sviluppatori-e-partner-tecnologici/integrazioni/integrazione-con-protocollo-informatico/documento-digitale.md): Descrizione in dettaglio di un documento generato dalla piattaforma - [Esempio documento con allegati non protocollato](https://docs.opencityitalia.it/sviluppatori-e-partner-tecnologici/integrazioni/integrazione-con-protocollo-informatico/documento-digitale/esempio-documento-con-allegati-non-protocollato.md) - [Esempio documento con allegati protocollato](https://docs.opencityitalia.it/sviluppatori-e-partner-tecnologici/integrazioni/integrazione-con-protocollo-informatico/documento-digitale/esempio-documento-con-allegati-protocollato.md) - [Esempio documento con campo retry\_meta prodotto dal protocol proxy](https://docs.opencityitalia.it/sviluppatori-e-partner-tecnologici/integrazioni/integrazione-con-protocollo-informatico/documento-digitale/esempio-documento-con-campo-retry_meta-prodotto-dal-protocol-proxy.md): Il campo "retry\_meta" è stato creato dal protocol proxy e contiene il topic di origine ed eventuali campi utili al protocol proxy per tenere lo stato della protocollazione - [Esempio documento con campo retry\_meta modificato dal sistema di retry](https://docs.opencityitalia.it/sviluppatori-e-partner-tecnologici/integrazioni/integrazione-con-protocollo-informatico/documento-digitale/esempio-documento-con-campo-retry_meta-modificato-dal-sistema-di-retry.md): Il campo "retry\_meta" contiente le informazioni inserite dal sistema di retry. Queste dovrebbero essere ignorate da protocol proxy - [Usecase: Il Documento originato dalle pratiche dai servizi digitali](https://docs.opencityitalia.it/sviluppatori-e-partner-tecnologici/integrazioni/integrazione-con-protocollo-informatico/documento-digitale/usecase-il-documento-originato-dalle-pratiche-dai-servizi-digitali.md) - [Stati del documento](https://docs.opencityitalia.it/sviluppatori-e-partner-tecnologici/integrazioni/integrazione-con-protocollo-informatico/documento-digitale/stati-del-documento.md) - [Architettura del sistema di protocollazione](https://docs.opencityitalia.it/sviluppatori-e-partner-tecnologici/integrazioni/integrazione-con-protocollo-informatico/architettura-del-sistema-di-protocollazione.md): Questa pagina descrive l'architettura impiegata per attuare il processo di protocollazione di una pratica - [WorkFlow sistema di protocollazione](https://docs.opencityitalia.it/sviluppatori-e-partner-tecnologici/integrazioni/integrazione-con-protocollo-informatico/workflow-sistema-di-protocollazione.md) - [Configurazione tenant e servizi](https://docs.opencityitalia.it/sviluppatori-e-partner-tecnologici/integrazioni/integrazione-con-protocollo-informatico/workflow-sistema-di-protocollazione/configurazione-tenant-e-servizi.md) - [Protocol Proxy: Specifiche Implementative](https://docs.opencityitalia.it/sviluppatori-e-partner-tecnologici/integrazioni/integrazione-con-protocollo-informatico/protocol-proxy-specifiche-implementative.md) - [Processo di sviluppo](https://docs.opencityitalia.it/sviluppatori-e-partner-tecnologici/integrazioni/integrazione-con-protocollo-informatico/processo-di-sviluppo.md) - [Integrazione con PDND](https://docs.opencityitalia.it/sviluppatori-e-partner-tecnologici/integrazioni/integrazione-con-pdnd.md) - [Introduzione](https://docs.opencityitalia.it/sviluppatori-e-partner-tecnologici/integrazioni/integrazione-con-pdnd/introduzione.md) - [Integrazione tecnica tra OpenCity, PDND Connector e PDND](https://docs.opencityitalia.it/sviluppatori-e-partner-tecnologici/integrazioni/integrazione-con-pdnd/integrazione-tecnica-tra-opencity-pdnd-connector-e-pdnd.md) - [Definizione API PDND Connector](https://docs.opencityitalia.it/sviluppatori-e-partner-tecnologici/integrazioni/integrazione-con-pdnd/definizione-api-pdnd-connector.md) - [Integrazioni con il Sito Istituzionale](https://docs.opencityitalia.it/sviluppatori-e-partner-tecnologici/integrazioni/integrazioni-con-il-sito-istituzionale.md): I widget dell'area personale sono una serie di componenti js/html/css che sono inseribili in una qualunque pagina web. In particolare alcuni di questi sono servizi built-in che i comuni devono offrire - [Single Sign-On](https://docs.opencityitalia.it/sviluppatori-e-partner-tecnologici/integrazioni/single-sign-on.md): Per SSO si intende la possibilità per il cittadino di fare login sull'area personale o su un servizio digitale e non dovrelo ripetere se si sposta su un altro servizio digitale dello stesso Ente. - [SSO mediante oAuth2](https://docs.opencityitalia.it/sviluppatori-e-partner-tecnologici/integrazioni/single-sign-on/sso-mediante-oauth2.md): Opencity Italia integra l'autenticazione Spid/CIE mediante il componente dedicato OpenLogin, dialogando con esso con protocollo oAuth2. Lo stesso componente può essere usato da altri applicativi. - [SSO mediante JWT](https://docs.opencityitalia.it/sviluppatori-e-partner-tecnologici/integrazioni/single-sign-on/sso-mediante-jwt.md): La piattaforma Opencity Italia supporta questa possibilità mediante una tecnica che permette di convertire una sessione basata su cookie in un token JWT. - [SSO con App IO](https://docs.opencityitalia.it/sviluppatori-e-partner-tecnologici/integrazioni/single-sign-on/sso-con-app-io.md): io-sso è l'identity broker tra App IO e la Stanza del Cittadino che consente ai cittadini di accedere ai documenti direttamente da un messaggio App IO, senza dover effettuare un login manuale. - [Processi asincroni (job)](https://docs.opencityitalia.it/sviluppatori-e-partner-tecnologici/integrazioni/processi-asincroni-job.md): In questa pagina viene fatta una breve descrizione delle API per la gestione dei Jobs (processi asincroni) - [Importazione dovuti](https://docs.opencityitalia.it/sviluppatori-e-partner-tecnologici/integrazioni/processi-asincroni-job/importazione-dovuti.md): In questa pagina viene fornito un esempio di chiamata API per l'importazione dovuti - [Integrazione di un servizio di terze parti protetto da autenticazione](https://docs.opencityitalia.it/sviluppatori-e-partner-tecnologici/integrazioni/integrazione-di-un-servizio-di-terze-parti-protetto-da-autenticazione.md): In questa sezione viene descritta la modalità di integrazione con un servizio di terze parti protetto da autenticazione tramite il token JWT dell'utente. - [Esempio con GovWay](https://docs.opencityitalia.it/sviluppatori-e-partner-tecnologici/integrazioni/integrazione-di-un-servizio-di-terze-parti-protetto-da-autenticazione/esempio-con-govway.md): Esempio dettagliato di una integrazione di un modulo di Opencity Italia che attinge a una API protetta mediante l'API gateway opensource GovWay di Link.it - [Integrazione dei calendari con un servizio di terze parti](https://docs.opencityitalia.it/sviluppatori-e-partner-tecnologici/integrazioni/integrazione-dei-calendari-con-un-servizio-di-terze-parti.md): La presente documentazione descrive come integrare sistemi esterni (ad esempio IVR o sistemi di gestione code) con le API dei calendari di OpenCity Italia - [Importazioni massive](https://docs.opencityitalia.it/sviluppatori-e-partner-tecnologici/integrazioni/importazioni-massive.md) - [Importazione massiva pagamenti](https://docs.opencityitalia.it/sviluppatori-e-partner-tecnologici/integrazioni/importazioni-massive/importazione-massiva-pagamenti.md) --- # 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: ``` GET https://docs.opencityitalia.it/sviluppatori-e-partner-tecnologici/integrazioni.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.