Facturation — proforma, définitive, PDF, UBL

Mis à jour le 2026-04-22

Facturation — proforma, définitive, PDF, UBL

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 / paid selon 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 FinalizeWellnessInvoices chaque 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_path sur l'enregistrement Invoice
  • UBL (Universal Business Language XML) : pour Peppol et la facturation électronique. Généré par GenerateAllInvoicesUbl toutes les heures pour les nouvelles factures, stocké en tant que ubl_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.