> ## Documentation Index
> Fetch the complete documentation index at: https://docs.e4-bizz.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Configuration

> Paramètres complets de votre organisation PEPSiMAD - informations générales, collaborateurs, mercuriales, promotions, équipements et intégrations.

# Configuration

Le module **Configuration** permet aux administrateurs de paramétrer la plateforme selon les besoins de votre organisation. Il regroupe 8 onglets distincts couvrant tous les aspects de gestion.

<Warning>
  Ce module est réservé exclusivement aux **administrateurs**. Les commerciaux n'y ont pas accès.
</Warning>

## Accéder à la configuration

Cliquez sur **Configuration** dans le menu latéral (icône engrenage). Vous accédez alors aux 8 onglets de paramétrage.

***

## Onglet 1 : Général

### Informations générales de l'organisation

Cet onglet centralise les informations de base de votre entreprise.

#### Champs disponibles

| Champ              | Type       | Limite         | Obligatoire | Description                                                                                 |
| ------------------ | ---------- | -------------- | :---------: | ------------------------------------------------------------------------------------------- |
| **Logo**           | Image      | 5 MB           |     Non     | Fichier PNG, JPG ou JPEG. S'affiche en haut de la plateforme et dans les documents exportés |
| **Raison sociale** | Texte      | 255 caractères |     Oui     | Nom officiel de votre entreprise                                                            |
| **Coordonnées**    | Texte long | 250 caractères |     Non     | Adresse complète de votre siège social                                                      |
| **Téléphone**      | Texte      | 20 caractères  |     Non     | Numéro de téléphone principal                                                               |
| **Email**          | Email      | 255 caractères |     Non     | Adresse email de contact principal                                                          |
| **Site web**       | URL        | 255 caractères |     Non     | Lien vers votre site web officiel                                                           |
| **Numéro de TVA**  | Texte      | 20 caractères  |     Non     | Numéro d'identification à la TVA (ex: FR12345678901)                                        |
| **SIRET**          | Numéro     | 14 chiffres    |     Non     | Code d'identification INSEE de votre établissement                                          |

#### Étapes d'enregistrement

<Steps>
  <Step title="Télécharger un logo (optionnel)">
    Cliquez sur la zone de drop pour sélectionner une image ou glissez-déposez un fichier PNG/JPG/JPEG. Le logo doit faire maximum 5 MB.
  </Step>

  <Step title="Remplir les informations texte">
    Complétez les champs nom, coordonnées, téléphone, email, site web, TVA et SIRET. Seule la raison sociale est obligatoire.
  </Step>

  <Step title="Cliquer sur Enregistrer">
    Validez vos modifications avec le bouton en bas du formulaire.
  </Step>
</Steps>

<Note>
  Les modifications sont immédiatement effectives sur toute la plateforme. Le logo apparaîtra dans les emails et documents générés.
</Note>

***

## Onglet 2 : Collaborateurs

### Gestion des utilisateurs internes

Cet onglet gère tous les collaborateurs ayant accès à la plateforme (administrateurs, commerciaux, etc.).

#### Vue liste

La liste affiche tous les collaborateurs avec les colonnes suivantes :

| Colonne              | Description                                                           |
| -------------------- | --------------------------------------------------------------------- |
| **Nom**              | Nom de famille du collaborateur                                       |
| **Prénom**           | Prénom du collaborateur                                               |
| **Identifiant**      | Identifiant unique (ex: jean-acmecorp). Non modifiable après création |
| **Rôle**             | Badge coloré indiquant le niveau d'accès                              |
| **Clients assignés** | Badge montrant le nombre de clients assignés                          |

#### Badges de rôle

* **Administrateur** (rouge) : Accès complet à tous les modules et paramètres
* **Collaborateur** (vert) : Accès limité uniquement aux clients qui lui sont assignés

#### Créer un collaborateur

<Steps>
  <Step title="Cliquer sur Ajouter un collaborateur">
    Bouton en haut à droite de la liste.
  </Step>

  <Step title="Remplir l'onglet Informations">
    * **Prénom**\* : Prénom du collaborateur
    * **Nom**\* : Nom de famille
    * **Nom d'utilisateur**\* : Identifiant unique du collaborateur (3-20 caractères, minuscules uniquement)
    * **Email**\* : Adresse email valide
    * **Téléphone** : Numéro optionnel
    * **Rôle**\* : Dropdown avec 2 options :
      * Administrateur = accès complet
      * Collaborateur = accès limité aux clients assignés uniquement
    * **Fonction** : Combobox avec liste prédéfinie (vous pouvez créer une nouvelle fonction directement en tapant)
  </Step>

  <Step title="Remplir l'onglet Affectations (Edit uniquement)">
    Sélectionnez les clients/patients à assigner à ce collaborateur. Les collaborateurs avec rôle "Collaborateur" ne voient que leurs clients assignés.
  </Step>

  <Step title="Cliquer sur Enregistrer">
    Le collaborateur est créé et recevra un email avec ses identifiants de connexion.
  </Step>
</Steps>

#### Éditer un collaborateur

Cliquez sur le bouton **Modifier** (crayon) pour éditer un collaborateur existant. Vous accédez aux deux onglets :

* **Informations** : Modifiez les informations personnelles et le rôle
* **Affectations** : Modifiez les clients assignés (non disponible en création)

#### Supprimer un collaborateur

Cliquez sur le bouton **Supprimer** (poubelle). Une confirmation est requise. L'utilisateur n'aura plus accès à la plateforme après suppression.

***

## Onglet 3 : Mercuriales (Paramètres des commandes)

### Configuration des frais et délais de livraison

Cet onglet définit les paramètres généraux des commandes et les grilles tarifaires de frais de port par montant.

<Note>
  Cette section configure les **paramètres des commandes**, pas les catalogues produits. Pour gérer les catalogues, consultez le module **Mercuriales**.
</Note>

#### Section A : Paramètres généraux

| Paramètre              | Type      | Obligatoire | Description                                                                                   |
| ---------------------- | --------- | :---------: | --------------------------------------------------------------------------------------------- |
| **Délai de livraison** | Nombre    |     Oui     | Nombre de jours ouvrables avant livraison (ex: 5)                                             |
| **Montant minimum HT** | Montant € |     Non     | Montant minimum d'une commande en euros HT. En dessous de ce montant, la commande est refusée |
| **Frais d'urgence**    | Montant € |     Non     | Frais additionnels appliqués si livraison urgente demandée                                    |

#### Section B : Grille tarifaire de frais de port

Définissez les frais de livraison en fonction du montant HT de la commande.

##### Table tarifaire

| Colonne          | Description                                                                            |
| ---------------- | -------------------------------------------------------------------------------------- |
| **Minimum (€)**  | Montant minimal de commande HT                                                         |
| **Maximum (€)**  | Montant maximal de commande HT. La dernière ligne affiche "∞" pour un montant illimité |
| **Frais HT (€)** | Frais de port appliqués si la commande est dans cette tranche                          |
| **Actions**      | Boutons éditer/supprimer (actifs uniquement pour la dernière ligne)                    |

##### Création d'une tranche tarifaire

Cliquez sur **Ajouter une tranche** pour ouvrir le formulaire :

<Steps>
  <Step title="Le minimum est auto-calculé">
    Le champ Minimum affiche automatiquement le maximum de la tranche précédente.
  </Step>

  <Step title="Définir le maximum">
    Entrez un montant en euros ou sélectionnez le radio "∞" pour un montant illimité.
  </Step>

  <Step title="Renseigner les frais de livraison HT">
    Entrez le montant HT des frais appliqués dans cette tranche.
  </Step>

  <Step title="Enregistrer">
    Cliquez sur le bouton pour ajouter la tranche. Elle apparaît immédiatement dans la table.
  </Step>
</Steps>

##### Modification et suppression

* **Seule la dernière tranche** peut être modifiée ou supprimée
* Pour modifier une tranche intermédiaire, supprimez toutes les tranches après celle-ci, puis modifiez-la
* Pour supprimer une tranche, cliquez sur le bouton supprimer (poubelle). Une confirmation est requise

##### Exemple de grille

| Minimum | Maximum | Frais HT |
| ------- | ------- | -------- |
| 0 €     | 100 €   | 8.50 €   |
| 100 €   | 500 €   | 12.00 €  |
| 500 €   | ∞       | 0.00 €   |

***

## Onglet 4 : Opérations promotionnelles

### Gestion des offres promotionnelles

Cet onglet permet de créer et gérer des opérations promotionnelles (réductions, offres spéciales) applicables à des produits spécifiques.

#### Actions disponibles

| Action                  | Description                                       |
| ----------------------- | ------------------------------------------------- |
| **Créer une opération** | Bouton en haut à droite                           |
| **Modifier**            | Cliquez sur l'opération dans la liste pour éditer |
| **Supprimer**           | Bouton poubelle pour supprimer définitivement     |

#### Créer une opération promotionnelle

Un formulaire 3-onglets s'ouvre :

##### Onglet 1 : Informations

<Steps>
  <Step title="Remplir le nom de l'opération*">
    Donnez un nom clair (ex: "Été 2025 - Réduction fauteuils").
  </Step>

  <Step title="Sélectionner la mercuriale*">
    Dropdown affichant toutes les mercuriales actives. C'est le catalogue auquel s'applique l'opération.
  </Step>

  <Step title="Sélectionner le produit concerné*">
    Combobox filtrant les produits de la mercuriale sélectionnée. Vous pouvez taper pour filtrer par nom ou référence.
  </Step>

  <Step title="Définir la date de début*">
    Date du jour du lancement de l'opération.
  </Step>

  <Step title="Définir la date de fin*">
    Date du dernier jour de l'opération. Doit être après la date de début.
  </Step>
</Steps>

##### Onglet 2 : Document (édition uniquement)

Disponible uniquement lors de l'édition d'une opération existante.

* **Upload PDF** : Fichier optionnel (max 10 MB) contenant les détails de l'opération
* **Fichier existant** : Affiche le fichier déjà uploadé avec lien de téléchargement
* **Remplacement** : Upload un nouveau fichier pour remplacer l'existant

##### Onglet 3 : Affectations (édition uniquement)

Disponible uniquement lors de l'édition d'une opération existante.

Deux modes :

* **Tous les clients** : L'opération s'applique automatiquement à tous les clients actuels et futurs
* **Clients spécifiques** : Multi-select filtrée avec options de recherche :
  * Recherche par libellé/nom
  * Tri par nombre de commandes
  * Option "Sélectionner tout" pour cocher rapidement tous les clients filtrés

***

## Onglet 5 : Dispositifs médicaux

### Gestion des types d'équipements

Cet onglet liste tous les dispositifs médicaux (équipements) gérés dans votre parc avec leurs configurations.

#### Table des dispositifs

| Colonne                | Description                                                  |
| ---------------------- | ------------------------------------------------------------ |
| **Désignation**        | Nom du dispositif (ex: "Fauteuil roulant électrique")        |
| **Type**               | Catégorie d'utilisation : Vente, Location, ou Vente+Location |
| **Points de contrôle** | Nombre de points de contrôle configurés pour ce dispositif   |
| **Salles d'audit**     | Nombre de salles d'audit liées                               |
| **Actions**            | Bouton éditer (crayon)                                       |

#### Filtres et pagination

* **Recherche par nom** : Filtre en temps réel sur la désignation
* **Filtre Type** : Dropdown pour filtrer par Vente, Location ou Vente+Location
* **Pagination** : 20 dispositifs par page

#### Éditer un dispositif

Cliquez sur le bouton **Éditer** pour ouvrir le formulaire avec 3 onglets :

##### Onglet Informations générales

* **Désignation**\* : Nom du dispositif
* **Type**\* : Dropdown (Vente / Location / Vente+Location)
* Description complète si applicable

##### Onglet Points de contrôle

Liste des points de contrôle (audits de sécurité) associés à ce dispositif.

##### Onglet Salles d'audit

Liste des salles d'audit où ce dispositif peut être audité.

***

## Onglet 6 : Audit de sécurisation

### Configuration du module d'audit

Cet onglet paramètre le système d'audit de sécurité des équipements (audits à domicile, aux locaux, etc.).

#### Paramètres généraux

| Paramètre           | Type       | Description                                                         |
| ------------------- | ---------- | ------------------------------------------------------------------- |
| **Inclure le logo** | Toggle     | Ajouter le logo de l'organisation dans les rapports d'audit générés |
| **Titre**           | Texte      | Titre affiché dans les rapports d'audit                             |
| **Sous-titre**      | Texte      | Sous-titre complémentaire                                           |
| **Raison**          | Texte long | Motif/contexte de l'audit                                           |
| **Titre PDF**       | Texte      | Titre du fichier PDF généré                                         |
| **Origine**         | Dropdown   | Lieu de l'audit : "À domicile" ou "En local"                        |

#### Sous-onglets

##### Salles d'audit (Audit rooms)

Liste des salles d'audit définies pour votre organisation :

* Création de nouvelles salles
* Modification des noms et paramètres
* Suppression si non utilisées

##### Points de contrôle (Checkpoints)

Liste des points de contrôle (questions d'audit) :

* Création de nouveaux checklist items
* Modification des questions et réponses attendues
* Ordre d'affichage dans les audits
* Suppression si non utilisés

***

## Onglet 7 : Documents d'intervention

### Configuration des documents interventions

Cet onglet définit les documents affichés lors des interventions (conditions générales de vente, chartes, documents légaux, etc.).

#### Table des documents

Affiche tous les documents configurés avec :

| Colonne               | Description                                                        |
| --------------------- | ------------------------------------------------------------------ |
| **Nom du document**   | Titre ou libellé                                                   |
| **Type**              | PDF (fichier statique) ou Template (document généré dynamiquement) |
| **Fichier**           | Nom du fichier uploadé (si type PDF)                               |
| **Ordre d'affichage** | Numéro définissant l'ordre dans la liste                           |
| **Règle d'inclusion** | Toujours / Vente uniquement / Location uniquement                  |
| **Signature requise** | Oui/Non - si oui, demande la signature du client                   |
| **Actions**           | Éditer/Supprimer                                                   |

#### Créer un document

<Steps>
  <Step title="Cliquer sur Ajouter un document">
    Bouton en haut à droite.
  </Step>

  <Step title="Remplir le formulaire">
    * **Nom du document**\* : Titre affiché (ex: "Conditions générales de vente")
    * **Type**\* : Dropdown - PDF ou Template
    * **Fichier**\* : Upload un fichier PDF (max 10 MB) si type PDF
    * **Ordre d'affichage** : Numéro définissant la position dans la liste des interventions
    * **Règle d'inclusion**\* : Dropdown -
      * Toujours = affiché pour toutes les interventions
      * Vente uniquement = visible uniquement pour les ventes
      * Location uniquement = visible uniquement pour les locations
    * **Signature requise** : Toggle - demande la signature électronique du client avant validation
  </Step>

  <Step title="Enregistrer">
    Cliquez sur le bouton pour ajouter le document.
  </Step>
</Steps>

#### Modifier ou supprimer

* **Modifier** : Cliquez sur le bouton Éditer pour ajuster les paramètres
* **Supprimer** : Cliquez sur le bouton Supprimer. Le document n'apparaîtra plus dans les interventions futures

<Note>
  Les modifications n'affectent que les nouvelles interventions. Les interventions déjà complétées conservent la version du document au moment de l'intervention.
</Note>

***

## Onglet 8 : Intégration CRM (Must G5)

### Configuration de l'intégration avec votre CRM

Cet onglet gère la connexion avec votre système CRM Must G5 (optionnel). Cette intégration permet de synchroniser les commandes, produits et clients.

#### Indicateur de connexion

En haut de l'onglet, un indicateur affiche l'état :

**Connecté** (cas optimal)

* Icône plug verte
* Label "Connecté à Must G5"
* Badge "Actif" en vert
* Les boutons "Tester la connexion" et "Supprimer" sont actifs
* Le bouton affiche "Mettre à jour"

**Non configuré** (cas par défaut)

* Icône plug grise
* Label "Non configuré"
* Les champs de connexion sont vides/désactivés
* Le bouton affiche "Activer Must G5"

#### Champs de configuration

| Champ                                       | Type         | Obligatoire | Description                                                     |
| ------------------------------------------- | ------------ | :---------: | --------------------------------------------------------------- |
| **URL du serveur**                          | URL          |    Oui\*    | Adresse complète du serveur                                     |
| **Identifiant**                             | Texte        |    Oui\*    | Nom d'utilisateur pour authentification                         |
| **Mot de passe**                            | Mot de passe |    Oui\*    | Mot de passe utilisateur                                        |
| **Code origine**                            | Texte        |    Oui\*    | Identifiant de votre organisation dans le CRM                   |
| **Synchronisation automatique des statuts** | Toggle       |     Non     | Si activé, met à jour les statuts des commandes automatiquement |

\*Obligatoires si vous activez l'intégration CRM

#### Étapes d'activation

<Steps>
  <Step title="Remplir les champs de connexion">
    Entrez l'URL du serveur, vos identifiants et le code origine.
  </Step>

  <Step title="Cliquer sur Tester la connexion">
    Le système teste la connexion. Un message affiche le résultat : succès ou erreur.
  </Step>

  <Step title="Activer la synchronisation automatique (optionnel)">
    Cochez le toggle si vous souhaitez que les statuts de commande se mettent à jour automatiquement.
  </Step>

  <Step title="Cliquer sur Activer ou Mettre à jour">
    Valide les paramètres et active la synchronisation.
  </Step>
</Steps>

#### Actions supplémentaires

| Bouton                          | Description                                                 |
| ------------------------------- | ----------------------------------------------------------- |
| **Tester la connexion**         | Vérifie que la connexion au CRM fonctionne                  |
| **Supprimer**                   | Désactive l'intégration. Les données ne sont pas supprimées |
| **Activer** / **Mettre à jour** | Valide et enregistre les paramètres                         |

<Warning>
  Ne fermez pas le formulaire sans cliquer sur "Tester la connexion" en premier.
</Warning>

#### Synchronisation automatique des statuts

Si activée, PEPSiMAD synchronise automatiquement :

* Les statuts des commandes créées dans PEPSiMAD
* Les statuts de retour depuis le CRM vers les commandes PEPSiMAD

Cela permet un suivi en temps quasi-réel des commandes sans intervention manuelle.

#### Tarif Must G5 par défaut

Une fois l'intégration Must G5 activée, un sélecteur **Tarif Must G5 par défaut** apparaît sous le formulaire. Cette option permet de choisir parmi tous les tarifs disponibles dans Must G5 (ex. "Pharmacie Avantage", "Pharmacie Confiance", etc.) celui qui sera appliqué automatiquement lors de la synchronisation Must G5 d'une mercuriale.

<Note>
  Sans ce paramètre, la synchronisation prend arbitrairement le premier prix retourné par Must G5, qui peut ne pas correspondre au tarif applicable à vos clients. Configurez ce tarif une seule fois pour que toutes vos synchronisations futures utilisent le bon prix.
</Note>

Le tarif sélectionné est aussi utilisé comme valeur par défaut sur la page **Comparaison des prix** d'une mercuriale.

***

## Messages de validation

### Succès

* "Configuration enregistrée avec succès."
* "Collaborateur créé. Un email a été envoyé à \[email] avec les identifiants."
* "Connexion au CRM testée avec succès."
* "Opération promotionnelle créée avec succès."

### Erreurs

| Erreur                              | Cause                  | Solution                                                             |
| ----------------------------------- | ---------------------- | -------------------------------------------------------------------- |
| "Le champ \[nom] est obligatoire."  | Champ manquant         | Remplissez le champ avant d'enregistrer                              |
| "Nom d'utilisateur déjà utilisé"    | Identifiant en doublon | Choisissez un autre identifiant                                      |
| "Format d'email invalide"           | Email mal formaté      | Vérifiez le format (ex: [user@example.com](mailto:user@example.com)) |
| "Impossible de se connecter au CRM" | Paramètres invalides   | Vérifiez l'URL, identifiants et code origine                         |
| "Date de fin avant date de début"   | Dates inversées        | Corrigez les dates                                                   |
| "Logo trop volumineux (max 5 MB)"   | Fichier trop gros      | Redimensionnez l'image                                               |

***

## Bonnes pratiques

<Tip>
  **Sauvegardes régulières** : Après une modification importante, vérifiez que toutes les modifications ont bien été enregistrées.
</Tip>

<Tip>
  **Collaborateurs** : Avant de supprimer un collaborateur, assurez-vous que ses clients sont réassignés à un autre pour ne pas perdre la traçabilité.
</Tip>

<Tip>
  **Frais de port** : Testez les frais de port calculés avec un exemple de commande pour valider la grille tarifaire avant activation.
</Tip>

<Tip>
  **Intégration CRM** : Testez systématiquement la connexion avant d'activer la synchronisation automatique.
</Tip>
