Reservas de mesas

A reserva funciona pelo mesmo esquema dos pedidos: o hóspede e o estabelecimento não editam um arquivo comum diretamente, mas enviam sinais separados que o servidor consolida. Assim não dá para mexer na reserva de outra pessoa: para fazer qualquer coisa com ela, é preciso o identificador imprevisível dela — que só o próprio hóspede tem (no link dele) e o estabelecimento. A visão geral da seção "Esquema do salão" está no artigo Esquema do salão; aqui tratamos em detalhes do próprio processo de reserva: criação, status, vínculo com a mesa, depósito e reserva por meio de agentes de AI.

Onde gerenciar as reservas#

Dois acessos equivalentes:

• Painel do salão no caixa — o chip 🗺 "Salão" no cabeçalho do ticket do POS, a aba "Reservas" (com um selo do número de solicitações em espera). O painel do salão está disponível por função — para o proprietário, o gerente ou o operador com permissão de gerenciar o salão — e com o botão "Chip do painel do salão" ativado em "Aparência do POS" (em tipos de estabelecimento que não são restaurantes, ele fica desativado por padrão). Além das reservas, o painel tem lista de espera, esquema, chamadas de garçom e análises por mesa;
• Esquema do salão no admin (/tables) — a mesma lista e o vínculo com as mesas no próprio esquema.

Nova reserva#

O botão "+ Nova reserva" abre o formulário:

• data e hora (com intervalo de 15 minutos);
• duração — 60/90/120/180/240 minutos;
• número de hóspedes (1–50);
• mesa — específica ou "Não atribuída" (no painel do salão no caixa, o mesmo item se chama "Sem mesa"), se você deixar a distribuição para depois. No caso do hotel, essa lista não tem quartos nem camas: o quarto é reservado por diárias, em um formulário separado — veja abaixo;
• nome do hóspede (obrigatório) e telefone — o número é registrado na forma como se escreve no país da unidade, por exemplo "+7 (912) 575-19-38": o agrupamento é inserido automaticamente durante a digitação, no campo vazio aparece um exemplo de número do país, nenhum dígito é alterado, e registros como "ramal 101" ou dois números separados por vírgula permanecem como digitados; o número também é exibido assim na lista de reservas;
• comentário.

Reservas criadas pela equipe recebem imediatamente o status "Confirmada" (diferente das reservas de hóspedes, que sempre começam como solicitação).

Status#

As ações de cada reserva ficam direto na linha da lista: confirmar (a partir de "Aguardando"), acomodar (a partir de "Confirmada"), concluir, além de "Não compareceram" e "Cancelar reserva". A acomodação muda o status, mas não abre a conta do cliente: no painel do salão no caixa, uma reserva já acomodada com mesa vinculada ganha um botão separado "Abrir ticket" — é ele que cria o pedido para essa mesa.

Em uma reserva que está em um quarto de hotel (essas sobraram de quando o quarto podia ser reservado por horas), em vez de "acomodar" aparece "Fazer check-in". É um check-in de verdade, não uma marcação na lista: abre-se a mesma janela do botão "Fazer check-in" no quadro de quartos. O nome e o telefone do hóspede já vêm preenchidos a partir da reserva, basta escolher o plano e, se necessário, preencher o documento. Após o check-in, o hóspede tem a conta do quarto aberta, o quarto fica ocupado, o registro vai para o livro de registro de hóspedes (na Rússia — para o registro migratório), e a reserva é marcada como "Hóspedes chegaram". Se o quarto não estiver pronto para o check-in (ocupado, não limpo, fora de serviço), a janela não abre — aparece uma explicação. No painel do salão no caixa, essa reserva também tem "Fazer check-in": o botão leva ao "Esquema do salão", para essa mesma janela. As mesas do restaurante dentro do mesmo hotel continuam sendo "acomodar". A ação final, também no caso do quarto, é "concluir": o check-out com fechamento da conta e envio do quarto para limpeza é feito pelo botão "Fazer check-out" no quadro de quartos.

Vínculo com a mesa e conflitos#

A mesa de uma reserva pode ser escolhida ou trocada direto na linha da lista — na lista suspensa há também o item "sem mesa". A troca para uma mesa que já está reservada por outra reserva em horário conflitante é rejeitada com a explicação "Conflita com outra reserva para esta mesa": o servidor faria o mesmo, só que em silêncio. No formulário de nova reserva do painel do salão no caixa, a ocupação é visível antes mesmo da escolha — a mesa ocupada no horário selecionado é marcada com "· Ocupada" e não pode ser selecionada, e se todas as mesas estiverem ocupadas, abaixo da lista aparece "Nenhuma mesa disponível" (a reserva "sem mesa" ainda é criada: a mesa será atribuída manualmente). O formulário também não aceita horários que já passaram. Atenção a uma particularidade da regra: a ocupação é calculada apenas com base em reservas confirmadas e já acomodadas — uma solicitação não confirmada não segura a mesa, ela é resolvida manualmente.

No próprio esquema do salão, uma mesa com reserva em andamento fica preenchida em âmbar e rotulada com o horário e o nome do hóspede, e uma mesa com a próxima reserva de hoje recebe um selo azul sem preenchimento — dá para ver de relance o que está ocupado agora e o que está prestes a ficar.

Reserva pelo hóspede#

No menu por QR e no site do estabelecimento, o hóspede abre a página de reserva, vê o mapa do salão (livre/ocupada/selecionada conforme as reservas atuais) e escolhe a mesa sozinho — ou várias mesas de uma vez, se o grupo for grande: nesse caso, a reserva é dividida igualmente entre as mesas selecionadas. O horário o hóspede define da mesma forma que você no painel do salão: início e duração — 60/90/120/180/240 minutos, por padrão 2 horas. Abaixo da lista está escrito até que hora a mesa fica reservada ("Até 21:00"); a reserva que atravessa a meia-noite (por exemplo, 22:00 + 3 horas) é calculada automaticamente. No hotel, o hóspede que abre o menu pelo QR do quarto reserva uma mesa do restaurante, e não o próprio quarto: se a mesa não for selecionada no mapa, a reserva chega "sem mesa" e não é vinculada ao quarto (o quarto é reservado por diárias — Hotel).

Os campos seguem a mesma ordem do formulário de reserva do painel do salão: primeiro data e hora, depois duração e número de hóspedes. A página abre na próxima hora cheia — tarde da noite, isso já é amanhã — e não aceita um horário que já passou: abaixo do campo aparece "Este horário já passou", e a solicitação não pode ser enviada enquanto o horário não for corrigido. Assim, não chega até você uma solicitação para a noite de ontem, que a lista de reservas esconderia imediatamente entre as passadas.

As mesas podem ser filtradas por características — são nove: à janela, terraço, silenciosa, tomada, acessível, para não fumantes, perto do palco, espaço para carrinho de bebê, aceita animais de estimação. As mesas que não se encaixam não são escondidas, mas atenuadas, para que o mapa do salão continue reconhecível. Se houver fotos carregadas para as mesas, o hóspede as abre em um lightbox no momento da seleção.

A ocupação no mapa do hóspede é calculada por todas as reservas ativas — incluindo solicitações não confirmadas: uma mesa já reservada para o horário escolhido não é oferecida ao hóspede. Se dois hóspedes ainda assim clicarem no mesmo segundo, a segunda reserva é rejeitada pelo servidor, e não apenas pela interface.

Se o hóspede deixar um e-mail, logo após a reserva ele recebe a mensagem "Solicitação de reserva recebida": horário, número de hóspedes, mesa e a indicação de que a reserva aguarda sua confirmação. Quando você confirmar a reserva, o hóspede receberá a mensagem "Reserva confirmada"; sobre remarcação e cancelamento da reserva também chegam e-mails. O hóspede pode adicionar a reserva ao calendário (arquivo .ics) e, a qualquer momento, abrir suas reservas: lá é possível ver o status em tempo real, há "Cancelar" e "Remarcar". Se o horário desejado estiver ocupado, o hóspede pode clicar em "Avise-me se vagar" — e receberá uma notificação quando a janela vagar.

A remarcação feita pelo hóspede é uma nova solicitação: você confirmou o horário anterior, não o novo. Por isso, uma reserva confirmada volta a ficar "Aguardando" após a remarcação — no painel do salão ela novamente tem o botão "Confirmar", e o hóspede vê "Aguardando confirmação" até que você confirme o novo horário (se o hóspede deixou um e-mail, ele receberá um e-mail de confirmação). Uma reserva com depósito — pago ou aguardando pagamento — permanece confirmada após a remarcação, assim como uma reserva remarcada pela própria equipe.

Sobre a remarcação você fica sabendo na hora, e não por uma linha que mudou silenciosamente: na tela aberta (mapa do salão, painel do salão do caixa, registro de agendamentos) aparece o aviso "O hóspede remarcou a reserva: nome, era → ficou" — no registro de agendamentos, ainda com som e notificação do navegador —, e o proprietário recebe um push no admin móvel e uma mensagem do bot do Telegram da unidade, se estiver conectado. Uma remarcação feita pela própria equipe não é revertida.

A reserva pelo hóspede vem ativada por padrão; se você não precisar dela, desligue-a com o botão na configuração do site da unidade — o botão atua no nível da unidade, e não da conta inteira.

Depósito pela reserva#

O depósito é configurado pelo botão "Depósito" (com o ícone de cartão) na janela de reservas da seção "Mapa do salão" — é um conjunto de regras, e não um valor único para todo o estabelecimento. Na regra, definem-se as condições ("dias da semana", "horário de/até", "a partir de quantos hóspedes") e os parâmetros: valor fixo, cobrado por hóspede ou pela reserva inteira, janela de cancelamento gratuito em horas e a caixa "reter em caso de não comparecimento". Não há percentual sobre o valor no depósito por mesa — ele existe apenas no pré-pagamento por agendamento de serviço, onde o preço do serviço é conhecido. É assim que se configura o cenário típico "sexta e sábado após as 18:00, grupo a partir de 6 pessoas".

Ao reservar online, o hóspede vê o valor exigido (ele é recalculado na hora quando o hóspede muda a data, o horário ou o número de hóspedes) e a janela de cancelamento gratuito. Em seguida:

• a reserva é criada imediatamente, mas o horário fica retido por 30 minutos — nesse prazo, o depósito precisa ser pago;
• assim que o pagamento é confirmado pelo provedor de pagamento, a reserva passa a "Confirmada";
• se o depósito não for pago no prazo previsto, a reserva é cancelada automaticamente com a marca "depósito não pago a tempo", e o horário é liberado — e quem pediu para ser avisado fica sabendo.

O cancelamento dentro da janela gratuita devolve o dinheiro automaticamente; o cancelamento tardio e o não comparecimento (se a regra tiver "reter em caso de não comparecimento") deixam o depósito com o estabelecimento. Na linha da reserva, vê-se o status do depósito — aguardando pagamento, pago, devolvido ou perdido —, e o botão "Devolver depósito" permite ao gerente devolver o dinheiro manualmente a qualquer momento, inclusive valores já retidos. O depósito só é ativado com a acquisição online configurada; sem ela, a reserva continua gratuita, como antes. ⚠️ O fechamento automático da reserva por não comparecimento (Painel do salão → "Reservas" → "⏱ Fechamento automático") NUNCA retém o depósito: o automático não toca em uma reserva paga, ela é encerrada pela equipe com o botão "Não compareceram" — junto com o status, decide-se o destino do dinheiro do hóspede.

Reserva via agentes de AI#

O mesmo mecanismo de reserva está disponível para assistentes de AI por voz e texto através da Guest API pública: o agente verifica as mesas livres (check_table_availability), cria a solicitação (create_reservation), pode verificar o status ou cancelar (get_reservation_status, cancel_reservation). Para o estabelecimento, essa reserva não é diferente de uma solicitação comum de hóspede — ela também entra na lista «Aguardando» e exige confirmação.

Banquetes#

Não existe uma entidade separada de «banquete» — o banquete é formalizado como uma reserva comum, com um grande número de hóspedes e a descrição do evento no comentário, vinculada ao salão de banquetes ou a mesas deslocadas no mapa.

O que é necessário para começar#

• Reserva ativada na unidade — em restaurante, café, bar e hotel ela existe por padrão; em refeitório e fast-food está desativada de forma consciente.
• Mapa do salão com mesas — para que a reserva possa ser vinculada a uma mesa específica (Mapa do salão).
• Canal de recebimento — vitrine, widget de reserva no seu site, Telegram ou agente de AI para hóspedes.
• Política de depósito — se a reserva for feita com pré-pagamento; para o depósito é necessário ter pagamento online funcionando.
• Local onde as reservas são vistas — a janela «Reservas» e a aba «Reservas» no Painel do salão.

Limitações#

• Uma reserva com depósito não pago mantém o horário por 30 minutos e depois o libera.
• Não há linha do tempo de reservas por mesa nem grade de assentos — a disponibilidade não é calculada por um esquema automático de acomodação, mas pela sua decisão.
• Não existe o status «hóspede chegou», assim como não há lembretes automáticos N horas antes da reserva; os lembretes no Telegram para o hóspede seguem suas próprias regras.
• O hóspede não escolhe a mesa no widget e no formulário da vitrine: ele deixa a solicitação, e a mesa é designada por você.
• Os depósitos são um mecanismo de pagamento geral, portanto, onde o pagamento online não está conectado, não é possível cobrar depósito.

Solução de problemas#

O hóspede não consegue reservar. A reserva está desativada na unidade ou o widget de reserva no seu site não foi pago como extensão.

A reserva não foi vinculada à mesa. A vinculação é feita pelo estabelecimento — o hóspede não a define.

O depósito não foi devolvido no cancelamento. A devolução segue a política de depósito; verifique suas condições e o status do pagamento.

A reserva não aparece no painel do salão. Você está vendo outra unidade ou a reserva está desativada.

O horário foi ocupado duas vezes. Os conflitos são exibidos, mas não há grade rígida de disponibilidade — para horários lotados, defina uma cota manualmente.

Seções relacionadas#

• Mapa do salão — editor do plano, códigos QR, garçons
• Painel do salão — posto de trabalho do hostess: reservas, lista de espera, mapa, chamadas
• Caixa (POS) — abertura de ticket a partir de uma reserva acomodada
• Guest API para agentes de AI — reserva em nome do hóspede de forma programática
• Agendamentos de serviços — o mesmo princípio de reserva para salões de beleza
• Funcionários e turnos — papéis e acesso ao painel do salão

Perguntas frequentes#

O hóspede pode reservar uma mesa sem ligar?#

Sim, diretamente pelo menu QR ou pelo site do estabelecimento — a solicitação aparece instantaneamente no painel do salão, e o hóspede vê imediatamente a confirmação ou o status «Aguardando».

O que acontece se dois funcionários acomodarem a mesma mesa no mesmo horário?#

O segundo não será permitido pela interface: tanto a troca de mesa na linha da lista quanto a criação de uma reserva para uma mesa ocupada são rejeitadas com a explicação «Conflita com outra reserva para esta mesa» — pela mesma regra com que o servidor já descarta esse sinal. Se dois funcionários clicarem no mesmo segundo, a segunda reserva será rejeitada pelo servidor. Uma solicitação não confirmada não mantém a mesa — o conflito por ela é resolvido manualmente.

Existe um modo separado para banquetes?#

Não há uma entidade separada — um banquete é uma reserva comum com um grande número de hóspedes, vinculada à zona necessária no mapa.