# Reservas

> O espaço onde o membro reserva salas, mesas e estações do espaço físico, pagando em créditos. Cadastro das salas, busca, reserva com custo e saldo, conflito com sugestão de horário, remarcar, cancelar, bloqueio de manutenção, reserva em nome de alguém, ausência, convite de calendário e lembrete.

O módulo **Reservas** deixa o membro **reservar salas, mesas e estações** do espaço físico (coworking, sede, escritório) por hora, **pagando em [créditos](/monetizacao/creditos)**. A equipe cadastra o que existe para reservar, define quanto cada coisa custa, e o membro encontra o que está livre, reserva e recebe a confirmação por e-mail com um convite para a agenda dele.

## Para que serve

| Comunidade | Reservas |
|---|---|
| Coworking | Sala de reunião para 8 pessoas, custo de 3 créditos a cada 30 minutos, paga com os créditos do plano |
| Escritório compartilhado | Mesas e estações por hora, para quem não tem lugar fixo |
| Sede de associação | Auditório e salas de comissão, com bloqueio nos dias de assembleia |
| Estúdio | Estações de edição reservadas por períodos de 2 horas |

## Como funciona

### O que se reserva

Cada coisa reservável é uma **sala ou mesa** (o app usa os tipos **Sala**, **Mesa**, **Estação** e **Outro**). Ela tem:

| Campo | O que significa |
|---|---|
| **Nome** e **Descrição** | Como o membro a vê |
| **Capacidade (pessoas)** | Quantas pessoas cabem; em branco, sem limite |
| **Unidades** | Quantas reservas aceita **ao mesmo tempo**. 1 é uma sala exclusiva; mais de 1 é um conjunto de mesas iguais |
| **Comodidades** | Projetor, TV, quadro branco, flipchart, videoconferência, viva-voz, monitor, Wi-Fi, tomadas, ar-condicionado, luz natural, café e água, mesa em pé, cabine telefônica, impressora e acessível |
| **Foto** | Aparece no cartão e na página da sala (recomendado 1800 × 600 pixels, 3:1) |
| **Horário semanal** | Quando pode ser reservada, no relógio da comunidade |
| **Preços** | Quanto custa em créditos (ver [Preços](#precos-em-creditos)) |

Três interruptores controlam a situação dela: **Aberta para reserva** (desligado, as pessoas veem, mas não reservam), **Ativa** (desligado, pausada: sem reservas novas, as existentes continuam) e **Visível para os membros** (desligado, só a equipe vê).

### Regras de reserva

O espaço define os padrões e cada sala pode mudá-los (campo vazio segue o espaço):

| Regra | Padrão |
|---|---|
| **Intervalo (minutos)** | 30: as reservas começam em múltiplos disto |
| **Menor reserva** e **Maior reserva (minutos)** | A menor é o intervalo; a maior, 240 (4 horas) |
| **Folga entre reservas** | Tempo mantido livre depois de cada reserva |
| **Antecedência mínima (minutos)** | 0: dá para reservar para agora |
| **Reservar com até (dias de antecedência)** | 30 |
| **Cancelamento sem perda até (horas antes)** | A janela da comunidade (24 h) |
| **Mostrar quem reservou** | Desligado: a agenda diz só "Ocupado" |

> [!NOTE]
> Por padrão, uma sala reservada continua **ocupada durante todo o horário, sem check-in**: ninguém precisa "chegar" para a reserva valer, e ela não é liberada sozinha se a pessoa não aparece. A equipe pode marcar a [ausência](#ausencia-no-show) à mão.

### Preços em créditos

Sem **faixa de preço**, a sala é **grátis**. Cada faixa diz **quantos créditos custa cada bloco de tempo** (por exemplo, 3 créditos a cada 30 minutos), e pode valer para **todos os dias**, para **um dia da semana** ou para **uma data específica**, com horário de início e fim opcionais. Vale a **primeira faixa que se encaixa**: uma data específica, depois um dia da semana, depois todos os dias. O custo é por bloco, e **cada bloco usa a faixa em que começa**.

Exemplo: a sala custa 3 créditos a cada 30 minutos. Uma reserva de 2 horas tem 4 blocos e custa **12 créditos**. Mudar a faixa depois **não altera** as reservas já feitas.

Horários que exigem pagamento em dinheiro ainda não estão disponíveis: aparecem com o aviso de que exigem pagamento e não dá para reservar.

## O que o membro faz

O espaço Reservas tem as abas **Agenda**, **Buscar sala** e **Minhas reservas** (e, para a equipe, **Salas e mesas** e **Reservas**). Quem não está logado vê **Entre para reservar**.

### Buscar uma sala

Em **Buscar sala**, informe o **dia**, a janela (**A partir de** e **Até**), a **duração**, quantas **pessoas** e o **tipo**, e marque o que ela **precisa ter** (as comodidades; todas são exigidas). O app mostra só o que atende, com o **custo em créditos** de cada uma, os horários de início livres e o seu saldo. Se o saldo não cobre um horário, ele aparece como créditos insuficientes. Se nada atende, o app mostra os **próximos horários livres** para o mesmo pedido.

A **Agenda** mostra o dia ou a semana de uma sala (ou de todas), com os horários **Livre**, **Livre, créditos insuficientes** e **Ocupado**.

### Reservar

1. Escolha o horário livre na busca ou na agenda. A janela **Reservar [sala]** abre.
2. Confira a **duração**: o app calcula o **custo** e mostra o seu **saldo**. Sem créditos suficientes, ele avisa *"Custa X, o saldo é Y: faltam Z créditos"* e não deixa confirmar.
3. Preencha as **pessoas** (até a capacidade), o motivo (**Para quê?**) e as **observações**, se quiser.
4. Clique em **Confirmar reserva**. O custo é **debitado na hora**, e a tela mostra *"Reserva confirmada"*, quantos créditos foram debitados e o saldo agora, com o botão **Adicionar ao calendário**.

A reserva já nasce **confirmada**: não há aprovação.

### Quando o horário já foi ocupado

Se alguém reservou o horário primeiro, a reserva não é feita e o app mostra **Horários livres próximos ao pedido**, para você escolher outro sem recomeçar. A mesma pessoa não consegue duplicar a reserva do mesmo horário.

### Remarcar

Em **Minhas reservas › Próximas**, **Remarcar** troca o dia e o horário de início **na mesma sala**, mantendo a duração. O app mostra o acerto antes de confirmar:

| Novo horário | O que acontece com os créditos |
|---|---|
| Custa o mesmo | Nada muda (*"Mesmo custo"*) |
| Custa mais | A **diferença é debitada** (sem saldo para a diferença, não remarca) |
| Custa menos | A **diferença é devolvida** |

Só dá para remarcar uma reserva ativa que ainda não começou. Remarcar não renova a janela de cancelamento: se a reserva já estava dentro da janela, cancelá-la depois continua sendo cancelamento tardio. O convite do calendário é atualizado e a pessoa recebe um e-mail avisando a mudança. Uma reserva de cortesia nunca mexe nos créditos.

### Cancelar

**Cancelar** abre a confirmação *"Cancelar esta reserva?"*. Cancelando **dentro da janela** de cancelamento (24 h por padrão), os créditos voltam por inteiro. **Depois dela**, o cancelamento é **tardio** e, por padrão, os créditos **se perdem** (a comunidade pode mudar isso nas [regras de créditos](/monetizacao/creditos#as-regras-da-comunidade)). Reserva grátis não tem o que devolver. O horário volta para a agenda, a pessoa recebe o e-mail e o evento é cancelado na agenda dela. Uma reserva que já começou não se cancela.

## O que a equipe faz

A equipe aqui é o proprietário, o administrador, o moderador e o financeiro. Acima da lista, a barra **Gerenciar reservas** mostra quantas reservas há **hoje** e traz **Nova sala ou mesa** e **Configurar espaço**.

### Cadastrar salas e mesas

Em **Salas e mesas**, **Adicionar sala ou mesa** pede o básico (nome, tipo, capacidade); depois, na tela da sala, as abas **Agenda**, **Dados e regras**, **Horário semanal**, **Bloqueios**, **Preços**, **Foto** e **Comodidades**. O tipo **não muda** depois de criado. Só o proprietário e o administrador criam, editam e excluem salas.

Excluir uma sala com **reservas futuras** pede para cancelá-las: os créditos voltam por inteiro e os membros são avisados por e-mail. As reservas já concluídas continuam no histórico.

### Bloqueio de manutenção

Em **Bloqueios**, **Bloquear** impede reservas num período (manutenção, feriado, evento) e **Abrir extra** cria um horário fora do semanal, sempre no relógio da comunidade. Bloquear um período com **reservas no caminho** exige cancelá-las: o app lista quantas são, os créditos **voltam por inteiro** e os membros são avisados por e-mail, com o seu motivo. Remover um bloqueio devolve o horário, mas as reservas que ele já cancelou **não voltam**. O bloqueio é da equipe toda (proprietário, administrador, moderador e financeiro).

### Reservar em nome de alguém

Na janela de reserva, a equipe vê **Reservar em nome de outra pessoa**: busque o membro; o custo é **debitado dele**, e é ele quem recebe o e-mail e o convite. Deixe vazio para reservar para você.

Só o proprietário e o administrador veem também a **Cortesia (sem créditos)**: a reserva sai de graça para o membro e nada é debitado, e é obrigatório dizer **por que** é uma cortesia.

### Ausência (no-show)

Quando o membro não aparece, a equipe (ou o anfitrião da agenda, no [Agendamento](/espacos/agendamento)) abre a reserva e escolhe **Ausência**. Só vale para reserva confirmada que **já começou**. O que acontece com os créditos segue a regra da comunidade: por padrão, **se perdem**; com a regra desligada, voltam.

### A lista de reservas

A aba **Reservas** (equipe) lista as reservas de todos, em **Próximas**, **Passadas** e **Canceladas**, com filtro por sala e por dia. Cada linha traz **Remarcar**, **Ausência** e **Cancelar**; o cancelamento pela equipe **sempre devolve os créditos por inteiro** e o membro é avisado por e-mail.

## E-mails e calendário

| Quando | O que a pessoa recebe |
|---|---|
| Reserva confirmada | E-mail com o horário (no fuso da comunidade), o custo, o saldo e um **convite de calendário** (arquivo `.ics`) |
| Reserva remarcada | E-mail avisando a mudança, e o **evento é atualizado** na agenda da pessoa |
| Reserva cancelada (por ela, pela equipe ou por bloqueio) | E-mail com o estorno, e o **evento é cancelado** na agenda da pessoa |
| **1 hora antes** | Um lembrete, uma única vez (reservas feitas dentro da última hora não recebem) |

O convite funciona no Google Agenda, no Outlook e no Apple Calendar. O convite sai do endereço da Memberfy, não do e-mail de uma pessoa. O botão **Adicionar ao calendário** na confirmação baixa o mesmo arquivo.

## Criar o espaço

1. **Adicionar Espaço**, aba **Coworking**, módulo **Reservas** (proprietário ou administrador).
2. Defina os padrões do passo **Reservas**: intervalo, menor e maior reserva, antecedência, quantos dias à frente a agenda fica aberta, **Mostrar quem reservou** e o **horário semanal**.
3. Salve e, no espaço, **Adicionar sala ou mesa**.
4. Para cobrar, crie as **faixas de preço** de cada sala e dê créditos aos planos e produtos (ver [Créditos](/monetizacao/creditos#passo-a-passo)).

## Quem pode o quê

| Ação | Proprietário | Administrador | Moderador | Financeiro | Membro |
|---|---|---|---|---|---|
| Buscar, reservar, remarcar e cancelar as próprias | ✔ | ✔ | ✔ | ✔ | ✔ |
| Ver a lista de todas as reservas | ✔ | ✔ | ✔ | ✔ | — |
| Reservar em nome de alguém, cancelar e remarcar as dos outros | ✔ | ✔ | ✔ | ✔ | — |
| Marcar ausência | ✔ | ✔ | ✔ | ✔ | — |
| Bloquear horário | ✔ | ✔ | ✔ | ✔ | — |
| Criar, editar e excluir salas | ✔ | ✔ | — | — | — |
| Faixas de preço | ✔ | ✔ | — | — | — |
| Reserva de cortesia | ✔ | ✔ | — | — | — |

## Erros comuns e como resolver

| Situação | O que fazer |
|---|---|
| *"Este horário não está mais livre"* | Alguém reservou antes; escolha um dos horários sugeridos |
| *"Faltam N créditos para esta reserva"* | Peça créditos à equipe, ou escolha um horário mais barato |
| A sala não aparece para o membro | Confira **Aberta para reserva**, **Ativa** e **Visível para os membros** |
| Não consigo bloquear um período | Há reservas nele: confirme o cancelamento delas |
| *"Este horário exige pagamento"* | Pagamento em dinheiro ainda não está disponível; use uma faixa em créditos |

## Perguntas frequentes

**Preciso de check-in?** Não. Por padrão a sala reservada fica ocupada o horário todo, e a equipe marca a ausência à mão.

**Posso cobrar em reais?** Ainda não: as reservas se pagam em créditos.

**O membro pode reservar sem créditos?** Só uma sala grátis (sem faixa de preço) ou uma cortesia.

**Quem vê o nome de quem reservou?** Só se **Mostrar quem reservou** estiver ligado; senão, os membros veem "Ocupado".

## Na API e no MCP

As rotas ficam em `/api/bookings`, documentadas na [referência da API](/api/referencia). O assistente reserva, remarca, cancela e gerencia salas pela conversa: ver [Ferramentas · Reservas e Agendamento](/mcp/ferramentas-reservas).

## Relacionados

- [Créditos](/monetizacao/creditos)
- [Agendamento](/espacos/agendamento)
- [Presença](/espacos/presenca)
- [Módulos](/conceitos/modulos)