# Loxya | Documentation

## Utiliser l'interface de Loxya

<a href="/wiki/usage#usage-terminology" id="usage-terminology" class="wiki__page__link">
    <i class="fas fa-link"></i>
</a>

> **Notes**  
> Cette documentation est à jour avec la **version 1.2** du logiciel.  
> Les [fonctionnalités additionnelles](/premium-features) de la **variante Premium de Loxya** sont indiquées par l'icône <i class="fas fa-crown fa-2x"></i>.

### Terminologie

Voici une description des principaux termes utilisés dans l'interface de Loxya (en Français)&nbsp;:

- **Parc**&nbsp;: Nous appelons "Parc" le lieu qui contient votre matériel. Concrètement, cela peut aussi bien être un grand entrepôt avec une adresse postale précise, qu'un petit placard à balais au fond de la cuisine, ou la cave du voisin.
- **Événement**&nbsp;: C'est le cœur du fonctionnement du logiciel. Un événement est une entité temporelle qui a un titre (nom), une date de début et une de fin, qui contient du matériel en quantités définies, et auquel on peut assigner un ou plusieurs bénéficiaires et techniciens.
- **Réservation** (<i class="fas fa-crown"></i> Premium uniquement)&nbsp;: Comme pour les événements, une réservation a une date de début et de fin, et contient du matériel en quantité définies. En revanche, elle doit obligatoirement avoir un bénéficiaire dès sa création, et n'a pas de titre ni de technicien.
- **Bénéficiaire**&nbsp;: Les personnes (ou structures) qui bénéficient de vos prestations. Donc si vous êtes une entreprise, vos _"clients"_ ; si vous êtes une école ou université, vos _"étudiants"_ ; et si vous êtes une association, vos _"adhérents"_.
- **Technicien**&nbsp;: Les personnes qui peuvent être assignées à des événements pour accompagner le matériel, afin d'y participer sur un poste en particulier (installation, régie, livraison...), durant un temps déterminé sur la période de l'événement.
- **Tag**&nbsp;: Il s'agit d'un terme (un mot ou une petite phrase) permettant de marquer le matériel pour faciliter sa recherche.
- **Unité** (<i class="fas fa-crown"></i> Premium uniquement)&nbsp;: Pour un matériel identifié de manière "unitaire", il s'agit de l'une de ses occurrences réelles. Une unité peut avoir un numéro de série, par exemple. L'ensemble des unités d'un matériel unitaire constitue son stock disponible.
- **Période de mobilisation**&nbsp;: Il s'agit de la période de temps pendant laquelle le matériel est mobilisé pour un événement ou une réservation. Cette période est forcément plus longue que la période d'exploitation (voir ci-dessous), et sert à prévoir la préparation, le transport, l'installation etc. Pendant toute la durée de sa période de mobilisation, le matériel est considéré comme indisponible.
- **Période d'exploitation** ou de **facturation**&nbsp;: C'est la période de temps pendant laquelle le matériel sera effectivement utilisé par le bénéficiaire ou les techniciens. Cette période est utilisée pour calculer le montant de la location à facturer (quand la facturation est activée).
- **Caractéristiques spéciales**&nbsp;: Il s'agit de champs additionnels que l'on peut créer pour ajouter des détails dans le matériel ou les unités de matériel (comme le poids, la taille, la couleur, etc).

<a href="/wiki/usage#usage-roles" id="usage-roles" class="wiki__page__link">
    <i class="fas fa-link"></i>
</a>

### Rôles des utilisateurs

Voici les différents rôles qui existent pour les utilisateurs de l'application&nbsp;:

- **Administration**&nbsp;: Ils ont accès à toutes les fonctions de l'application, sans restriction. Il faut donc faire à attention à qui on octroie ce rôle. Les admins peuvent créer et modifier tous les utilisateurs de l'application (hormis leurs mots de passe).
- **Supervision**&nbsp;: Ce niveau d'accès donne les mêmes droits que l'accès "Administration", sauf celui de gérer les utilisateurs, les parcs de matériel et les paramètres du logiciel. Il permet toutefois de gérer les tags, les catégories et les sous-catégories de matériel.
- **Opération**&nbsp; (anciennement _"gestion"_): Ces utilisateurs n'ont accès qu'aux tâches communes de la _gestion "métier"_ du logiciel, comme par exemple la création et la modification des événements, ainsi que la gestion du matériel, des techniciens et des bénéficiaires. Ils ne peuvent pas créer ou modifier les autres utilisateurs.
- **Consultation du planning général**&nbsp;: Les utilisateurs avec ce rôle, une fois connectés, peuvent consulter le planning (événements et réservations), mais ne peuvent rien créer ni modifier. Ils n'ont accès à rien d'autre.
- **Consultation de son planning**&nbsp;: Avec ce rôle, un utilisateur n'a accès qu'aux événements et réservations qui le concerne lui-même dans le planning. Pour qu'il soit concerné, il faut qu'il soit bénéficiaire de l'événement ou réservation, ou qu'il soit chef de projet, préparateur de commande ou technicien assigné à l'événement.
- **Externe** (<i class="fas fa-crown"></i> Premium)&nbsp;: Il s'agit d'un rôle spécial, qui ne peut être utilisé que dans le cadre de la réservation en ligne, pour associer un bénéficiaire à un compte utilisateur lui permettant d'accéder à la partie "externe" de l'application.

<a href="/wiki/usage#usage-login" id="usage-login" class="wiki__page__link">
    <i class="fas fa-link"></i>
</a>

### Connexion à Loxya

Pour accéder au logiciel, un utilisateur doit s'authentifier sur la page de login, grâce à&nbsp;:

- Son **pseudo**, ou son **adresse e-mail**,
- Son **mot de passe**.

<img src="/img/screens/wiki/login-page.webp" class="display-none--sm" alt="La page de login de Loxya." />

<a href="/wiki/usage#usage-login-password-reset" id="usage-login-password-reset" class="wiki__page__link">
    <i class="fas fa-link"></i>
</a>

#### Réinitialisation du mot de passe

Il est possible de réinitialiser son mot de passe en cliquant sur *"Mot de passe oublié&nbsp;?"*.

Le processus de réinitialisation du mot de passe se déroule ainsi&nbsp;:

1. L'utilisateur renseigne son adresse e-mail.
2. Loxya envoie un e-mail à cette adresse avec un code de vérification. Si le code n'a pas été reçu, il est possible de demander à Loxya de le renvoyer au bout d'une minute.
3. L'utilisateur doit ensuite saisir ce code de vérification, dans les 10 minutes suivant son envoi par Loxya.
4. Si le code est valide, l'utilisateur peut ensuite définir un mot de passe (en l'écrivant deux fois pour confirmation).
5. Une fois terminé, il peut se connecter à Loxya en utilisant son nouveau mot de passe.

**Notes importantes** concernant les **mesures de sécurité** de la réinitialisation de mot de passe&nbsp;:

- Le mot de passe d'un **compte administrateur** ne peut **pas être réinitialisé** via ce moyen. Si vous êtes dans ce cas, il faut [nous contacter](/contact) pour qu'une vérification manuelle soit effectuée, et nous nous occupons de la réinitialisation.
- Loxya ne révèle jamais si l'adresse saisie dans la demande de réinitialisation est bien associée à un **compte existant** ou non ; un message indiquant l'envoi d'un code sera affiché dans tous les cas. **Si vous ne recevez pas l'e-mail de validation**, c'est que l'adresse spécifiée n'existe pas dans Loxya. Vérifiez son orthographe ; si vous êtes sûr(e) de vous, vérifiez si le message n'est pas arrivé dans les spams.

<img src="/img/screens/news/password-reset-step1.webp" class="display-none--sm" alt="La page de réinitialisation du mot de passe de Loxya." />

<a href="/wiki/usage#usage-menus" id="usage-menus" class="wiki__page__link">
    <i class="fas fa-link"></i>
</a>

### Menus et navigation

Une fois connecté, l'interface de Loxya présente se présente ainsi&nbsp;:

- La barre de titre, qui affiche le nom de la page affichée, en haut de l'écran.
- La vue principale, qui affiche le contenu de chaque page, au centre.
- La barre de menu, située à gauche de l'écran, composée de :

<img src="/img/screens/wiki/main-menu-sidebar.png" style="float: left; margin-right: 20px;" class="display-none--sm" alt="Les trois menus de l'interface de Loxya." />

- Le **logo "LOXYA"** situé tout en haut, qui est aussi le <a href="/wiki/usage#usage-menus-park-context-selector">**sélecteur de parc**</a>.
- La <a href="/wiki/usage#usage-menus-quick-search">**recherche rapide**</a>, le bouton "Rechercher" juste en dessous du sélecteur de parc.
- Le <a href="/wiki/usage#usage-menus-main-menu">**menu principal**</a>, avec une partie haute et une partie basse (voir image ci-contre).
- Le <a href="/wiki/usage#usage-menus-user-menu">**menu utilisateur**</a> tout en bas, en cliquant sur le nom de l'utilisateur connecté.
- Le **numéro de la version** actuelle du logiciel.

<a href="/wiki/usage#usage-menus-park-context-selector" id="usage-menus-park-context-selector" class="wiki__page__link">
    <i class="fas fa-link"></i>
</a>

#### Sélecteur de parc

Si vous avez **plusieurs parcs**, et que ceux-ci vous sont accessibles, vous pouvez **contextualiser l'ensemble du logiciel** sur un parc de votre choix.

<img src="/img/screens/wiki/park-context-selector.webp" style="float: right; margin-left: 20px;" class="display-none--sm" alt="Le sélecteur de parc." />

En cliquant sur le sélecteur, vous pourrez choisir un parc dans la liste. Cela aura pour effet de&nbsp;:

- N'afficher que **le matériel de ce parc** dans les **listes** de matériel et les **inventaires**.
- N'afficher que **les événements et réservations** qui contiennent du matériel de ce parc sur le **planning**.
- N'afficher que **les unités de matériel** appartenant au parc sélectionné dans la **liste des unités** d'un matériel.
- N'afficher que **les modèles de liste** qui contiennent au moins un matériel du parc sélectionné.

Quand vous avez choisi un parc, le sélecteur affiche le nom du parc sélectionné, et les pages concernées par cette contextualisation voient leur titre modifié avec la phrase _"pour le parc «&nbsp;[nom du parc]&nbsp;»_.

<p style="text-align: right;">
    <img src="/img/screens/wiki/park-context-selected.webp" class="display-none--sm" alt="Un parc sélectionné dans le sélecteur." />
</p>

Bien entendu, s'il n'existe **qu'un seul parc**, ou que vous n'avez accès qu'à un seul parc, ce sélecteur n'est pas affiché et vous ne voyez que le logo "LOXYA", car toutes vos listes et le planning n'affiche que le matériel auquel vous avez accès.

<a href="/wiki/usage#usage-menus-quick-search" id="usage-menus-quick-search" class="wiki__page__link">
    <i class="fas fa-link"></i>
</a>

#### Recherche / scan rapide (<i class="fas fa-crown"></i> Premium)

Cliquer sur le bouton «&nbsp;Rechercher&nbsp;» situé en haut à gauche de l'écran ouvre une fenêtre contenant un champ de recherche, qui permet de&nbsp;:

- Soit entrer un **nom** de matériel, une **référence** de matériel ou une **référence d'unité** de matériel,
- Soit [**scanner un code-barres**](#usage-material-barcodes) d'un matériel ou d'une unité de matériel.

Quand une recherche est lancée, la liste des résultats apparaît en dessous du champ de recherche&nbsp;:

<img src="/img/screens/wiki/quick-search-results.webp" alt="La fenêtre de recherche rapide avec des résultats." />

Le choix d'un matériel dans cette liste permet d'afficher&nbsp;:

<img src="/img/screens/wiki/quick-search-result-details.webp" style="float: right; margin-left: 20px;" class="display-none--lg" alt="La fenêtre de recherche rapide avec les détails d'un matériel." />

- À droite, la **photo** du matériel et ses **informations** complètes, comme son parc, sa catégorie et sous-catégorie, son prix de remplacement et son tarif de location journalier (si la facturation est activée), ainsi que les valeurs de ses caractéristiques spéciales et les tags qui lui sont associés.  
De plus, est affichée la **quantité restante** au moment où vous consultez cette fiche.
- Si le matériel est identifié de manière unitaire, à gauche se trouve la **liste de ses unités**.  
Sélectionner une unité dans cette liste permet d'afficher les détails de cette unité&nbsp;: son n° de série, son parc et emplacement, son état, sa date d'achat et les valeurs de ses caractéristiques spéciales.
- Si un **inventaire de retour ou de départ** doit être effectué pour ce matériel, une section bleue affiche un bouton permettant d'accéder à cet inventaire. **Si une unité est sélectionnée** au-dessus, seuls les inventaires de départ ou de retour à effectuer *pour cette unité* sont affichés.
- En bas de la fenêtre se trouve la **liste des événements et réservations** dans lesquels le matériel est actuellement sorti, afin de voir rapidement où il se trouve. Si le matériel est identifié de manière unitaire, les références des unités utilisées dans chaque sortie sont spécifiées. **Si une unité est sélectionnée** au-dessus, alors c'est la liste des utilisations actuelles *de l'unité* qui est affichée.

<a href="/wiki/usage#usage-menus-main-menu" id="usage-menus-main-menu" class="wiki__page__link">
    <i class="fas fa-link"></i>
</a>

#### Menu principal

Ce menu, situé à gauche de l'écran, apparaît différemment selon le <a href="#usage-roles">rôle de l'utilisateur</a> connecté au logiciel.
Il se compose des entrées suivantes&nbsp;:

<table>
    <thead>
        <tr>
            <th>Entrée du menu</th>
            <th>Destination</th>
            <th>Visible par le rôle</th>
        </tr>
    </thead>
    <tbody>
        <tr>
            <td><a href="#usage-calendar"><strong>Planning</strong></a></td>
            <td>Le calendrier (frise temporelle), ou le <a href="#usage-listings">listing</a> des événements et réservations.</td>
            <td>Administration, Gestion, Consultation</td>
        </tr>
        <tr>
            <td><a href="#usage-material"><strong>Matériel</strong></a></td>
            <td>Gestion du matériel&nbsp;: <a href="#usage-listings">listing</a> complet, consultation des fiches, ajout et modification, gestion du stock.</td>
            <td>Administration, Gestion</td>
        </tr>
        <tr>
            <td><a href="#usage-technicians"><strong>Techniciens</strong></a></td>
            <td>Gestion des techniciens&nbsp;: <a href="#usage-listings">listing</a> complet, consultation de leurs fiches et plannings, ajout et modification.</td>
            <td>Administration, Gestion</td>
        </tr>
        <tr>
            <td><a href="#usage-beneficiaries"><strong>Bénéficiaires</strong></a></td>
            <td>Gestion des bénéficiaires&nbsp;: <a href="#usage-listings">listing</a> complet, consultation de leurs fiches et historique, ajout et modification.</td>
            <td>Administration, Gestion</td>
        </tr>
        <tr>
            <td>
                <a href="#usage-online-reservations"><strong>Demandes de réservation</strong></a><br />
                <small>(<i class="fas fa-crown"></i> Premium uniquement)</small>
            </td>
            <td>
                Gestion des demandes de réservation, à approuver ou rejeter, et demandes déjà traitées.
            </td>
            <td>Administration, Gestion</td>
        </tr>
        <tr>
            <td><a href="#usage-parks"><strong>Parcs de matériel</strong></a></td>
            <td>Gestion des parcs de matériel&nbsp;: <a href="#usage-listings">listing</a> complet, ajout et modification, et inventaires des parcs.</td>
            <td>Administration</td>
        </tr>
        <tr>
            <td><a href="#usage-users"><strong>Utilisateurs</strong></a></td>
            <td>Gestion des utilisateurs du logiciel.</td>
            <td>Administration</td>
        </tr>
        <tr>
            <td><a href="#usage-settings"><strong>Paramètres</strong></a></td>
            <td>Gestion des paramètres globaux à toute l'application.</td>
            <td>Administration</td>
        </tr>
    </tbody>
</table>

<a href="/wiki/usage#usage-menus-user-menu" id="usage-menus-user-menu" class="wiki__page__link">
    <i class="fas fa-link"></i>
</a>

#### Menu utilisateur

Ce menu est le même pour tous. Il apparaît lorsqu'on clique sur le nom de l'utilisateur connecté en bas à gauche de l'écran.  
Il se compose des entrées suivantes&nbsp;:

- **Vos paramètres**&nbsp;: Permet de modifier les informations personnelles de l'**utilisateur connecté**, ses préférences d'interface (langue, affichage) et de notification. Voir plus de détails dans la section "[Paramètres de l'utilisateur connecté](#usage-user-settings)".
- **Quitter Loxya**&nbsp;: En cliquant sur ce bouton vous serez déconnecté du logiciel, et retournerez sur la [page de connexion](#usage-login).

<a href="/wiki/usage#usage-listings" id="usage-listings" class="wiki__page__link">
    <i class="fas fa-link"></i>
</a>

### Listings

Que ce soit la gestion du **matériel**, des **techniciens**, des **bénéficiaires**  des **demandes de réservation**, des **parcs de matériel**, des **utilisateurs** ou du **planning en liste**, le comportement est identique. En cliquant sur l'entrée correspondante du menu principal, vous verrez un liste de ce qui est sauvegardé dans Loxya.

#### Recherche

Tous les listings disposent d'un champ de recherche en haut de page. En général cette recherche est effectuée sur le _nom_ et la _référence_ des éléments, mais certaines listes peuvent utiliser d'autres critères (comme par exemple l'adresse e-mail). Elle est déclenchée directement quand écrivez dans le champ.

<img src="/img/screens/wiki/search-field.webp" alt="Le champ de recherche d'un listing." />

Dans la variante <i class="fas fa-crown"></i> Premium, il est possible de spécifier **plusieurs termes** de recherche indépendants, par exemple pour obtenir tous les résultats correspondants aux termes «&nbsp;Mon événement spécial&nbsp;» **OU** «&nbsp;Autre événement&nbsp;».

#### Filtres

Certaines listes (comme par exemple celle du matériel) disposent en plus de filtres, situés tout en haut de la page. Ces filtres permettent de n'afficher qu'une partie des enregistrements et de mieux s'y retrouver quand la liste est très longue.

<img src="/img/screens/wiki/filters.webp" alt="Les filtres d'un listing." />

#### Tri

Il est également possible de trier les listes selon certaines colonnes (celles qui ont les petites flèches à droite du nom). En cliquant une première fois, on peut trier de manière ascendante, et la seconde fois cela trie de manière descendante.

<img src="/img/screens/wiki/listing-sort.webp" alt="Le tri selon certaines colonnes d'un listing." />

#### Montrer / cacher des colonnes

Dans les pages contenant une liste sous forme de tableau, le **menu trois-points** situé tout **en haut à droite** de l'écran inclut un bouton **"Configurer les colonnes"**, qui permet de choisir les colonnes à afficher ou non dans la liste. Cela permet d'améliorer l'affichage ou d'avoir plus d'informations, selon le besoin.

<img src="/img/screens/wiki/column-chooser.webp" alt="Le choix des colonnes d'un listing." />

#### Pagination

Les listes sont paginées. C'est à dire que quand il y a plus d'un certain nombre d'éléments (typiquement 100), des boutons en bas de page permettent de passer à la page suivante ou précédente.

<img src="/img/screens/wiki/pagination.webp" alt="Le sélecteur de pages d'un listing." />

#### Actions individuelles

Chaque ligne du listing présente des actions (tout à fait à droite de la ligne). Généralement, sont présents les boutons <i class="fas fa-eye"></i> (pour consulter la fiche des détails de l'entité) et un «&nbsp;**menu trois-points**&nbsp;» qui contient lui-même les boutons «&nbsp;<i class="fas fa-edit"></i> modifier&nbsp;» et «&nbsp;<i class="fas fa-trash color-primary"></i> supprimer&nbsp;». Il peut en exister d'autres, selon l'entité.

<img src="/img/screens/wiki/listing-actions.webp" alt="Les actions en bout de ligne d'un élément de liste." />

#### Opérations générales

Tout en haut à droite de la page d'un listing, se trouvent généralement&nbsp;:

- un **bouton <span class="color-success"><i class="fas fa-plus"></i> Nouveau ...</span>**, permettant de créer un enregistrement.
- des **liens** vers d'autres pages ayant un rapport avec l'entité (comme par exemple «&nbsp;Modèles de liste&nbsp;» dans le listing du matériel).
- des **actions secondaires**, placées dans un «&nbsp;menu trois-points&nbsp;» tout à fait à droite.

#### Corbeille

Dans certains listing, la suppression d'un enregistrement **n'est pas définitive**. Cet enregistrement se retrouve alors dans la «&nbsp;corbeille&nbsp;». Un bouton _«&nbsp;Afficher la corbeille&nbsp;»"_, situé dans le menu «&nbsp;menu trois-points&nbsp;» en haut à droite de la page permet d'afficher les enregistrements supprimés. Quand la liste affiche le contenu de la corbeille, un bouton _«&nbsp;<span class="color-secondary">Afficher les enregistrements non supprimés</span>&nbsp;»_ permet de revenir au listing principal.  
Il est possible de **<span class="color-success">restaurer</span>**, ou **<span class="color-error">supprimer définitivement</span>** un enregistrement en cliquant sur le bouton correspondant de la ligne. Si un enregistrement est supprimé depuis la corbeille, il sera donc _impossible de le restaurer_.

<a href="/wiki/usage#usage-forms" id="usage-forms" class="wiki__page__link">
    <i class="fas fa-link"></i>
</a>

### Formulaires de création / modification

Pour créer un enregistrement, il faut cliquer sur le bouton «&nbsp;<span class="color-success"><i class="fas fa-plus"></i> Nouveau ...</span>&nbsp;» en haut à droite des pages de listing.  
Pour modifier un enregistrement existant, il faut cliquer sur le bouton «&nbsp;<i class="fas fa-edit"></i> Modifier&nbsp;» situé dans le menu trois-points à droite de la ligne dans le listing.

Chacun de ces boutons fera s'afficher le formulaire de l'entité. Le formulaire sera vide pour un nouvel enregistrement, ou bien déjà rempli avec les données de l'enregistrement à modifier.

Bien entendu, chaque entité a son propre formulaire, en fonction de ses données. Mais le fonctionnement reste le même partout&nbsp;: des champs à remplir, et des boutons _«&nbsp;<span class="color-secondary">Sauvegarder</span>&nbsp;»_ et _«&nbsp;Annuler&nbsp;»_ en bas de page.

Si des erreurs de validation surviennent (quand l'utilisateur entre des données non conformes), celles-ci sont affichées en rouge, sous les champs incriminés. Un message rouge est également affiché en haut à droite de la page.

<a href="/wiki/usage#usage-beneficiaries" id="usage-beneficiaries" class="wiki__page__link">
    <i class="fas fa-link"></i>
</a>

### Bénéficiaires

Un bénéficiaire désigne un **emprunteur**, c'est à dire la personne à qui est destiné l'événement ou la réservation, et à qui les devis et la facture seront adressés.

La gestion des bénéficiaires n'est accessible qu'aux utilisateurs ayant les rôles "**administration**", "**supervision**", ou "**opération**".

Seuls le **nom** et le **prénom** du bénéficiaire sont obligatoires pour le créer, mais son **adresse postale** sera utile à l'élaboration des <a href="#usage-billing">devis et factures</a>. Il est aussi possible de lui attribuer une **adresse email**, un **numéro de téléphone**, ainsi que des **notes** ou commentaires utiles à votre gestion.

Un bénéficiaire peut être associé à **une société**&nbsp;: Vous pouvez en choisir une existante dans le sélecteur qui se trouve dans le formulaire de création / modification de bénéficiaire, ou bien en créer une en cliquant sur le lien _Ajouter une nouvelle société_ juste en dessous. Seule la **raison sociale** de la société est obligatoire, mais celle-ci peut aussi avoir une adresse et des notes.

> _Astuce&nbsp;: Si vous souhaitez créer une société qui n'a pas de personne référente, vous pouvez utiliser des tirets (`--`) dans le nom et prénom du bénéficiaire, pour en créer un "faux". C'est une astuce qui permet de contourner le problème, en attendant mieux._

Pour qu'un bénéficiaire puisse effectuer des **demandes de réservation** lui-même directement en ligne (<i class="fas fa-crown"></i> Premium), et si cette fonctionnalité est activée dans les paramètres de l'application, alors on peut créer un utilisateur associé au bénéficiaire en activant le champ _"Permettre la réservation en ligne"_. Ensuite, il suffit de créer l'utilisateur associé comme indiqué dans la section [Réservations en ligne](#usage-online-reservations).

<a href="/wiki/usage#usage-beneficiaries-page" id="usage-beneficiaries-page" class="wiki__page__link">
    <i class="fas fa-link"></i>
</a>

#### Fiche d'un bénéficiaire

En cliquant sur un bénéficiaire dans la liste des bénéficiaires, on peut consulter sa fiche. Cette page comporte 4 onglets&nbsp;:

- **Informations**, qui affiche toutes les données du bénéficiaire, de la société à laquelle il est assigné, ainsi que la liste de ses emprunts en cours ou à venir.
- **Devis & Factures**, qui liste tous les devis et toutes les factures qui ont été émis pour ce bénéficiaire.
- **Emprunts**, affichant la liste de tous les événements et réservations qui lui ont été assignés (passés, présents et futurs).
- **Historique**, qui montre tous les e-mails qui ont été envoyés au bénéficiaires via Loxya (notifications automatiques et messages envoyés manuellement).

<img src="/img/screens/wiki/beneficiary-page.webp" alt="La page d'un bénéficiaire, onglet «&nbsp;Informations&nbsp;»." />

<a href="/wiki/usage#usage-beneficiaries-import" id="usage-beneficiaries-import" class="wiki__page__link">
    <i class="fas fa-link"></i>
</a>

#### Couleur des bénéficiaires (<i class="fas fa-crown"></i> Premium)

Avec la **[variante Premium](/premium-features)**, une couleur peut être assignée à chaque technicien. Cette couleur apparaît ensuite à côté du nom du bénéficiaire partout dans l'application.

Quand le bénéficiaire est assigné à un événement, celui-ci **prend la couleur** du bénéficiaire, sauf si une couleur est spécifiée pour l'événement, auquel cas c'est cette couleur qui est affichée.

#### Import des bénéficiaires en masse depuis un fichier CSV (<i class="fas fa-crown"></i> Premium)

Dans la **[variante Premium](/premium-features#premium-features-inventories)**, il est possible d'**importer des bénéficiaires** en masse, grâce à un fichier CSV.

Pour cela, en tant qu'utilisateur ayant le rôle "administration", rendez-vous sur la page de la liste des bénéficiaires, dans le menu 3-points situé tout en haut à droite de la page.

- Cliquez sur le bouton **"Importer depuis un fichier CSV"**.
- Une fenêtre s'ouvre, vous invitant à y **glisser-déposer** un fichier CSV.
- Ensuite, vous pouvez choisir la **correspondance des colonnes** CSV à utiliser pour chaque champs utiles à la création des bénéficiaires dans le logiciel, puis de **vérifier** que les données résultantes seront bien conformes.
- Une fois l'import terminé, un **récapitulatif** des lignes qui n'ont pas pu être importées s'affiche, avec la raison de l'échec pour chaque ligne.

À noter que pour que l'import fonctionne correctement, le fichier CSV doit être encodé en **UTF-8**, et avoir une (et une seule) **ligne d'en-tête** contenant les noms des colonnes. Les séparateurs "virgule", "point-virgule", "deux-points" et "tabulation" sont acceptés, et les retours à la ligne doivent être au format `\n` ou `\r\n`.

<a href="/wiki/usage#usage-technicians" id="usage-technicians" class="wiki__page__link">
    <i class="fas fa-link"></i>
</a>

### Techniciens

Il s'agit du personnel qui peut être assigné à des postes et des horaires précis lors des événements. Autrement dit, ce sont les personnes qui vont accompagner le matériel lors de sa sortie, pour la livraison, l'installation, l'exploitation, ou toute autre tâche liée au matériel pendant la période de l'événement.

> <i class="fas fa-info-circle"></i> _Note&nbsp;: Si vous n'avez **pas besoin de la gestion des techniciens**, cette fonctionnalité peut être **désactivée** dans les [paramètres du logiciel](/wiki/appendices#appendices-settings), côté serveur. Dans le cas où vous utilisez une instance de Loxya hébergée par nos soins, [contactez-nous](/contact) pour qu'on se charge de modifier ce paramètre._

Les informations obligatoires d'un technicien sont uniquement son **nom et prénom**, mais il est possible renseigner son **adresse postale**, son adresse **e-mail**, son **numéro de téléphone**, et d'écrire des notes à son sujet (pour y mettre d'autres informations comme son numéro de sécurité sociale, par exemple).

<img src="/img/screens/wiki/listing-planning-switch.webp" alt="Le bouton permettant de basculer entre le mode liste et le mode planning." style="float: right; margin: 0 20px;" />

Il est possible de choisir **deux modes d'affichage** pour lister les techniciens, grâce au sélecteur situé tout en haut à droite de la page (voir image ci-contre).

Soit une **liste classique**, affichant les informations principales des techniciens&nbsp;:  
<img src="/img/screens/wiki/technicians-listing.webp" alt="La liste des techniciens." />

Soit une **frise temporelle**, affichant le planning général des techniciens&nbsp;:  
<img src="/img/screens/wiki/technicians-planning.webp" alt="Le planning général des techniciens." />

Pour **assigner les techniciens dans des événements,** rendez-vous dans la documentation expliquant <a href="#usage-events-step3">l'étape 3 de la modification d'événement</a>.

<a href="/wiki/usage#usage-technicians-preparers" id="usage-technicians-preparers" class="wiki__page__link">
    <i class="fas fa-link"></i>
</a>

#### Préparateurs de commande (<i class="fas fa-crown"></i> Premium)

La **[variante Premium](/premium-features)** offre également la possibilité de définir des techniciens **"préparateurs de commande"** des événements, c'est à dire pouvant être assignés comme étant la personne responsable de préparer le matériel d'un événement ou d'une réservation lors de son départ.

Le logiciel envoie un **e-mail de notification** au préparateur de commande d'un événement **la veille** de l'événement ou de la réservation, avec la fiche de sortie en pièce jointe, pour lui rappeler qu'il doit s'occuper de cette sortie de matériel.

<a href="/wiki/usage#usage-technicians-page" id="usage-technicians-page" class="wiki__page__link">
    <i class="fas fa-link"></i>
</a>

#### Fiche d'un technicien

Accessible grâce au bouton <i class="fas fa-eye"></i> dans le listing des techniciens, (ou en cliquant sur son nom), la fiche d'un technicien contient les onglets suivants&nbsp;:

<img src="/img/screens/wiki/technician-informations.webp" alt="La page d'un technicien, onglet «&nbsp;Informations&nbsp;»." />

- **Informations**, affichant les données du technicien comme son nom, prénom, adresse e-mail, numéro de téléphone, liste des rôles, notes, etc. (voir image ci-dessus).
- **Agenda**, permettant de visualiser le **planning du technicien** dans un calendrier mensuel. Dans cet agenda, on peut double-cliquer sur une assignation pour ouvrir la <a href="#usage-bookings-modal">fenêtre de l'événement</a> associé, onglet "Techniciens" ouvert, afin de consulter la liste des autres techniciens qui l'accompagneront, et de vérifier toutes les informations de l'événement.
- **Documents**, pour attacher des fichiers divers au technicien (avec le même fonctionnement que pour les [documents du matériel](#usage-material-documents)).
- **Assignations**, pour afficher l'historique de toutes les assignations du technicien, avec le **nombre total d'heures** de travail. Cette liste et ces totaux peuvent être groupés par poste occupé, ou par événement (voir image ci-dessous). Et comme dans l'agenda, il est possible de consulter les détails de l'événement en double-cliquant dessus.

<img src="/img/screens/wiki/technician-assignations.webp" alt="La page d'un technicien, onglet «&nbsp;Assignations&nbsp;»." />

<a href="/wiki/usage#usage-technicians-user-account" id="usage-technicians-user-account" class="wiki__page__link">
    <i class="fas fa-link"></i>
</a>

#### Accès des techniciens au calendrier (<i class="fas fa-crown"></i> Premium)

Dans la variante Premium il est possible de donner accès au logiciel à un technicien. Pour cela, il suffit d'ouvrir la page de **modification ou de création** d'un technicien (en tant qu'utilisateur _ayant le rôle «&nbsp;Administration&nbsp;»_), et d'activer le paramètre **«&nbsp;Peut accéder au planning&nbsp;?&nbsp;»** situé tout en bas du formulaire.

Ensuite, il est possible de choisir de&nbsp;:

- soit **créer un utilisateur** pour ce technicien, en lui donnant un pseudo, une adresse e-mail et un mot de passe,
- soit **lier un utilisateur existant** à ce technicien, en recherchant un nom ou une adresse e-mail.

Une fois que le compte utilisateur du technicien existe, celui-ci peut se connecter au logiciel, avec le niveau d'accès que vous lui avez fourni.

<a href="/wiki/usage#usage-material" id="usage-material" class="wiki__page__link">
    <i class="fas fa-link"></i>
</a>

### Le matériel

Les données obligatoires qui définissent le _matériel_ sont les suivantes&nbsp;:

- Un **nom**&nbsp;: C'est ce qui sera visible partout dans l'application, et sur les devis et factures. Il faut choisir un nom compréhensible et assez concis de préférence. Sa taille maximum est de 191 caractères.
- Une **référence**&nbsp;: C'est ce qui permettra d'identifier le matériel précisément par l'application. La référence doit être unique&nbsp;: un matériel ne peut pas avoir la même référence qu'un autre. Il vaut donc créer des références les plus courtes et simples possibles, en utilisant des lettres et des chiffres, sans ponctuation.
- Un **parc**&nbsp;: Il s'agit du parc de matériel auquel il appartiendra. Il suffit de choisir celui qui convient dans la liste des [parcs](#usage-terminology).  
*Note&nbsp;: Pour pouvoir créer ou modifier un parc, il faut avoir le rôle "administration".*
- Un **tarif de location**&nbsp;: Le prix à appliquer par unité de location (typiquement, par jour donc). Ce tarif peut être égal à 0, par exemple dans le cas d'un prêt, ou encore s'il s'agit d'un petit accessoire que vous ne voulez pas facturer.  
*Note&nbsp;: Cette information n'est à renseigner que si le mode "facturation" est activé. En mode "prêt", pas besoin de tarif de location.*
- Une **Quantité en stock**&nbsp;: Il s'agit de la quantité exacte de ce matériel que vous détenez dans le parc. Il est important de tenir ce nombre à jour afin qu'il reflète au mieux la réalité de votre stock. Ne tenez pas compte du matériel en panne, cela est fait dans un autre champ (voir ci-dessous).

> <i class="fas fa-crown fa-2x"></i> Dans la **[variante Premium](/premium-features#premium-features-material-units)**, il est possible d'identifier le matériel avec des **unités** précises.

> Pour cela, il suffit de mettre le champ **"Identification unitaire"** sur **"oui"** dans le formulaire d'ajout / modification du matériel. Cela fait disparaître le choix du **parc** pour le matériel, car cette information fera partie des unités que vous allez créer&nbsp;: chaque unité pourra faire partie d'un parc différent, si besoin. De même, les champs **quantité stock** et **quantité en panne** disparaissent, car celles-ci seront calculées automatiquement en fonction des unités.  
> Pour en savoir plus, voir la section "<a href="#usage-material-units">Unités de matériel</a>" plus bas.

Les informations facultatives du matériel sont les suivantes&nbsp;:

- Une **catégorie**&nbsp;: Cette information permettra à la fois de vous aider à filtrer le matériel dans les listings, mais aussi à catégoriser le matériel dans les [récapitulatifs des événements](#usage-events), les devis et les factures.
- Une **sous-catégorie**&nbsp;: En complément de la catégorie (voir ci-dessus), la sous-catégorie permet d'affiner les recherches dans les listings.
- Une **description**&nbsp;: Un champ de texte libre, qui vous permet d'ajouter tous les détails (technique ou non) qui vous semblent importants à propos du matériel.
- Un **emplacement** dans le parc qui a été sélectionné (voir ci-dessus). Il s'agit de l'endroit précis où est stocké le matériel au sein du parc. Voir la section des [emplacements dans les parcs](#usage-parks-locations) <em>(<i class="fas fa-crown"></i> Premium uniquement)</em>.
- Un **prix de remplacement**&nbsp;: Ce tarif est celui qui servira à calculer le montant du _chèque de caution_, si vous voulez en demander un à vos bénéficiaires pour vos événements.
- Une **quantité en panne**&nbsp;: En complément à la _quantité en stock_, ce champ permet de savoir combien de ce matériel est en panne. Il sert aussi à calculer le _matériel manquant_ dans le récapitulatif d'un événement. En espérant que vous en ayez le moins possible&nbsp;!
- Des **notes**&nbsp;: Ici vous pouvez ajouter d'autres détails, concernant la vie du matériel par exemple (ses mises à jour, modifications), son utilisation (précautions d'emploi), etc.

Puis, des informations de **facturation** (visibles uniquement si l'application est en mode *"Location"*, ou *"Location et prêt"*)&nbsp;:

- Un interrupteur **"Remisable&nbsp;?"** permettant de définir si le matériel peut accepter un taux de remise ou non à [l'étape «&nbsp;facturation&nbsp;»](#usage-events-step5) des événements et réservations.
- Un interrupteur **"Caché sur la facture&nbsp;?"**&nbsp;: Si *"Oui"*, permet de ne pas montrer certains matériels sur les factures (consommables, accessoires communs, outils...). Pour que ceci puisse être activé, il faut impérativement que le tarif de location du matériel soit égal à 0.
- Le choix de la **taxe** à appliquer au matériel. Voir la section [paramètres des taxes](#usage-settings-billing-taxes) pour plus d'informations.
- Le choix du **coefficient** (grille de **tarif dégressif**) à appliquer au matériel. Voir la section [paramètres des coefficients](#usage-settings-billing-degressive-rates) pour plus d'informations.

Si les **[demandes de réservation en ligne](#usage-online-reservations)** sont activées <em>(<i class="fas fa-crown"></i> Premium uniquement)</em>, le matériel dispose des informations supplémentaires suivantes&nbsp;:

- Un interrupteur **"Permettre la réservation en ligne&nbsp;?"** qui permet de choisir si le matériel peut être réservé directement par les bénéficiaires, ou s'il est réservé à une utilisation par les gestionnaires.
- Un sélecteur permettant de **choisir les membres approbateurs** de ce matériel, parmi les utilisateurs au niveau "opération" (voir la section "[Gestion des utilisateurs pouvant approuver ou rejeter les demandes de réservation](#usage-online-reservations-approvers)"). Ce sélecteur est visible uniquement par les administrateurs et les superviseurs.

Enfin, si des **[caractéristiques spéciales](#usage-material-attributes)** existent avec la portée «&nbsp;matériel&nbsp;» accessibles à la catégorie du matériel, des **champs additionnels** sont affichés pour chacune de ces caractéristiques.

<a href="/wiki/usage#usage-material-page" id="usage-material-page" class="wiki__page__link">
    <i class="fas fa-link"></i>
</a>

#### Fiche d'un matériel

En cliquant sur un matériel dans la liste du matériel (ou sur le bouton <i class="fas fa-eye"></i> en bout de ligne), une page s'ouvre contenant 4 onglets&nbsp;:

- **Informations**&nbsp;: sont affichées toutes les caractéristiques du matériel, ainsi que sa photo et la quantité disponible actuellement.
- **Unités** (<i class="fas fa-crown"></i>)&nbsp;: cet onglet n'est affiché que si le matériel est identifié de manière «&nbsp;unitaire&nbsp;» (voir ci-dessus). Il contient la liste des unités associées au matériel, qui constituent ainsi son stock.
- **Documents**&nbsp;: dans cet onglet, on peut stocker et consulter tous types de documents que l'on veut associer au matériel.
- **Périodes de réservation** (<i class="fas fa-crown"></i>)&nbsp;: sont listées toutes les sorties (événements et réservations) passées, actuelles et futures de ce matériel.

<img src="/img/screens/wiki/material-page.webp" alt="Contenu de l'onglet « informations » de la page d'une fiche de matériel." />

<a href="/wiki/usage#usage-material-exports" id="usage-material-exports" class="wiki__page__link">
    <i class="fas fa-link"></i>
</a>

#### Export d'une liste de matériel (<i class="fas fa-crown"></i> Premium)

La liste du matériel peut être exportée grâce aux boutons _"Imprimer la liste complète du matériel (PDF)"_ et _"Exporter la liste complète du matériel (CSV)"_, situés dans le menu trois-points tout en haut de la liste du matériel, de deux manière&nbsp;:

- Au **format PDF**, présentée sous la forme d'un tableau trié par sous-catégories, incluant la référence, le nom, la valeur de remplacement, la quantité en stock de chaque matériel. La liste des unités du matériel identifié unitairement est également visible dans la colonne "désignation" du matériel. Une colonne vide "Quantité recomptée" tout à droite du tableau permet d'écrire une quantité au stylo si besoin.
- Au **format CSV**, pour pouvoir ouvrir la liste dans un logiciel de tableur comme Excel ou LibreOffice Calc. Toutes les données disponibles du matériel sont incluses, y compris les valeurs des caractéristiques spéciales. Pour le matériel unitaire, chaque unité est affichée dans une ligne supplémentaire sous la ligne du matériel lui-même.

> Note&nbsp;: en activant le paramètre `exports.materials.advanced` du [fichier de configuration](/wiki/appendices#appendices-settings), certaines informations additionnelles, comme le contenu des codes-barres par exemple, peuvent être incluses dans le fichier. Si vous disposez d'une instance hébergée par nos soins, [contactez-nous](/contact) pour activer ce mode.

Ces exports peuvent également être **séparés par parc**, grâce aux boutons _"Imprimer la liste de ce parc"_ et _"Exporter la liste de ce parc"_ situés dans le menu trois-points de chaque parc dans la [liste des parcs](#usage-parks).

<a href="/wiki/usage#usage-material-units" id="usage-material-units" class="wiki__page__link">
    <i class="fas fa-link"></i>
</a>

### Unités de matériel <small>(<i class="fas fa-crown"></i> Premium)</small>

Quand l'option _"identification unitaire"_ d'un <a href="#usage-material">matériel</a> est activée, un nouvel **onglet "Unités"** apparaît dans la page du matériel (la page accessible via le bouton <i class="fas fa-eye"></i> du listing matériel). Dans cet onglet, on trouve un listing des unités du matériel.

<img src="/img/screens/wiki/material-units-list.webp" alt="Contenu de l'onglet « unités » de la page d'une fiche de matériel." />

 En bout de ligne, un bouton <i class="fa fa-barcode"></i> (code-barres) permet de télécharger le code-barres de l'unité, et un menu _"trois point"_ révèle les boutons permettant de <i class="fa fa-edit"></i> (modifier) et <i class="fa fa-trash"></i> (supprimer) l'unité.

En cliquant sur une ligne de cette liste (ou sur le bouton <i class="fa fa-eye"></i>), une petite fenêtre s'ouvre avec les **détails de l'unité**.

<img src="/img/screens/wiki/unit-details-modal.webp" alt="La fenêtre de détails d'une unité de matériel." />

Une unité de matériel comporte les informations minimales suivantes&nbsp;:

- Une **référence.** Il s'agit d'un _identifiant unique_, permettant de nommer l'unité.
- Un **parc** auquel l'unité appartient, à choisir dans la liste des [parcs](#usage-parks).

À cela, s'ajoutent les informations facultatives suivantes&nbsp;:

- L'**emplacement** de l'unité dans le parc qui a été sélectionné (voir ci-dessus). Il s'agit de l'endroit précis où est stocké l'unité au sein du parc. Voir la section des [emplacements dans les parcs](#usage-parks-locations).
- Le **propriétaire** de l'unité. Il doit s'agir d'une personne existante dans l'application (un utilisateur, un technicien ou même un bénéficiaire).
- Un **numéro de série** (champ de texte libre)
- Si l'unité est **en panne** (bouton oui&nbsp;/&nbsp;non)&nbsp;: cela sert au calcul de la disponibilité
- Si l'unité est **perdue** (bouton oui&nbsp;/&nbsp;non)&nbsp;: cela sert aussi au calcul de la disponibilité
- Son **état**&nbsp;: pour savoir si l'unité est neuve, en excellent état, utilisée, obsolète ou en mauvais état
- La **date d'achat** de l'unité
- Des **notes** et commentaires associés à l'unité.

De plus, si des **[caractéristiques spéciales](#usage-material-attributes)** existent avec la portée «&nbsp;unités de matériel&nbsp;», accessible à la catégorie du matériel de l'unité, des **champs additionnels** sont affichés pour chacune de ces caractéristiques.

Ces informations sont affichées dans l'onglet **"Informations"** de la fenêtre de détails de l'unité.

Un deuxième onglet **"Utilisations"** permet de consulter la **liste des événements et réservations** dans lesquels l'unité de matériel est, a été, ou sera utilisée. En cliquant sur une ligne de cette liste, on peut consulter les détails de l'événement ou de la réservation dans laquelle l'unité est utilisée. 

<a href="/wiki/usage#usage-material-attributes" id="usage-material-attributes" class="wiki__page__link">
    <i class="fas fa-link"></i>
</a>

### Caractéristiques spéciales du matériel

Vous avez la possibilité d'ajouter des **caractéristiques spéciales** au matériel, qui seront spécifiques à **votre** utilisation du logiciel.

Pour ouvrir la page de gestion de ces caractéristiques, cliquer sur le bouton _«&nbsp;Gérer les caractéristiques spéciales&nbsp;»_ situé dans le menu trois-points qui se trouve en haut à droite de la page du listing du matériel. Dans cette page, vous avez la possibilité d'ajouter autant de caractéristiques que vous le souhaitez. Une caractéristique est composée de&nbsp;:

- Un **nom,** qui doit décrire précisément et de manière concise l'attribut du matériel à utiliser. On peut écrire _"Poids"_, _"Hauteur"_ ou encore _"Puissance"_ par exemple. Ce nom doit rester assez court pour une meilleure visibilité.
- La **portée** de la caractéristique. Choisissez si la caractéristique doit être **spécifique au matériel**, aux **unités de matériel**, ou utilisable **dans les deux** (le matériel et les unités de matériel). En effet, certaines caractéristiques peuvent n'avoir du sens que pour les unités (par exemple, une date de maintenance, une couleur...), alors que d'autres caractéristiques sont liées au modèle du matériel lui-même (comme un poids ou une puissance, par exemple).
- Le **type de donnée** que représente cette caractéristique. Vous avez le choix entre du **texte**, un **text multi-lignes**, un **nombre entier**, un **nombre décimal**, une **date,** ou un **booléen** (c'est à dire une valeur oui/non).
- Une **unité** de mesure, pour les données de type numérique uniquement (c'est à dire _"nombre entier"_ ou _"nombre décimal"_). L'unité doit être une abréviation très courte, comme par exemple _kg_, _cm_, _W_, _°C_, ou encore _W/m²_.
- La rendre **totalisable** (uniquement pour données numériques, du type _"nombre entier"_ ou _"nombre décimal"_)&nbsp;: quand ce paramètre est sur _"Oui"_, le **total de la caractéristique** est affiché dans un tableau situé en bas de la liste du matériel sur les **fiches de sorties**.
- Une **taille maximum**, pour les données du type _"texte"_ uniquement, afin de limiter le nombre de caractères pouvant être utilisés.
- Les **catégories** de matériel pour lesquelles cette caractéristique sera utilisable. En effet, certaines caractéristiques n'ont du sens que dans certaines catégories de matériel (par exemple, une _puissance_ n'est pas utile pour du mobilier). Si vous ne choisissez **aucune catégorie**, la caractéristique sera alors disponible dans **toutes les catégories**.

<img src="/img/screens/wiki/attribute-edit.webp" alt="Les champs de création d'une caractéristique spéciale." /> 

N'oubliez pas de cliquer sur le bouton _"<span class="color-secondary">Sauvegarder</span>"_ en bas de page, sinon la caractéristique sera perdue.  
Aussi, attention à bien **vérifier le type de donnée** choisi pour la caractéristique avant de sauvegarder, car ensuite il **ne sera plus modifiable**&nbsp;!

Chaque caractéristique spéciale ajoutée pour le matériel et les unités de matériel provoquera l'**ajout d'un champ dans le formulaire** de création/modification du matériel ou de l'unité de matériel. Si une valeur est spécifiée pour l'un de ces champs de caractéristique spéciale, alors celle-ci sera également **visible dans la fiche** du matériel ou de l'unité de matériel, ainsi que dans la fenêtre de résultat d'une recherche rapide de matériel.

<a href="/wiki/usage#usage-material-documents" id="usage-material-documents" class="wiki__page__link">
    <i class="fas fa-link"></i>
</a>

### Documents attachés au matériel

Dans l'onglet **"Documents"** de la fiche d'un matériel, vous pouvez attacher des fichiers divers, comme un manuel d'utilisation, une certification de conformité, des photos additionnelles, et tout autres données qui ont du sens pour le suivi du matériel.

<img src="/img/screens/wiki/material-documents.webp" alt="Contenu de l'onglet « documents » de la page d'une fiche de matériel." />

À gauche de cette page se trouve la **liste des fichiers** qui ont déjà été envoyés, et à droite une **zone** vous permettant de **glisser-déposer** des nouveaux fichiers. Les fichiers déposés dans cette zone sont immédiatement envoyés. Une barre de progression vous permet de suivre l'envoi de chaque fichier. Une fois qu'il a été bien réceptionné, il s'affiche dans la partie de droite, dans la liste des fichiers attachés au matériel.

La **taille maximum** d'un fichier est de **25 Mo**, et les **formats de fichier autorisés** sont les suivants&nbsp;: `.pdf`, `.zip`, `.rar`, `.jpg`, `.png`, `.webp`, `.txt`, `.csv`, `.ods`, `.xls`, `.xlsx`, `.odt`, `.doc` et `.docx`.

<a href="/wiki/usage#usage-material-tracking" id="usage-material-tracking" class="wiki__page__link">
    <i class="fas fa-link"></i>
</a>

### Consulter les indisponibilités du matériel <small>(<i class="fas fa-crown"></i> Premium)</small>

Dans la variante Premium, un onglet **"Périodes de réservation"** est présent dans la fiche de chaque matériel.

<img src="/img/screens/wiki/material-availabilities.webp" alt="Contenu de l'onglet « périodes de réservation » de la page d'une fiche de matériel." />

Cet onglet affiche une **liste des événements et réservations** sur lesquels le matériel a été réservé, ainsi qu'une frise temporelle permettant de resituer ces événement dans le temps. Cela permet d'avoir une vue d'ensemble de l'utilisation du matériel.

En **cliquant** sur un événement de la liste, la frise temporelle se déplace automatiquement sur l'événement. Et en cliquant sur un événement de la frise temporelle, la liste défile automatiquement pour afficher l'événement.

En **double-cliquant** sur un événement sur la frise temporelle, ou en utilisant le bouton "ouvrir" dans la liste, vous pouvez ouvrir la <a href="#usage-bookings-modal">fenêtre de cet événement</a> (voir plus bas) pour en connaître tous les détails.

> **Note**&nbsp;: pour consulter les utilisations d'une **unité particulière** de ce matériel (s'il est identifié de manière unitaire), il suffit d'ouvrir la fenêtre de détails de cette unités. Voir la section **[unités de matériel](#usage-material-units)**.

<a href="/wiki/usage#usage-material-barcodes" id="usage-material-barcodes" class="wiki__page__link">
    <i class="fas fa-link"></i>
</a>

### Les codes-barres du matériel <small>(<i class="fas fa-crown"></i> Premium)</small>

Il possible de générer un code-barres pour chaque **matériel** et chaque **unité de matériel**. Ce code-barres pourra ensuite être imprimé puis collé sur le matériel lui-même, afin d'être scanné avec une douchette pour l'ajouter rapidement dans les **événements**, les **inventaires**, et les **modèles de liste** de matériel.

<img src="/img/screens/wiki/material-barcode.webp" style="float: right; margin-left: 20px;" class="display-none--sm" alt="Exemple de code-barres d'un matériel." />

Ces codes-barres sont de type **2D**, au format **PDF417** (voir exemple ci-contre).

Pour générer et télécharger le code-barres, il suffit d'utiliser le bouton <i class="fas fa-barcode"></i> <em>("Télécharger le code-barres")</em> situé&nbsp;:

- Pour un **matériel**&nbsp;: en haut à droite de la page d'un [matériel](#usage-material), à côté du bouton "modifier".
- Pour une **unité de matériel**&nbsp;: à droite de chaque ligne de la [liste des unités](#usage-material-units).

Sur une page d'inventaire ou de liste de matériel, **l'action effectuée** lors du scan d'un code-barres est la suivante&nbsp;:

- Pour un **matériel**&nbsp;: ajoute **1** à la quantité du matériel scanné.
- Pour une **unité de matériel**&nbsp;: ajoute ou coche l'unité dans la liste.

Il est également possible de scanner un code-barres dans la fenêtre de [**recherche / scan rapide**](#usage-menus-quick-search) pour trouver rapidement un matériel et afficher toutes les informations qui le concernent.

<a href="/wiki/usage#usage-calendar" id="usage-calendar" class="wiki__page__link">
    <i class="fas fa-link"></i>
</a>

### Le planning sous forme de calendrier

<img src="/img/screens/wiki/planning-timeline.webp" alt="Le planning sour forme de frise temporelle." />

Cette vue affiche les événements sur une frise temporelle (_timeline_), de manière à voir tout ce qu'il se passe, d'un seul coup d'œil.

- Les événements <strong class="color-primary"> _en couleur_ </strong> sont ceux qui sont **futurs** ou **en cours**.
- Quand ils ont des _bandes diagonales mouvantes_, c'est qu'ils sont **en cours**.
- Si le logiciel est configuré avec une politique des [retours manuels](#usage-return-policy), la couleur devient <strong style="color: #be1111ff"> _rouge_ </strong> quand l'inventaire de retour n'est pas encore effectué (retard).
- Quand ils sont _semi-transparents_, c'est qu'ils ne sont **pas confirmés**.
- Les événements <strong class="color-medium"> _en gris clair_ </strong> sont ceux qui sont **passés**.
- Les événements <strong class="color-dark"> _en gris foncé_ </strong> sont ceux qui sont **archivés**.

Signification des icônes&nbsp;:

- <i class="fas fa-question color-medium"></i>&nbsp;: Cet événement est **en attente de confirmation**.
- <i class="fas fa-check color-medium"></i>&nbsp;: Cet événement est **confirmé**.
- <i class="fas fa-clock color-medium"></i>&nbsp;: L'**inventaire de retour** de cet événement passé n'a pas encore été effectué.
- <i class="fas fa-box color-medium"></i>&nbsp;: Cet événement est **archivé**.
- <i class="fas fa-exclamation-triangle" style="color: #fd423f;"></i>&nbsp;: Sur un événement _futur_&nbsp;: il **manque du matériel** (excédent ou pénurie).
- <i class="fas fa-exclamation-triangle" style="color: #fd423f;"></i>&nbsp;: Sur un événement _passé_&nbsp;: du matériel a été marqué comme **non retourné** dans l'inventaire de retour, ou que cet inventaire n'a pas encore été effectué (en mode strict).

#### Manipulation de la frise temporelle

Avec la souris, vous avez la possibilité de&nbsp;:

- **Cliquer-glisser** pour déplacer la vue à **gauche** (vers le passé) ou à **droite** (vers l'avenir).
- **Scroller** avec la molette de la souris (ou deux doigts sur un pavé tactile), pour **zoomer** / **dézoomer**.
- **Double-cliquer** sur la frise (en dehors d'un événement) pour déclencher la **création** d'un événement à la date sous la souris.
- **Double-cliquer** sur un événement pour ouvrir la <a href="#usage-bookings-modal">**fenêtre d'un événement**</a> ou d'une réservation, qui affiche tous ses détails, et permet d'effectuer d'autres actions sur cet événement.
- **Survoler** un événement pour en afficher les détails sans ouvrir la fenêtre.

En haut de page, vous avez la possibilité de&nbsp;:

- **Placer** le centre de la frise temporelle sur une **date précise** en changeant la date dans le champ à gauche.
- **Centrer** la frise sur le jour courant d'un seul clic, grâce au bouton "<span class="color-secondary">Centrer sur aujourd'hui</span>".
- **Rafraîchir** les événements affichés, si vous voulez vous assurer que la frise affiche bien les données actualisées avec le bouton "<span class="color-secondary">Rafraîchir les données</span>".
- **Effectuer une recherche** sur le titre ou le lieu d'un événement, la référence d'une réservation, le nom ou l'adresse e-mail d'un bénéficiaire, d'un chef de projet ou d'un utilisateur ayant créé l'événement ou approuvé la réservation.
- **Filtrer** les événements pour n'afficher que ceux qui&nbsp;:
  - utilisent du matériel provenant d'un **parc** en particulier (si vous avez plusieurs parcs).
  - utilisent du matériel provenant d'une **catégorie** en particulier.
  - ont un **manque de matériel** (donc uniquement les événements futurs ou en cours).

Pour afficher les détails d'un événement, il faut d'abord **double-cliquer** dessus dans la frise temporelle. Une fenêtre apparaît au centre de la page, affichant toutes ses informations et permettant diverses manipulations (voir ci-dessous, [fenêtre d'un événement / réservation](#usage-bookings-modal)).

<a href="/wiki/usage#usage-planning-list" id="usage-planning-list" class="wiki__page__link">
    <i class="fas fa-link"></i>
</a>

### Le planning sous forme de liste

<img src="/img/screens/wiki/planning-list.webp" alt="Le planning sour forme de liste." />

Les événements et réservations peuvent être affichés dans une liste. Pour cela, il suffit de cliquer sur le bouton "Liste" situé en haut à droite du calendrier.

Cette liste est **triée par date de début décroissante**&nbsp;: les éléments qui commencent le plus tard sont affichés en haut de la liste, et les plus anciens en bas.

Un **champ de recherche** permet rechercher un **titre** ou un **lieu** d'événement, la **référence d'une réservation**, le nom ou l'adresse e-mail d'un **bénéficiaire**, d'un **chef de projet** ou d'un utilisateur ayant **créé** l'événement ou **approuvé** la demande réservation.

Un **filtre** permet de n'afficher que les éléments qui&nbsp;:

- se terminent aujourd'hui,
- ne sont pas confirmés (événements uniquement),
- n'ont pas encore d'inventaire de retour,
- sont archivés.

En cliquant sur le nom d'un élément de la liste, on peut ouvrir la <a href="#usage-bookings-modal">fenêtre d'un événement</a> ou d'une réservation, qui affiche tous ses détails, et permet d'effectuer d'autres actions sur cet événement.

<a href="/wiki/usage#usage-bookings-modal" id="usage-bookings-modal" class="wiki__page__link">
    <i class="fas fa-link"></i>
</a>

### Fenêtre d'un événement (ou d'une réservation)

Pour ouvrir la fenêtre d'un emprunt (événement, ou  <i class="fas fa-crown"></i> réservation), il suffit de&nbsp;:

- **Double-cliquer** sur un événement ou une réservation de la [frise temporelle](#usage-calendar) principale.
- **Cliquer** sur le bouton "<i class="fas fa-eye"></i>" d'une ligne d'événement ou de réservation, dans les listes&nbsp;:
  - [planning sous forme de liste](#usage-planning-list),
  - [périodes de réservation](#usage-material-tracking) d'un matériel,
  - [utilisations](#usage-material-units) d'une unité de matériel.
  - [emprunts](#usage-beneficiaries) d'un bénéficiaire.
  - [assignations](#usage-technicians) d'un technicien.

<img src="/img/screens/wiki/event-window.webp" alt="La fenêtre d'un événement." />

En haut de cette fenêtre, nous trouvons les **dates de début et de fin** de l'événement ou de la réservation, le **titre** de l'événement (ou, pour une réservation, le nom du bénéficiaire et la date à laquelle elle a été effectuée), ainsi que des boutons permettant d'effectuer les actions courantes.

#### Actions disponibles

Pour les **événements et les réservations**&nbsp;:

- Télécharger la **fiche de sortie** au format PDF (ou copier son **URL publique** <i class="fas fa-crown"></i>).
- **Modifier** l'événement ou la <i class="fas fa-crown"></i> réservation (possible tant que l'inventaire de retour n'est pas terminé).
- Effectuer l'inventaire de **départ** (possible dès 24 heures avant le début), et de le consulter.
- Effectuer l'inventaire de **retour** (possible dès 24 heures avant la fin), et de le consulter.
- **Archiver** l'événement ou la réservation (possible quand son inventaire de retour est terminé).
- **Supprimer** l'événement ou la réservation.
- **Envoyer la liste du matériel** (<i class="fas fa-crown"></i>) par e-mail au(x) **bénéficiaire(s)** (si leurs adresses e-mail sont renseignées).

Pour les **événements** uniquement&nbsp;:

- **Confirmer** l'événement (ou le remettre "en attente").
- **Dupliquer** l'événement.
- Créer un **modèle de liste** (<i class="fas fa-crown"></i>) à partir du matériel de l'événement.
- **Envoyer la fiche de sortie** (<i class="fas fa-crown"></i>) par e-mail en PDF aux **techniciens** assignés à l'événement.

À l'intérieur de la fenêtre, se trouvent les onglets suivants&nbsp;:

<a href="/wiki/usage#usage-bookings-modal-infos" id="usage-bookings-modal-infos" class="wiki__page__link">
    <i class="fas fa-link"></i>
</a>

#### Onglet informations

Cet onglet contient toutes les informations de base de l'événement ou de la réservation.

- le nom et coordonnées du (des) **bénéficiaire(s)**.
- le **lieu** de l'événement (cliquer sur le lieu ouvre une recherche <a href="https://www.google.com/maps" target="_blank" rel="nofollow noreferrer">Google Maps <i class="fas fa-external-link-alt"></i></a>).
- ses **techniciens** (cliquer sur un nom ouvre la fiche du technicien).
- le nom de **l'utilisateur** qui a créé l'événement.
- l'éventuel **chef de projet** assigné à l'événement.
- l'éventuel **préparateur de commande** (<i class="fas fa-crown"></i>) assigné à l'événement (cliquer sur son nom ouvre sa fiche technicien).
- la **description** de l'événement.
- une phrase qui indique si l'événement est **confirmé ou non**.
- si une demande existe pour la réservation ou l'événement&nbsp;:
    - la **référence** et la **date de la demande**,
    - les noms des **utilisateurs** qui ont **approuvé** la demande.

En bas de page sont affichés le **nombre total d'articles**, la **durée en jours**, et la **valeur de remplacement** totale.

Si la facturation est activée, sont également affichés les **montants totaux** de location.

<a href="/wiki/usage#usage-bookings-modal-technicians" id="usage-bookings-modal-technicians" class="wiki__page__link">
    <i class="fas fa-link"></i>
</a>

#### Onglet techniciens

Une frise temporelle montre les **plages horaires** et les **postes** assignés aux techniciens, sur toute la durée de l'événement.

_**Note**&nbsp;: cet onglet n'est pas disponible dans la fenêtre d'une réservation (qui ne peut pas avoir de technicien)._

<a href="/wiki/usage#usage-bookings-modal-materials" id="usage-bookings-modal-materials" class="wiki__page__link">
    <i class="fas fa-link"></i>
</a>

#### Onglet matériel

Affiche la **liste complète du matériel** qui est attribué à l'événement ou réservation.

Cette liste est triée par **catégories**, et contient les **quantités** assignées, ainsi que les **prix** et les **sous-totaux** par catégories si le mode de facturation le permet.

Au dessus de la liste, est éventuellement affiché&nbsp;:

- la **liste et les quantités manquantes**, s'il manque du matériel pour la période de l'événement.
- le **récapitulatif de l'inventaire de retour**, si celui-ci est terminé.

<a href="/wiki/usage#usage-bookings-modal-estimates" id="usage-bookings-modal-estimates" class="wiki__page__link">
    <i class="fas fa-link"></i>
</a>

#### Onglet devis

C'est ici que l'on peut **générer** et **télécharger des devis** pour l'événement, en spécifiant éventuellement une remise (voir plus bas, partie [devis et factures](#usage-billing)).

_**Note**&nbsp;: cet onglet n'est disponible que pour les [modes de facturation](#usage-billing) "location" et "location et prêt"._

<a href="/wiki/usage#usage-bookings-modal-invoices" id="usage-bookings-modal-invoices" class="wiki__page__link">
    <i class="fas fa-link"></i>
</a>

#### Onglet factures

Comme pour les devis, il permet de **générer** et **télécharger la facture** de l'événement ou la réservation, en spécifiant éventuellement une remise (voir plus bas, partie [devis et factures](#usage-billing)).

_**Note**&nbsp;: cet onglet n'est disponible que pour les [modes de facturation](#usage-billing) "location" et "location et prêt"._

<a href="/wiki/usage#usage-bookings-modal-documents" id="usage-bookings-modal-documents" class="wiki__page__link">
    <i class="fas fa-link"></i>
</a>

#### Onglet documents

Dans cet onglet, vous pouvez **attacher des fichiers** de toutes sortes à l'événement ou à la réservation.

Le fonctionnement est similaire à celui des [documents du matériel](#usage-material-documents), sauf que la zone d'envoi des fichiers est située en haut de la liste.

<a href="/wiki/usage#usage-bookings-modal-notes" id="usage-bookings-modal-notes" class="wiki__page__link">
    <i class="fas fa-link"></i>
</a>

#### Onglet notes

Ici, vous pouvez écrire du **texte libre**, pour ajouter toute sorte d'informations à votre événement, comme par exemple les détails d'accès au lieu de livraison, une note interne concernant un matériel, etc.

À noter que ces notes ne **sont visibles que dans cet onglet**&nbsp;! C'est idéal pour noter des informations privées, qui ne seront pas affichées sur la fiche de sortie ou ailleurs.

<a href="/wiki/usage#usage-bookings-modal-history" id="usage-bookings-modal-history" class="wiki__page__link">
    <i class="fas fa-link"></i>
</a>

#### Onglet historique <small>(<i class="fas fa-crown"></i> Premium)</small>

Cet onglet (accessible uniquement par les administrateurs et les superviseurs) affiche la liste de **tous les changements** qui ont eu lieu pour cet événement ou réservation, avec 3 colonnes&nbsp;:

- Le type d'opération qui a été effectuée (par ex. _"modification des informations de l'événement"_).
- La date et l'heure à laquelle cette modification a eu lieu.
- L'utilisateur qui a effectué la modification.

Sur certaines lignes, un bouton <i class="fa fa-eye"></i> permet de visionner plus de détails concernant la modification effectuée. Par exemple,
si c'est une modification des informations de l'événement, est affichée la liste des champs qui ont été modifiés. Et si c'est une modification de quantité de matériel, la quantité précédente est affichée.

<a href="/wiki/usage#usage-events" id="usage-events" class="wiki__page__link">
    <i class="fas fa-link"></i>
</a>

### Créer / modifier un événement

Pour **créer un événement**, deux possibilités&nbsp;:

- Soit en cliquant sur le bouton _"<span class="color-success"><i class="fas fa-plus"></i> Nouvel événement</span>"_ en haut à droite de la page du calendrier,
- Soit avec un **double-clic** sur la frise temporelle (sur une zone vide d'événement), dans la colonne d'un jour en particulier, afin de pré-remplir la date de début de l'événement à créer avec ce jour.

Pour **modifier un événement**, il faut l'ouvrir (double-clic dessus) puis cliquer sur le bouton _"<i class="fas fa-edit"></i> Modifier"_ situé en haut de la fenêtre qui s'ouvre. Bien sûr, ce bouton n'est présent que si l'événement est modifiable.

Ces deux actions ouvrent le même formulaire de gestion d'un événement.

Dans la partie gauche de cette page, se trouve un **fil d’Ariane** affichant les différentes étapes et permettant de savoir où vous en êtes de l'édition de l'événement (en vert quand l'étape est remplie), ainsi qu'un **mini-récapitulatif** qui affiche les données de l'événement, au fur et à mesure que vous sauvegardez les étapes. La bordure de ce mini-récapitulatif devient orange (et un petit icône ⚠️ apparaît) quand des modifications ont été apportées à l'événement, mais qu'elles n'ont pas encore été sauvegardées.

<img src="/img/screens/wiki/edit-event-step-1.webp" alt="La première étape de l'édition d'un événement." />

> <i class="fas fa-info-circle"></i> **Astuce**&nbsp;: il est possible de **naviguer au clavier** entres les étapes de l'édition des événements et réservations, en utilisant les **combinaisons de touches** suivantes&nbsp;:

> - `CTRL + ALT + FLÈCHE HAUT (ou GAUCHE)`pour aller à l'étape précédente. 
- `CTRL + ALT + FLÈCHE BAS (ou DROITE)` pour aller à l'étape suivante.

Ce formulaire est donc composé de **5 étapes** dont voici le détail&nbsp;:

<a href="/wiki/usage#usage-events-step1" id="usage-events-step1" class="wiki__page__link">
    <i class="fas fa-link"></i>
</a>

#### Étape 1 - Informations de l'événement

Dans cette première étape, il faut renseigner les **informations obligatoires** de l'événement, à savoir&nbsp;:

- Le **titre** (nom) de l'événement. Il ne peut pas excéder 191 caractères.
- La **période** de l'événement (période d'exploitation). Un petit calendrier s'affiche pour vous aider à remplir ce champ. Ici, vous pouvez mettre le bouton **"Jours entiers ?"** sur _"non"_ pour pouvoir choisir les **horaires exacts** de début et de fin de la période.

On peut également y donner des informations supplémentaires, telles que&nbsp;:

- La **période de mobilisation** du matériel de l'événement, qui peut être différente de la période d'exploitation. Par défaut, il s'agit des mêmes dates que celles de la période d'exploitation. Quoi qu'il en soit, la mobilisation du matériel commencera dès que [l'inventaire de départ](#usage-departure-inventory) aura été marqué comme terminé, si celui-ci est effectué avant la date de mobilisation initialement prévue. De même, la date de fin de mobilisation sera automatiquement redéfinie si [l'inventaire de retour](#usage-return-inventory) est terminé avant la fin de mobilisation prévue, ce qui permet de signifier que le matériel est de retour en stock plus tôt. S'il est terminé après, ou qu'il n'est jamais effectué, c'est la date de fin de mobilisation prévue qui rendra le matériel à nouveau disponible.
- Le **lieu** de l'événement. Il ne peut pas excéder 64 caractères.
- Une **description**, dans un champ de texte libre.
- Choisir un **chef de projet**&nbsp;: en effectuant une recherche parmi les utilisateurs existants, vous pourrez en choisir un pour l'assigner à l'événement en tant que chef de projet. Le système lui enverra une notification par e-mail la veille du premier jour de l'événement (sauf si l'inventaire de départ a déjà été effectué).
- Choisir un **préparateur de commande** (<i class="fas fa-crown"></i> Premium)&nbsp;: en effectuant une recherche parmi les techniciens qui ont été définis comme préparateurs de commande (voir [Techniciens](#usage-technicians)), vous pourrez en choisir un pour l'assigner à l'événement en tant que préparateur du matériel. Le système lui enverra une notification par e-mail la veille du premier jour de l'événement (sauf si l'inventaire de départ a déjà été effectué), avec la fiche de sortie en pièce jointe, pour lui rappeler qu'il devra le préparer.
- Définir si l'événement est **facturable ou non.**  
_Note&nbsp;: ceci n'est disponible qu'avec le mode de facturation «&nbsp;universel&nbsp;» (voir l'étape [facturation](#usage-events-step5) plus bas)._
- Choisir une **couleur** à utiliser pour afficher l'événement sur le calendrier.  
_Note&nbsp;: si un bénéficiaire a une couleur (<i class="fas fa-crown"></i> Premium), une indication s'affiche sous le champ de choix de la couleur. Si vous spécifiez quand-même une couleur ici, c'est bien cette couleur qui sera affichée sur le planning, et non plus celle du bénéficiaire._

Un bouton _"<span class="color-secondary">Sauvegarder et continuer →</span>"_ situé en bas de page permet d'enregistrer et de passer à l'étape suivante.

<a href="/wiki/usage#usage-events-step2" id="usage-events-step2" class="wiki__page__link">
    <i class="fas fa-link"></i>
</a>

#### Étape 2 - Bénéficiaires de l'événement

Ici il s'agit de choisir quel sera le (ou les) bénéficiaire(s) de l'événement.

Pour cela, vous disposez d'un **sélecteur multi-lignes** qui permet d'en ajouter autant que vous voulez. En cliquant dans le sélecteur lui-même, vous choisissez un bénéficiaire, et son nom et sa ville (si renseignée) s'affichent.  
Une fois votre choix effectué, un bouton _"<span class="color-success"><i class="fas fa-plus"></i> Ajouter un Bénéficiaire</span>"_ apparaît en dessous, pour afficher un nouveau sélecteur et ajouter un autre bénéficiaire à la liste.  
Vous pouvez également supprimer un bénéficiaire de la liste, en cliquant sur la <i class="fas fa-trash color-error"></i> (poubelle rouge).  
Si vous avez ajouté une ligne en trop, vous pouvez cliquer sur le bouton <i class="fas fa-ban color-primary"></i> pour l'enlever.

Le choix de bénéficiaire est facultatif, vous pouvez très bien cliquer directement sur le bouton "<span class="color-success">Sauvegarder et continuer</span>", sans choisir de bénéficiaire. Un autre bouton _"<span class="color-secondary">← Sauvegarder et retour à l'étape précédente</span>"_ permet de retourner à l'étape 1.

> Attention&nbsp;: L'ordre de la liste des bénéficiaires est importante, car seul le **premier bénéficiaire** de la liste apparaîtra sur la facture de l'événement.

<a href="/wiki/usage#usage-events-step3" id="usage-events-step3" class="wiki__page__link">
    <i class="fas fa-link"></i>
</a>

#### Étape 3 - Techniciens de l'événement

Cette page vous permet de choisir un ou plusieurs techniciens à assigner à l'événement, pour des plages horaires précises. Pour cela, une **frise temporelle**, qui couvre toute la durée de l'événement, affiche la liste de tous les techniciens (une personne par ligne).

Cette étape est facultative, vous pouvez cliquer directement sur le bouton "<span class="color-success">Sauvegarder et continuer</span>", sans choisir de technicien.

Un **champ de recherche** est présent en haut de page, pour rechercher un technicien par son nom, son prénom ou son adresse e-mail.

Pour **assigner un technicien**, il suffit de&nbsp;:

- Double-cliquer dans la frise temporelle, sur la ligne du technicien de votre choix,
- Choisir les dates et heures de début et fin de l'assignation,
- Renseigner le poste occupé par ce technicien _(facultatif)_,
- Cliquer sur le bouton "<span class="color-success">Assigner ...</span>"

Il est également possible de déplacer les assignations existantes sur la frise temporelle (uniquement sur l'axe du temps), de les modifier en double-cliquant dessus, et de les supprimer en utilisant la petite corbeille située à droite de l'assignation sélectionnée.

La précision minimum des horaires des assignations de technicien est de 15 minutes. Et bien entendu, les horaires doivent obligatoirement être compris entre les dates de début et fin de l'événement.

##### Postes des techniciens sur l'événement <small>(<i class="fas fa-crown"></i> Premium)</small>

La **[variante Premium](/premium-features#premium-features-technicians-assignations)** offre la possibilité de créer des **postes** qui doivent être occupés par des techniciens à des horaires précis.

<img src="/img/screens/wiki/technicians-roles-assignations.webp" alt="La gestion des postes des techniciens dans un événement." />

Il suffit de cliquer sur le bouton _"Ajouter un poste sur cet événement"_ pour ajouter une ligne dans la frise temporelle, permettant d'assigner des techniciens à ce poste.

En ajoutant un poste, on peut spécifier si ce poste doit être **obligatoirement assigné** ou non. Ainsi, tant que tous les postes obligatoires n'ont pas au moins une assignation, une **alerte** s'affiche sur l'événement dans le planning principal, et sur l'onglet "techniciens" de la fenêtre de l'événement.

<a href="/wiki/usage#usage-events-step4" id="usage-events-step4" class="wiki__page__link">
    <i class="fas fa-link"></i>
</a>

#### Étape 4 - Matériel de l'événement

Dans cette étape, il s'agit de définir quel matériel vous allez louer ou prêter, avec quelles quantités. Pour cela, vous disposez de la **liste complète** du matériel au détail. Comme tous les [listings](#usage-listings), cette liste est **paginée,** dispose d'un champ de **recherche** sur le nom ou la référence, ainsi que de **filtres** en haut de page, pour n'afficher que le matériel d'un certain parc, d'une certaine catégorie et/ou sous-catégorie, ou encore ayant certains tags.

En survolant le nom d'un matériel dans la liste avec le curseur de la souris, une petite fenêtre affiche la photo et tous les détails du matériel.

Lors de la modification d'un événement existant, seul le matériel qui est **déjà assigné à l'événement** est affiché. Un bouton en haut à droite de la page permet d'**afficher la liste complète** de tout le matériel.

Pour **ajouter du matériel** à l'événement, il suffit d'augmenter la **quantité** voulue d'une ligne en particulier, en cliquant sur le bouton <i class="fas fa-plus color-secondary"></i> de cette ligne, ou bien en écrivant directement une quantité dans le champ prévu.

> <i class="fas fa-crown fa-2x"></i> Avec la **[variante Premium](/premium-features#premium-features-barcodes)**, vous pouvez utiliser une "**douchette**" (ou "scanner de code-barres", ou "scanette").
> Quand vous scannez un **code-barres,** l'unité de matériel associé est **automatiquement ajouté** dans la liste de l'événement, et le listing défile jusqu'à afficher la ligne de cette unité. Pour savoir comment imprimer les codes-barres, voir la partie "<a href="#usage-material-units">Unités de matériel</a>" plus haut.

Il est aussi possible d'utiliser la **liste d'un événement existant** pour l'importer dans l'événement que vous êtes en train d'éditer.  
En cliquant sur le bouton <strong class="color-secondary">"Ajouter du matériel depuis un autre événement..."</strong>, vous pourrez lancer une recherche sur le titre des événements existants, et en choisir un. Une fois que vous avez vérifié la liste du matériel de cet événement, vous pouvez cliquer sur le bouton "<strong class="color-success"><i class="fas fa-check"></i> Utiliser ce matériel</strong>". Cela a pour effet d'ajouter le matériel à la liste de l'événement courant. Si un matériel était déjà sélectionné, sa quantité sera modifiée pour correspondre à celle qui est importée.

> <i class="fas fa-crown fa-2x"></i> La **[variante Premium](/premium-features#premium-features-list-templates)** permet également l'utilisation de **modèles de liste** de matériel.
> Le fonctionnement est identique à celui de la réutilisation de la liste du matériel d'un événement existant. Pour créer un modèle de liste, il suffit d'aller dans la page "Matériel" et de cliquer sur le bouton **"<span class="color-secondary">Modèles de liste</span>"** en haut à droite de la page. Voir la section "<a href="#usage-list-templates">Modèles de liste</a>" plus bas.

Pour **enlever du matériel** à l'événement, vous pouvez cliquer sur le bouton <i class="fas fa-backspace color-primary"></i> en bout de ligne, ou bien réduire la quantité jusqu'à 0, grâce au bouton <i class="fas fa-minus color-secondary"></i> de cette ligne, ou encore en écrivant directement "0" dans le champ.

La **sauvegarde** de l'événement se fait **automatiquement** à chaque changement effectué dans la liste du matériel. Ainsi, si vous oubliez de cliquer sur le bouton "<span class="color-success">Sauvegarder et continuer</span>", votre travail est conservé quand même.

<a href="/wiki/usage#usage-events-multi-lists" id="usage-events-multi-lists" class="wiki__page__link">
    <i class="fas fa-link"></i>
</a>

##### **Listes multiples** <small>(<i class="fas fa-crown"></i> Premium)</small>

Dans la variante Premium du logiciel, vous pouvez créer **plusieurs [sous-listes](/premium-features#premium-features-multi-lists)** de matériel pour un même événement.  

Pour cela, il suffit d'utiliser le bouton **<span class="color-success">"Nouvelle sous-liste"</span>** en haut de l'écran, et lui donner un nom. Ensuite, vous pouvez ajouter du matériel dans cette liste.  

Pour modifier le contenu d'une liste, il suffit de cliquer sur le bouton "modifier" (<i class="fas fa-edit"></i>) à droite du nom de la liste, pour que son contenu s'affiche avec les champs de quantité.  

À noter que si votre événement contient déjà du matériel au moment où vous créer une nouvelle liste, le matériel déjà présent sera transféré dans une liste appelée "Liste globale".

<a href="/wiki/usage#usage-events-step5" id="usage-events-step5" class="wiki__page__link">
    <i class="fas fa-link"></i>
</a>

#### Étape 5 - Facturation

Cette page n'est visible que si la facturation est activée pour l'événement (voir [étape 1](#usage-events-step1) ci-dessus).

Ici est reprise la liste complète de tout le matériel, dans laquelle il est possible de&nbsp;:

- **modifier le tarif** journalier de chaque matériel (bien sûr, ces modifications sont appliquées sur **l'événement courant** uniquement),
- **appliquer une remise** (taux en %) sur chaque matériel qui est "remisable".

<img src="/img/screens/wiki/invoice-material-line.webp" alt="La gestion de la tarification du matériel à l'étape facturation." />

Sont également affichés le coefficient de tarif dégressif de chaque matériel, la quantité qui a été choisie à l'étape précédente, ainsi que le total hors-taxes de chaque ligne. Les montants s'ajustent au fil des modifications.

Si un tarif de matériel a été modifié, il est toujours possible de **re-synchroniser le tarif** avec celui qui est enregistré actuellement dans la fiche du matériel, grâce au bouton «&nbsp;Resynchroniser les données...&nbsp;» situé dans le menu trois-point qui apparaît en bout de ligne.

En dessous de la liste du matériel, vous pouvez créer des **lignes additionnelles** qui seront ajoutées à la facture. Cliquer sur le bouton «&nbsp;<span class="color-success"><i class="fa fa-plus"></i> Ajouter une ligne</span>&nbsp;» permet de créer une nouvelle ligne additionnelle, comportant&nbsp;:

- une **dénomination**
- un **prix unitaire**
- une **quantité**
- une **taxe** (menu déroulant, voir [gestion des taxes](#usage-settings-billing-taxes))
- Un bouton «&nbsp;<span class="color-error">Supprimer</span>&nbsp;» (dans le menu trois-points en bout de ligne) permet de supprimer la ligne additionnelle.

<img src="/img/screens/wiki/invoice-extra-lines.webp" alt="La gestion des lignes additionnelles à l'étape facturation" />

Enfin, tout en bas de la page, se trouve les **totaux** avec deux champs permettant d'**ajuster la remise globale**. Soit en spécifiant un taux de remise en %, soit en spécifiant le montant hors-taxes souhaité (et le système calcule automatiquement le taux correspondant).

<img src="/img/screens/wiki/discount-form.webp" alt="Le formulaire de remise globale à l'étape facturation." />

<a href="/wiki/usage#usage-events-step6" id="usage-events-step6" class="wiki__page__link">
    <i class="fas fa-link"></i>
</a>

#### Étape 6 - Récapitulatif de l'événement

Cette dernière étape affiche la totalité des informations de l'événement, pour pouvoir les vérifier.  
_Note&nbsp;: cette étape est la n° 5 quand la facturation est désactivée._

En haut, on trouve les **informations de base** de l'événement&nbsp;: son titre, ses dates, son lieu, sa description et les bénéficiaires ainsi que les techniciens assignés à l'événement.

Puis, peut être affichée la liste du **matériel manquant** s'il y en a, avec la quantité manquante. Les causes possibles d'un **manque de matériel** sont les suivantes&nbsp;:

- d'autres événements utilisent le même matériel durant la période de l'événement,
- les quantités voulues dépassent les quantités disponibles en stock,
- du matériel est en panne.

Puis, est affichée la **liste complète du matériel**, triée par catégorie et par prix décroissant. Cette liste présente le **nom** de chaque matériel, ainsi que la **quantité** choisie, et le **tarif** résultant (si le mode de facturation le permet). De même, un **sous-total par catégorie** est aussi affiché.

> <i class="fas fa-crown fa-2x"></i> Dans la **[variante Premium](/premium-features#premium-features-list-templates)** si vous utilisez **plusieurs sous-listes** de matériel, celui-ci sera classé par sous-listes et trié par catégories.

Enfin, en bas de page se trouvent quelques boutons d'action, tels que&nbsp;:

- «&nbsp;<span class="color-success">Confirmer l'événement</span>&nbsp;» pour définir l'événement comme étant <i class="fa fa-check"></i> confirmé,
- «&nbsp;Retour à l'étape précédente&nbsp;» pour revenir sur l'étape facturation (ou matériel, si la facturation est désactivée),
- «&nbsp;<span class="color-secondary">Imprimer ce récapitulatif</span>&nbsp;» pour télécharger la **fiche de sortie en PDF**,
- «&nbsp;<span class="color-secondary">Retour au planning</span>&nbsp;» pour retourner sur la page du planning,

<a href="/wiki/usage#usage-online-reservations" id="usage-online-reservations" class="wiki__page__link">
    <i class="fas fa-link"></i>
</a>

### Réservations en ligne <small>(<i class="fas fa-crown"></i> Premium)</small>

Cette fonctionnalité permet aux bénéficiaires existants, et disposant d'un compte personnel, de **faire eux-mêmes des demandes de réservation** de matériel, ou des **demandes d'événement**.  
Voici une petite vidéo pour vous donner un aperçu du fonctionnement de cette fonctionnalité&nbsp;:

<div class="flex flex--justify-center margin-bottom margin-sm" style="max-width: 900px;">
    <iframe
        width="560"
        height="315"
        src="https://www.youtube.com/embed/eyHcXRgOV4o"
        title="Tutoriel : la réservations en ligne"
        frameborder="0"
        allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share"
        allowfullscreen
    ></iframe>
</div>

> <i class="fas fa-exclamation-triangle"></i>
> **Attention**  
> Avant tout, il faut **activer cette fonctionnalité** en se rendant dans les [paramètres de l'application](#usage-settings-online-reservations).

Dès que les réservations en ligne sont activées, plusieurs choses changent dans l'application&nbsp;:

- Une nouvelle partie devient disponible dans le logiciel&nbsp;: c'est la **partie "externe"**, en marque blanche. Cette nouvelle partie est accessible à l'adresse `[url de base]/external`, et permettra aux bénéficiaires de s'y connecter pour effectuer leurs demandes.
- Un nouveau bouton intitulé _"Demandes de réservation"_ apparaît dans le menu principal (pour les administrateurs, les superviseurs et les opérateurs uniquement). Il permettra d'accéder à la **liste des demandes** en attente, et de celles qui ont déjà été traitées.
- Dans le formulaire d'**édition des bénéficiaires**, un bouton _"Permettre les réservations en ligne"_ est ajouté. En activant cela pour un bénéficiaire, vous pourrez lui créer un compte utilisateur qui lui permettra d'accéder à la partie "externe" et faire ses demandes de réservation lui-même.
- Dans le formulaire d'**édition d'un matériel**, une nouvelle section _"Réservations en ligne"_ apparaît. Dans cette section, on peut choisir de ne pas _"permettre la réservation en ligne"_ pour le matériel concerné. On peut également choisir les utilisateurs ayant le rôle _"opération"_ qui pourront approuver le matériel dans les demandes de réservation.
- Dans la page de **gestion des catégories**, un bouton _"Définir les membres approbateurs"_ est ajouté dans le menu trois-points de chaque catégorie. Celui-ci permet de choisir les utilisateurs ayant le rôle _"opération"_ qui pourront approuver les demandes de réservation du matériel faisant partie de la catégorie.
- Dans le **calendrier principal**, les réservations qui ont été approuvées apparaîtront parmi les événements existants.

<a href="/wiki/usage#usage-online-reservations-external" id="usage-online-reservations-external" class="wiki__page__link">
    <i class="fas fa-link"></i>
</a>

#### Partie "externe" (réservation en ligne) du logiciel

En accédant à l'adresse `[url-de-votre-instance]/external`, un utilisateur faisant partie des bénéficiaires pourra s'y connecter grâce à son pseudo et son mot de passe.

Cette partie est en **marque blanche**, c'est à dire que le nom de Loxya n'apparaît pas. À la place, en haut à gauche de la page, c'est le **nom de votre structure** (raison sociale) qui est affiché. Aussi, le design est différent de celui de la partie "administration" du logiciel.

<img src="/img/screens/wiki/external-online-reservation.webp" alt="La page de choix du matériel de réservation en ligne." />

Une fois connecté, le bénéficiaire peut commencer un "panier" pour sa demande de réservation&nbsp;:

- Étape 1&nbsp;: **choix de la période** de réservation. Il doit choisir une date de début et une date de fin. La date de début ne pourra pas être antérieure à la date courante, plus une période de sécurité configurable dans les [paramètres de l'application](#usage-settings).
- Étape 2&nbsp;: **choix du matériel** à réserver. Les disponibilités affichées tiennent compte de toutes les autres réservations et événements qui ont lieu durant la période choisie à l'étape 1, mais aussi de tous les autres paniers en cours de création. À gauche de la page, on peut choisir de filtrer par catégorie et sous-catégorie, et un champ de recherche permet de filtrer le matériel sur son nom ou sa référence. Note&nbsp;: il est possible de modifier la période choisie même après avoir commencé le choix du matériel, en cliquant sur le bouton "Changer les dates" en bas à gauche.
- Étape 3&nbsp;: **récapitulatif / visualisation** du panier, et **ajout d'informations supplémentaires**. C'est la dernière étape avant validation du panier pour en faire une demande de réservation ou d'événement. On y voit la _liste complète du matériel_ choisi, les _montants totaux_, et une section _"Informations additionnelles"_ qui permet au bénéficiaire de renseigner les éventuels **champs additionnels** (voir section [paramètres des réservations en ligne](#usage-settings-online-reservations)) qui ont été paramétrés. Si vous avez défini le paramètre _"destination des demandes"_ sur _"laisser le choix au bénéficiaire"_, celui-ci peut également choisir si sa demande concerne un événement ou non. Si **la demande concerne un événement**, il devra renseigner le _titre de son événement_ pour pouvoir valider sa demande. Il peut également faire part de ses remarques ou observations concernant sa demande, dans le champ "**commentaire**".
- Étape 4&nbsp;: **page de remerciement**. Un message prévient le bénéficiaire que sa demande a bien été prise en compte, et qu'elle sera examinée par un membre de l'équipe.

Attention, **le temps est limité** pour valider son panier. Ce temps est configurable dans les [paramètres de l'application](#usage-settings), mais par défaut les bénéficiaires ont **15 minutes** pour valider leur panier. Au delà de cette limite, leur **panier est supprimé** pour éviter un blocage inutile des quantités de matériel en stock.

Il est possible d'**activer une option** qui permet de **déconnecter automatiquement les utilisateurs inactifs** de cette partie externe (demande de réservation et inscription en autonomie des bénéficiaires). Cela permet d'utiliser Loxya sur des postes partagés entre plusieurs utilisateurs, pour éviter les oublis de déconnexion et de "vol" de session.  
Quand cette option est activée, en l'absence d'interaction (clavier, souris, etc.) de l'utilisateur, celui-ci est **automatiquement déconnecté** de sa session au bout de quelques minutes. Cette option se trouve dans le [fichier de configuration](/wiki/appendices#appendices-settings) (voir `auth.inactivityWatcher`), donc si vous utilisez Loxya en mode SaaS, il faut [nous contacter](/contact) pour que nous la configurions pour vous.

<a href="/wiki/usage#usage-online-reservations-beneficiaries" id="usage-online-reservations-beneficiaries" class="wiki__page__link">
    <i class="fas fa-link"></i>
</a>

#### Comptes utilisateurs des bénéficiaires

Par défaut, pour qu'un bénéficiaire puisse accéder à la réservation en ligne, il lui faut un **compte utilisateur**.  

> <i class="fas fa-info-circle"></i> **Notes**  
> - Seuls les utilisateurs ayant le **rôle "administration"** peuvent créer un compte utilisateur pour les bénéficiaires.  
> - Il est possible d'autoriser les bénéficiaires à se **créer eux-mêmes un compte** utilisateur (voir ci-dessous, section [paniers anonymes](#usage-online-reservations-anonymous-cart)).

Pour créer le compte utilisateur d'un bénéficiaire, il suffit d'ouvrir la page de [modification de ce bénéficiaire](#usage-beneficiaries), et de choisir "Oui" pour le champ _"Permettre les réservations en ligne"_ (en bas du formulaire). À ce moment-là, une section _"compte utilisateur"_ apparaît en dessous, avec deux boutons pour choisir si l'on veut&nbsp;:

- soit **créer un nouvel utilisateur** pour l'associer au bénéficiaire, en renseignant un **pseudo**, une **adresse e-mail**, et un **mot de passe**.
- soit **choisir un utilisateur existant**, pour l'associer à celui que l'on est en train d'éditer, en recherchant son nom, prénom ou adresse e-mail dans la liste qui apparaît.

Une fois créé, l'utilisateur lié au bénéficiaire ne pourra pas être modifié via la page de modification du bénéficiaire. Pour cela, il faudra utiliser la page de [gestion des utilisateurs](#usage-users).

À partir de là, le bénéficiaire peut se connecter à Loxya pour effectuer des demandes de réservation ou d'événement. Si besoin, vous pouvez modifier son niveau d'accès pour lui permettre de visionner le planning, voire même de gérer le matériel si c'est un membre de l'équipe.

<a href="/wiki/usage#usage-online-reservations-anonymous-cart" id="usage-online-reservations-anonymous-cart" class="wiki__page__link">
    <i class="fas fa-link"></i>
</a>

#### Paniers anonymes et création du compte par le bénéficiaire lui-même

En activant le paramètre _"Autoriser l'accès sans compte à la liste du matériel et l'inscription en autonomie&nbsp;?"_ (voir la section [paramètres des réservations en ligne](#usage-settings-online-reservations)), vous pouvez autoriser le **public** à consulter votre catalogue sans qu'il ait besoin d'être connecté.

> <i class="fas fa-exclamation-triangle"></i> **Attention**&nbsp;!  
> En activant cela, vous exposez **tout votre inventaire** de matériel au **public**, car il n'est plus nécessaire de se connecter pour commencer à créer un panier. Vérifiez donc bien au préalable quel sont les équipements qui sont exposés à la réservation en ligne.

Il peut choisir une période de réservation et créer un panier, puis il est invité à **créer son propre compte bénéficiaire** pour pouvoir valider et envoyer sa demande de réservation ou d'événement.

L'utilisateur peut commencer à saisir sa réservation (période, et choix du matériel), et&nbsp;:

- soit cliquer sur le bouton "Connexion / Inscription" en haut à droite de la page à tout moment,
- soit laisser Loxya le rediriger automatiquement vers la page de connexion ou d'inscription avant d'accéder à la vérification de son panier.

<img src="/img/screens/wiki/public-registration-step1.webp" alt="Les deux fenêtres de connexion ou d'inscription de la réservation en ligne." />

Le processus d'inscription se déroule en 3 étapes&nbsp;:

1. L'utilisateur renseigne son **nom**, **prénom**, **adresse e-mail** et **mot de passe** souhaité. Si c'est une **entreprise**, il peut choisir le type "entreprise" et devra renseigner en plus la **raison sociale** de sa structure, et éventuellement un numéro d'identification (SIREN ou autre).
2. Ensuite, il doit renseigner son **adresse postale**.
3. L'utilisateur reçoit un e-mail à l'adresse qu'il a renseigné à la première étape, qui contient un **code de vérification**. Il doit ensuite saisir ce code dans Loxya (dans les 10 minutes suivant l'envoi) pour finaliser son inscription.

> <i class="fas fa-info-circle"></i> **Bon à savoir**&nbsp;:  
> &bull; Il est possible de **limiter l'inscription** aux adresses e-mails provenant d'un (ou plusieurs) **nom(s) de domaine(s)** particulier(s). C'est utile quand on veut limiter l'accès aux utilisateurs d'une entreprise ou d'une université, tout en leur laissant la possibilité de se créer leur compte eux-mêmes.  
> &bull; Un **compte en cours de création**, dont l'adresse e-mail n'a pas encore été validée, **expire au bout d'une heure** (par défaut, mais c'est paramétrable).  
> &bull; Pour des raisons de **sécurité**, un utilisateur qui effectue plusieurs **tentatives d'inscription** sans aller jusqu'au bout peut voir son **adresse IP bloquée**, pendant un certain temps. Le nombre de ces tentatives est également paramétrable (2 par défaut).  
> &bull; Il est aussi possible d'afficher des **liens** vers des documents légaux (**Conditions d'utilisation du service** et **Politique de Confidentialité**). Ces documents doivent être hébergés sur votre propre site web, mais Loxya peut **afficher des liens** pour que l'utilisateur puisse y accéder.  
> &bull; De même que pendant le processus de demande de réservation, une option peut être activée pour **déconnecter automatiquement** les utilisateurs qui sont **inactifs pendant quelques minutes**, pour augmenter la sécurité dans des environnement ouverts (postes partagés).

> Tout cela est [paramétrable côté serveur](/wiki/appendices#appendices-settings), donc si votre instance est hébergée par nos soins (SaaS), n'hésitez pas à [nous contacter](/contact) pour nous demander de modifier ces paramètres pour vous.

<a href="/wiki/usage#usage-online-reservations-requests" id="usage-online-reservations-requests" class="wiki__page__link">
    <i class="fas fa-link"></i>
</a>

#### Traitement des demandes de réservation ou d'événement

Grâce au bouton _"Demandes de réservation"_ du menu principal, on accède à la liste des demandes de réservation ou d'événement. Sur cette page, se trouvent deux onglets&nbsp;:

- **Demandes en attente**&nbsp;: Il s'agit des paniers qui ont été validés par les bénéficiaires. Il faut donc **inspecter** cette liste régulièrement, pour approuver ou rejeter les demandes.
- **Demandes traitées**&nbsp;: Toutes les demandes qui ont déjà été **approuvées** (et donc liées à une réservation ou un événement), celles qui ont été **rejetées**, et celles qui n'ont pas été traitées à temps (**expirées**).

Dans ces listes, on voit la **référence** de la demande, le **nom du bénéficiaire** ayant fait la demande, le **statut** et la **période** de la demande, ainsi que les totaux du **nombre de matériel** et du **prix de location** (si la facturation est activée).

Pour **traiter une demande en attente**, il suffit de cliquer sur sa ligne dans la liste.  
Cela ouvre une page qui affiche toutes les informations de la demande&nbsp;: Sa **référence**, le nom et les **coordonnées du bénéficiaire**, les dates de la **période de réservation**, la **liste complète du matériel** demandé, et les **totaux** tout en bas&nbsp;:

<img src="/img/screens/wiki/request-view.webp" alt="La page d'inspection d'une demande de réservation." />

Il est possible d'**approuver** le matériel ligne par ligne (pour les utilisateurs ayant le rôle _"opération"_), ou alors d'approuver la demande en entier (pour les utilisateurs ayant le rôle _"administration"_ ou _"supervision"_).  
Il est également possible de **rejeter** la demande. Lors de cette action, on peut spécifier une raison pour laquelle la demande est rejetée. Attention, cette raison sera affichée dans l'e-mail de notification envoyé au bénéficiaire.

Si des données supplémentaires ([champs additionnels](#usage-settings-online-reservations)) sont présents dans la demande, un onglet **Informations additionnelles** permet de consulter la **valeur de ces champs** supplémentaires. S'il s'agit d'une **demande d'événement**, cet onglet affichera également le **titre** et le **lieu** de l'événement renseigné par le bénéficiaire.

Quand une réservation a été **approuvée**, celle-ci se retrouve affichée sur la frise temporelle du **[calendrier principal](#usage-calendar)**.

<a href="/wiki/usage#usage-online-reservations-edit-request" id="usage-online-reservations-edit-request" class="wiki__page__link">
    <i class="fas fa-link"></i>
</a>

#### Modification des demandes

Une demande de réservation ou d'événement peut être modifiée, tant qu'elle n'a pas été approuvée ou rejetée, et qu'elle n'a pas expiré. Pour cela, il suffit d'utiliser le bouton "<i class="fa fa-edit"></i> Modifier" situé en haut à droite de la page.

On retrouve alors une page similaire à la [modification d'une réservation](#usage-online-reservations-edition), avec 4 étapes&nbsp;:

<a href="/wiki/usage#usage-online-reservations-edit-request-step1" id="usage-online-reservations-edit-request-step1" class="wiki__page__link">
    <i class="fas fa-link"></i>
</a>

##### Étape 1 - Informations de la demande

Dans cette étape, il est possible de&nbsp;:

- modifier les **dates** de début et fin de la réservation,
- spécifier si elle doit être **facturable** ou non (mode «&nbsp;location&nbsp;» ou «&nbsp;prêt&nbsp;»),
- spécifier si la demande **concerne un événement**, ou une **réservation**.
- si la demande concerne un événement, les champs **"Titre"** et **"Lieu"** sont également présents.

<a href="/wiki/usage#usage-online-reservations-edit-request-step2" id="usage-online-reservations-edit-request-step2" class="wiki__page__link">
    <i class="fas fa-link"></i>
</a>

##### Étape 2 - Matériel de la demande

Dans cette étape, il est possible de modifier la liste du matériel de la demande, de la même manière que pour un événement (voir [l'étape matériel des événements](#usage-events-step4)). La seule différence étant que les demandes ne peuvent pas avoir de sous-listes.

<a href="/wiki/usage#usage-online-reservations-edit-request-step3" id="usage-online-reservations-edit-request-step3" class="wiki__page__link">
    <i class="fas fa-link"></i>
</a>

##### Étape 3 - Récapitulatif de la demande

Comme pour les événements et réservations, cette dernière étape affiche toutes les informations de la demande, pour pouvoir les vérifier.

En haut, on retrouve les dates de la demande, sa durée en jours, ainsi que le nom de l'emprunteur.

Ensuite, est affichée la liste complète du matériel, triée par catégorie et par prix décroissant. Cette liste présente le nom de chaque matériel, ainsi que la quantité choisie. Si la facturation est activée pour la demande, le tarif de chaque ligne de matériel est affiché, avec un sous-total par catégorie.

Enfin, en bas de page se trouvent deux boutons&nbsp;:

- «&nbsp;Retour à l'étape précédente&nbsp;» pour revenir sur l'étape matériel,
- «&nbsp;<span class="color-secondary">Retour aux demandes en attente</span>&nbsp;» pour retourner sur la page qui liste les demandes.

<a href="/wiki/usage#usage-online-reservations-approvers" id="usage-online-reservations-approvers" class="wiki__page__link">
    <i class="fas fa-link"></i>
</a>

#### Gestion des utilisateurs pouvant approuver ou rejeter les demandes de réservation

Les utilisateurs ayant le rôle **"administration"** ou **"supervision"** ont le droit d'approuver ou rejeter **toutes les demandes** de réservation.

Les utilisateurs ayant le rôle **"opération"**, eux, ne peuvent gérer les demandes de réservation que dans les conditions suivantes&nbsp;:

- Si la demande de réservation contient **au moins un matériel** dont il a explicitement été défini comme **"membre approbateur"**, il pourra rejeter la demande, ou approuver le matériel dont il est "membre approbateur" (et uniquement ce matériel-là).
- S'il fait partie des "membres approbateurs" de **tout le matériel** de la demande, il pourra également approuver la réservation dans son ensemble en un clic, comme peut le faire un administrateur.

Pour **définir les "membres approbateurs"** du matériel ou des catégories de matériel, un utilisateur ayant le rôle "administration" peut procéder ainsi&nbsp;:

- Pour le matériel, il lui suffit d'aller dans la page de modification dudit matériel (bouton "modifier"), dans la section _"Réservations en ligne"_, et d'ajouter l'utilisateur dans la liste de ceux qui peuvent approuver le matériel, en recherchant leur nom ou pseudo.
- Pour les catégories, il doit utiliser le bouton _"Définir les membres approbateurs"_ de la catégorie. Dans la fenêtre qui s'ouvre, il suffit d'ajouter l'utilisateur à la liste des membres pouvant approuver le matériel de la catégorie.

<a href="/wiki/usage#usage-online-reservations-material-reservable" id="usage-online-reservations-material-reservable" class="wiki__page__link">
    <i class="fas fa-link"></i>
</a>

#### Gestion du matériel pouvant être réservé en ligne ou non

Les utilisateurs ayant les rôles "administration", "supervision" et "opération" peuvent **choisir d'activer ou non** la réservation en ligne de **chaque matériel**, en se rendant dans la page de modification du matériel, section _"Réservations en ligne"_, et en utilisant le champ _"Permettre la réservation en ligne"_ ("oui"/"non").

Ce champ est à "oui" par défaut lors de la création d'un nouveau matériel, ou lors de l'activation des réservations en ligne.

<a href="/wiki/usage#usage-online-reservations-planning" id="usage-online-reservations-planning" class="wiki__page__link">
    <i class="fas fa-link"></i>
</a>

#### Visualisation des réservations sur le calendrier

Dans le **calendrier principal**, les réservations sont affichées au même endroit que les événements, et suivant la même légende visuelle&nbsp;: orange pour les réservations futures, bariolées pour celles qui se déroulent actuellement, gris pour les réservations passées, et gris sombre pour celles qui ont été archivées.

Les différences principales avec les événements sont les suivantes&nbsp;:

- une réservation n'a pas de titre (c'est le nom du bénéficiaire et la date de la demande qui permettent de l'identifier). Elle a donc obligatoirement un bénéficiaire.
- elle n'a pas de lieu.
- elle n'a pas de chef de projet.
- elle n'a pas de statut "à confirmer" ou non.
- on ne peut pas lui assigner de technicien.

Comme pour les événements, on peut **double-cliquer sur une réservation** pour ouvrir une fenêtre permettant de visualiser tous ses détails&nbsp;: le nom et les coordonnées du bénéficiaire, les noms des utilisateurs ayant approuvé la demande, les totaux (nombre d'articles, valeur de remplacement, montant total...). Dans un autre onglet, on peut aussi voir la liste complète du matériel, et le matériel manquant éventuel. Enfin, on peut également créer et télécharger ses devis et factures (si la facturation est activée), ainsi que consulter l'historique des opérations qui ont eu lieu sur cette réservation.

De même, on peut effectuer son [inventaire de retour](#usage-return-inventory), qui fonctionne de la même manière que pour les événements.

<a href="/wiki/usage#usage-online-reservations-edition" id="usage-online-reservations-edition" class="wiki__page__link">
    <i class="fas fa-link"></i>
</a>

#### Modification des réservations

Pour modifier une réservation, il suffit d'ouvrir sa fenêtre (depuis le planning par exemple), et de cliquer sur son bouton «&nbsp;<i class="fa fa-edit"></i> modifier&nbsp;».

On retrouve alors une page similaire à la [modification d'un événement](#usage-events), avec 4 étapes&nbsp;:

<a href="/wiki/usage#usage-online-reservations-edition-step1" id="usage-online-reservations-edition-step1" class="wiki__page__link">
    <i class="fas fa-link"></i>
</a>

##### Étape 1 - Informations de la réservation

Dans cette étape, il est possible de&nbsp;:

- modifier les **dates** de début et fin de la réservation,
- définir une **période de mobilisation** différente de la période d'exploitation,
- assigner un **préparateur de commande**,
- spécifier si elle doit être **facturable** ou non (mode «&nbsp;location&nbsp;» ou «&nbsp;prêt&nbsp;»),
- définir une **couleur**.

<a href="/wiki/usage#usage-online-reservations-edition-step2" id="usage-online-reservations-edition-step2" class="wiki__page__link">
    <i class="fas fa-link"></i>
</a>

##### Étape 2 - Matériel de la réservation

Dans cette étape, il est possible de modifier la liste du matériel de la réservation, de la même manière que pour un événement (voir [l'étape matériel des événements](#usage-events-step4)). La seule différence étant que les réservations ne peuvent pas avoir de sous-listes.

<a href="/wiki/usage#usage-online-reservations-edition-step3" id="usage-online-reservations-edition-step3" class="wiki__page__link">
    <i class="fas fa-link"></i>
</a>

##### Étape 3 - Facturation

Là encore, le fonctionnement de cette page est le même que [l'étape facturation des événements](#usage-events-step5). Et comme pour les événements, cette étape n'existe que si la facturation est activée pour la réservation.

<a href="/wiki/usage#usage-online-reservations-edition-step4" id="usage-online-reservations-edition-step4" class="wiki__page__link">
    <i class="fas fa-link"></i>
</a>

##### Étape 4 - Récapitulatif de la réservation

Comme pour les événements, cette dernière étape affiche toutes les informations de la réservation, pour pouvoir les vérifier.  
_Note : cette étape est la n° 3 quand la facturation est désactivée._

En haut, on retrouve les dates de la réservation, sa durée en jours, ainsi que le nom de l'emprunteur.

Ensuite, est affichée la liste complète du matériel, triée par catégorie et par prix décroissant. Cette liste présente le nom de chaque matériel, ainsi que la quantité choisie. Si la facturation est activée pour la réservation, le tarif de chaque ligne de matériel est affiché, avec un sous-total par catégorie.

Enfin, en bas de page se trouvent quelques boutons d'action, tels que&nbsp;:

- «&nbsp;Retour à l'étape précédente&nbsp;» pour revenir sur l'étape facturation (ou matériel, si la facturation est désactivée),
- «&nbsp;<span class="color-secondary">Imprimer ce récapitulatif</span>&nbsp;» pour télécharger la **fiche de sortie en PDF**,
- «&nbsp;<span class="color-secondary">Retour au planning</span>&nbsp;» pour retourner sur la page du planning.

<a href="/wiki/usage#usage-billing" id="usage-billing" class="wiki__page__link">
    <i class="fas fa-link"></i>
</a>

### Devis et Factures

<blockquote style="background-color: #fdad8e;">
    <i class="fas fa-exclamation-triangle"></i>
    <strong>IMPORTANT</strong><br />
    Il appartient aux <strong>utilisateurs</strong> de s'assurer de <strong>l'exactitude des données</strong> lors de l'utilisation de l'outil de facturation de Loxya. L'éditeur du logiciel ne pourra pas être tenu pour responsable des préjudices résultant d'erreurs ou d'inexactitudes présentes dans les devis et les factures.
</blockquote>

> <i class="fas fa-info-circle"></i>
> **Avant tout**  
> Cette section dépend du **mode de facturation**, choisi à [l'étape 2 de l'installation](/wiki/wizard#wizard-step2) du logiciel.

> - Si le mode de facturation choisi est **«&nbsp;location&nbsp;»**, la facturation sera toujours activée pour tous les événements (même si définis comme *"non facturables"*).
> - Si le mode de facturation est **«&nbsp;location et prêt&nbsp;»** (aussi appelé «&nbsp;«universel&nbsp;»), la facturation sera activée uniquement quand l'événement est défini comme *"facturable"* (voir l'étape 1 de [modification d'un événement](#usage-events-step1) ci-dessus).
> - Si le mode de facturation choisi est **«&nbsp;prêt uniquement&nbsp;»**, cette section est inutile car la facturation est désactivée. Ceci n'est donc utile que pour les modes de facturation *"location"*, ou *"location et prêt"*.

Pour créer un devis ou une facture, il suffit de se rendre dans les onglets *"Devis"* ou *"Facture"* de la [fenêtre de l'événement ou de la réservation](#usage-bookings-modal).  
Puis, cliquer sur le bouton _"Créer"_ pour générer un **fichier PDF,** qu'il sera ensuite possible de télécharger&nbsp;!

<img src="/img/screens/wiki/event-estimate-tab.webp" alt="Contenu de l'onglet Devis d'un événement." />

> <i class="fas fa-info-circle"></i>
> **Notes importantes**

> - Les devis et la facture ne seront générés qu'au nom du **premier bénéficiaire** de la liste des bénéficiaires de l'événement (voir l'étape 2 de [modification d'un événement](#usage-events-step2) ci-dessus).
> - Le nom, l'adresse et les données de l'émetteur de la facture sont stockées dans le [fichier de configuration](/wiki/appendices#appendices-settings), c'est à dire renseignées à l'[étape 3](/wiki/wizard#wizard-step3) de l'installation du logiciel.

Vous pouvez créer autant de devis que nécessaire. En revanche, une seule facture ne peut exister pour un événement. Donc si une facture existe déjà, vous avez la possibilité de la re-générer grâce au lien *"Cliquez ici pour refaire une facture"*, mais attention, cela incrémentera le numéro de la facture (car la loi n'autorise pas la modification d'une facture existante).

Si une facture est créée avec un **montant négatif**, le nom du document résultant sera **"Avoir"**, et fera partie de la séquence de numérotation des factures.

Pour spécifier une **remise**, à l'étape «&nbsp;Facturation&nbsp;» de l'édition d'un événement ou d'une réservation, vous pouvez&nbsp;:

- soit donner le pourcentage de remise (en %),
- soit spécifier un montant total (hors-taxes) souhaité, pour que l'application se charge de trouver le taux exact correspondant.

Notez que les montants totaux se mettent à jour automatiquement quand vous modifiez la remise à appliquer.

<a href="/wiki/usage#usage-billing-calc-details" id="usage-billing-calc-details" class="wiki__page__link">
    <i class="fas fa-link"></i>
</a>

#### Détail des calculs utilisés pour la facturation

Tout d'abord, Loxya parcourt la liste du matériel, et applique pour chaque ligne&nbsp;:

- **prix unitaire** × **tarif dégressif** = **prix pour la période de réservation**, qui est **arrondi** à deux chiffres après la virgule.
- **prix pour la période** × **quantité** =  **total pour le matériel**, à nouveau arrondi à deux décimales.
- si un **pourcentage de remise** est défini pour le matériel, on l'applique de cette manière&nbsp;:
    - **total pour le matériel** × **pourcentage de remise** = **montant de la remise** à déduire, arrondi à deux décimales.
    - **total pour le matériel** - **montant de la remise** = **total pour le matériel hors taxe**, arrondi à deux chiffres après la virgule.

Une fois que ce calcul est fait pour chaque matériel de la liste, le calcul des totaux est fait ainsi&nbsp;:

- la **somme** de tous les **totaux pour le matériel** permet d'obtenir le **total hors remise globale**, arrondi à deux décimales.
- Si un **pourcentage de remise globale** est défini&nbsp;:
    - **total hors remise globale** × **pourcentage de remise globale** = **montant de la remise globale** à déduire, arrondi à deux décimales.
    - **total hors remise globale** - **montant de la remise globale** = **total hors taxe**, lui aussi arrondi à deux chiffres après la virgule.

Enfin, si le matériel de la liste contient **une ou plusieurs taxes**&nbsp;:

- Le montant total de **toutes les taxes** est calculé en **additionnant** le montant de la **taxe de chaque matériel** concerné, en se basant sur leur total hors taxes.
- La **remise globale** éventuelle est déduite de ce **montant total des taxes** (de la même manière que précédemment),
- Le **montant total T.T.C** est calculé en additionnant le **montant total des taxes** au **total hors taxe**.

À noter que les **taxes à montant fixe** ne sont pas incluses dans l'application de la remise globale, et ne sont pas soumises elles-mêmes à d'autres taxes (TVA ou autre) ; elles sont simplement ajoutées au montant total pour obtenir le montant T.T.C. à payer.

Il est possible de **personnaliser la présentation des factures**. En attendant de pouvoir le faire depuis l'interface en tant qu'administrateur de l'application, il faut modifier "à la main" le fichier `src/views/pdf/bill-default.twig`. Vous trouverez plus de détails sur la façon de procéder dans l'annexe ["personnaliser les factures"](/wiki/appendices#appendices-bill-template).

<a href="/wiki/usage#usage-departure-inventory" id="usage-departure-inventory" class="wiki__page__link">
    <i class="fas fa-link"></i>
</a>

### Inventaire de départ du matériel

![L'inventaire de départ d'un événement.](/img/screens/wiki/departure-inventory.webp)

Quand un événement va bientôt commencer, l'inventaire de départ est très utile pour vérifier que tout le matériel qui va sortir est bien préparé, emballé pour le transport, ou même chargé dans le camion.

Pour démarrer l'inventaire de départ, il suffit d'ouvrir la fenêtre d'un événement (ou d'une réservation, exclusive à la variante <i class="fas fa-crown"></i> Premium), puis de cliquer sur le bouton "<span class="color-primary">Inventaire de départ</span>", situé en haut à gauche.

> <i class="fas fa-exclamation-triangle"></i> Attention, pour que l'inventaire de départ soit possible, il faut impérativement que l'événement ou réservation ne contienne **aucun manque de matériel**.

Dans la page qui s'ouvre, la liste du matériel qui doit sortir s'affiche, avec les quantités qui prévues pour la sortie, et un champ permettant de définir la quantité qui est bien préparée pour la sortie (ou des cases à cocher pour les unités de matériel).

Vous pouvez également ajouter des **commentaires** sur le matériel. Ainsi vous pouvez y noter l'état du matériel au moment de sa sortie, ou une remarque concernant son utilisation pour l'événement en cours, ou encore un commentaire à destination du livreur, etc. Pour cela, il suffit d'utiliser le "menu trois-points" situé tout à droite de la ligne du matériel.

Vous pouvez <span class="color-primary">sauvegarder le brouillon</span> de l'inventaire à tout moment, pour ne pas perdre votre travail en cours.

> <i class="fas fa-info-circle"></i> Si vous devez **modifier la quantité de matériel** qui doit sortir, il faut utiliser le bouton "<span class="color-primary">Modifier le matériel</span>" situé en haut à droite de la liste. Cela vous permettra de retrouver l'étape de modification du matériel de l'événement ou de la reservation dans une nouvelle fenêtre, sans perdre de vue votre inventaire en cours.

Une fois que **toutes les lignes** de l'inventaire sont en **vert**, donc que tout le matériel est prêt pour la sortie, vous pouvez cliquer sur le bouton "<span class="color-primary">Terminer l'inventaire</span>", puis valider.

> <i class="fas fa-exclamation-triangle"></i> **Important**&nbsp;: quand vous **terminez** un inventaire de départ **avant la date de début de mobilisation prévue**, cette date sera **automatiquement redéfinie** au moment ou vous validez (au quart d'heure suivant).

<a href="/wiki/usage#usage-return-inventory" id="usage-return-inventory" class="wiki__page__link">
    <i class="fas fa-link"></i>
</a>

### Inventaire de retour du matériel

Quand un événement est passé (ou sur le point de se terminer), il devient nécessaire de faire son inventaire de retour, afin de nous assurer que tout le matériel a bien été restitué, en bon état de marche. Pour cela, il faut ouvrir la <a href="#usage-bookings-modal">fenêtre d'un événement</a> passé (ou d'une réservation, dans la variante <i class="fas fa-crown"></i> Premium), puis de cliquer sur le bouton **"Inventaire de retour"**, situé en haut à gauche.

Dans la page qui s'ouvre, se trouve une liste de tout le matériel qui est sorti pour cet événement, avec deux champs de quantités pour chaque matériel&nbsp;:

- Le premier champ "Qté effective" est la **quantité retournée** de ce matériel,
- Le second champ "Qté en panne" est la quantité de ce matériel qui est revenu **cassé ou en panne**.

En bas de page, un bouton "<strong class="color-secondary">Sauvegarder le brouillon</strong>" permet d'enregistrer les modifications afin de revenir plus tard sur cet inventaire.

Le bouton **"Terminer l'inventaire"** permet de finaliser l'inventaire, pour signifier que **tout le matériel a bien été restitué**. Dans la fenêtre de confirmation, se trouve un bouton _"Options avancées"_ qui permet de révéler un champ servant à **définir la date** à laquelle l'inventaire doit **avoir été effectué**.

<img src="/img/screens/wiki/return-inventory-confirm.webp" alt="Fenêtre de confirmation de finalisation d'un inventaire de retour." />

Terminer l'inventaire aura pour effet de **le verrouiller**, et de **mettre à jour automatiquement** les quantités de **matériel en panne**. Si du matériel n'a **pas été restitué** (quantité retournée inférieure à la quantité sortie), un message d'alerte s'affiche en haut de page, mais aussi dans l'événement sur la frise temporelle, ainsi que dans la fenêtre de l'événement dans l'onglet "Matériel".

> <i class="fas fa-info-circle"></i>
> **Notes importantes**

> - Lorsqu'on termine un inventaire de retour, seules les **quantités "en panne" du matériel sont mises à jour**. Les quantités du stock du matériel, même si la quantité retournée est moindre que la quantité sortie, **ne sont pas modifiées**. Si vous avez vraiment perdu un matériel, il vous faudra **modifier sa quantité en stock manuellement**.
> - Il est possible de **commencer** un inventaire de retour **dès le début** de l'événement, mais pas avant.
> - Le fait de **terminer** l'inventaire de retour **avant la fin prévue** aura pour effet de **redéfinir les dates de fin de mobilisation et d'exploitation prévues** au moment de la validation (au quart d'heure suivant).

> <i class="fas fa-crown fa-2x"></i> La **[variante Premium](/premium-features#premium-features-notifications)** offre la possibilité d'envoyer des **e-mails de notification** automatiquement aux bénéficiaires qui n'ont pas restitué la totalité du matériel de l'événement à temps.  
> Aussi, quand l'inventaire a été sauvegardé comme brouillon et tant qu'il n'est pas terminé, un bouton **"Notifier les techniciens"** s'affiche en bas de page, pour envoyer un e-mail aux techniciens qui étaient assignés à l'événement, avec la liste du matériel manquant.

<a href="/wiki/usage#usage-return-policy" id="usage-return-policy" class="wiki__page__link">
    <i class="fas fa-link"></i>
</a>

### Politique de retour / clôture des événements et réservations

**Deux politiques** de clôture des sorties de matériel sont possibles avec Loxya&nbsp;:

**Automatique** (par défaut)  
Le logiciel considère que le matériel est effectivement retourné en stock **dès que la date de fin de mobilisation** de l'événement ou réservation est **passée**. L'[inventaire de retour](#usage-return-inventory) est alors **facultatif**, et sert uniquement de check-list de vérification&nbsp;: la libération du matériel n'est donc pas liée à la validation d'un inventaire de retour. Quand la date de fin de mobilisation de l'événement est passée, le matériel est donc libéré **même si l'inventaire de retour n'est pas terminé**.

**Manuel**  
Quand la date de fin de mobilisation est passée, le matériel de l'événement ou de la réservation **devient indisponible** pour les événements ou réservations suivants, tant que l'inventaire de retour n'est pas **effectivement terminé**. Les retards sont alors affichés sur le planning principal (voir le [planning principal](#usage-calendar)), et le temps de retard est affiché dans les utilisations du matériel (onglet [périodes de réservation](#usage-material-page) de la fiche matériel).

Dans tous les cas, si l'inventaire de retour est effectué _avant la date de fin prévue_, le matériel est tout de même _"libéré"_ dès que cet inventaire est terminé.

Pour choisir l'une ou l'autre politique, il faut définir le **paramètre `returnPolicy`** du fichier de configuration [`settings.json`](/wiki/appendices#appendices-settings). Et si vous souhaitez changer de politique pour passer de _"automatique"_ à _"manuel"_, alors assurez-vous au préalable que tous les inventaires de retour de tous les événements passés sont bien terminés&nbsp;! Si votre instance est hébergée chez nous (SaaS), [contactez-nous](/contact) pour que nous modifions ce paramètre pour vous.

<a href="/wiki/usage#usage-duplicate" id="usage-duplicate" class="wiki__page__link">
    <i class="fas fa-link"></i>
</a>

### Dupliquer un événement

Pour gagner du temps, il est possible de dupliquer un événement existant grâce au bouton "Dupliquer" de la [fenêtre de l'événement](#usage-bookings-modal)&nbsp;: cela copiera toutes ses informations (titre, lieu, bénéficiaires, techniciens assignés, etc.) ainsi que tout le matériel qui lui était assigné.

Il suffit de renseigner les dates de début et fin du nouvel événement dans la fenêtre qui s'ouvre, puis valider, et le tour est joué&nbsp;!

<img src="/img/screens/wiki/duplicate-event.webp" alt="Fenêtre de duplication d'un événement." />

<a href="/wiki/usage#usage-list-templates" id="usage-list-templates" class="wiki__page__link">
    <i class="fas fa-link"></i>
</a>

### Modèles de liste de matériel <small>(<i class="fas fa-crown"></i> Premium)</small>

Ils servent à **importer rapidement** une liste de matériel avec des quantités et des unités précises dans un événement (ou dans un autre modèle de liste). Cela peut être pratique quand on a des _événements récurrents_, ou plusieurs événements qui partagent la même _base de matériel_.

Pour accéder à la gestion des modèles de liste, rendez-vous dans la page "Matériel" du menu principal. En haut à droite se trouve un bouton "<span class="color-secondary"><i class="fas fa-list"></i> Modèles de liste</span>".

Un modèle de liste a un **nom**, une **description** (facultative), et une liste de matériel.

Pour assigner le matériel à un modèle de liste, c'est le même fonctionnement que pour les événements&nbsp;: il suffit d'utiliser les boutons <i class="fas fa-plus color-secondary"></i> et <i class="fas fa-minus color-secondary"></i>, le champ de quantité, ou bien votre scanette à code-barres&nbsp;!

Et pour **utiliser un modèle de liste** dans un événement (voir <a href="#usage-events-step4">l'étape 4 de la modification d'événement</a> plus haut), il suffit de cliquer sur le bouton "<span class="color-secondary">Ajouter du matériel depuis...</span>", et de choisir "<span class="color-success">Un modèle de liste...</span>". Vous pouvez ensuite choisir un modèle parmi ceux affichés, et vérifier que sa liste de matériel correspond à vos attentes. Pour finir, cliquez sur le bouton "<span class="color-primary"><i class="fas fa-check"></i> Utiliser ce modèle de liste</span>", ou bien de revenez en arrière grâce au bouton **"En choisir un autre"**.

Quand vous utilisez un modèle de liste, le matériel est **ajouté à la liste** de l'événement. Si un matériel était déjà sélectionné, sa quantité sera modifiée pour correspondre à celle du modèle (elle n'est pas ajoutée). Si une unité est déjà sélectionnée, elle le sera toujours après l'importation. Attention, _cela ne désélectionne aucun matériel_&nbsp;!

<a href="/wiki/usage#usage-parks" id="usage-parks" class="wiki__page__link">
    <i class="fas fa-link"></i>
</a>

### Parcs de matériel

Un parc de matériel est un lieu qui contient votre matériel.  
Seul son **nom** est obligatoire, mais un parc peut avoir d'autres informations si besoin&nbsp;: son **adresse**, ses **horaires d'ouverture**, et des **notes** ou commentaires.

Dans le listing des parcs, on peut voir les **totaux** du matériel qu'ils contiennent&nbsp;: le nombre de matériel distinct (articles), et le total de leurs quantités en stock additionnées. En cliquant sur le total des articles d'un parc, on peut se rendre sur la page du listing du matériel, avec le filtre par parc sélectionné sur ce parc.

Toujours dans ce listing, une colonne "Valeur totale" affiche un bouton sur chaque parc qui permet de calculer le **montant total** de toutes les **valeurs de remplacement** cumulées du matériel qui compose ce parc.

> <i class="fas fa-crown fa-2x"></i> Dans la **[variante Premium](/premium-features#premium-features-inventories)**, vous pouvez effectuer des [**inventaires pour les parcs**](#usage-parks-inventories), et utiliser les [**emplacements dans les parcs**](#usage-parks-locations).

<a href="/wiki/usage#usage-parks-inventories" id="usage-parks-inventories" class="wiki__page__link">
    <i class="fas fa-link"></i>
</a>

### Inventaires des parcs de matériel <small>(<i class="fas fa-crown"></i> Premium)</small>

Les inventaires des parcs servent à **mettre à jour votre stock** de matériel de façon précise. Ils permettent aussi de créer des **rapports en PDF** pour visualiser toutes les différences avec le stock qui était en mémoire avant l'inventaire.

Vous pouvez accéder aux inventaires grâce au bouton "<strong><i class="fas fa-boxes"></i> Inventaires</strong>" se trouvant en haut des pages "_Parcs de matériel_" et "_Matériel_". Il faut ensuite choisir avec quel parc de matériel vous souhaitez travailler, dans la liste déroulante. Il est également possible de cliquer directement sur le bouton <i class="fas fa-boxes"></i> (inventaires) d'un parc dans la page du listing des parcs.

Cela ouvre la liste des inventaires de ce parc, qui affiche les **dates** et les **noms** des utilisateurs qui les ont fait. Vous pouvez télécharger le rapport PDF de chacun de ces inventaires en cliquant sur le bouton <i class="fas fa-print"></i> (imprimer) de sa ligne.

Vous pouvez créer un inventaire pour le parc en cliquant sur le bouton "<strong class="color-secondary"><i class="fas fa-plus"></i> Nouvel inventaire pour ce parc</strong>".

> **Attention**&nbsp;: Quand vous commencez un inventaire, assurez vous qu'il n'y a **aucun événement en cours**, car cela voudrait dire qu'il vous manque du matériel à compter physiquement&nbsp;!

La **liste complète du matériel** du parc est affichée, avec les colonnes suivantes&nbsp;:

- La **référence** et le **nom** du matériel.
- La **quantité attendue** est celle qui est enregistrée actuellement dans l'application, avant l'inventaire.
- La **quantité effective**&nbsp;: Ici vous pouvez entrer la quantité totale du stock de ce matériel dans votre parc que vous avez compté.
- La **quantité en panne**&nbsp;: Si vous constatez qu'une ou plusieurs occurrences de ce matériel sont en panne, vous pouvez en spécifier la quantité ici.

Pour le matériel **identifié unitairement**, à la place des champs de quantité se trouvent&nbsp;:

- Un **bouton de présence** de l'unité (cliquer dessus pour l'activer et signaler ainsi la présence de l'unité dans le parc).
- Un **bouton de panne**, permettant de la signaler l'unité comme "en panne".
- Un **sélecteur d'état** permet de redéfinir l'état actuel de l'unité (_neuf, excellent, d'usage, mauvais, ou obsolète_). Ce champ n'est bien sûr actif que si le bouton de présence est activé.
- Vous avez aussi la possibilité de cliquer sur le bouton <i class="fas fa-barcode"></i> (code-barres) de l'unité, pour **télécharger le code-barres** de l'unité afin de l'imprimer si vous devez renouveler vos étiquettes papier.

Si la _quantité effective_ est **supérieure ou égale** à la _quantité attendue_ (ou que toutes les unités sont présentes), et qu'il n'y a **aucune panne**, alors le matériel est <strong class="color-success">surligné en vert</strong>.  
Si la _quantité en panne_ est **supérieure à 0,** alors le matériel est <strong class="color-error">surligné en rouge</strong>.  

Si vous souhaitez ajouter un nouveau matériel dans le parc qui ne se trouve pas dans la liste, il faut le faire depuis la page "Matériel". 

Avant de quitter l'inventaire, assurez-vous d'en **sauvegarder** le brouillon&nbsp;: Pour cela, vous pouvez utiliser le bouton "<strong class="color-success">sauvegarder le brouillon</strong>" de l'inventaire (bouton en bas de page), afin de revenir dessus plus tard s'il dure plusieurs jours.  
Pour revenir sur l'inventaire en cours (le "_brouillon_" qui a été sauvegardé), il faut **cliquer à nouveau** sur le bouton "<strong class="color-secondary"><i class="fas fa-plus"></i> Nouvel inventaire pour ce parc</strong>", car vous ne le trouverez pas dans la liste des inventaires tant qu'il n'a pas été terminé.

> **Note**&nbsp;: Si un inventaire a déjà été commencé par un **autre utilisateur** de l'application, vous ne pourrez pas y accéder tant qu'il n'est pas terminé. En effet, il n'est pas possible de créer deux inventaires simultanés pour un même parc de matériel.

Enfin, quand vous pensez en avoir **fini** avec votre inventaire en cours, vous pouvez cliquer sur le bouton "<strong class="color-secondary"><i class="fa fa-check"></i> Terminer l'inventaire</strong>", en bas de page.  
Cela aura les **conséquences** suivantes&nbsp;:

- Les **quantités** _en stock_ et _en panne_ de tout le matériel du parc seront **mises à jour**.
- Les **unités absentes** seront marquées comme "**perdues**" (elles ne seront donc plus utilisables dans les événements).
- Les **unités retrouvées** (qui étaient perdues avant l'inventaire) seront à nouveau disponibles.
- **L'état** des unités et leur statut "en panne" ou non, sera mis à jour.
- Un **rapport de l'inventaire** sera disponible au téléchargement en PDF (depuis la liste des inventaires).
- L'inventaire ne sera **plus modifiable**.

Le **rapport d'inventaire**, téléchargeable en PDF, affiche en détail _toutes les différences_ entre l'état précédent du parc et son nouvel état (quantités, pannes, réparations, changements d'état des unités, etc). En bas du rapport figure les _totaux_ de ces différences, mais aussi le total des nouvelles valeurs de remplacement de tout le matériel du parc.

<a href="/wiki/usage#usage-parks-locations" id="usage-parks-locations" class="wiki__page__link">
    <i class="fas fa-link"></i>
</a>

### Emplacements dans les parcs de matériel <small>(<i class="fas fa-crown"></i> Premium)</small>

Grâce aux emplacements dans les parcs, vous pouvez spécifier le **lieu exact** où est stocké le matériel au sein d'un parc. En créant une liste d'emplacements disponibles dans un parc, vous pourrez ensuite choisir un emplacement pour chaque matériel, ou unité de matériel, afin de le retrouver plus vite lors de la préparation du matériel qui doit sortir, ou de le ranger plus facilement quand il revient.

Pour créer des emplacements dans un parc, il faut cliquer sur le bouton <i class="fas fa-sitemap"></i> ("gérer les emplacements du parc"), situé à droite sur chaque ligne dans la liste des parcs.  
Ensuite, en cliquant sur le bouton <span class="color-success">+ Ajouter un emplacement</span>, une petite fenêtre s'ouvre dans laquelle vous pouvez entrer 3 données d'emplacement. Par exemple&nbsp;:

- Le nom du bâtiment, ou le numéro de l'étage
- Le numéro de l'allée ou de la salle dans le bâtiment ou l'étage
- Le nom de l'emplacement précis dans l'allée ou la salle

<img src="/img/screens/wiki/park-location-slots.webp" alt="Fenêtre de création d'un emplacement de parc." />

C'est assez libre, mais chaque emplacement créé doit bien sûr être **unique** au sein d'un même parc. Quand vous avez saisi les 3 valeurs de l'emplacement, vous pouvez cliquer sur le bouton <span class="color-primary">"Sauvegarder et créer un autre"</span>. L'emplacement apparaît alors dans la liste sous la fenêtre, et les trois champs sont réinitialisés pour vous permettre de saisir un nouvel emplacement rapidement. Quand vous avez créé tous les emplacements voulus, vous pouvez cliquer sur **"Terminer"** pour fermer la fenêtre.

Pour **assigner un emplacement au matériel**, rendez-vous dans la partie modification d'un [matériel](#usage-material), ou d'une [unité de matériel](#usage-material-units). À côté du champ "Parc" se trouve un sélecteur qui vous permettra de choisir l'emplacement du matériel ou de l'unité.

Ensuite, cet emplacement sera affiché dans la liste du matériel des **fiches de sortie** des événements ou réservations, ainsi que dans la page d'[inventaire de retour](#usage-return-inventory) des événements ou réservations.

<a href="/wiki/usage#usage-users" id="usage-users" class="wiki__page__link">
    <i class="fas fa-link"></i>
</a>

### Gérer les utilisateurs

Cette partie de l'application n'est accessible qu'aux utilisateurs existants ayant le rôle "**administration**".

Vous pouvez créer autant d'utilisateurs que vous le souhaitez. Les informations obligatoires d'un utilisateur sont&nbsp;:

- son **pseudo**
- son **e-mail**
- son **mot de passe**
- son **niveau d'accès (rôle)** (administration, supervision, opération, consultation ou externe, voir <a href="#usage-roles">"rôles des utilisateurs"</a> plus haut)
- son **nom** et son **prénom**.
- son _numéro de téléphone_ (facultatif).

> <i class="fas fa-crown fa-2x"></i> La **[variante Premium](/premium-features#premium-features-user-parcs-restriction)** offre la possibilité de **restreindre l'accès** d'un utilisateur à **certains parcs** de matériel.

> Pour cela, il suffit d'activer l'option _"Restreindre l'accès à certains parcs"_ du formulaire. Une fois activée, cette option affiche la liste des parcs sous forme de petits blocs cliquables. En cliquant sur le bloc d'un parc, vous pouvez activer (en vert) ou désactiver (en rouge) l'accès de l'utilisateur à ce parc.

> <img src="/img/screens/wiki/user-parcs-restriction.webp" alt="La section de restriction des parcs du formulaire de modification d'un utilisateur." />

<a href="/wiki/usage#usage-user-settings" id="usage-user-settings" class="wiki__page__link">
    <i class="fas fa-link"></i>
</a>

### Paramètres de l'utilisateur connecté

En cliquant sur votre nom, tout en haut à droite de l'écran, un utilisateur peut accéder à ses paramètres personnels.

Dans cette page, 3 onglets&nbsp;:

<a href="/wiki/usage#usage-user-settings-profile" id="usage-user-settings-profile" class="wiki__page__link">
    <i class="fas fa-link"></i>
</a>

#### Onglet **"Profil"**

C'est ici que l'utilisateur connecté peut **modifier ses informations personnelles**, comme son nom, son prénom, son adresse e-mail et son numéro de téléphone.

C'est également ici que l'utilisateur peut **changer son mot de passe**. Attention cependant, car dès que la modification du mot de passe a été sauvegardée, c'est le nouveau mot de passe qui devra être utilisé pour une prochaine connexion. Il ne faut donc pas l'oublier&nbsp;!

<a href="/wiki/usage#usage-user-settings-interface" id="usage-user-settings-interface" class="wiki__page__link">
    <i class="fas fa-link"></i>
</a>

#### Onglet **"Interface"**

Dans cet onglet, l'utilisateur connecté peut choisir ses préférences concernant l'utilisation du logiciel&nbsp;:

- La **langue** de l'interface,
- La **vue du planning** utilisée par défaut lorsqu'on clique dans le menu&nbsp;: vue en planning (frise temporelle, par défaut) ou en liste.
- La **vue des techniciens** utilisée par défaut lorsqu'on clique dans le menu&nbsp;: vue en liste (par défaut), ou en planning (frise temporelle).
- Activation / désactivation des **infobulles contextuelles**, notamment celle qui s'affiche lorsqu'on survole un matériel dans une liste.
- Activation / désactivation de la **persistance des recherches**, pour conserver ou non les filtres et les termes de recherche sur les listings même si on change de page.

<a href="/wiki/usage#usage-user-settings-notifications" id="usage-user-settings-notifications" class="wiki__page__link">
    <i class="fas fa-link"></i>
</a>

#### Onglet **"Notifications"** <small>(<i class="fas fa-crown"></i> Premium)</small>

Ici, l'utilisateur connecté peut activer ou désactiver la réception des e-mails de notification.


<a href="/wiki/usage#usage-settings" id="usage-settings" class="wiki__page__link">
    <i class="fas fa-link"></i>
</a>

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

Cette page est réservée aux utilisateurs ayant le rôle **"administration"**.

Elle permet de modifier certains **paramètres globaux** à _toute l'application_ (et donc pour _tous les utilisateurs_).

<a href="#usage-settings-calendar" id="usage-settings-calendar" class="wiki__page__link">
    <i class="fas fa-link"></i>
</a>

#### Onglet **"Calendrier"**&nbsp;:

Les paramètres de personnalisation du calendrier principal de l'application sont les suivants&nbsp;:

##### Données affichées dans les événements du calendrier

Vous pouvez choisir d'**afficher ou non** certaines données dans les blocs de la frise temporelle&nbsp;:

  - Le **lieu** de l'événement (si présent)
  - Le **bénéficiaire** (emprunteur) de l'événement (si présent)

##### Abonnement externe au calendrier

Il est possible d'obtenir un **lien public** pour le calendrier au **format iCal**, pour l'afficher dans un logiciel lecteur de calendrier, comme Mozilla Lightning, Apple Calendar, Google Agenda (attention, ce dernier ne synchronise les données que toutes les 24h), ou tout autre application compatible avec le format iCal.

> _**Important**&nbsp;: En activant le lien public du calendrier, vous **exposez certaines données publiquement**&nbsp;: toute personne en possession de ce lien pourra consulter les événements de votre calendrier, même sans être connecté à l'application&nbsp;! Veillez donc bien à ne communiquer ce lien qu'à des personnes de confiance. Si vous avez un doute, vous pouvez **re-générer le lien** afin de rendre l'ancien lien caduque._

<a href="#usage-settings-categories" id="usage-settings-categories" class="wiki__page__link">
    <i class="fas fa-link"></i>
</a>

#### Onglet **"Catégories du matériel"**

Les catégories sont présentées sous la forme de blocs. Chaque bloc contient **une catégorie**, avec ses **sous-catégories**.

Un bouton <span class="color-success"><i class="fa fa-plus"></i> Nouvelle catégorie</span> en haut de la page permet de **créer une catégorie**.

Des boutons apparaissent au survol de la souris, permettant de **modifier ou supprimer** la catégorie, mais aussi d'y **ajouter une sous-catégorie**. Lors du clic sur un bouton d'ajout ou modification, une petite fenêtre s'ouvre au centre de l'écran pour demander le nom de la catégorie ou sous-catégorie.

<a href="#usage-settings-tags" id="usage-settings-tags" class="wiki__page__link">
    <i class="fas fa-link"></i>
</a>

#### Onglet **"Tags du matériel"**

Les tags sont listés très simplement, sous forme de petits blocs (un bloc par tag). Des boutons de modification et de suppression apparaissent au survol de la souris, et une fenêtre s'ouvre pour demander le nom du tag.

Pour assigner des tags au matériel, il faut aller dans la liste du matériel, et se servir du bouton-lien "Ajouter des tags" présent dans la colonne "Tags", sur chaque ligne de matériel de la liste.

<a href="#usage-settings-release-sheets" id="usage-settings-release-sheets" class="wiki__page__link">
    <i class="fas fa-link"></i>
</a>

#### Onglet **"Fiches de sorties"**&nbsp;:

Dans cette partie se trouve tous les paramètres permettant de personnaliser les fiches de sortie des événements et réservations (documents PDF générés par Loxya). Trois sections sont présentes&nbsp;:

##### Haut de page

Un paramètre permet de choisir d'afficher ou non les **numéros légaux** de votre société (comme le n° SIRET ou APE), en haut de la **première page** des fiches de sorties des événements et réservations.

##### Liste du matériel

Ici, vous pouvez ajuster le contenu des listes de matériel des fiches de sortie, en choisissant&nbsp;:

- le **mode de présentation** de la liste du matériel affichée sur les fiches de sorties, afin de **grouper** le matériel _par catégorie, par sous-catégorie ou par parc_, ou encore de ne pas grouper le matériel du tout.
- les colonnes et **les données à afficher** dans la **liste du matériel** de la fiche de sortie&nbsp;:
  - Les **photos** (en miniature) de chaque matériel.
  - La **valeur de remplacement** de chaque matériel,
  - La **description** de chaque matériel,
  - Les **numéros de série des unités** de matériel,
  - Les **tags** associés au matériel,

##### Texte personnalisé (bas de page)

Dans cette section, vous pouvez écrire un **titre** (optionnel), et rédiger un **bloc de texte** qui sera affiché en bas de la **dernière page** de la fiche de sortie.  
Ce texte peut servir à définir un contrat de location par exemple, ou des modalités d'assurance, etc.

<a href="#usage-settings-online-reservations" id="usage-settings-online-reservations" class="wiki__page__link">
    <i class="fas fa-link"></i>
</a>

#### Onglet **"Réservations en ligne"** <small>(<i class="fas fa-crown" title="Premium"></i> Premium)</small>&nbsp;:

Dans cet onglet, vous pourrez **activer la fonctionnalité** (Premium) des **[réservations en ligne](#usage-online-reservations)** pour permettre aux bénéficiaires disposant d'un compte d'accès d'effectuer eux-mêmes des demandes de réservation du matériel.

Une fois que le paramètre **"permettre les réservations en ligne"** est activé, les options suivantes sont disponibles&nbsp;:

- **Mode de réservation**&nbsp;: pour permettre la réservation **à l'heure près**, ou **à la journée**.
- **Délai avant réservation**&nbsp;: il s'agit du temps minimum (en heures) qu'il faut entre la création d'une demande de réservation et sa date de début effectif.
- **Durée de validité du panier actif**&nbsp;: durée (en minutes) permettant d'éviter de bloquer du matériel indéfiniment si la personne faisant la demande a délaissé son panier, ou qu'elle prend trop de temps à le valider.
- **URL de la réservation en ligne**&nbsp;: c'est l'adresse à fournir à vos bénéficiaires à qui vous avez donné un accès à la partie "external" du logiciel. Un simple clic sur le bouton _"copier"_ permet de le coller ensuite dans un e-mail ou la barre d'adresse du navigateur.
- **Autoriser l'accès sans compte à la liste du matériel et l'inscription en autonomie&nbsp;?**&nbsp;: activer ceci permet au public (bénéficiaires potentiels) de parcourir le matériel et de se créer eux-mêmes un compte (voir la section ["paniers anonymes"](#usage-online-reservations-anonymous-cart) plus haut).

##### Destination des demandes

Dans cette section vous pouvez choisir ce que deviendront les demandes en ligne&nbsp;:

- Une **réservation** (_comportement par défaut_)&nbsp;: Le bénéficiaire choisit une période, et une liste de matériel avant de valider sa demande avec un commentaire éventuel. Quand elle est approuvée, une _réservation est ajoutée_ au planning.
- Un **événement**&nbsp;: Le bénéficiaire doit en plus saisir le **titre** de son événement avant de pouvoir valider sa demande. Il peut aussi éventuellement préciser le **lieu** de l'événement. Quand elle est approuvée, la demande _devient un événement_ sur le planning, avec toutes les fonctionnalités liées aux événements.
- **Laisser le choix** au bénéficiaire&nbsp;: À la dernière étape de sa demande, le bénéficiaire peut choisir si sa demande concerne un événement ou non. S'il répond par l'affirmative, il devra saisir le titre de son événement pour valider sa demande. Selon son choix (modifiable par un administrateur ou un superviseur), sa demande aboutira à _une réservation ou un événement_ sur le planning.

##### Notifications d'approbation au bénéficiaire

Ici vous pouvez choisir s'il faut **joindre la fiche sortie** en PDF aux e-mails de **notification d'approbation** des demandes de réservation.

##### Champs additionnels

Dans cette section, vous pouvez définir des champs supplémentaires à faire remplir aux bénéficiaires lorsqu'ils soumettent une demande de réservation.

En cliquant sur le bouton <strong class="color-success">"Nouveau champ"</strong> à droite, vous pouvez créer une nouvelle information à demander aux bénéficiaires. Dans la fenêtre qui s'ouvre, vous devez définir **un nom** pour le champ, choisir **son type de données**, et le rendre **obligatoire ou non**. Quand il s'agit d'un champ de type "nombre entier" ou "nombre décimal", vous pouvez également définir une **unité de mesure** à afficher.

Si vous choisissez de rendre obligatoire un champ additionnel, le bénéficiaire *ne pourra pas finaliser sa demande* tant qu'il n'aura pas renseigné une *valeur valide* pour le champ en question.

Les données de champs additionnels des demandes sont visibles dans l'onglet **"Informations additionnelles"** de la [page d'inspection de la demande](#usage-online-reservations-requests) de réservation.

<a href="#usage-settings-departure-return-inventories" id="usage-settings-departure-return-inventories" class="wiki__page__link">
    <i class="fas fa-link"></i>
</a>

#### Onglet **"Inventaires de départ&nbsp;/&nbsp;retour"**&nbsp;:

Cet onglet montre les paramètres globaux concernant les inventaires de départ et de retour.

##### Inventaires de retour

Vous pouvez choisir ici le **comportement des <u>nouveaux</u> inventaires de retour**. Deux possibilités&nbsp;:

- _Les quantités restituées doivent être **définies manuellement**_&nbsp;: en ouvrant un nouvel inventaire de retour, celui-ci est vide et il faut définir la quantité restituée de chaque matériel à la main. C'est le comportement par défaut.
- _Les quantités restituées sont **pré-remplies avec les quantités attendues**_&nbsp;: le nouvel inventaire de retour est pré-rempli comme si tout le matériel était bien restitué, et il faut définir le matériel qui n'est _pas revenu_ manuellement.

À noter que ce paramètre n'est utilisé que si l'inventaire de retour n'a _pas encore été sauvegardé_.

<a href="#usage-settings-billing-taxes" id="usage-settings-billing-taxes" class="wiki__page__link">
    <i class="fas fa-link"></i>
</a>

#### Onglet **"Facturation - Taxes"**&nbsp;:

Ici, vous pouvez voir la liste et créer différentes **taxes**, ou **groupes de taxes**. Un groupe de taxes est la réunion de plusieurs taxes appliquées en même temps, par exemple une _T.V.A à 20% + participation écologique à prix fixe_, ou encore les _taxes TPS + TVQ_ pour le Québec.

Chaque taxe peut être soit un **pourcentage**, soit un **montant fixe**. 

<img src="/img/screens/wiki/create-tax-group-tps-tvq.webp" alt="La fenêtre de création d'un groupe de taxes (TPS et TVQ) pour le Québec." /> 

Après avoir défini une première taxe ou groupe de taxes, vous pouvez l'assigner en tant que **taxe par défaut**. Cela permet de l'assigner automatiquement à tout nouveau matériel créé par la suite.

<a href="#usage-settings-billing-degressive-rates" id="usage-settings-billing-degressive-rates" class="wiki__page__link">
    <i class="fas fa-link"></i>
</a>

#### Onglet **"Facturation - Tarifs dégressifs"**&nbsp;:

Ici, vous pouvez voir la liste et créer différentes **grilles de tarifs dégressifs**. Un tarif dégressif est constitué d'un **nom** et d'une **série de paliers** de correspondance entre la durée des périodes de facturation et un coefficient multiplicateur du tarif (ou un pourcentage de réduction du tarif). 

Un palier est donc défini par **un nombre de jour** qui correspond au nombre minimum de jours pour lequel il faut appliquer un **taux** ou un **coefficient** multiplicateur. Le nombre maximal de jours est défini par le palier suivant.

<img src="/img/screens/wiki/degressive-rates-list.webp" alt="La fenêtre de création d'une grille de tarif dégressif." /> 

Après avoir défini un premier tarif dégressif, vous pouvez l'assigner en tant que **tarif dégressif par défaut**. Cela permet de l'assigner automatiquement à tout nouveau matériel créé par la suite.

>  <i class="fas fa-info-circle"></i> **Tutoriel vidéo**
<iframe width="380" height="200" src="https://www.youtube.com/embed/6rtML7XjCSE?si=RCl9B7r5eQi4oVGq" frameborder="0" allow="accelerometer; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen></iframe>

<a href="#usage-settings-estimates-invoices" id="usage-settings-estimates-invoices" class="wiki__page__link">
    <i class="fas fa-link"></i>
</a>

#### Onglet **"Contenu des devis et factures"**&nbsp;:

Dans cet onglet, vous pouvez personnaliser ce qui apparaît dans les devis et factures. _Attention_, il ne s'agit pas de la [personnalisation des documents](/wiki/appendices#appendices-bill-template) eux-mêmes, mais bien de _choisir les données qui doivent apparaître_ ou non.

Pour chaque paramètre ci-dessous, il est possible de choisir si on veut l'activer pour les devis, les factures, ou les deux&nbsp;:

##### Détails

- Afficher les dates d'enlèvement et retour
- Afficher la description de l'événement
- Afficher le total des valeurs de remplacement
- Afficher les totaux des caractéristiques spéciales (sous la liste du matériel)

##### Liste du matériel

- Afficher les photos (miniatures)
- Afficher les valeurs de remplacement
- Afficher les descriptions
- Afficher les prix unitaires et sous-totaux

##### Textes personnalisés

Pour les devis, on peut rédiger un texte (et un titre) qui apparaîtra au-dessus de mention «&nbsp;Bon pour accord&nbsp;» et la signature. Cela permet d'ajouter des clauses personnalisées au devis, comme des conditions de règlement, ou un RIB.

Pour les factures, le texte personnalisé ser affiché en dessous des totaux sur la première page de la facture. Également utile pour afficher les conditions de règlement ou autre.

<img src="/img/screens/wiki/estimates-invoices-settings.webp" alt="L'onglet des paramètres concernant le contenu des devis et factures." /> 

Bien sûr, **n'oubliez pas** de cliquer sur **sauvegarder** quand vous avez terminé, avant de changer d'onglet&nbsp;!


