Manual / Pagamentos

Faturação — proforma, definitiva, PDF, UBL

Atualizado em 2026-04-22

Faturação — proforma, definitiva, PDF, UBL

O BedFlow gera automaticamente faturas proforma em cada reserva. Após a partida é convertida numa fatura definitiva que pode ser enviada para o Yuki (contabilidade) e, opcionalmente, via Peppol (para B2B).

Fatura proforma

  • Gerada assim que uma reserva é criada (via BookingService, widget ou formulário do admin)
  • Contém: ref. da reserva, hóspede, período, noites × preço, extras, taxa turística, total
  • financial_state = unpaid / partial / paid consoante o estado de pagamento
  • PDF gerado automaticamente e guardado em storage/app/invoices/

Fatura definitiva

Após o check-out a proforma é convertida em fatura. Isto pode ser feito:

  • Manualmente através do admin ("Finalizar fatura")
  • Automaticamente através de FinalizeWellnessInvoices diariamente às 23:30

A fatura definitiva recebe um número sequencial da série de faturação e fica guardada de forma imutável (apenas a adição de pagamentos continua a ser possível).

PDF + UBL

  • PDF: visual — guardado como pdf_path no registo Invoice
  • UBL (Universal Business Language XML): para Peppol e faturação eletrónica. Gerado por GenerateAllInvoicesUbl a cada hora para novas faturas, guardado como ubl_path

Descarregue ambos pelo botão de download na página de detalhe da fatura.

Yuki push

A cada 2 horas corre PushInvoices → as novas faturas definitivas são enviadas para a sua administração Yuki.

  • Faturas B2C → simplesmente submetidas
  • Faturas B2B (com número de contribuinte) → também via Peppol (se a definição yuki_peppol_enabled = true)

As faturas que já tenham um timestamp yuki_journal_at são ignoradas.

Faturas negativas (notas de crédito)

O BedFlow suporta notas de crédito (por ex. em caso de cancelamento com reembolso parcial). O respetivo pagamento de saída é colocado automaticamente no IBAN do devedor — a falta de IBAN bloqueia a saída até que o admin a complete.

Reconciliação de pagamentos

As exportações CODA da sua conta Belfius são, através de ReconcilePayments (a cada 2 horas), reconciliadas com faturas em aberto via structured_communication / payment_reference. Suporta split payments por várias faturas.

← Voltar à categoria