> ## Documentation Index
> Fetch the complete documentation index at: https://help.firby.fr/llms.txt
> Use this file to discover all available pages before exploring further.

# Tags de logements

> Regrouper vos hébergements pour les retrouver et les filtrer, et leur facturer des forfaits en plus de leur règle.

Un **tag** regroupe des hébergements. Un logement suit **une seule règle de
facturation**, mais peut porter **autant de tags que vous voulez**.

À la création, vous choisissez à quoi sert le tag. C’est le seul réglage qui change
tout le reste.

## Les deux rôles d’un tag

| Rôle                   | Ce qu’il fait                                                                                              | Effet sur les factures                                  |
| ---------------------- | ---------------------------------------------------------------------------------------------------------- | ------------------------------------------------------- |
| **Tag de facturation** | Porte des forfaits (maintenance, consommables, linge…) facturés aux logements qui le portent.              | Ses forfaits s’ajoutent à ceux de la règle du logement. |
| **Étiquette**          | Identifie et regroupe des logements — « Sous-location », « Conciergerie », « Saisonnier », « Client VIP ». | **Aucun.** Une étiquette ne facture jamais rien.        |

L’étiquette sert à **retrouver** vos logements, pas à les facturer. C’est le bon outil
quand vous voulez marquer une catégorie de biens sans toucher à un seul euro.

<Note>
  **Un tag de facturation cumule, il ne remplace pas**

  Les forfaits d’un tag viennent **en plus** de la règle du logement, jamais à la place.
  Un logement qui porte trois tags de facturation reçoit les forfaits des trois, ajoutés
  à ceux de sa règle. Voir [Forfaits](/regles/forfaits).
</Note>

## Créer un tag

<Steps>
  <Step title="Ouvrez Tags de logements → Nouveau tag">
    Donnez-lui un nom court : c’est ce qui apparaîtra sur la fiche de chaque logement.
  </Step>

  <Step title="Choisissez son rôle">
    **Tag de facturation** ouvre l’éditeur de forfaits juste en dessous. **Étiquette**
    le masque : il n’y a rien à tarifer.
  </Step>

  <Step title="Choisissez une couleur">
    Firby propose la couleur la moins utilisée de votre palette, pour que deux tags
    créés à la suite ne se ressemblent pas.
  </Step>

  <Step title="Cochez les hébergements concernés">
    Le tableau du bas liste tout votre parc, avec les tags que chaque logement porte
    déjà. Cocher un logement ici ne retire **aucun** de ses autres tags.
  </Step>
</Steps>

## Filtrer vos hébergements par tag

C’est tout l’intérêt d’une étiquette. Sur la page **Hébergements**, trois chemins mènent
au même résultat :

* **cliquez sur un tag** dans la colonne Tags — la liste se filtre aussitôt sur ce tag,
  recliquez pour l’enlever ;
* utilisez le menu **Tous les tags** dans la barre de filtres, et cochez-en plusieurs :
  Firby affiche les logements qui portent **au moins un** des tags cochés ;
* depuis la page **Tags de logements**, cliquez le **nombre d’hébergements** d’un tag :
  vous arrivez directement sur la liste filtrée.

<Tip>
  L’adresse de la page filtrée contient le filtre. Mettez-la en favori, ou envoyez-la à
  votre équipe : elle rouvrira exactement la même sélection.
</Tip>

Le filtre par tag se combine avec la recherche et les filtres propriétaire et statut.

## Poser un tag sur un logement

Deux entrées, au choix :

* depuis la **fiche du logement**, section **Tags** : cochez, puis **Enregistrer les
  tags** ;
* depuis le **tag lui-même**, section **Hébergements concernés** : vous traitez tout le
  parc d’un coup.

Pour que les logements que Firby découvre ensuite dans votre PMS arrivent déjà tagués,
cochez la colonne **Nouveaux logements** de la page Tags. Voir
[Configurer d’avance les nouveaux logements](/pms/synchronisation#configurer-d-avance-les-nouveaux-logements).

## Changer le rôle d’un tag

Vous pouvez basculer un tag d’un rôle à l’autre à tout moment.

* **Étiquette → tag de facturation** : ajoutez-lui des forfaits, ils seront facturés dès
  la prochaine génération aux logements qui le portent.
* **Tag de facturation → étiquette** : ses forfaits sont **supprimés**. Firby vous
  prévient pendant l’édition, puis demande confirmation avant d’enregistrer.

<Warning>
  Transformer un tag de facturation en étiquette supprime définitivement ses forfaits.
  Les factures **déjà envoyées** ne bougent pas, mais les **brouillons** perdront ces
  montants si vous relancez une génération — et les factures suivantes ne les porteront
  plus. En cas de doute, créez plutôt une nouvelle étiquette à côté.
</Warning>

## Supprimer un tag

Supprimer une **étiquette** la retire des logements qui la portent : aucune facture
n’est concernée.

Supprimer un **tag de facturation** retire aussi ses forfaits — ils ne seront plus
facturés aux logements concernés. Là encore, les factures déjà envoyées restent
intactes ; les brouillons, eux, seront recalculés sans ces forfaits à la prochaine
génération.