Problemas comuns

Antes de abrir um ticket, confere se sua dúvida já está aqui.

Login e acesso

"E-mail ou senha inválidos" no login

• Senha digitada errada (confere maiúsculas/Caps Lock)
• Usuário não existe ainda (admin precisa criar em Sistema → Usuários)
• Conta foi desativada (campo active = false em user_profiles)

Alternativas:

• Clica Esqueci a senha → link mágico no email
• Ou Entrar com link mágico sem senha

"Sua sessão expirou"

• Normal após alguns dias sem usar
• Solução: login de novo

"Dados carregam infinitamente" em alguma tela

• Problema de conexão com Supabase (API Key errada na Vercel)
• Cache do navegador — Ctrl+Shift+R (hard refresh)
• Se persistir: ticket

Integração Stays.net

"Erro de conexão com o servidor" no Testar Conexão

• Subdomínio digitado errado (ex.: com .stays.net ou com https://)
• Login/senha do Stays mudaram
• API desabilitada no plano do Stays

"Reserva ficou sem unidade"

• Unidade do Stays sem código interno
• Unidade foi removida no Stays mas tem reserva histórica
• Solução: menu Unidades → Órfãs → vincular manualmente

"Sync Stays demora muito (>5min)"

• Mês com muitas reservas (150+) — normal até 10min
• API do Stays lenta — tenta depois
• Se travar > 20min: cancela, abre ticket

Importação de despesas com IA

"IA não extraiu os itens do boleto"

• PDF corrompido ou foto com pouca qualidade
• Solução: tirar nova foto ou preenche manual

"Extraiu valor errado"

• Edita na lista antes de salvar
• Se acontecer sistematicamente: ticket (a gente ajusta prompt)

"IA categorizou errado"

• Edita categoria na linha antes de salvar
• IA melhora com feedback — cadeia de aprendizado depende de quantidade de amostras

"Botão de upload sumiu no portal"

• Proprietário marcou opt-out de IA (pode verificar em Proprietários → [nome] → Dados pessoais)
• Restaurar: proprietário desmarca no portal, ou você edita ai_opt_out = false em SQL

Fechamento mensal

"Botão Fechar Mês não aparece"

• Você está em período futuro (só fecha mês já decorrido ou atual)
• Ou seu usuário não tem role admin (só admin fecha)

"Comissão Vivare ficou zero"

• Modelo de comissão da unidade não foi configurado → Unidades → [unidade] → Modelo de comissão
• Ou a taxa ficou como 0 (bug potencial — reportar)

"Faltou um proprietário no fechamento"

• Unidades dele estão inativas?
• Unidades dele estão sem reserva no mês?
• Ver em Proprietários → [nome] → Unidades

"Quero regenerar relatório pra corrigir uma despesa"

• Vai em Relatórios → [proprietário] → Regenerar
• Ou fecha o mês de novo (sobrescreve todos os drafts)

Portal do proprietário

"Proprietário diz que link do portal não funciona"

• Link foi gerado há mais de 90 dias (expirou)
• Você regenerou o token depois (o link antigo foi invalidado)
• Solução: gera novo em Proprietários → [nome] → Portal Token

"Proprietário diz que não recebeu email"

• Email cadastrado está correto?
• Olha spam
• RESEND_API_KEY está configurado na Vercel?

"Link do portal foi compartilhado erroneamente"

• Revoga imediatamente: Proprietários → [nome] → Portal Token → Revogar
• Gera novo e envia pra proprietário

Assinatura D4Sign

"Contrato ficou travado em pending"

• Webhook do D4Sign não configurado → URL: https://seu-dominio.com/api/contracts/sign/webhook
• Proprietário não assinou ainda → checa no painel D4Sign
• Cancela no D4Sign e gera novo se passou > 30 dias

"Dados do proprietário no contrato estão errados"

• Proprietário cadastrado com campo errado → corrige cadastro
• Regenera contrato

Financeiro / Caixa

"Saldo tá negativo mas conta bancária tá positiva"

• Sync Stays recente não rodou → forçar sincronização manual
• Repasse marcado como pago sem ter sido transferido — verifica extrato
• Receita de reserva ainda não entrou (depósito Stays pode demorar 3-7 dias)

"Não bate o saldo com o extrato"

• Ver Reconciliação do caixa pra fluxo de diagnóstico

LGPD

"Proprietário pediu pra excluir dados mas tem contrato ativo"

• Aprovar o pedido com force=true OU resolver contrato primeiro
• Política recomendada: resolver contrato primeiro — evita queimar pontes

"Quero saber quem acessou meus dados"

• Resposta no export JSON (seção lgpd_data_access_log)
• Ou admin consulta /api/owners/[id]/access-log

Sistema / performance

"Tudo lento nas últimas horas"

• Verifica Status page
• Se tudo verde, reporta ticket

"Mudei env var na Vercel mas não aplicou"

• Env var só entra em vigor no próximo deploy
• Forçar redeploy: Vercel → Deployments → último → ⋮ → Redeploy

"Quero rodar migration de LGPD"

• SQL Editor Supabase → cola o conteúdo do arquivo supabase/migrations/*.sql → Run
• Se der erro de permissão (42501): migration mexe em storage.objects — aplica via Dashboard UI (ver HURDLE 23 no CLAUDE.md)

---

Sua dúvida não está aqui?

• Use o widget de ajuda no canto inferior direito (pergunta pra IA primeiro)
• Ou abre um ticket de suporte (botão no mesmo widget)
• Email direto: suporte@vivarestay.com