Gerir clientes (devedores)
Atualizado em 2026-04-26
Gestão → Clientes — visão geral e gestão de todos os devedores (hóspedes e empresas).
Adicionar manualmente um novo cliente
Habitualmente os devedores são criados automaticamente assim que um novo hóspede reserva. Por vezes quer criar um previamente — por ex. para um cliente empresarial ou para um orçamento.
- Abra Gestão → Clientes → Novo devedor
- Preencha pelo menos Nome próprio, Apelido e E-mail ou Telefone
- Opcional: nome da empresa, número de contribuinte, morada de faturação, preferência de idioma
- Criar — o devedor pode agora ser associado a reservas e faturas
Ações CRUD
- ➕ Novo cliente
- ✏️ Editar cliente (nome, morada, contacto, NIF, IBAN, notas)
- 🗑️ Apagar (apenas se não tiver reservas ou faturas associadas)
Campos
- Nome próprio + apelido
- Nome da empresa (opcional)
- Número de contribuinte (opcional)
- Company chamber ID (KBO, opcional)
- E-mail, telemóvel, telefone
- Morada, código postal, cidade, país
- IBAN bancário (para pagamentos de saída em notas de crédito)
- Notas (campo de texto livre)
- Latitude/longitude (para mapa — preenchido automaticamente via geocoding quando a morada muda)
Pesquisa
A barra de pesquisa do Filament funciona em todos os campos em simultâneo. Digite "Vannerom" → match em last_name. Digite "+32470" → match em telemóvel. Digite "BE0123" → match em NIF.
Sincronização do MyTourist (opcional)
A cada hora via comando SyncDebtors — os devedores do MyTourist são sincronizados para o BedFlow. Os registos existentes não são sobrescritos (apenas os campos vazios são preenchidos).
Os novos devedores criados via BedFlow (widget, formulário do admin, orçamento) têm um external_id único que começa por OV-D- — assim sabe imediatamente que se trata de um registo nativo BedFlow.
Associação com reserva
A partir do detalhe do cliente pode ver todas as reservas e faturas. Útil para hóspedes recorrentes — vê de imediato o seu histórico completo.
Comunicação
Clique no e-mail ou telefone para abrir diretamente um e-mail/WhatsApp. Por cliente também vê todos os e-mails recentes (a partir do EmailLog).
Privacidade / RGPD
Ao apagar, o devedor é hard delete (sem soft-delete). As reservas mantêm-se com debtor_id = null. Aceite um pedido de eliminação RGPD apagando definitivamente o registo dele — as faturas históricas mantêm-se (obrigatório por lei durante 7 anos).