> ## 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.

# Personnaliser les portails client, les contrôles d'accès et les taux de taxe

> Mettez votre image de marque sur vos pages de connexion et d'inscription client, contrôlez la visibilité de la barre latérale par rôle et configurez les taux de taxe pour les factures et le paiement dans AgencyHandy.

AgencyHandy vous offre un contrôle approfondi sur ce que vos clients voient et expérimentent — de la toute première page sur laquelle ils arrivent lors de la connexion, jusqu'aux sections de la plateforme qu'ils peuvent parcourir après s'être connectés. Cette page couvre quatre domaines de configuration interconnectés : le **portail de connexion**, le **portail d'inscription**, les contrôles de **barre latérale et d'accès**, et les **taux de taxe**. Ensemble, ces paramètres vous permettent de créer une expérience soignée et adaptée à chaque rôle pour tous les utilisateurs de votre espace de travail.

<Note>
  Tous les paramètres de cette page nécessitent un accès **Super Admin** ou **Admin**. Accédez à **Workspace Config** dans la barre latérale gauche pour accéder à chaque section.
</Note>

***

<Tabs>
  <Tab title="Portail de connexion">
    ## Portail de connexion

    Le portail de connexion est la page de connexion que vos clients et membres de l'équipe voient lorsqu'ils accèdent à votre espace de travail AgencyHandy. Le personnaliser garantit que la première impression de vos clients est entièrement à votre image de marque — avec les visuels, le titre et le message de votre agence.

    ### Ce que vous pouvez personnaliser

    | Élément        | Description                                                            | Limite                    |
    | -------------- | ---------------------------------------------------------------------- | ------------------------- |
    | **Titre**      | Le titre principal affiché en haut de la page de connexion             | Max 120 caractères        |
    | **Image**      | Une photo ou illustration à votre image de marque affichée sur la page | PNG, JPG, JPEG — max 5 Mo |
    | **Sous-texte** | Un court message sous les champs de connexion                          | Max 300 caractères        |

    ### Étapes pour personnaliser le portail de connexion

    <Steps>
      <Step title="Ouvrez les paramètres du portail de connexion">
        Allez dans **Workspace Config** dans la navigation de gauche, puis sélectionnez **Sign-in Portal** dans le sous-menu.
      </Step>

      <Step title="Saisissez un titre personnalisé">
        Saisissez le titre souhaité dans le champ **Heading**. Restez concis et pertinent — par exemple, *« Content de vous revoir chez \[Nom de l'agence] »* ou *« Votre portail client. »* La longueur maximale est de 120 caractères.
      </Step>

      <Step title="Téléchargez une image à votre image de marque">
        Cliquez sur la zone de téléchargement ou glissez-déposez un fichier image (PNG, JPG ou JPEG, maximum 5 Mo) pour ajouter un élément visuel à la page de connexion. Cette image apparaît généralement à côté du formulaire de connexion.

        <Tip>
          Utilisez une image de haute qualité qui représente votre agence — une photo de votre équipe, une illustration de marque épurée ou un arrière-plan professionnel. Assurez-vous que la taille du fichier est inférieure à 5 Mo pour éviter les erreurs de téléchargement.
        </Tip>
      </Step>

      <Step title="Ajoutez un sous-texte">
        Dans le champ **Subtext**, rédigez un bref message à afficher sous les champs de connexion — par exemple, un mot de bienvenue, un contact d'assistance ou un slogan court. Restez en dessous de 300 caractères.
      </Step>

      <Step title="Prévisualisez et enregistrez">
        Vérifiez la mise en page de la page de connexion à l'aide de l'aperçu. Une fois satisfait, cliquez sur **Save** (ou **Update**) pour appliquer les modifications. Les modifications prennent effet immédiatement.
      </Step>
    </Steps>

    ### Réinitialisation aux valeurs par défaut

    Cliquez sur **Reset Default Settings** sur la page du portail de connexion pour supprimer toutes les personnalisations et restaurer la page de connexion AgencyHandy d'origine.

    <Warning>
      La réinitialisation aux valeurs par défaut est irréversible. Tous les titres, images et sous-textes personnalisés seront définitivement supprimés. Cliquez sur **Cancel** si vous n'êtes pas sûr — les modifications non enregistrées sont ignorées et les paramètres enregistrés actuels restent intacts.
    </Warning>

    ### Bonnes pratiques

    * Gardez le titre court et accueillant — les clients le voient avant de se connecter, alors rendez-le rassurant.
    * Utilisez une image professionnelle qui représente votre agence. Évitez les photos génériques de banque d'images qui semblent déconnectées de votre marque.
    * Prévisualisez sur différentes tailles d'écran avant d'enregistrer pour vous assurer que la mise en page de l'image et du texte est correcte.
    * Si l'image ne se télécharge pas, vérifiez qu'elle respecte les exigences de format (PNG, JPG, JPEG) et de taille (inférieure à 5 Mo).
  </Tab>

  <Tab title="Portail d'inscription">
    ## Portail d'inscription

    Le portail d'inscription est la page d'inscription sur laquelle les nouveaux clients arrivent lorsqu'ils créent un compte dans votre espace de travail. Le personnaliser crée une expérience de marque cohérente dès la toute première interaction qu'un client potentiel a avec la plateforme de votre agence.

    ### Ce que vous pouvez personnaliser

    | Élément        | Description                                                            | Limite                    |
    | -------------- | ---------------------------------------------------------------------- | ------------------------- |
    | **Titre**      | Le titre principal affiché en haut de la page d'inscription            | Max 120 caractères        |
    | **Image**      | Une photo ou illustration à votre image de marque affichée sur la page | PNG, JPG, JPEG — max 5 Mo |
    | **Sous-texte** | Un court message sous les champs d'inscription                         | Max 300 caractères        |

    ### Étapes pour personnaliser le portail d'inscription

    <Steps>
      <Step title="Ouvrez les paramètres du portail d'inscription">
        Allez dans **Workspace Config** dans la navigation de gauche, puis sélectionnez **Sign-up Portal** dans le sous-menu.
      </Step>

      <Step title="Saisissez un titre personnalisé">
        Saisissez un titre dans le champ **Heading** qui accueille les nouveaux clients. Par exemple, *« Démarrez avec \[Nom de l'agence] »* ou *« Créez votre compte client. »* Maximum 120 caractères.
      </Step>

      <Step title="Téléchargez une image à votre image de marque">
        Cliquez sur la zone de téléchargement ou glissez-déposez un fichier image (PNG, JPG ou JPEG, maximum 5 Mo). Cette image est affichée sur la page d'inscription à côté du formulaire d'inscription.

        <Tip>
          Utilisez le même style visuel et la même palette de couleurs sur les images de vos portails de connexion et d'inscription pour créer une expérience cohérente entre les deux pages.
        </Tip>
      </Step>

      <Step title="Ajoutez un sous-texte">
        Rédigez un court message d'accompagnement dans le champ **Subtext** — par exemple, des instructions sur ce à quoi s'attendre après l'inscription, ou une brève proposition de valeur. Maximum 300 caractères.
      </Step>

      <Step title="Prévisualisez et enregistrez">
        Vérifiez la page d'inscription à l'aide de l'option d'aperçu. Cliquez sur **Save** (ou **Update**) pour appliquer les modifications immédiatement.
      </Step>
    </Steps>

    ### Réinitialisation aux valeurs par défaut

    Cliquez sur **Reset Default Settings** sur la page du portail d'inscription pour supprimer toutes les personnalisations et restaurer la page d'inscription AgencyHandy d'origine.

    <Warning>
      Cette action ne peut pas être annulée. Toutes les configurations personnalisées de titre, d'image et de sous-texte seront définitivement effacées.
    </Warning>

    ### Bonnes pratiques

    * Adaptez le ton du titre d'inscription à votre style global de communication client — professionnel, amical, ou les deux.
    * Gardez le sous-texte ciblé : indiquez aux nouveaux clients ce qui se passe après leur inscription (par exemple, *« Une fois inscrit, notre équipe vous enverra un e-mail de bienvenue dans les 24 heures. »*).
    * Testez vous-même le parcours d'inscription après avoir enregistré les modifications pour confirmer que la page s'affiche et se comporte comme prévu.
  </Tab>

  <Tab title="Barre latérale et accès">
    ## Contrôles de barre latérale et d'accès

    Les paramètres de barre latérale et d'accès vous permettent de contrôler exactement ce que chaque rôle d'utilisateur peut voir dans le menu de navigation de gauche. Vous pouvez renommer les éléments de menu pour qu'ils correspondent à la terminologie de votre agence, remplacer les icônes par défaut par des icônes personnalisées et activer/désactiver la visibilité de n'importe quelle section de menu par rôle. Le résultat est une interface plus épurée et conçue sur mesure pour chaque personne qui se connecte.

    ### Rôles que vous pouvez configurer

    * Client
    * Super Admin
    * Admin
    * Manager
    * Assigné
    * Personnalisé (tout rôle personnalisé que vous avez créé sous Roles & Permissions)

    ### Étapes pour personnaliser les éléments du menu de la barre latérale

    <Steps>
      <Step title="Ouvrez les paramètres de barre latérale et d'accès">
        Allez dans **Workspace Config**, puis sélectionnez **Sidebar & Access** dans le menu des paramètres.
      </Step>

      <Step title="Cliquez sur Customize">
        Cliquez sur le bouton **Customize** en haut du panneau. La liste complète des éléments de menu actuels de la barre latérale apparaît sous la catégorie **Main**.
      </Step>

      <Step title="Renommez un élément de menu">
        Cliquez sur le champ texte de n'importe quel élément de menu et saisissez le nouveau libellé. Par exemple, renommez « Dashboard » en « Aperçu » ou « CRM » en « Contacts ». Cliquez sur **Save** pour appliquer le nouveau nom.
      </Step>

      <Step title="Changez l'icône d'un menu">
        Cliquez sur l'icône à côté du nom d'un élément de menu. Une fenêtre s'ouvre avec un ensemble d'options d'icônes — sélectionnez-en une dans la bibliothèque, ou téléchargez une image personnalisée de 32×32 px pour utiliser votre propre icône de marque. Cliquez sur **Save** pour appliquer.
      </Step>
    </Steps>

    ### Étapes pour configurer la visibilité basée sur les rôles

    <Steps>
      <Step title="Cliquez sur Edit Access">
        Cliquez sur le bouton **Edit Access** (à côté du bouton **Customize**). Vous verrez des onglets pour chaque rôle disponible.
      </Step>

      <Step title="Sélectionnez un rôle">
        Cliquez sur l'onglet du rôle que vous souhaitez configurer — par exemple, **Client**.
      </Step>

      <Step title="Activez ou désactivez la visibilité des éléments de menu">
        Pour chaque élément de menu répertorié, utilisez le commutateur pour l'afficher ou le masquer pour le rôle sélectionné. Par exemple, vous pouvez masquer **Invoices** et **Subscriptions** pour les clients tout en les gardant visibles pour les Admins et les Managers.
      </Step>

      <Step title="Enregistrez vos modifications">
        Cliquez sur **Save**. Les paramètres de visibilité mis à jour prennent effet immédiatement — les utilisateurs voient les modifications lors de leur prochaine navigation ou après s'être reconnectés.
      </Step>

      <Step title="Réinitialisez aux valeurs par défaut si nécessaire">
        Cliquez sur **Reset to Default** sur l'onglet de n'importe quel rôle pour restaurer les paramètres de visibilité d'origine de ce rôle.
      </Step>
    </Steps>

    <Tip>
      Une barre latérale épurée et minimale améliore l'expérience client. N'afficher aux clients que ce dont ils ont besoin — comme **Dashboard**, **Orders** et **Messages** — réduit la confusion et les empêche de tomber sur des sections réservées à un usage interne.
    </Tip>

    ### Exemples de configurations de rôles

    | Rôle        | Sections visibles recommandées                        |
    | ----------- | ----------------------------------------------------- |
    | Client      | Dashboard, Orders, Messages, Invoices (si nécessaire) |
    | Manager     | CRM, Projects, Timesheet, Tasks                       |
    | Assigné     | Dashboard, Tasks, Projects, Messages                  |
    | Super Admin | Toutes les sections (aucune restriction)              |

    ### Remarques importantes

    * **Les modifications sont instantanées :** Les mises à jour de visibilité des rôles se reflètent immédiatement après que les utilisateurs actualisent ou se reconnectent.
    * **Le rôle le plus permissif l'emporte :** Si un utilisateur détient plusieurs rôles, le rôle ayant l'accès le plus large prévaut.
    * **Icônes personnalisées :** Téléchargez des images de 32×32 px pour correspondre aux visuels de la marque de votre agence dans la barre latérale.
    * **Cohérence de nommage :** Utilisez des conventions de nommage claires et cohérentes que toute votre équipe comprend — évitez les abréviations ou le jargon interne que les nouveaux membres de l'équipe ne reconnaîtront pas.
  </Tab>

  <Tab title="Taux de taxe">
    ## Taux de taxe

    La fonctionnalité Taux de taxe vous permet de créer, gérer et appliquer des configurations fiscales à vos services, abonnements et factures. Vous pouvez configurer plusieurs types de taxes — TVA, GST, taxe de vente et autres — avec des taux spécifiques par pays et par état, la prise en charge des modèles de prix inclusifs et exclusifs, et l'application automatique au paiement en fonction de la localisation du client.

    <Note>
      Seuls les **Super Admins** et les **Admins** peuvent créer, modifier ou supprimer des configurations fiscales.
    </Note>

    ### Concepts fiscaux en un coup d'œil

    | Concept      | Définition                                                                                                   |
    | ------------ | ------------------------------------------------------------------------------------------------------------ |
    | **Exclusif** | La taxe est ajoutée au prix indiqué au moment du paiement (par exemple, 100 $+ 10 % de taxe = 110$ au total) |
    | **Inclusif** | La taxe est déjà incluse dans le prix affiché au client (par exemple, 110 \$ au total incluent déjà la taxe) |
    | **Tax ID**   | Le numéro d'identification fiscale de votre entreprise, affiché sur les factures                             |

    ### Étape 1 : Créer un taux de taxe

    <Steps>
      <Step title="Ouvrez les taux de taxe">
        Allez dans **Workspace Config**, puis cliquez sur l'onglet **Tax Rates**.
      </Step>

      <Step title="Cliquez sur + New Tax">
        Cliquez sur le bouton **+ New Tax**. Un formulaire apparaît.
      </Step>

      <Step title="Renseignez les détails de la taxe">
        Complétez les champs suivants :

        * **Title / Tax Type** *(requis)* : Saisissez un nom descriptif, par exemple Standard VAT, Reduced GST ou US Sales Tax. Maximum 255 caractères.
        * **Tax ID** *(optionnel)* : Le numéro d'identification fiscale de votre entreprise. Maximum 20 caractères.
        * **Home Country** : Sélectionnez le pays principal auquel cette taxe s'applique.
        * **Home Country General Tax Rate %** *(optionnel)* : Le taux par défaut pour votre pays d'origine.
        * **Country-Specific Rates** *(optionnel)* : Ajoutez des taux par pays avec un état, un code postal et un pourcentage optionnels. Ceci est utile pour les agences servant des clients dans plusieurs juridictions fiscales.
      </Step>

      <Step title="Définissez le statut">
        Basculez la taxe sur **Active** pour la rendre immédiatement disponible pour les services et les factures. Définissez-la sur **Inactive** pour enregistrer la configuration sans encore l'appliquer aux nouveaux achats.
      </Step>

      <Step title="Enregistrez">
        Cliquez sur **Save**. La taxe apparaît dans votre liste de taux de taxe et peut désormais être liée à des services.
      </Step>
    </Steps>

    <Tip>
      Vous pouvez prendre en charge jusqu'à 4 décimales dans les pourcentages de taux de taxe. Un taux de taxe de 0 % est valide — utilisez-le pour les articles à taux zéro ou les scénarios de conformité où la taxe doit être indiquée mais s'élève à zéro.
    </Tip>

    ### Étape 2 : Lier des taxes à des services

    <Steps>
      <Step title="Ouvrez le service pour le modifier">
        Accédez à **Services** et créez un nouveau service ou modifiez-en un existant.
      </Step>

      <Step title="Allez à la section Additional Info">
        Passez à l'étape 3 (Additional Info) de l'assistant de configuration du service.
      </Step>

      <Step title="Ajoutez des taxes au service">
        Cliquez sur **Add Tax** et sélectionnez un ou plusieurs types de taxes dans votre liste configurée. Choisissez si les taxes s'appliquent de manière **inclusive** ou **exclusive** pour ce service. Ce paramètre s'applique à toutes les taxes liées au service, y compris les frais d'installation et les modules complémentaires.
      </Step>
    </Steps>

    ### Étape 3 : Comment les taxes sont appliquées

    Les taxes peuvent être appliquées **automatiquement au moment du paiement** ou **manuellement sur les factures** :

    **Automatique (paiement)**

    * Les taxes liées à un service sont automatiquement calculées en fonction de l'adresse de facturation du client.
    * Le client doit fournir son pays, son état et son code postal au moment du paiement pour que la taxe basée sur la localisation s'applique.
    * Pour les comptes Stripe Inde, les informations complètes de localisation (pays, état, code postal) sont obligatoires.

    **Manuelle (facture)**

    * Lors de la création manuelle d'une facture, cliquez sur **Add Taxes** pour choisir les taxes à appliquer.
    * Les champs de l'adresse de facturation se remplissent automatiquement.
    * **Seules les taxes exclusives** peuvent être appliquées aux factures manuelles — les taxes inclusives ne sont pas prises en charge dans ce flux.

    ### Affichage des taxes sur la facture

    Chaque facture incluant une taxe affiche les détails suivants :

    * **Nom de la taxe** — le libellé que vous avez saisi (par exemple, TVA, GST)
    * **Pourcentage de taxe** — le taux appliqué (par exemple, 15 %)
    * **Montant de la taxe** — le montant calculé facturé

    ### Gestion des taux de taxe existants

    * **Modifier une taxe :** Cliquez sur l'entrée de taxe dans la liste pour mettre à jour son titre, son taux ou ses règles par pays. Les mises à jour s'appliquent uniquement aux futures factures et achats.
    * **Supprimer une taxe :** Les taxes supprimées ne s'appliquent plus aux nouveaux achats ou abonnements, mais les factures existantes qui les incluaient ne sont pas affectées.
    * **Désactiver une taxe :** Définissez une taxe sur **Inactive** pour cesser de l'appliquer aux nouveaux achats sans supprimer la configuration.

    ### Remarques importantes

    * **Les remises par coupon s'appliquent avant la taxe :** Lorsqu'un client utilise un coupon de réduction, la taxe est calculée sur le prix réduit, et non sur le prix d'origine.
    * **Plusieurs taxes par service :** Vous pouvez attacher plusieurs taxes à un seul service (par exemple, TVA + GST simultanément).
    * **La taxe s'applique aux modules complémentaires et aux frais d'installation :** Si votre service comporte des frais d'installation ou des modules complémentaires, la taxe est également appliquée à ces montants.
    * **La localisation du client est préremplie :** Si un client a un pays et un état de facturation enregistrés dans son profil, ces champs sont préremplis au moment du paiement. Cependant, modifier la localisation au moment du paiement ne met **pas** à jour le profil du client.
    * **Détection de l'état basée sur le code postal :** Pour les clients américains, le système peut détecter automatiquement l'état à partir du code postal et appliquer la taxe régionale correcte si elle est configurée.
  </Tab>
</Tabs>
