> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agencyhandy.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Personalizza Portali Cliente, Controlli di Accesso e Aliquote Fiscali
> Personalizza le pagine di accesso e registrazione dei clienti, controlla la visibilità della barra laterale per ruolo e configura le aliquote fiscali per fatture e pagamenti in AgencyHandy.
AgencyHandy ti offre un controllo approfondito su ciò che i tuoi clienti vedono e vivono — dalla prima pagina su cui atterrano al momento dell'accesso, alle sezioni della piattaforma a cui possono navigare dopo il login. Questa pagina copre quattro aree di configurazione interconnesse: il **Portale di Accesso**, il **Portale di Registrazione**, i controlli **Barra Laterale e Accesso**, e le **Aliquote Fiscali**. Insieme, queste impostazioni ti permettono di creare un'esperienza curata e adeguata al ruolo per ogni utente nel tuo workspace.
Tutte le impostazioni di questa pagina richiedono accesso da **Super Amministratore** o **Amministratore**. Vai su **Configurazione Workspace** nella barra laterale sinistra per accedere a ciascuna sezione.
***
## Portale di Accesso
Il Portale di Accesso è la pagina di login che i tuoi clienti e i membri del team vedono quando accedono al tuo workspace AgencyHandy. Personalizzarlo garantisce che la prima impressione che i clienti hanno sia completamente in linea con il tuo brand — completa di immagini, titoli e messaggi della tua agenzia.
### Cosa Puoi Personalizzare
| Elemento | Descrizione | Limite |
| --------------- | --------------------------------------------------------------- | ------------------------- |
| **Titolo** | Il titolo principale visualizzato in cima alla pagina di login | Massimo 120 caratteri |
| **Immagine** | Una foto o illustrazione con il tuo brand mostrata nella pagina | PNG, JPG, JPEG — max 5 MB |
| **Sottotitolo** | Un breve messaggio sotto i campi di login | Massimo 300 caratteri |
### Passaggi per Personalizzare il Portale di Accesso
Vai su **Configurazione Workspace** nella navigazione sinistra, poi seleziona **Portale di Accesso** dal sottomenu.
Digita il titolo desiderato nel campo **Titolo**. Mantienilo conciso e pertinente — ad esempio, *"Bentornato su \[Nome Agenzia]"* o *"Il Tuo Portale Cliente."* La lunghezza massima è di 120 caratteri.
Clicca sull'area di caricamento o trascina e rilascia un file immagine (PNG, JPG o JPEG, massimo 5 MB) per aggiungere un elemento visivo alla pagina di accesso. Questa immagine appare tipicamente accanto al modulo di login.
Usa un'immagine di alta qualità che rappresenti la tua agenzia — una foto del tuo team, un'illustrazione del brand pulita o uno sfondo professionale. Assicurati che la dimensione del file sia inferiore a 5 MB per evitare errori di caricamento.
Nel campo **Sottotitolo**, scrivi un breve messaggio da visualizzare sotto i campi di login — ad esempio, un messaggio di benvenuto, un contatto di supporto o un breve slogan. Mantienilo sotto i 300 caratteri.
Esamina il layout della pagina di accesso usando l'anteprima. Una volta soddisfatto, clicca su **Salva** (o **Aggiorna**) per applicare le modifiche. Le modifiche hanno effetto immediato.
### Ripristino delle Impostazioni Predefinite
Clicca su **Ripristina Impostazioni Predefinite** nella pagina del Portale di Accesso per rimuovere tutte le personalizzazioni e ripristinare la pagina di accesso originale di AgencyHandy.
Il ripristino delle impostazioni predefinite è irreversibile. Tutti i titoli, le immagini e i sottotitoli personalizzati verranno rimossi definitivamente. Clicca su **Annulla** se non sei sicuro — le modifiche non salvate vengono scartate e le impostazioni salvate correnti rimangono intatte.
### Buone Pratiche
* Mantieni il titolo breve e accogliente — i clienti lo vedono prima di accedere, quindi fallo essere rassicurante.
* Usa un'immagine professionale che rappresenti la tua agenzia. Evita foto stock generiche che risultano disconnesse dal tuo brand.
* Visualizza in anteprima su diverse dimensioni di schermo prima di salvare per assicurarti che il layout di immagine e testo sia corretto.
* Se l'immagine non viene caricata, verifica che soddisfi i requisiti di formato (PNG, JPG, JPEG) e dimensione (meno di 5 MB).
## Portale di Registrazione
Il Portale di Registrazione è la pagina di iscrizione su cui atterrano i nuovi clienti quando creano un account nel tuo workspace. Personalizzarlo crea un'esperienza di brand coerente fin dalla primissima interazione che un potenziale cliente ha con la piattaforma della tua agenzia.
### Cosa Puoi Personalizzare
| Elemento | Descrizione | Limite |
| --------------- | ---------------------------------------------------------------------- | ------------------------- |
| **Titolo** | Il titolo principale visualizzato in cima alla pagina di registrazione | Massimo 120 caratteri |
| **Immagine** | Una foto o illustrazione con il tuo brand mostrata nella pagina | PNG, JPG, JPEG — max 5 MB |
| **Sottotitolo** | Un breve messaggio sotto i campi di registrazione | Massimo 300 caratteri |
### Passaggi per Personalizzare il Portale di Registrazione
Vai su **Configurazione Workspace** nella navigazione sinistra, poi seleziona **Portale di Registrazione** dal sottomenu.
Digita un titolo nel campo **Titolo** che dia il benvenuto ai nuovi clienti. Ad esempio, *"Inizia con \[Nome Agenzia]"* o *"Crea il tuo account cliente."* Massimo 120 caratteri.
Clicca sull'area di caricamento o trascina e rilascia un file immagine (PNG, JPG o JPEG, massimo 5 MB). Questa immagine viene visualizzata nella pagina di registrazione accanto al modulo di iscrizione.
Usa lo stesso stile visivo e la stessa palette di colori sia per il Portale di Accesso che per le immagini del portale di Registrazione, per creare un'esperienza coerente tra le due pagine.
Scrivi un breve messaggio di supporto nel campo **Sottotitolo** — ad esempio, istruzioni su cosa aspettarsi dopo la registrazione o una breve proposta di valore. Massimo 300 caratteri.
Esamina la pagina di registrazione usando l'opzione di anteprima. Clicca su **Salva** (o **Aggiorna**) per applicare le modifiche immediatamente.
### Ripristino delle Impostazioni Predefinite
Clicca su **Ripristina Impostazioni Predefinite** nella pagina del Portale di Registrazione per rimuovere tutte le personalizzazioni e ripristinare la pagina di registrazione originale di AgencyHandy.
Questa azione non può essere annullata. Tutte le configurazioni personalizzate di titolo, immagine e sottotitolo verranno cancellate definitivamente.
### Buone Pratiche
* Abbina il tono del titolo di registrazione al tuo stile generale di comunicazione con i clienti — professionale, amichevole o entrambi.
* Mantieni il sottotitolo focalizzato: informa i nuovi clienti di cosa succede dopo la registrazione (es. *"Una volta registrato, il nostro team ti invierà un'email di benvenuto entro 24 ore."*).
* Testa il flusso di registrazione da solo dopo aver salvato le modifiche per confermare che la pagina appaia e si comporti come previsto.
## Controlli Barra Laterale e Accesso
Le impostazioni Barra Laterale e Accesso ti permettono di controllare esattamente cosa può vedere ogni ruolo utente nel menu di navigazione sinistra. Puoi rinominare le voci del menu per adattarle alla terminologia della tua agenzia, sostituire le icone predefinite con icone personalizzate e attivare/disattivare la visibilità di qualsiasi sezione del menu per ruolo. Il risultato è un'interfaccia più pulita e mirata per ogni persona che effettua l'accesso.
### Ruoli Configurabili
* Cliente
* Super Amministratore
* Amministratore
* Manager
* Assegnatario
* Personalizzato (tutti i ruoli personalizzati creati in Ruoli e Permessi)
### Passaggi per Personalizzare le Voci del Menu Barra Laterale
Vai su **Configurazione Workspace**, poi seleziona **Barra Laterale e Accesso** dal menu delle impostazioni.
Clicca sul pulsante **Personalizza** in cima al pannello. L'elenco completo delle voci del menu della barra laterale corrente appare sotto la categoria **Principale**.
Clicca sul campo di testo di qualsiasi voce del menu e digita la nuova etichetta. Ad esempio, rinomina "Dashboard" in "Panoramica" o "CRM" in "Contatti." Clicca su **Salva** per applicare il nuovo nome.
Clicca sull'icona accanto al nome di una voce del menu. Si apre un popup con una serie di opzioni di icone — seleziona una dalla libreria o carica un'immagine personalizzata 32×32 px per usare la tua icona con il brand. Clicca su **Salva** per applicare.
### Passaggi per Configurare la Visibilità Basata su Ruolo
Clicca sul pulsante **Modifica Accesso** (accanto al pulsante **Personalizza**). Vedrai schede per ogni ruolo disponibile.
Clicca sulla scheda del ruolo che vuoi configurare — ad esempio, **Cliente**.
Per ogni voce del menu elencata, usa il toggle per mostrarla o nasconderla per il ruolo selezionato. Ad esempio, potresti nascondere **Fatture** e **Abbonamenti** ai Clienti mantenendoli visibili per Amministratori e Manager.
Clicca su **Salva**. Le impostazioni di visibilità aggiornate hanno effetto immediato — gli utenti vedono le modifiche alla prossima navigazione della pagina o dopo aver effettuato nuovamente l'accesso.
Clicca su **Ripristina Predefiniti** sulla scheda di qualsiasi ruolo per ripristinare le impostazioni di visibilità originali per quel ruolo.
Una barra laterale pulita e minimale migliora l'esperienza del cliente. Mostrare ai clienti solo ciò di cui hanno bisogno — come **Dashboard**, **Ordini** e **Messaggi** — riduce la confusione e impedisce loro di imbattersi in sezioni solo per uso interno.
### Esempi di Configurazione per Ruolo
| Ruolo | Sezioni Visibili Raccomandate |
| -------------------- | ---------------------------------------------------- |
| Cliente | Dashboard, Ordini, Messaggi, Fatture (se necessario) |
| Manager | CRM, Progetti, Timesheet, Task |
| Assegnatario | Dashboard, Task, Progetti, Messaggi |
| Super Amministratore | Tutte le sezioni (nessuna restrizione) |
### Note Importanti
* **Le modifiche sono immediate:** Gli aggiornamenti di visibilità per ruolo si riflettono immediatamente dopo che gli utenti aggiornano la pagina o effettuano nuovamente l'accesso.
* **Il ruolo più permissivo prevale:** Se un utente detiene più ruoli, il ruolo con l'accesso più ampio ha la precedenza.
* **Icone personalizzate:** Carica immagini 32×32 px per abbinare gli elementi visivi del brand della tua agenzia nella barra laterale.
* **Coerenza nella denominazione:** Usa convenzioni di denominazione chiare e coerenti che tutto il team capisce — evita abbreviazioni o gergo interno che i nuovi membri del team non riconoscerebbero.
## Aliquote Fiscali
La funzionalità Aliquote Fiscali ti consente di creare, gestire e applicare configurazioni fiscali su servizi, abbonamenti e fatture. Puoi impostare più tipologie di imposta — IVA, GST, Imposta sulle Vendite e altre — con aliquote specifiche per paese e stato, supporto per modelli di prezzo inclusivi ed esclusivi, e applicazione automatica al pagamento in base alla posizione del cliente.
Solo i **Super Amministratori** e gli **Amministratori** possono creare, modificare o eliminare configurazioni fiscali.
### Concetti Fiscali in Sintesi
| Concetto | Definizione |
| ------------------ | ------------------------------------------------------------------------------------------------ |
| **Esclusivo** | L'imposta viene aggiunta al prezzo elencato al pagamento (es. €100 + 10% imposta = €110 totale) |
| **Inclusivo** | L'imposta è già inclusa nel prezzo mostrato al cliente (es. €110 totale comprende già l'imposta) |
| **Codice Fiscale** | Il numero di identificazione fiscale della tua agenzia, mostrato sulle fatture |
### Passaggio 1: Crea un'Aliquota Fiscale
Vai su **Configurazione Workspace**, poi clicca sulla scheda **Aliquote Fiscali**.
Clicca sul pulsante **+ Nuova Imposta**. Appare un modulo.
Completa i seguenti campi:
* **Titolo / Tipo di Imposta** *(obbligatorio)*: Inserisci un nome descrittivo, es. IVA Standard, GST Ridotta o Imposta sulle Vendite US. Massimo 255 caratteri.
* **Codice Fiscale** *(opzionale)*: Il numero di identificazione fiscale della tua agenzia. Massimo 20 caratteri.
* **Paese di Origine**: Seleziona il paese principale a cui si applica questa imposta.
* **Aliquota Fiscale Generale Paese di Origine %** *(opzionale)*: L'aliquota predefinita per il tuo paese di origine.
* **Aliquote Specifiche per Paese** *(opzionale)*: Aggiungi aliquote per paese con stato, CAP e percentuale opzionali. Utile per agenzie che servono clienti in più giurisdizioni fiscali.
Attiva il toggle dell'imposta su **Attiva** per renderla immediatamente disponibile per l'uso in servizi e fatture. Imposta su **Inattiva** per salvare la configurazione senza applicarla ai nuovi acquisti.
Clicca su **Salva**. L'imposta appare nel tuo elenco Aliquote Fiscali ed è ora disponibile per essere collegata ai servizi.
Puoi supportare fino a 4 cifre decimali nelle percentuali delle aliquote fiscali. Un'aliquota fiscale dello 0% è valida — usala per articoli a zero tassazione o scenari di conformità in cui l'imposta deve essere elencata ma ammonta a zero.
### Passaggio 2: Collega le Imposte ai Servizi
Vai su **Servizi** e crea un nuovo servizio o modifica uno esistente.
Procedi al Passaggio 3 (Informazioni Aggiuntive) della procedura guidata di configurazione del servizio.
Clicca su **Aggiungi Imposta** e seleziona uno o più tipi di imposta dall'elenco configurato. Scegli se le imposte si applicano come **inclusive** o **esclusive** per questo servizio. Questa impostazione si applica a tutte le imposte collegate al servizio, incluse le commissioni di configurazione e i componenti aggiuntivi.
### Passaggio 3: Come Vengono Applicate le Imposte
Le imposte possono essere applicate **automaticamente durante il pagamento** o **manualmente sulle fatture**:
**Automatico (Pagamento)**
* Le imposte collegate a un servizio vengono calcolate automaticamente in base alla posizione di fatturazione del cliente.
* Il cliente deve fornire paese, stato e CAP al momento del pagamento affinché si applichi l'imposta basata sulla posizione.
* Per gli account Stripe India, le informazioni complete sulla posizione (paese, stato, CAP) sono obbligatorie.
**Manuale (Fattura)**
* Quando si crea una fattura manualmente, clicca su **Aggiungi Imposte** per scegliere quali imposte applicare.
* I campi dell'indirizzo di fatturazione si popolano automaticamente.
* **Solo le imposte esclusive** possono essere applicate alle fatture manuali — le imposte inclusive non sono supportate in questo flusso.
### Visualizzazione delle Imposte in Fattura
Ogni fattura che include un'imposta mostra i seguenti dettagli:
* **Nome Imposta** — l'etichetta che hai inserito (es. IVA, GST)
* **Percentuale Imposta** — l'aliquota applicata (es. 15%)
* **Importo Imposta** — l'importo calcolato addebitato
### Gestione delle Aliquote Fiscali Esistenti
* **Modifica un'imposta:** Clicca sulla voce fiscale nell'elenco per aggiornarne il titolo, l'aliquota o le regole per paese. Gli aggiornamenti si applicano solo alle future fatture e acquisti.
* **Elimina un'imposta:** Le imposte eliminate non si applicano più ai nuovi acquisti o abbonamenti, ma le fatture esistenti che le includevano non vengono modificate.
* **Disattiva un'imposta:** Imposta un'imposta su **Inattiva** per smettere di applicarla ai nuovi acquisti senza eliminare la configurazione.
### Note Importanti
* **Gli sconti coupon si applicano prima dell'imposta:** Quando un cliente usa un coupon di sconto, l'imposta viene calcolata sul prezzo scontato, non sul prezzo originale.
* **Più imposte per servizio:** Puoi collegare più di un'imposta a un singolo servizio (es. IVA + GST contemporaneamente).
* **L'imposta si applica ai componenti aggiuntivi e alle commissioni di configurazione:** Se il tuo servizio ha una commissione di configurazione o dei componenti aggiuntivi, l'imposta viene applicata anche a quegli importi.
* **La posizione del cliente è precompilata:** Se un cliente ha un paese e uno stato di fatturazione salvati nel suo profilo, quei campi vengono pre-popolati al momento del pagamento. Tuttavia, la modifica della posizione durante il pagamento **non** aggiorna il profilo del cliente.
* **Rilevamento dello stato tramite CAP:** Per i clienti statunitensi, il sistema può rilevare automaticamente lo stato dal CAP e applicare l'imposta regionale corretta se configurata.