Facturación — proforma, definitiva, PDF, UBL

Actualizado el 2026-04-22

BedFlow genera automáticamente facturas proforma en cada reserva. Tras la salida, esta se convierte en una factura definitiva que puede enviarse a Yuki (contabilidad) y, opcionalmente, mediante Peppol (para B2B).

Factura proforma

• Generada en cuanto se crea una reserva (a través del BookingService, del widget o del formulario de admin)
• Contiene: referencia de la reserva, huésped, periodo, noches × precio, extras, tasa turística y total
• financial_state = unpaid / partial / paid según el estado del pago
• PDF generado automáticamente y guardado en storage/app/invoices/

Factura definitiva

Tras el check-out, la proforma se convierte en factura. Esto puede hacerse:

• Manualmente desde la administración ("Finalizar factura")
• Automáticamente mediante FinalizeWellnessInvoices a diario a las 23:30

La factura definitiva recibe un número correlativo de la serie de facturas y se conserva inmutable (solo es posible añadir pagos).

PDF + UBL

• PDF: visual — almacenado como pdf_path en el registro Invoice
• UBL (Universal Business Language XML): para Peppol y facturación electrónica. Generado por GenerateAllInvoicesUbl cada hora para las facturas nuevas, almacenado como ubl_path

Descargue ambos mediante el botón de descarga en la página de detalle de la factura.

Push a Yuki

Cada 2 horas se ejecuta PushInvoices → las nuevas facturas definitivas se envían a su administración de Yuki.

• Facturas B2C → simplemente enviadas
• Facturas B2B (con número de IVA) → también a través de Peppol (si el ajuste yuki_peppol_enabled = true)

Las facturas que ya tienen un timestamp yuki_journal_at se omiten.

Facturas negativas (notas de crédito)

BedFlow admite notas de crédito (por ejemplo, en caso de cancelación con reembolso parcial). El pago correspondiente se asigna automáticamente al IBAN del deudor — la falta de IBAN bloquea el pago hasta que el administrador lo complete.

Conciliación de pagos

Las exportaciones CODA de su cuenta Belfius se cruzan mediante ReconcilePayments (cada 2 horas) con las facturas pendientes a través de structured_communication / payment_reference. Admite pagos divididos en varias facturas.