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

# La synchronisation, en bref

> Comment Firby importe vos réservations depuis votre PMS, à la demande et automatiquement avant chaque génération.

La synchronisation est l’opération qui met à jour vos logements et vos réservations
depuis votre PMS vers Firby. Tout le reste — règles, factures, suivi — part de ces
données.

## Quand la sync a lieu

* **Automatiquement, avec chaque génération.** Quand vous lancez la génération des
  factures, Firby resynchronise d’abord vos PMS pour partir des données les plus à
  jour.
* **Veille automatique des logements.** Toutes les heures, Firby scanne la **liste des
  logements** de chaque PMS connecté (un scan léger, respectueux des limites des API).
  Les **nouveaux logements** sont importés automatiquement et vous en êtes informé par
  e-mail. Les réservations, elles, ne sont pas concernées par ce scan : elles sont
  synchronisées à la génération.
* **À la demande.** Vous pouvez lancer une synchronisation **complète** (logements +
  réservations) à tout moment depuis **Réglages → Connexion PMS** — utile après avoir
  corrigé une réservation côté PMS.

<Note>
  **Un nouveau logement est compté dans l’abonnement**

  Un logement détecté par la veille est importé **actif**, donc compté dans votre
  abonnement. Si vous ne souhaitez pas le facturer, **archivez-le** avant votre prochain
  renouvellement (voir [Gérer les propriétaires](/proprietaires/gestion#archiver-un-logement)).
</Note>

Sur la page **Hébergements**, le bouton **Synchroniser** lance ce même scan rapide des
logements et vous indique aussitôt le nombre de logements trouvés, dont les nouveaux.

## Configurer d’avance les nouveaux logements

Par défaut, un logement importé arrive **sans règle de facturation** : il n’est pas
facturable tant que vous ne lui en affectez pas une à la main. C’est la première cause
de logement importé puis oublié — et donc jamais facturé.

Pour l’éviter, dites une fois pour toutes ce que doit recevoir un nouveau logement,
dans **Réglages → Mon compte → Nouveaux logements** :

* une **règle de facturation** — celle de la majorité de votre parc ;
* un ou plusieurs **tags** — par exemple « Consommables », pour que le forfait
  correspondant soit facturé dès le premier séjour.

Chaque logement découvert par la veille ou par une synchronisation reçoit alors cette
configuration automatiquement. Vous n’ajustez ensuite que les exceptions, depuis la
fiche du logement.

Les mêmes réglages sont accessibles là où vous travaillez :

* page **Règles de facturation** — le bouton **Définir par défaut** sur une règle, et
  le badge **Par défaut** qui indique celle en vigueur ;
* page **Tags de logements** — la colonne **Nouveaux logements** : cochez les tags à
  poser d’office.

<Note>
  **Seuls les futurs logements sont concernés**

  Modifier ces valeurs par défaut ne change **rien** à vos logements actuels : leur règle
  et leurs tags restent tels que vous les avez réglés. Un logement ré-importé après la
  suppression de sa connexion PMS garde lui aussi sa configuration d’origine.
</Note>

## Ce qui est importé

Pour chaque réservation, Firby récupère et normalise :

| Donnée                                | Usage dans Firby                                         |
| ------------------------------------- | -------------------------------------------------------- |
| Dates de check-in / check-out         | Rattachement au bon mois de facturation                  |
| Montant brut du séjour                | Base des commissions « brut »                            |
| Frais de ménage                       | Base « net hors ménage », forfait ménage en répercussion |
| Commissions des plateformes           | Base « net »                                             |
| Taxe de séjour                        | Déduction de la base « net »                             |
| Commission PMS (le cas échéant)       | Base « commission PMS »                                  |
| Statut (confirmée, annulée, no-show…) | Inclusion ou exclusion de la facture                     |
| Logement                              | Rattachement au propriétaire                             |

## PMS pris en charge

Firby se connecte à six PMS. La méthode de connexion varie selon le logiciel :

| PMS                         | Connexion                                   |
| --------------------------- | ------------------------------------------- |
| [Superhote](/pms/superhote) | Identifiants (e-mail + mot de passe)        |
| [Guesty](/pms/guesty)       | OAuth — Client ID + Client Secret           |
| [Lodgify](/pms/lodgify)     | Clé API                                     |
| [Smoobu](/pms/smoobu)       | Clé API                                     |
| [Smily](/pms/smily)         | Autorisation OAuth (un clic, rien à coller) |
| [Hostaway](/pms/hostaway)   | Account ID + clé API                        |

<Note>
  **Statut de connexion**

  Chaque connexion affiche un statut : **active**, **erreur** ou **déconnectée**. En cas
  d’erreur (identifiants expirés, accès révoqué côté PMS), reconnectez le PMS depuis son
  écran. Voir [Résoudre un problème](/aide/depannage).
</Note>