Skip to Content
Guias de WorkflowSolução de Problemas

Solução de Problemas

Esta página cobre os problemas mais comuns encontrados no Opero e como resolvê-los. Se seu problema não estiver listado aqui, entre em contato com o administrador do sistema.

Reservas

”Unidade indisponível para as datas selecionadas”

Causa: Outro hóspede já tem uma reserva confirmada para essa unidade e período, ou a unidade está com status “Manutenção” ou “Bloqueada”.

Solução:

  1. Verifique o Calendário de Reservas para ver quais unidades estão livres
  2. Escolha outra unidade do mesmo tipo de quarto
  3. Se não houver unidades disponíveis, considere ajustar as datas ou habilitar overbooking (aprovação do gerente necessária)

“Tarifa não encontrada para o período”

Causa: Nenhum plano de tarifa está configurado para a combinação de datas e tipo de quarto selecionada.

Solução:

  1. Vá em Settings > Planos de Tarifa
  2. Verifique se um plano de tarifa cobre o período desejado
  3. Se estiver usando tarifas sazonais, confira se não há gaps entre as datas das temporadas
  4. Veja Tarifas e Preços para configuração detalhada

Reserva não aparece no calendário

Causa: Filtros ativos estão ocultando a reserva (tipo de unidade, status ou filtro de datas).

Solução:

  1. Clique em “Limpar Filtros” no topo do calendário
  2. Expanda o período para incluir as datas da reserva
  3. Use a barra de busca global para encontrar a reserva por código ou nome do hóspede

Check-in e Check-out

”Unidade não disponível para check-in”

Causa: A unidade atribuída está com status “Suja” ou “Manutenção”.

Solução:

  1. Verifique o status de governança da unidade em Governança > Kanban
  2. Se a unidade estiver suja, solicite limpeza urgente
  3. Alternativamente, reatribua a reserva para uma unidade limpa do mesmo tipo na tela de check-in

”Pagamento pendente necessário” no check-in

Causa: A propriedade está configurada para exigir pagamento total ou parcial antes do check-in.

Solução:

  1. Processe o pagamento na tela de check-in pelos métodos disponíveis (cartão, PIX, dinheiro)
  2. Se o hóspede pagará no check-out, peça ao gerente para liberar a exigência
  3. Verifique a política de pagamento da propriedade em Settings > Propriedade > Políticas

Causa: O token JWT no link de check-in expirou (padrão: 24 horas).

Solução:

  1. Abra o detalhe da reserva
  2. Clique em “Enviar Link de Check-in” para gerar um novo token
  3. O hóspede recebe um novo email com o link atualizado

Erro “Pagamento necessário” no self-check-in

Causa: O status de pagamento da reserva não é PAID, e a propriedade exige pagamento antes do self-check-in.

Solução:

  1. Registre o pagamento no Folio da reserva
  2. Quando o status for PAID, o hóspede pode completar o self-check-in
  3. Alternativamente, o hóspede pode fazer check-in na recepção

Financeiro

Valores financeiros não correspondem ao esperado

Causa: A API retorna valores monetários em centavos (inteiro), enquanto a UI exibe moeda formatada.

Solução:

  • Isso é por design. Um valor de 19999 na API equivale a R$ 199,99 na UI
  • Ao integrar via API, sempre divida por 100 para exibição
  • Veja Conceitos Fundamentais para entender como os valores financeiros funcionam

Fatura não gerada no check-out

Causa: Dados fiscais ausentes (CPF/CNPJ) no perfil do hóspede ou do pagador.

Solução:

  1. Complete o CPF/CNPJ do hóspede na tela de check-out
  2. Para faturas corporativas, verifique se o CNPJ da empresa está cadastrado
  3. Tente novamente o check-out após atualizar os dados

Comunicação

Email não enviado para o hóspede

Causa: OCP (Opero Communication Platform) não está configurado, ou o template de email está inativo.

Solução:

  1. Vá em Settings > Comunicação e verifique se o provedor de email (AWS SES) está configurado
  2. Verifique se o template relevante está ativo em Comunicação > Templates
  3. Confirme que o hóspede tem um endereço de email válido
  4. Verifique os logs do OCP para erros de entrega

Acesso e Permissões

403 Forbidden ao acessar uma funcionalidade

Causa: Seu perfil de usuário não tem permissão para esta ação.

Solução:

  1. Contate seu administrador para verificar seu perfil atribuído
  2. O administrador pode verificar e ajustar permissões em Admin > Roles & Permissions
  3. Veja Perfis e Permissões para a matriz completa de permissões

Hóspede duplicado detectado

Causa: Um hóspede com o mesmo email ou documento já existe no sistema.

Solução:

  1. Busque o hóspede existente por email ou número do documento
  2. Se for a mesma pessoa, use o perfil existente em vez de criar um novo
  3. Se os perfis precisarem ser mesclados, use a funcionalidade de merge de Person em Hóspedes > Perfis

Importação de Dados

Importação de CSV falha

Causa: O formato do arquivo CSV não corresponde ao template esperado.

Solução:

  1. Baixe o template no diálogo de importação
  2. Verifique se os cabeçalhos das colunas correspondem exatamente (case-sensitive)
  3. Verifique caracteres especiais nos campos de texto
  4. Certifique-se de que campos numéricos usam o separador decimal correto (ponto, não vírgula)
  5. Salve como CSV codificado em UTF-8

Ainda Precisa de Ajuda?

Se seu problema não foi coberto aqui:

  1. Consulte a documentação da funcionalidade relevante na barra lateral
  2. Verifique o Changelog para alterações recentes que podem afetar seu workflow
  3. Contate o administrador do sistema ou o suporte Opero
Last updated on
Jornada do HóspedeChangelog