> 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/modello-comuni/configurare-le-schede-informative-dei-servizi-forniti-dal-comune.md).
# Configurare le schede informative dei servizi forniti dal Comune
Servizio pubblico
**Servizio pubblico** è la classe che rappresenta le schede informative dei servizi erogati dall'ente ai cittadini, descrivendo in modo chiaro come accedervi, cosa serve, cosa si ottiene e in quanto tempo.
Identificatore > public\_service
| Attributo | Descrizione | Tipo di dato | Obbligatorio | Ricercabile |
| -------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------- | ------------ | ----------- |
| Tipologia del servizio (type) | Esprime la struttura di navigazione della sezione servizi | Tags (eztags) | X | X |
| Nome del Servizio (name) | Il nome del Servizio deve essere facilmente comprensibile dai cittadini. Il Servizio di raccolta differenziata si chiamerà "Raccolta differenziata". Il Servizio di iscrizione all'asilo nido si chiamerà "Iscrizione asilo nido". Vincoli: massimo 60 caratteri spazi inclusi | Linea di testo (ezstring) | X | X |
| Identificativo unico (identifier) | Codice identificativo del Servizio; deve essere univoco all'interno del Comune | Linea di testo (ezstring) | X | X |
| Altro codice identificativo (other\_service\_code) | un altro codice associato al servizio pubblico. Per esempio, nel caso di servizi di pagamento, tale proprietà potrebbe essere utilizzata per indicare il relativo codice gestionale SIOPE (Sistema informativo delle operazioni degli enti pubblici). | Linea di testo (ezstring) | | X |
| Stato del servizio (has\_service\_status) | Lo stato del servizio indica l’effettiva fruibilità del Servizio. Visibile solo se il servizio non è attivo | Tags (eztags) | X | X |
| Motivo dello stato (status\_note) | Descrizione testuale del motivo per cui un servizio non è attivo. Es. Servizio momentaneamente disattivato perché....Servizio attivo dal... | Blocco di testo (eztext) | | X |
| Titolo alternativo/Sottotitolo (alternative\_name) | Indica un sottotitolo che può avere il Servizio, oppure un nome che identifica informalmente il Servizio. Ad esempio il Servizio "Sistema Unico di Segnalazioni" potrebbe avere come sottotitolo/titolo alternativo "IoSegnalo". | Linea di testo (ezstring) | | X |
| Immagine (image) | Immagine identificativa del servizio | Relazioni oggetti (ezobjectrelationlist) | | X |
| Descrizione breve (abstract) | Indicare una sintetica descrizione del Servizio (max 160 caratteri) utilizzando un linguaggio semplice che possa aiutare qualsiasi utente a identificare con chiarezza il Servizio. Non utilizzare un linguaggio ricco di riferimenti normativi | Linea di testo (ezstring) | X | X |
| Descrizione dei destinatari (audience) | Descrizione testuale dei principali destinatari del Servizio | Blocco XML (ezxmltext) | X | X |
| Copertura geografica (has\_spatial\_coverage) | Indicare a quale area geografica viene esteso il servizio | Comuni italiani (openpacomuniitaliani) | X | X |
| Chi può fare domanda (applicants) | esempi: solo cittadini residenti da X anni, con reddito inferiore a X euro, con N figli; il genitore o il tutore del bambino; ecc... | Blocco XML (ezxmltext) | | X |
| Descrizione completa (description) | Descrizione estesa e completa del Servizio | Blocco XML (ezxmltext) | | X |
| Tipologia di procedimento (process) | I procedimenti a istanza di parte sono quelli che vengono attivati dai cittadini (es. richiesta pubblicazione matrimonio); i procedimenti avviati d'ufficio vengono attivati su iniziativa dell'Ente (es. sanzione) | Tags (eztags) | X | X |
| Parole chiave (service\_keyword) | una parola chiave o un’etichetta che descrive il servizio | Tags (eztags) | | X |
| Tema del servizio (service\_theme) | Classificazione del servizio secondo le tematiche europee | Tags (eztags) | | X |
| Lingua (has\_language) | Lingue in cui viene erogato il servizio | Tags (eztags) | X | X |
| Come si fa (how\_to) | Procedura da seguire per usufruire del servizio | Blocco XML (ezxmltext) | X | X |
| Documentazione da presentare (has\_input) | Elenco delle cose necessarie (documenti o altro) per attivare il Servizio con le relative istruzioni all'uso ed eventuale link di approfondimento | Blocco XML (ezxmltext) | X | X |
| Modulistica (has\_module\_input) | Documentazione da presentare per attivare il servizio: documenti, dichiarazioni ed eventuale modulistica che il cittadino può scaricare, compilare e trasmettere al Comune | Relazioni oggetti (ezobjectrelationlist) | | X |
| Cosa si ottiene (output) (produces\_output) | Pagina dedicata alla descrizione dell'output (es. carta d'identità, carta dei servizi, ecc) | Relazioni oggetti (ezobjectrelationlist) | X | X |
| Tempi e scadenze (has\_processing\_time\_text) | Specifica i tempi e le scadenze relative a questo servizio. In alternativa puoi compilare il campo "Giorni massimi di attesa, dalla richiesta" | Blocco di testo (eztext) | | X |
| Quando (has\_temporal\_coverage) | Indicare uno o più periodi temporali associati al servizio. Se esiste una copertura temporale specificare almeno la data di inizio dei periodi temporali. es. Dal 22 gennaio al 22 febbraio 2017 si aprono le Iscrizioni alle scuole online. | Relazioni oggetti (ezobjectrelationlist) | | X |
| Giorni massimi di attesa, dalla richiesta (has\_processing\_time) | Indicare con un numero intero i giorni di attesa massima per ottenere l'output del servizio (tempo di processamento) | Intero (ezinteger) | | X |
| Giorni medi di attesa, dalla richiesta (average\_processing\_time) | Indicare con un numero intero i giorni di attesa media per ottenere l'output del servizio (tempo medio di processamento) | Intero (ezinteger) | | X |
| Servizi richiesti (requires\_service) | collega un servizio a un altro servizio che è richiesto per espletare quello che si sta descrivendo | Relazioni oggetti (ezobjectrelationlist) | | X |
| Servizi correlati (relation\_service) | collega il servizio a un altro correlato (esempio. cambio di residenza cittadino italiano, cambio di residenza cittadino straniero potrebbero essere correlati) | Relazioni oggetti (ezobjectrelationlist) | | X |
| Costi (has\_cost) | Condizioni e termini economici per completare la procedura di richiesta del Servizio | Matrice (ezmatrix) | | X |
| Descrizione dei costi (has\_cost\_description) | Descrizione testuale delle condizioni e termini economici per completare la procedura di richiesta del Servizio | Blocco XML (ezxmltext) | | X |
| Procedure collegate all'esito (output\_notes) | Cosa fare per conoscere l'esito della procedura, e dove eventualmente ritirare l'esito (link all'ufficio, orari, numero sportello) | Blocco XML (ezxmltext) | | X |
| Canali digitali (has\_channel) | Canale/i per l'attivazione del servizio. Questo campo mette in relazione "Servizio" con il suo canale di attivazione (sito web, e-mail, telefono, ..) | Relazioni oggetti (ezobjectrelationlist) | | X |
| Istruzioni per accedere al servizio (canale fisico) (is\_physically\_available\_at\_how\_to) | Breve testo che segnala la presenza di una o più sedi per fruire il servizio. Es "Il servizio è disponibile in tutte le sedi dell'ufficio anagrafe" | Blocco di testo (eztext) | | X |
| Dove recarsi (is\_physically\_available\_at) | Sedi comunali presso le quali il servizio viene erogato. Indicare sia sportelli fisici che totem | Relazioni oggetti (ezobjectrelationlist) | X | X |
| Vincoli (conditions) | Specificare eventuali vincoli. Ad es. non è possibile rinnovare la carta identità x mesi prima della scadenza | Blocco XML (ezxmltext) | | X |
| Casi particolari (exceptions) | Inserire come testo libero, eventuali casi particolari riferiti all'ottenimento del Servizio in questione. Le persone con disabilità (legge 104) possono contattare direttamente l'ufficio e concordare una procedura di rinnovo a domicilio | Blocco XML (ezxmltext) | | X |
| Condizioni di servizio (terms\_of\_service) | | File multipli (ocmultibinary) | X | X |
| Punti di contatto (has\_online\_contact\_point) | Punti di contatto per avere informazioni | Relazioni oggetti (ezobjectrelationlist) | X | X |
| Unità organizzativa responsabile (holds\_role\_in\_time) | Ufficio responsabile dell'erogazione di questo Servizio | Relazioni oggetti (ezobjectrelationlist) | X | X |
| Documenti (has\_document) | Link alle schede documenti non funzionali al completamento del servizi, ma di semplice supporto | Relazioni oggetti (ezobjectrelationlist) | | X |
| Argomenti (topics) | Argomenti che caratterizzano il servizio; IMPORTANTE: gli argomenti accompagnano il cittadino nella navigazione del sito | Relazioni oggetti (ezobjectrelationlist) | X | X |
| Autenticazione (has\_authentication\_method) | Indicare, se previste, le modalità di autenticazione necessarie per accedere al Servizio | Tags (eztags) | | X |
| Livello di interattività (has\_interactivity\_level) | Per informazioni, vedi la guida: | Tags (eztags) | | X |
| Per prenotare (on\_line\_booking) | Se è possibile prenotare un appuntamento nel canale fisico, link al servizio di prenotazione appuntamenti del Comune | URL (ezurl) | | |
| Regolamenti, linee guida, normative (is\_compliant\_with\_rule) | insieme di regole tecniche, regolamenti, disciplinari, linee guida e qualsiasi altra procedura che il servizio pubblico deve seguire | Relazioni oggetti (ezobjectrelationlist) | | X |
| Link a siti esterni (link) | Inserire eventuali link a pagine web, siti, servizi esterni | Matrice (ezmatrix) | | X |
| Notizie e aggiornamenti (news\_and\_updates) | | Visualizzazione degli oggetti correlati inversi (openpareverserelationlist) | | |
| Life events (ife\_event) | Collega il Servizio pubblico a un evento della vita di una persona | Tags (eztags) | | X |
| Business events (business\_event) | Collega il Servizio pubblico a un evento della vita di un'impresa | Tags (eztags) | | X |
| NACE (service\_sector) | Classificazione europea delle attività economiche | Tags (eztags) | | X |
| Box d'aiuto (help) | Ulteriori informazioni sul Servizio, FAQ, eventuali riferimenti normativi ed eventuali contatti di supporto all'utente. Per esempio i riferimenti dell'URP. | Relazioni oggetti (ezobjectrelationlist) | | X |
{% hint style="info" %}
Attualmente, OpenCity Italia dispone per i Comuni che ne fanno richiesta di [un catalogo di servizi](https://docs.opencityitalia.it/admins/il-catalogo-dei-servizi-digitali/catalogo-comuni) progettati con cura secondo le [Linee guida di design dei servizi digitali per la PA](https://docs.italia.it/italia/design/lg-design-servizi-web/it/versione-corrente/index.html) e il [CAD (Codice dell'Amministrazione Digitale)](https://www.normattiva.it/uri-res/N2Ls?urn:nir:stato:decreto.legislativo:2005-03-07;82).
{% endhint %}
## Vai alla sezione "Servizi"
Per creare un Servizio pubblico collocati nella sezione "Servizi" e procedi alla [creazione del contenuto](/sito-web/la-piattaforma/funzioni-generali-di-gestione-dei-contenuti/creare-un-nuovo-contenuto.md).
Seleziona la tipologia di servizio dal menù ad albero.
Specifica poi il nome del servizio (max. 60 caratteri) e il suo codice identificativo
{% hint style="warning" %}
Puoi aggiungere al massimo 1 immagine di copertina. Se tenti di inserirne più di una, la piattaforma mostra un messaggio di errore e non ti permette di proseguire.
{% endhint %}
## Indica lo stato del servizio
Devi specificare se il servizio è attivo, disattivato o in fase di sviluppo.
Nel caso in cui il servizio non sia disponibile per i cittadini ("In fase di sviluppo" o "Servizio non attivo"), devi indicarne il motivo ("Motivo dello stato")
{% hint style="warning" %}
Quando il servizio è impostato come "Servizio non attivo" o è fuori dalla finestra di programmazione, i cittadini che tentano di accedervi visualizzano una pagina informativa con il motivo dell'indisponibilità e i link per tornare alla scheda del servizio o alla lista dei servizi.
{% endhint %}
Aggiungi la descrizione breve del contenuto (max. 160 caratteri) e specifica se si tratta di un procedimento ad iniziativa privata (attivato dai cittadino) o ad istanza d'ufficio (es. sanzioni).
Specifica la lingua in cui viene erogato il servizio.
## Descrivi i destinatari
Indica i gruppi di utenti che possono fare richiesta del servizio.
## Indica la collocazione geografica
Specifica la copertura geografica del servizio. Questo campo abilita la visualizzazione a mappa nella sezione "Servizi".
## Esponi la procedura
Spiega come deve fare un cittadino per richiedere l'attivazione del servizio.
## Descrivi cosa bisogna presentare
Elenca le cose necessarie per l'attivazione del servizio. Puoi anche [creare una relazione](/sito-web/la-piattaforma/funzioni-generali-di-gestione-dei-contenuti/creare-relazioni-tra-contenuti.md) tra il Servizio pubblico e un [Documento](/sito-web/modello-comuni/pubblicare-la-documentazione-del-comune.md) nel campo "Modulistica"
## Spiega che cosa ottiene il cittadino
[Crea una relazione](/sito-web/la-piattaforma/funzioni-generali-di-gestione-dei-contenuti/creare-relazioni-tra-contenuti.md) tra il contenuto e un Output del servizio per descrivere che cosa ottiene il cittadino attivando il servizio.
Output del servizio
**Output del servizio** è una classe di supporto che descrive il risultato concreto che il cittadino ottiene in seguito all'attivazione di un servizio pubblico, ad esempio un permesso, un'attestazione, un'iscrizione o un documento rilasciato dall'ente.
Identificatore > output
| Attributo | Descrizione | Tipo di dato | Obbligatorio | Ricercabile |
| ------------------------------------------------------------- | ---------------------------------------------- | ---------------------------------------- | ------------ | ----------- |
| Nome (name) | | Linea di testo (ezstring) | X | X |
| Nome breve (short\_name) | | Linea di testo (ezstring) | | X |
| Abstract (Descrizione breve) (abstract) | | Blocco XML (ezxmltext) | | X |
| Descrizione (description) | | Blocco XML (ezxmltext) | | X |
| Immagini (image) | Immagini rappresentative dell'output | Relazioni oggetti (ezobjectrelationlist) | | X |
| Tipologia di output/esito (has\_service\_input\_output\_type) | | Tags (eztags) | X | X |
| Argomento (topics) | | Relazioni oggetti (ezobjectrelationlist) | | X |
| File di esempio (files) | Files rappresentative dell'output (fac-simile) | File multipli (ocmultibinary) | | X |
## Specifica tempi e scadenze
{% hint style="warning" %}
Per pubblicare la scheda del servizio, almeno un campo tra "Tempi e scadenze" e "Giorni massimi di attesa" deve essere compilato
{% endhint %}
Definisci i tempi e le scadenze del servizio o i giorni massimi di attesa per l'ottenimento dell'output del servizio.
## Indica gli importi da pagare
Nel caso in cui il servizio preveda il pagamento di un importo indica il tipo di spesa e l'importo che i cittadini devono affrontare cliccando su "Aggiungi riga" e compilando i campi richiesti.
## Specifica i canali di attivazione
[Crea una relazione](/sito-web/la-piattaforma/funzioni-generali-di-gestione-dei-contenuti/creare-relazioni-tra-contenuti.md) tra il contenuto e un Canale di erogazione del servizio per mettere in relazione il servizio pubblico con il suo canale di attivazione.
### Creare un canale di attivazione
{% hint style="info" %}
Puoi utilizzare questo sistema per creare un [canale di prenotazione appuntamento](/sito-web/modello-comuni/configurare-le-schede-informative-dei-servizi-forniti-dal-comune/attivare-il-canale-di-prenotazione-appuntamento.md) da associare alla scheda informativa del servizio
{% endhint %}
Nel caso in cui il Comune faccia uso di gestionali o servizi pubblicati su siti esterni, crea un nuovo canale di erogazione cliccando su "Crea canale di erogazione del servizio".
Dopo aver aggiunto il nome ("Funzione del canale") e la descrizione breve, incolla la URL al servizio esterno nel campo "Valore del canale"
Canale di erogazione del servizio
**Canale di erogazione del servizio** è una classe di supporto che descrive le modalità attraverso cui il cittadino può accedere e attivare un servizio pubblico, sia in presenza che online.
Identificatore > channel
| Attributo | Descrizione | Tipo di dato | Obbligatorio | Ricercabile |
| ------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------- | ------------ | ----------- |
| Funzione del canale (object) | Ad esempio (download App Android, download App iOS, prenotazione appuntamento, pagamento online, contatto telefonico, ...) | Linea di testo (ezstring) | X | X |
| Tipo di canale di erogazione (has\_channel\_type) | | Tags (eztags) | | X |
| Descrizione breve (abstract) | Indicare una sintetica descrizione del canale di erogazione (max 160 caratteri) utilizzando un linguaggio semplice che possa aiutare l'utente. Non utilizzare un linguaggio ricco di riferimenti normativi. | Blocco XML (ezxmltext) | X | X |
| Descrizione (description) | Descrizione generica del canale ed eventuali condizioni particolari di pagamento | Blocco XML (ezxmltext) | | X |
| Valore del canale (url) (channel\_url) | Nel caso si tratti di un indirizzo web | URL (ezurl) | X | |
| Valore del canale (channel) | Ad esempio indirizzo email, numero di telefono | Linea di testo (ezstring) | | X |
| Costo (has\_cost) | | Matrice (ezmatrix) | | X |
| Condizioni di accesso (has\_access\_condition) | | Relazioni oggetti (ezobjectrelationlist) | | X |
| Immagini (image) | Immagini rappresentative del canale | Relazioni oggetti (ezobjectrelationlist) | | X |
| Files (files) | Files rappresentative del canale (fac-simile) | File multipli (ocmultibinary) | | X |
## Allega le condizioni del servizio
Clicca su "Aggiungi file" per allegare le condizioni di servizio. Le funzioni sono le stesse di quelle presenti per il [Documento](/sito-web/modello-comuni/pubblicare-la-documentazione-del-comune.md#caricare-piu-file-allegati).
## Indica i punti di contatto e l'ufficio responsabile
Punto di contatto
**Punto di contatto** è una classe di supporto che raccoglie le informazioni di contatto di un ufficio o di una persona, riutilizzabile su più contenuti del sito. Raggruppa un insieme di tipi di canali digitali, come email, social network, siti web, ecc.
Identificatore > online\_contact\_point
| Attributo | Descrizione | Tipo di dato | Obbligatorio | Ricercabile |
| ------------------------------------------------------------- | ----------------------------------------------------------------------- | --------------------------------------------------------------------------- | ------------ | ----------- |
| Nome del punto di contatto (name) | Es.: "Contatti Ufficio Anagrafe" | Linea di testo (ezstring) | X | X |
| Contatti (contact) | Specificare tutti i contatti | Matrice (ezmatrix) | X | X |
| Note (note) | | Blocco di testo (eztext) | | X |
| Orari di disponibilità telefonica (phone\_availability\_time) | | Relazioni oggetti (ezobjectrelationlist) | | X |
| Strutture collegate (is\_contact\_point\_of\_organizations) | Strutture (uffici, aree, organizzazioni) collegate al Punto di contatto | Visualizzazione degli oggetti correlati inversi (openpareverserelationlist) | | |
| Persone (is\_contact\_point\_of\_people) | Persone collegate al Punto di contatto | Visualizzazione degli oggetti correlati inversi (openpareverserelationlist) | | |
[Crea due relazioni](/sito-web/la-piattaforma/funzioni-generali-di-gestione-dei-contenuti/creare-relazioni-tra-contenuti.md) tra il contenuto, un Punto di contatto e un'[Unità organizzativa](/sito-web/modello-comuni/gestire-lorganigramma-del-comune.md) per specificare i contatti a disposizione dei cittadini e l'ufficio responsabile del servizio
## Pubblica il contenuto
Dopo aver compilato i campi richiesti, [pubblica il contenuto](https://app.gitbook.com/o/-MRQtav6dxPB0RkAwAX7/s/fYDGLbEkTaK5gywjDOEN/~/changes/14/funzioni-generali/pubblicare-un-contenuto) sul sito web.
---
# 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/modello-comuni/configurare-le-schede-informative-dei-servizi-forniti-dal-comune.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.