Ciclo de Vida da Reserva

Toda reserva no Argonautas segue um ciclo de vida claro, desde o momento em que é criada até a saída do hóspede. Este guia explica cada etapa, como as reservas são criadas e como gerenciá-las no dia a dia.

Visão Geral

As reservas são o objeto central do Argonautas. Elas podem chegar automaticamente de canais OTA (Airbnb, Booking.com, VRBO) ou ser criadas manualmente pela sua equipe para reservas diretas. Independentemente da origem, toda reserva passa pelo mesmo conjunto de status e é gerenciada na mesma interface.

Status das Reservas

Cada reserva possui um status que reflete em que ponto do ciclo de vida ela se encontra. O status aparece como um indicador colorido em todo o aplicativo.

Status	Cor	Significado
Confirmada	Azul	A reserva está garantida e a propriedade está bloqueada para essas datas.
Pendente	Amarelo	A reserva foi recebida, mas ainda não foi confirmada — normalmente aguardando pagamento ou revisão manual.
Em Espera	Amarelo	As datas estão temporariamente reservadas (por exemplo, durante uma cotação ou processo de pagamento).
Check-in Feito	Azul	O hóspede chegou e está atualmente hospedado na propriedade.
Check-out Feito	Cinza	O hóspede partiu. A reserva agora faz parte do seu histórico.
Cancelada	Vermelho	A reserva foi cancelada antes da chegada do hóspede.

A visualização da lista de Reservas organiza esses status em abas:

• Reservas Ativas — Mostra reservas confirmadas, pendentes, em espera e com check-in feito (exclui concluídas e canceladas). Esta é a aba padrão.
• Confirmadas — Apenas reservas confirmadas.
• Pendentes — Apenas reservas pendentes.
• Na Casa — Hóspedes atualmente hospedados: reservas confirmadas ou com check-in feito cuja estadia abrange o dia de hoje (chegada hoje ou antes, partida hoje ou depois). Use esta aba para ver exatamente quem está na propriedade agora.
• Canceladas — Apenas reservas canceladas.
• Concluídas — Reservas em que o hóspede já fez o check-out.

Cada aba exibe um selo com a contagem para que você veja rapidamente quantas reservas se enquadram em cada categoria.

Criando uma Reserva Manual

Para criar uma reserva diretamente (para reservas por telefone, e-mail ou presenciais):

1. Navegue até Reservas e clique em Nova Reserva.
2. Escolha um tipo de reserva. O Argonautas suporta três tipos:
   • Reserva de Hóspede — Uma reserva padrão com dados do hóspede, preço e e-mails de confirmação.
   • Estadia do Proprietário — Bloqueia datas para uso do proprietário da propriedade. Nenhum preço é calculado.
   • Manutenção — Bloqueia datas para limpeza, reparos ou outra manutenção. Nenhum preço é calculado.
3. Selecione uma propriedade no menu suspenso.
4. Defina as datas de check-in e check-out. Para reservas de hóspedes, você também pode definir um horário de chegada.
5. Insira o número de hóspedes — adultos, crianças (de 2 a 17 anos) e bebês (menores de 2 anos).
6. Preencha as informações do hóspede (apenas reservas de hóspedes): nome, e-mail, telefone e, opcionalmente, um endereço postal.
7. Revise a cotação de preço. Assim que você selecionar uma propriedade e as datas, a barra lateral exibirá uma cotação em tempo real com:
   • Tarifa base (tarifa diária multiplicada pelo número de noites)
   • Cobranças adicionais (taxa de limpeza, taxa de serviço, impostos, etc.)
   • Preço total
8. Adicione detalhes da reserva (opcional): fonte da reserva (direta, Airbnb, Booking.com, VRBO, telefone, e-mail, indicação, etc.), agente de reservas (o membro da equipe que cuidou da reserva, usado para controle de comissões), uma referência/código de confirmação externo e notas internas visíveis apenas para a equipe.
9. Clique em Criar Reserva para finalizar.

[Screenshot: O formulário de criação de reserva mostrando o seletor de tipo de reserva, o seletor de propriedade, campos de data, seção de informações do hóspede e a barra lateral de cotação de preço.]

Como as Reservas de OTA Chegam

Quando um hóspede reserva através de uma OTA conectada (Airbnb, Booking.com, VRBO), a reserva é sincronizada automaticamente no Argonautas via rede de distribuição. Essas reservas:

• Aparecem na lista de Reservas com um ícone de canal indicando a origem.
• Têm seu status definido com base no que a OTA reporta (tipicamente Confirmada).
• Incluem o código de confirmação da OTA no campo Referência Externa.
• Importam os dados de contato do hóspede da OTA, quando disponíveis.
• Têm os preços preenchidos a partir dos dados de reserva da OTA.

As reservas de OTA são gerenciadas da mesma forma que as reservas manuais, embora alguns campos (como informações de contato do hóspede) possam ser limitados pelo que a OTA compartilha.

Detalhamento financeiro da OTA

Para reservas de OTA, os detalhes da reserva detalham os totais para que você possa reconciliar o que a OTA realmente cobrou:

• Acomodação Base — a tarifa diária do quarto que a OTA reportou.
• Taxas — extras não tributáveis (taxa de limpeza, taxa de resort, taxa de serviço e similares).
• Impostos — IVA, imposto de ocupação, imposto de hospedagem e outras linhas do tipo imposto, separados das taxas.
• Comissão da OTA — a comissão do lado do anfitrião que a OTA cobra (por exemplo, ~15,5% no Airbnb, ~15% no Booking.com, ~8% no VRBO). Reservas diretas mostram isso em branco em vez de zero, para que os relatórios possam distinguir "sem OTA" de "OTA com comissão zero".
• Valor Líquido ao Proprietário — o que o proprietário recebe após comissão e impostos. Para a maioria das reservas, isso é calculado automaticamente. Quando uma liquidação de OTA é incomum — um cancelamento, reembolso parcial, estadia editada ou uma taxa que a OTA ainda não finalizou — o pagamento é retido para revisão de liquidação até que você confirme o valor correto. Consulte Modificações de Reservas de OTA para o fluxo de trabalho de revisão.

Se a OTA modificar uma reserva posteriormente, o detalhamento é preservado quando a nova revisão não o inclui — ele não é zerado silenciosamente. As entradas de Taxa de Cancelamento recebidas da sincronização do canal são intencionalmente excluídas do detalhamento de taxas para evitar dupla contagem nos pagamentos.

A Visualização de Detalhes da Reserva

Clique em qualquer reserva na lista para abrir sua visualização de detalhes. A página é dividida em duas colunas:

Coluna Principal (Esquerda)

• Cartão de Detalhes da Reserva — Status, datas de check-in/check-out, horário de chegada, número de hóspedes, fonte da reserva e código de confirmação. As linhas de check-in e check-out mostram os horários configurados da própria propriedade (por exemplo, "Após as 15:00" / "Antes das 11:00"), formatados para o idioma ativo, para que a janela exibida sempre corresponda àquela propriedade, em vez de um padrão fixo. Todos os campos são editáveis inline; uma barra de salvamento flutuante aparece na parte inferior quando você faz alterações.
• Cartão de Informações da Propriedade — O nome da propriedade (somente leitura, vinculado a partir da reserva).
• Cartão de Informações do Hóspede — Nome, e-mail, telefone e endereço do hóspede. Editável para reservas manuais.
• Cartão de Notas — Notas internas visíveis apenas para sua equipe. Clique em "Adicionar Nota" nas ações rápidas para ir até aqui.

Barra Lateral (Direita)

• Cartão de Detalhamento de Preço — O preço discriminado: tarifa base, cobranças adicionais e total. Para reservas diretas, cada taxa da cotação (limpeza, serviço, animal de estimação, processamento, etc.) aparece como sua própria linha identificada em vez de um único total agrupado como "Taxas", para que o detalhamento corresponda ao que o hóspede está sendo cobrado. Você pode adicionar ou remover cobranças e ajustar valores; essas linhas de taxa geradas pelo sistema são gerenciadas automaticamente. Você também pode aplicar um crédito para reduzir o total de uma reserva direta — escolha Valor para inserir um crédito fixo, ou Porcentagem para descontar a acomodação em uma porcentagem (o imposto é ajustado proporcionalmente em ambos os casos). Um crédito não pode exceder o total da reserva. As alterações são salvas juntamente com quaisquer outras edições.
• Cartão de Status de Pagamento — Mostra o status atual do pagamento (Pendente, Parcial, Pago, Reembolsado, Falhou), valor total, valor pago e saldo devedor. Se o pagamento estiver pendente, um botão "Registrar Pagamento" estará disponível.
• Cartão de Ações Rápidas — Ações com um clique:
  • Enviar E-mail ao Hóspede — Abre uma janela modal para compor e enviar um e-mail ao hóspede.
  • Imprimir Voucher — Gera e abre um PDF do voucher do hóspede em uma nova aba.
  • Baixar Fatura — Baixa uma fatura em PDF para a reserva.
  • Adicionar Nota — Rola para a seção de notas e ativa a edição.

[Screenshot: A visualização de detalhes da reserva mostrando o layout de duas colunas com detalhes da reserva, informações do hóspede, detalhamento de preço e status de pagamento.]

Modificando uma Reserva

Você pode editar a maioria dos campos da reserva diretamente da visualização de detalhes:

1. Abra a reserva.
2. Altere qualquer campo editável (datas, número de hóspedes, status, informações do hóspede, notas, preço).
3. Uma gaveta flutuante "Alterações não salvas" aparece na parte inferior da tela com os botões Cancelar e Salvar Alterações.
4. Clique em Salvar Alterações para persistir suas edições.

Se você tentar navegar para longe com alterações não salvas, uma caixa de diálogo de confirmação perguntará se você deseja sair sem salvar.

Reenviar o e-mail de confirmação: Após fazer alterações, clique em Enviar Confirmação no cabeçalho para reenviar a confirmação atualizada ao hóspede.

Cancelando uma Reserva

Para cancelar uma reserva:

1. Abra a visualização de detalhes da reserva.
2. Clique em Cancelar Reserva (botão vermelho no cabeçalho).
3. Uma janela modal de confirmação aparece. Confirme para prosseguir.
4. O status da reserva muda para Cancelada e as datas são liberadas no calendário de disponibilidade.

O cancelamento é refletido automaticamente em todos os canais conectados.

Quando uma reserva é cancelada, suas finanças são neutralizadas para que não contem mais para receita ou saldos ativos:

• O cartão de detalhamento de preço é renomeado para Economia original da reserva e fica esmaecido — permanece visível para registro, mas não é mais tratado como valor devido.
• O saldo devedor cai para zero e o selo de pagamento exibe Anulado em vez de mostrar um valor fantasma a pagar.
• Para reservas de OTA, o valor líquido ao proprietário reflete o resultado real do cancelamento em vez do pagamento projetado original. Quando o Airbnb confirma um reembolso total (nada retido), o pagamento é resolvido automaticamente para R$ 0,00. Quando o valor retido ainda precisa de uma decisão humana, a reserva é sinalizada para revisão de liquidação (consulte Modificações de Reservas de OTA).

A Visualização da Lista de Reservas

A visualização de lista fornece várias ferramentas para encontrar e gerenciar reservas:

• Indicadores operacionais — Quatro medidores circulares no topo fornecem uma visão geral das operações do dia, em vez de totais financeiros:
  • Chegando Hoje — Reservas confirmadas ou com check-in feito cuja data de chegada é hoje.
  • Partindo Hoje — Reservas confirmadas ou com check-in feito cuja data de partida é hoje.
  • Pagamento Pendente — Reservas ativas que não foram pagas ou foram pagas apenas parcialmente. O medidor destaca em âmbar quando alguma reserva precisa de atenção.
  • Ocupação — A parcela de suas propriedades ativas que atualmente têm hóspedes hospedados, mostrada como uma porcentagem.
• Pesquisa — Pesquisa de texto completo em nomes de hóspedes, nomes de propriedades e códigos de confirmação.
• Filtros — Filtrar por propriedade, status, fonte (OTA), intervalo de datas e Precisa de revisão (reservas cuja liquidação de OTA ainda precisa de uma decisão manual — consulte Modificações de Reservas de OTA). Clique em "Limpar filtros" para redefinir.
• Alternância de visualização — Alterne entre Visualização em cartões (cartões de reserva visuais) e Visualização em tabela (tabela de dados classificável com colunas para código de confirmação, status, propriedade, hóspede, datas, noites, fonte, preço total e status de pagamento). A primeira coluna mostra o código de confirmação de cada reserva como um link para sua visualização de detalhes.
• Paginação — Os resultados são paginados com 12 reservas por página.

[Screenshot: A lista de reservas na visualização em tabela com filtros aplicados, mostrando as abas de status, barra de pesquisa e colunas classificáveis.]

Status de Pagamento

Cada reserva também rastreia o pagamento de forma independente:

Status de Pagamento	Cor	Significado
Pago	Azul	Pagamento integral recebido.
Parcial	Amarelo	Algum pagamento recebido; saldo restante.
Pendente	Amarelo	Nenhum pagamento registrado ainda.
Reembolsado	Cinza	O pagamento foi devolvido ao hóspede.
Falhou	Vermelho	Uma tentativa de pagamento falhou.

Conceitos Principais

• Fonte da Reserva — Onde a reserva se originou: direta, Airbnb, Booking.com, VRBO, telefone, e-mail, indicação, hóspede repetido, entrada manual ou outro. Isso é usado para relatórios e é mostrado como um ícone de canal na visualização de lista.
• Agente de Reservas — O membro da equipe que cuidou ou trouxe a reserva. Usado para controle de comissão de agente. Reservas de OTA (Airbnb, Booking.com, VRBO) não geram comissões de agente; apenas reservas de canal direto atribuídas a um agente geram um registro de comissão no check-out.
• Referência Externa — O código de confirmação de uma OTA ou sistema externo. Útil para referência cruzada com painéis de parceiros de canal.
• Notas Internas — Notas de texto livre visíveis apenas para a equipe. Use-as para instruções especiais, preferências do hóspede ou detalhes de coordenação.
• Código de Confirmação — O identificador da reserva dentro do Argonautas, exibido em comunicações voltadas para o hóspede.

Importando Reservas Históricas

Se você está migrando de outro sistema de gerenciamento de propriedades, um administrador pode importar em lote reservas históricas de um arquivo CSV através de um comando de gerenciamento do lado do servidor. Isso é destinado como uma ferramenta de migração única, não para entrada de dados do dia a dia.

Forneça ao seu contato de suporte:

• Uma exportação CSV de reservas passadas, com uma linha por reserva e colunas para propriedade, nome do hóspede, e-mail, datas, status e totais.
• Uma lista de mapeamentos de nome de propriedade → ID de propriedade no Argonautas (ou nomes de propriedade consistentes para que o importador possa correspondê-los automaticamente).

O importador é tolerante a variações de formatação em datas, totais e status. Ele desconecta os sinais pós-salvamento durante a execução, para que a importação de milhares de reservas passadas não dispare milhares de e-mails de confirmação para hóspedes que já se hospedaram anos atrás.

Perguntas Frequentes

Posso alterar a propriedade de uma reserva após a criação? A propriedade é definida no momento da criação e não pode ser alterada. Se um hóspede precisar mudar para uma propriedade diferente, cancele a reserva original e crie uma nova.

O que acontece com as reservas de OTA se eu as modificar no Argonautas? As alterações feitas no Argonautas (como ajustes de data) são sincronizadas de volta para a OTA através do seu provedor de canal, dependendo das capacidades do canal.

Como faço para marcar um hóspede como check-in feito ou check-out feito? Altere o status da reserva para "Check-in Feito" ou "Check-out Feito" no menu suspenso de status da visualização de detalhes e salve.

Posso criar uma reserva para datas que se sobrepõem a outra reserva? Não. O sistema valida contra reservas existentes para a mesma propriedade. Estadias de proprietário e bloqueios de manutenção também impedem reservas de hóspedes sobrepostas.

Relacionados

• Guia de Preços — Como tarifas, descontos e taxas determinam os preços das reservas.
• Calendário de Disponibilidade — Calendário visual mostrando a disponibilidade da propriedade.
• Guia de Mensagens — Comunicando-se com os hóspedes antes, durante e após a estadia.