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 Propriedades, abra a propriedade e selecione a aba Tarifas
  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: O check-in só é aceito para reservas com status Confirmada. O Opero não bloqueia o check-in pelo status de governança da unidade.

Solução:

  1. Confirme a reserva antes de fazer o check-in
  2. Se a unidade ainda estiver em limpeza, verifique a tarefa em Governança antes de entregar as chaves
  3. Alternativamente, reatribua a reserva para uma unidade limpa do mesmo tipo

”Pagamento pendente necessário” no check-in

Causa: O check-in pela recepção não é bloqueado por pagamento. A política de pagamento da propriedade (antecipado, sinal + saldo ou no check-in) vale para as reservas feitas no Portal de Reservas.

Solução:

  1. Registre o pagamento no Folio da reserva pelos métodos disponíveis
  2. Se o hóspede pagará no check-out, deixe o saldo em aberto no folio
  3. Verifique a política de pagamento da propriedade em Propriedades > aba Configurações

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 Configurações > Config. do Tenant > Provedores de Comunicação e verifique se o provedor de email está configurado
  2. Confirme que o hóspede tem um endereço de email válido
  3. 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 Configurações > Controle de Acesso
  3. Se a tela informar que o módulo não está contratado (erro 402), o tenant precisa do add-on correspondente na Loja Opero
  4. 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