firby_sk_…) qui permet à vos outils — ou à un
assistant IA via MCP — d’interroger vos données Firby. Se crée dans
Réglages → API. Voir L’API Firby.Démarrer
Glossaire
Le vocabulaire de Firby et de la facturation de conciergerie, expliqué simplement.
PMS (Property Management System) — Votre logiciel de gestion locative, là où vivent
vos réservations et vos logements. Firby s’y connecte pour importer les données.
Exemples : Superhote, Guesty, Lodgify.
Outil de facturation — Le logiciel qui émet vos factures légales, porte leur
numérotation et assure la conformité (TVA, e-invoicing). Firby lui envoie les
brouillons. Exemples : Pennylane, Qonto, Abby, Henrri, Sinao, Axonaut.
Propriétaire — Le client de votre conciergerie : le détenteur du bien que vous
gérez. Firby produit une facture par propriétaire et par mois.
Commission — La part que vous prélevez sur l’activité d’un logement. Elle peut être
un pourcentage d’une base (brut, net, nuitées…), un montant fixe par réservation,
le cumul des deux, ou un forfait de base + supplément par période. Voir
Commissions.
Base de commission — L’assiette sur laquelle s’applique votre taux. Firby en propose
cinq : montant brut, net, net hors ménage, nuitées seules, ou la commission déjà
calculée par le PMS. Voir Commissions.
Forfait — Un montant fixe ajouté à la facture pour un service : ménage, linge,
consommables, check-in, maintenance. Il peut être facturé par séjour, par nuit ou par
mois. Voir Forfaits.
Passthrough (répercussion) — Reprendre tel quel un montant remonté par le PMS —
typiquement les frais de ménage — pour le refacturer sans le recalculer.
Dépense exceptionnelle — Une dépense ponctuelle (achat, travaux, ménage exceptionnel,
caution…) que vous refacturez à un propriétaire pour un mois donné, en plus des lignes
issues des réservations. Voir Dépenses exceptionnelles.
HT / TTC — Hors taxes / Toutes taxes comprises. Le mode dépend de votre régime de
TVA : en franchise en base, vos lignes sont en HT sans TVA ; en régime normal, la TVA
s’applique.
Timing (check-in / check-out) — La règle qui dit dans quel mois tombe une
réservation : le mois de l’arrivée ou celui du départ. Il détermine sur quelle facture
elle apparaît.
Brouillon — Une facture préparée par Firby mais pas encore envoyée. Vous la
relisez, puis vous l’envoyez vers votre outil de facturation où elle devient définitive.
Synchronisation (sync) — L’opération qui met à jour les réservations depuis le PMS.
Firby synchronise à la demande, et automatiquement avant chaque génération de factures.
Taxe de séjour — La taxe collectée pour le compte de la commune. Elle peut être
déduite de la base « net » selon votre configuration.
Mandat SEPA — L’autorisation signée par un propriétaire (avec son IBAN) qui vous
permet de prélever le montant de ses factures directement sur son compte. Sa
référence unique s’appelle la RUM. Voir
Paiements et prélèvement SEPA.
Clé API — Un identifiant secret (