Facturation — proforma, définitive, PDF, UBL
Mis à jour le 2026-04-22
BedFlow génère automatiquement des factures proforma pour chaque réservation. Après le départ, elles sont converties en factures définitives qui peuvent être poussées vers Yuki (comptabilité) et, en option, via Peppol (pour le B2B).
Facture proforma
- Générée dès qu'une réservation est créée (via BookingService, widget ou formulaire admin)
- Contient : référence réservation, client, période, nuits × prix, extras, taxe de séjour, total
financial_state=unpaid/partial/paidselon le statut de paiement- PDF généré automatiquement et stocké dans
storage/app/invoices/
Facture définitive
Après le check-out, la proforma est convertie en facture. Cela peut se faire :
- Manuellement par l'admin (« Finaliser la facture »)
- Automatiquement via
FinalizeWellnessInvoiceschaque jour à 23:30
La facture définitive reçoit un numéro séquentiel de la série de factures et est conservée de manière immuable (seul l'ajout de paiements reste possible).
PDF + UBL
- PDF : visuel — stocké en tant que
pdf_pathsur l'enregistrement Invoice - UBL (Universal Business Language XML) : pour Peppol et la facturation électronique. Généré par
GenerateAllInvoicesUbltoutes les heures pour les nouvelles factures, stocké en tant queubl_path
Téléchargez les deux via le bouton de téléchargement sur la page de détail de la facture.
Push Yuki
Toutes les 2 heures, PushInvoices s'exécute → les nouvelles factures définitives sont envoyées à votre administration Yuki.
- Factures B2C → simplement déposées
- Factures B2B (avec numéro de TVA) → également via Peppol (si le réglage
yuki_peppol_enabled = true)
Les factures déjà dotées d'un timestamp yuki_journal_at sont ignorées.
Factures négatives (notes de crédit)
BedFlow prend en charge les notes de crédit (par exemple lors d'une annulation avec remboursement partiel). Le remboursement correspondant est automatiquement déclenché vers l'IBAN du débiteur — un IBAN manquant bloque le remboursement jusqu'à ce que l'admin le complète.
Réconciliation des paiements
Les exports CODA de votre compte Belfius sont rapprochés des factures ouvertes via ReconcilePayments (toutes les 2 heures) à l'aide de structured_communication / payment_reference. Prend en charge les split payments répartis sur plusieurs factures.