ReportForge

Generateur de rapports — API Lean

🔐 Entrez le code de votre application d'authentification (ou un code de secours).

Entrez votre adresse e-mail pour recevoir un code de verification.

Code envoye a

ReportForge

API Lean
?

Rapport

📅 Planification automatique
▼

La date de fin correspond toujours à la veille (dernier jour complet).

Lean publie production_date = D+1 (nouvelle journée). Le rapport couvre jusqu'à D = D+1 − 1 jour (journée clôturée).

🔔 Ce rapport sera déclenché automatiquement à la clôture de journée (hotel.day.closed).
Aucune récurrence ni heure d'exécution à configurer.

Environnements

Endpoints API Lean requis cliquer pour afficher/masquer

L'utilisateur API créé dans Lean PMS doit avoir les droits d'accès (lecture) sur les endpoints suivants :

/api/v2/hotels/ — Hôtels
/api/v2/charges/ — Charges (CA)
/api/v2/taxes/ — Taxes
/api/v2/statistics/statistictype/ — Types statistiques
/api/v2/statistics/substatistictype/ — Sous-types stat.
/api/v2/cashtransactions/ — Encaissements
/api/v2/cashtransactionstypes/ — Types encaissements
/api/v2/bill/ — Factures
/api/v2/billpayments/ — Règlements factures
/api/v2/depositbillpayments/ — Arrhes / Dépôts
/api/v2/roomshk/ — Housekeeping
/api/v2/customers/ — Clients
/api/v2/statistics/occupation/ — Statistiques occupation
/api/v2/statistics/reservation-summary/ — Résumé réservations
/api/v2/statistics/reservations/ — Liste des réservations
/api/v2/statistics/breakfast/ — Petit-déjeuner
/api/v2/reservations/ — Réservations
/api/v2/customers/agencies/ — Agences
/api/v2/customers/companies/ — Sociétés

Utilisateurs par hotel

En ajoutant cet utilisateur, vous confirmez avoir obtenu son consentement pour le traitement de son adresse e-mail dans le cadre de l'utilisation de ReportForge, conformement au RGPD. Contact DPO :

Parametres des rapports

Categories

Configuration des rapports

Historique des rapports

Tous les rapports generés sont conserves 30 jours et téléchargeables.

Aide - Feuille de Situation

1. Objectif de la feuille de situation

La feuille de situation explique l'écart entre le chiffre d'affaires reconnu et les encaissements perçus sur une même période. Elle propose une lecture par mouvements, avec des rapports de détail qui justifient chaque montant.

2. Deux approches équivalentes

La réconciliation peut se lire de deux manières équivalentes :

  1. Approche par soldes : solde fin - solde début.
  2. Approche par mouvements : dotations/créés - reprises/soldés.

Nous privilégions l'approche par mouvements, notamment pour pallier une limite actuelle de Lean : certains soldes ne peuvent pas être édités dans leur état à une date antérieure.

Solde fin = Solde début + Entrées - Sorties

3. Figer les soldes à la clôture mensuelle

Certains soldes ne sont pas historisés par Lean, comme dans la plupart des PMS. Il est donc indispensable d'éditer les rapports de soldes au moment exact de la clôture mensuelle, après les écritures d'avant clôture et avant celles de la période suivante.

Cette photo de clôture permet de sécuriser les références et de vérifier ensuite que les mouvements du mois expliquent correctement l'évolution des soldes.

4. Équation de rapprochement

CA - Encaissements = (FAE dotations - FAE reprises) - (PCA dotations - PCA reprises) + (Débiteurs créés - Débiteurs soldés) - (Dépôts reçus - Dépôts imputés) - (Avoirs émis - Avoirs utilisés)

L'écart entre chiffre d'affaires et encaissements doit être exactement expliqué par la somme de ces mouvements. En pratique : écart expliqué = écart observé, donc l'écart résiduel attendu est nul.

5. Définitions des composantes

FAE (Factures à établir)

  • Dotation FAE : charge produite et non encore facturée, qui augmente le stock de FAE.
  • Reprise FAE : charge précédemment en FAE et facturée sur la période, qui diminue le stock de FAE.

PCA (Produits constatés d'avance)

  • Dotation PCA : montant facturé avant la date de production, qui augmente le stock de PCA.
  • Reprise PCA : consommation du PCA lors de la production, qui diminue le stock de PCA.

Débiteurs

  • Débiteurs créés : créances générées sur la période.
  • Débiteurs soldés : créances réglées sur la période.

Dépôts

  • Dépôts reçus : montants encaissés en avance, non encore imputés.
  • Dépôts imputés : dépôts utilisés sur factures pendant la période.

Avoirs

  • Avoirs émis : avoirs créés sur la période.
  • Avoirs utilisés : avoirs consommés en imputation sur la période.

6. Explications complémentaires

Les soldes de clôture restent indispensables pour la piste d'audit. Les mouvements de la période suivante doivent permettre de retomber sur les nouveaux soldes de clôture.

La feuille de situation est une restitution comptable par familles de flux. D'autres états opérationnels peuvent présenter les mêmes informations avec une granularité différente.

7. Mode opératoire mensuel recommandé

  1. Finaliser les écritures du mois.
  2. Éditer et archiver les rapports de soldes au moment de la clôture.
  3. Générer la feuille de situation et les rapports détaillés.
  4. Vérifier l'égalité de rapprochement.
  5. En cas d'écart, analyser composante par composante avec les rapports détaillés correspondants.
  6. Archiver le dossier mensuel complet.

8. Correspondance avec les rapports détaillés

  • Chiffre d'affaires : ca_detaille
  • Encaissements : encaissements_detail ou encaissements_cumul
  • FAE : fae_detail
  • PCA : pca_detail
  • Débiteurs créés : debiteurs_crees_detail
  • Débiteurs soldés : debiteurs_soldes_detail
  • Dépôts reçus : depots_detail
  • Dépôts imputés : depots_utilises_detail
  • Avoirs émis : avoirs_crees_detail
  • Avoirs utilisés : avoirs_consommes_detail

Toutes les planifications

Modifier la planification

🔔 Déclencheur : hotel.day.closed — s'exécute automatiquement à la clôture journalière

Configuration SMTP

Configurez le serveur SMTP pour l'envoi de rapports par email et les notifications du planificateur.

Tâches en cours

Liste des exports async en cours d'exécution (fenêtre 6 heures). Rafraîchissement automatique toutes les 20 secondes.

Mon compte

Double authentification (TOTP)

Activez une application d'authentification (Google Authenticator, Authy…) pour sécuriser votre connexion.

Gestion des administrateurs

Creez, modifiez ou desactivez les comptes administrateurs. Seul le super-administrateur peut gerer les autres admins.

IP Allowlist

Aucune restriction active — Toutes les adresses IP peuvent accéder à l'interface admin.

Restreindre l'accès admin à certaines adresses IP ou plages CIDR (ex : 82.165.0.0/16 ou 192.168.1.10). Si la liste est vide, aucune restriction n'est appliquée.

Webhooks

Mode lecture seule — La gestion des webhooks est désactivée sur cette instance.

Journal des événements

→
Heure Type Rapport Environnement Statut Durée Message
Aucun événement trouvé.

Callbacks Webhook reçus

Reçu le Hôtel Environnement Statut Rapports déclenchés Détail / Payload
Aucun callback reçu.

Logs de connexion

Heure Type Email Adresse IP Navigateur Détail
Aucun log de connexion.
Détail de l'événement
Credentials Webhook

Laisser vide pour utiliser l'URL par défaut.

Ajouter un administrateur
🔐 Configurer l'authentification TOTP

Scannez ce QR code avec Google Authenticator, Authy ou toute application compatible TOTP.

Saisie manuelle

✅ TOTP activé avec succès !

Conservez ces codes de secours dans un endroit sûr. Ils ne seront plus affichés.

Désactiver le TOTP

Entrez votre code TOTP actuel (ou un code de secours) pour désactiver la 2FA.

Ajouter un environnement

Methode d'authentification API

🔔 Webhook hotel.day.closed

Les credentials webhook (URL API, utilisateur, clé statique) se configurent dans Administration → Webhooks.

Mapping hôtels ↔ users Lean autorisés
Confirmer la suppression

Voulez-vous vraiment supprimer cet element ?