Manual da Bela Casa Praia

1. Começando

O sistema da Bela Casa Praia (Águas Belas, Caponga, Ceará) junta num só lugar o site público, as reservas, o calendário (com Airbnb e Booking), o caixa da casa, o painel do hóspede, o painel da equipe (caseiro, faxina e outros) e o painel dos comércios que vendem para a casa. Tudo fica gravado na nuvem: o que você muda no computador aparece no celular, e vice-versa.

Quem usa cada parte:

Admin o dono, que usa o painel completo   Equipe Luiz, Kaeline e outros   Hóspede quem reservou   Fornecedor comércios cadastrados   Site qualquer visitante

1.1 Os endereços

Por trás do site existe um serviço chamado Worker (casa-api), que guarda os dados (reservas, caixa, equipe…) e envia e-mails. Quando este manual diz “atualizar o Worker”, é isso.

1.2 Entrar no Admin

1. Abra belacasapraia.pages.dev/admin.html (ou o atalho instalado, veja 1.4).
2. Em Seu e-mail de administrador, digite o seu e-mail.
3. Em Senha, digite a senha do Admin.
4. Toque em Entrar. Abre a aba Pedidos.

Esqueci a senha:

1. Na tela de entrada, digite o e-mail e toque em Não consigo entrar — enviar código no e-mail.
2. Toque em Enviar código.
3. Abra o seu e-mail (olhe também o spam). Chega um código de 6 números. Ele vale 10 minutos.
4. Digite o código em Código de 6 dígitos e toque em Entrar com o código.
5. Já dentro, grave uma senha nova (veja 9.2).

1.3 Sair do Admin

1. No topo, toque no ícone da porta com seta (no computador, ao passar o mouse aparece “Sair”).
2. Aparece a janela “Sair do painel?”.
3. Toque em Sair para sair, ou em Cancelar para continuar no painel.

O navegador lembra o login. Para entrar com outra pessoa no mesmo aparelho, use uma janela anônima.

1.4 Instalar como aplicativo

Android (Chrome):

1. Abra o Admin no Chrome.
2. Toque no menu ⋮ (canto de cima, à direita).
3. Toque em Adicionar à tela inicial ou Instalar app → confirme.

iPhone (Safari):

1. Abra o Admin no Safari.
2. Toque em Compartilhar (quadrado com seta para cima).
3. Role e toque em Adicionar à Tela de Início → Adicionar.

Computador (Windows):

1. Na tela de entrada do Admin, toque em Baixar instalador do computador.
2. Abra o arquivo baixado (BelaCasaPraia-Admin.bat). Se o Windows avisar, toque em Mais informações → Executar assim mesmo.
3. Aparece na área de trabalho o atalho Admin da Bela Casa Praia.

Quando o painel pedir permissão para notificações, toque em Permitir para ser avisado de pedidos, mensagens e pendências.

1.5 Os ícones do topo do Admin

No computador, o nome de cada ícone aparece ao passar o mouse por cima.

1.6 Versões e atualização

• A versão aparece no rodapé de todas as páginas (por exemplo, v 12.65) e no menu lateral do Admin. Todas as páginas têm que mostrar a mesma versão.
• O sistema percebe sozinho quando há versão nova e se recarrega. Para forçar: toque no ícone ↻ Atualizar no topo.
• Para ver o que mudou em cada versão: ⚙ Configurações → Histórico → Versões (veja 9.3).

1.7 Tema claro ou escuro

1. No topo do Admin, do painel da equipe, do painel do comércio ou deste manual, toque no ícone da lua.
2. A tela fica escura (verde-azulado). O ícone vira um sol.
3. Toque no sol para voltar ao tema claro.

A escolha fica guardada em cada aparelho. Se limpar os dados do navegador, volta para o claro. O site público e o painel do hóspede não mudam de tema.

1.8 Quem vê o quê

A equipe e os fornecedores só enxergam o que eles mesmos enviaram. A senha de cada um nunca vai nas mensagens de WhatsApp.

2. O painel de administração

A barra de abas fica embaixo no celular e ao lado no computador. Toque no nome da aba para abrir.

Um número ou ! vermelho em cima da aba avisa que há algo novo ali (pedidos, mensagens, aviso de reserva).

2.1 Onde fazer cada coisa

2.2 Ajuda dentro do painel (ⓘ)

1. Perto dos títulos há o ícone ⓘ (às vezes escrito ⓘ Como funciona).
2. Toque nele (ou passe o mouse, no computador). Aparece uma explicação curta daquele bloco.
3. Toque de novo no ⓘ para fechar.

2.3 Abrir, fechar e organizar blocos

1. Os blocos com uma setinha ⌄ à direita abrem ao tocar no título e fecham ao tocar de novo.
2. Nas abas Agenda, Hóspede e Site, o botão Organizar (no fim da página) mostra setas ↑ ↓ em cada bloco.
3. Use as setas para mudar a ordem e toque em Concluir organização. A ordem fica igual no celular e no computador. Isso não muda o site público.

3. Reservas (aba Pedidos)

3.1 Como o hóspede reserva pelo site

1. No site, o hóspede toca em Reserve agora e escolhe entrada e saída no calendário (um mês por vez, setas ‹ › para mudar).
2. Informa adultos, crianças, bebês e animais. Só adultos e crianças entram no limite de 12. Bebê com menos de 2 anos não conta. Animal não conta e não é cobrado.
3. O site calcula o valor com as suas regras de preço e promoções (seção 4).
4. Informa nome, RG, CPF e cidade, como no contrato.
5. Paga o sinal de 30% por PIX (ou cartão pelo Mercado Pago). O restante é pago nas chaves.

Quando o sinal é confirmado, o hóspede recebe a senha do painel do hóspede e o link. Você recebe o e-mail “Nova reserva”.

3.2 Situações de uma reserva

Etiquetas de origem: Site WhatsApp Airbnb Booking. As reservas antigas marcadas como “Particular” passaram a ser Site. Uma bolinha ● com texto sinaliza algo que pede ação.

3.3 O quadro “Hoje” e o que falta receber

No topo de Pedidos, o quadro Hoje mostra: quantos entram hoje, entram amanhã, saem hoje, hospedados agora e aguardando sinal. Embaixo, dois valores:

• hóspedes devem: o que falta receber de reservas do site, do WhatsApp e das lançadas à mão;
• Airbnb e Booking vão repassar: previsão do que as plataformas ainda vão pagar.

Ver quem deve:

1. Toque no quadro hóspedes devem.
2. Abre a lista em três grupos: Cobrar agora (já passou ou entra em até 7 dias), Próximos 30 dias e Mais adiante, cada um com a soma.
3. Em cada linha: Abrir leva até a reserva; o ícone verde do WhatsApp chama o hóspede.
4. A lista fica aberta mesmo quando a tela se atualiza sozinha. Toque de novo no quadro para fechar.

Ver o que as plataformas vão pagar:

1. Toque no quadro Airbnb e Booking vão repassar.
2. Abre a lista das reservas do Airbnb e da Booking que ainda não tiveram o repasse importado. As linhas não têm WhatsApp, porque quem paga é a plataforma.
3. No topo da lista fica o grupo Sem valor ainda (entra com o CSV): reservas lançadas sem valor, com a etiqueta sem valor. Aparecem também as que já saíram há até 60 dias e ainda esperam o CSV. O quadro mostra quantas são (ex.: “2 sem valor (falta o CSV)”).
4. Quando o dinheiro cair, importe o arquivo do canal (5.8) e a reserva sai dessa lista.

3.4 Encontrar uma reserva

Pela busca:

1. Toque no campo Buscar por nome, telefone ou data….
2. Digite parte do nome, do telefone, o código ou uma data. A busca olha todas as reservas, mesmo as escondidas pelo filtro.
3. Apague o texto para voltar à lista normal.

Pelo filtro:

1. Toque em Filtrar: Atual e próxima ▾.
2. Escolha uma situação (Atual e próxima, Todas, Aguardando, Confirmadas, Finalizadas, Expiradas, Canceladas) ou uma origem (Site, Airbnb, Booking, WhatsApp).
3. O nome do filtro escolhido aparece no botão. O link Ver todas, embaixo, mostra todas de uma vez.

As reservas aparecem agrupadas por mês de entrada, com o número de reservas e a soma dos valores do mês.

3.5 O cartão da reserva e os botões

1. Toque no nome da reserva. O cartão abre e mostra período e horários, pessoas, contato, valores, comprovante, nota, registros da equipe (fotos, vídeos, observações) e os botões.
2. Toque de novo no nome para fechar. O ícone verde do WhatsApp, à direita do cartão fechado, chama o hóspede direto.

Os botões mudam conforme a situação:

Valores nas reservas do Airbnb e da Booking (linha de valores do cartão):

3.6 Lançar uma reserva (Airbnb, Booking ou direta)

1. Em Pedidos, toque em + Nova reserva. Abre o bloco Nova reserva (Airbnb, Booking ou direta).
2. Em Origem, escolha Airbnb · PNL-TNS, Booking · PNL-TNS ou Site / direta · PNL-TNS.
3. Preencha Nome, WhatsApp e E-mail. O e-mail é obrigatório para mandar o contrato pelo Autentique.
4. Escolha Entrada, Horário de entrada, Saída e Horário de saída.
5. Informe Adultos autorizados e Crianças. Aqui você pode passar de 12 se autorizou.
6. Site / direta: informe Valor total (R$) e Valor recebido (R$).
7. Airbnb ou Booking: o campo muda para Valor previsto (R$) · opcional e o Valor recebido some. Pode deixar em branco: o valor certo (o que cai na sua conta) e o recebido entram sozinhos quando você importar o CSV (5.8). Se colocar uma previsão, ela aparece no quadro “Airbnb e Booking vão repassar”; se deixar em branco, a reserva aparece em Sem valor ainda (3.3).
8. Se quiser, escreva uma Nota.
9. Toque em Lançar e gerar painel. A reserva bloqueia as datas no calendário e gera a senha do painel do hóspede. Na reserva direta com valor recebido, a receita entra no Caixa (PNL-TNS). No Airbnb e na Booking, a receita só entra no Caixa com o CSV.

3.7 Sinal, comprovante e restante

Confirmar o sinal pago por PIX:

1. Confira no banco que o PIX caiu.
2. Em Pedidos, toque na reserva (situação Aguardando sinal).
3. Toque em Confirmar PIX. A reserva passa a Confirmada e o hóspede recebe a senha do painel.

Guardar o comprovante na reserva:

1. Abra a reserva e vá até Comprovante do hóspede.
2. Toque em Anexar comprovante e escolha a foto ou o PDF. Ou copie a imagem (Ctrl+C) e toque em Colar.
3. Se anexou o arquivo errado, toque em Tirar embaixo dele.

Sinal pago no cartão: o Mercado Pago confirma sozinho e avisa por e-mail. O link belacasapraia.pages.dev/pagar/código abre direto o pagamento; se já foi pago, mostra o painel do hóspede.

Lançar o restante pago nas chaves (reserva do site):

1. Abra a reserva confirmada.
2. Toque em Restante no caixa. A receita entra no Caixa e o cartão passa a mostrar Pago.
3. Por 8 segundos aparece um aviso com Desfazer. Se perceber o erro depois, abra a reserva e toque em Desfazer restante do caixa.

3.8 Editar, cancelar ou excluir

Editar:

1. Abra a reserva e toque em Editar.
2. Mude o que precisar: origem, nome, contato, datas, horários, pessoas, Valor total, Valor recebido ou nota.
3. Toque em Guardar alteração.

Airbnb e Booking:

• Antes do CSV: aparece Valor previsto (R$) · opcional (pode mudar ou deixar em branco) e Valor recebido com o texto “entra com o CSV” (não dá para mudar).
• Depois do CSV: aparece o quadro Dados do CSV do Airbnb (ou da Booking) com Código da reserva, Hóspede pagou (bruto), Taxa, Caiu na conta (repasse), Data do repasse, Valor total e Valor recebido, todos cinza: não se editam aqui, porque são os mesmos do Caixa. Para corrigir, baixe o CSV de novo e importe (5.8). Os outros campos (nome, contato, datas, pessoas, nota) continuam editáveis.

Numa reserva do site ou do WhatsApp já quitada, o Valor recebido já vem com o total: guardar de novo não faz o cartão voltar a mostrar falta. Se a reserva foi paga por inteiro de uma vez (cartão, por exemplo), coloque o Valor recebido igual ao total; o contrato então diz que foi pago integralmente.

Cancelar:

1. Abra a reserva e toque em Cancelar (botão vermelho).
2. Confirme na pergunta que aparece.
3. As datas são liberadas e abre o WhatsApp com a mensagem de cancelamento (texto em 9.4).

Excluir (só para corrigir erro, apaga o registro):

1. Abra a reserva e toque em Excluir (botão vermelho).
2. Confirme na pergunta que aparece.

3.9 Faxina extra

Para uma faxina que não pertence a nenhuma reserva (antes de uma visita, depois de uma obra…):

1. Em Pedidos, toque no botão verde + Faxina extra.
2. Em Colaboradora, escolha quem fez.
3. Em Dia da faxina, escolha o dia em que foi feita.
4. Em Motivo, escreva o porquê.
5. Em Valor (R$), deixe em branco para usar o valor padrão dela, ou digite outro.
6. Toque em Lançar faxina extra. Ela entra já aprovada no pagamento do mês do dia informado.
7. Para corrigir, toque em Excluir na lista que aparece embaixo do formulário.

3.10 Faxina que não foi da Kaeline

1. Abra a reserva (confirmada ou finalizada).
2. Toque no link Faxina: não foi a Kaeline.
3. A faxina sai do pagamento dela e o cartão dela mostra “Faxina: não foi feita por você”.
4. Para voltar atrás, toque em Desfazer: foi a Kaeline.

3.11 Aviso amarelo “Possível reserva”

Quando o calendário do Airbnb ou da Booking mostra dias ocupados que não têm reserva lançada aqui, aparece no topo de Pedidos e da Agenda um aviso como “Possível reserva no Booking · 24-04 → 05-05 (11 noites)”, e o ! na aba Pedidos.

1. Confira no Airbnb ou na Booking se é mesmo uma reserva.
2. Se for: toque em Lançar. Abre a Nova reserva já com a origem e as datas; complete e lance (3.6). O aviso some.
3. Se não for (bloqueio seu, manutenção, uso da família): toque em Não é reserva. O aviso some e não volta para essas datas.

O sistema já ignora o fim do calendário do canal e trechos que começam a mais de 12 meses. No Airbnb, dia bloqueado (“não disponível”) não gera aviso.

Outros avisos (reserva que sumiu do canal, datas que não batem) têm o botão Já conferi: confira no canal e toque nele para o aviso sumir.

3.12 Pedir avaliação ao hóspede

1. Depois da saída, abra a reserva (situação Finalizada).
2. Toque em Pedir avaliação. Abre o WhatsApp do hóspede com o link da avaliação no Google (configurado em 7).
3. Envie a mensagem.

3.13 Visitas no site

1. No fim da aba Pedidos, toque em Visitas no site.
2. Aparecem as visitas de Hoje, dos 7 dias e o Total, separadas por página (Site, Álbum e painel do Hóspede). Cada número de internet conta uma vez por dia.

3.14 Reserva que chega pelo WhatsApp

Quando o robô do WhatsApp cria a reserva, o cartão em Pedidos mostra a etiqueta WhatsApp. O sinal, o Confirmar PIX, o cancelamento e a senha do hóspede funcionam como na reserva do site. O sistema avisa o robô quando nasce uma reserva, quando o sinal está pendente, quando você confirma o PIX, quando o cartão confirma, quando passam 24 horas sem sinal, quando você cancela e quando lança uma reserva à mão. Se o robô estiver fora do ar, a reserva e o e-mail seguem normalmente.

4. Agenda

Preços, promoções e o calendário que o site e os canais usam. Abra a aba Agenda.

4.1 Valores e regras

1. Toque no bloco Valores e regras.
2. Preencha Diária semana (R$), Fim de semana (R$) e, se usar, Promoção sexta a domingo, 2 noites (R$).
3. Preencha Mínimo de noites e Máximo de pessoas (máximo 12 no site).
4. Descontos de estadia longa: 1º desconto: a partir de X noites e 1º desconto (%); depois 2º desconto: a partir de X noites e 2º desconto (%). A marca “só de segunda a quinta” vale para os dois: se a estadia pegar sexta, sábado ou domingo, nenhum desconto entra.
5. Em Meses sem desconto de longa, digite os números dos meses separados por vírgula (ex.: 1,7,12 = janeiro, julho e dezembro).
6. Em Feriados extras, uma data por linha no formato AAAA-MM-DD. Os feriados nacionais e do Ceará já entram sozinhos; feriado ou véspera tira o desconto de dias de semana.
7. Toque em Salvar. A faixa de promoção do site muda junto com os percentuais.

4.2 Promoções por período

Criar:

1. Toque no bloco Promoções por período.
2. Escreva o Nome (ex.: Réveillon) e escolha De e Até.
3. Em Tipo, escolha: Valor fixo (R$) (troca a diária por um preço fixo), Desconto (%) (porcentagem sobre a diária normal) ou Bloquear desconto de longa (não mexe no preço, só impede o desconto de estadia longa).
4. Em Valor, digite o preço ou a porcentagem (no “Bloquear desconto de longa” pode deixar vazio).
5. Se quiser, preencha Mínimo de noites neste período.
6. Toque em Adicionar promoção. Ela aparece na lista.
7. Toque em Salvar. Sem este passo, nada é gravado.

Corrigir:

1. Na lista, toque em Editar na promoção. Os dados voltam para o formulário.
2. Mude o que precisar e toque em Atualizar promoção (ou Cancelar edição).
3. Toque em Salvar.

4.3 Calendário: preço de um dia, bloquear e liberar

1. Toque no bloco Calendário (ele já vem aberto).
2. Use ← e → para mudar de mês.
3. Toque nos dias que quer mudar (pode vários). Eles aparecem em Dias selecionados.
4. Para mudar o preço: digite em Preço destes dias (R$) e toque em Aplicar valor.
5. Para fechar as datas: toque em Bloquear. Para abrir de novo: Liberar.
6. Para desmarcar tudo: Limpar datas selecionadas.
7. Toque em Salvar calendário. Só grava aqui.

Legenda: Livre, Selecionado, Bloqueado e Reservado.

4.4 Hospedagens embaixo do calendário

1. Embaixo do calendário, cada hospedagem aparece na sua cor: vermelho Airbnb, azul Booking, verde Bela Casa Praia.
2. Toque num dia reservado do calendário: a lista mostra a hospedagem daquele dia.
3. Toque em Ver dados ▾ para abrir o cartão completo (dados do hóspede, editar, cancelar) ali mesmo.

4.5 Ligar o calendário com Airbnb e Booking (iCal)

São 4 links no bloco Links Airbnb, Booking e Bela Casa Praia: dois que trazem as reservas dos canais para cá e dois que levam as nossas reservas para lá.

Trazer o calendário do Airbnb para cá:

1. No Airbnb, use o computador com a janela bem larga (no celular ou em janela estreita o painel da direita não aparece).
2. No menu de cima, clique em Calendário.
3. Na lista da esquerda (“1 anúncio”), clique em Casa na Praia de Águas Belas - Caponga. Abre o calendário do mês e, à direita, um painel com Preços, Descontos, Disponibilidade e Cancelamentos.
4. No painel da direita, clique em Disponibilidade.
5. Role o painel até o fim, no título Conectar calendários. Ali aparece o calendário já ligado (Bela Casa Praia, com “Última atualização”, Atualizar e Editar).
6. Clique em Conectar outro calendário e depois em Conectar a outro site.
7. Na Etapa 1 – Link do calendário do Airbnb, clique em Copiar. Esse é o link que vem para cá.
8. Não preencha a Etapa 2 agora: clique na seta de voltar (‹) no alto do painel para sair sem mudar nada.
9. No Admin: Agenda → Links Airbnb, Booking e Bela Casa Praia → cole em Link EXPORTAR do Airbnb.

Trazer o calendário da Booking para cá:

1. Entre na extranet da Booking (admin.booking.com).
2. No menu azul de cima, clique em Calendário e preços ▾.
3. Na lista que abre, clique em Sincronizar calendários.
4. Na página que abre, copie o link de exportação do calendário da Booking (o link que termina em .ics).
5. No Admin, cole em Link EXPORTAR do Booking.
6. Toque em Sincronizar agora. As datas ocupadas nos canais passam a ficar bloqueadas aqui.

Levar as nossas reservas para o Airbnb e a Booking:

1. No Admin, toque em Copiar link Airbnb (campo Colar na Airbnb).
2. No Airbnb (computador, janela larga): Calendário → clique no anúncio → painel da direita Disponibilidade → role até Conectar calendários.
3. Se já existir a linha Bela Casa Praia, não precisa fazer nada: ela já está ligada. Para trocar o link, clique em Editar nessa linha.
4. Se não existir: clique em Conectar outro calendário → Conectar a outro site.
5. Na Etapa 2, cole o link em Link para outro site e escreva Bela Casa Praia em Nome do calendário.
6. Clique em Adicionar calendário. A linha nova aparece em Conectar calendários; o botão Atualizar dela puxa as datas na hora.
7. No Admin, toque em Copiar link Booking (campo Colar na Booking).
8. Na extranet da Booking: Calendário e preços ▾ → Sincronizar calendários.
9. Na página que abre, adicione um calendário novo (importar), cole o link, dê o nome Bela Casa Praia e salve.

4.6 Aviso de mês novo para conferir valores

Quando um mês novo entra na janela de reservas (24 meses), aparece um aviso na Agenda e chega um e-mail.

1. Confira os preços desse mês no Calendário (4.3) e as promoções (4.2).
2. Toque em Valores conferidos. O aviso some.

5. Caixa

5.1 Como a tela do Caixa está organizada

A ordem é fixa, de cima para baixo:

1. A conferir (só aparece quando há algo para pagar ou aprovar).
2. O Mês, com as setas ‹ ›, e os números de Neste mês: Receitas, Despesas e Saldo.
3. O botão + Lançar.
4. O filtro Todos Receitas Despesas e a lista do mês (bolinha verde = receita, vermelha = despesa).
5. Uma linha com o Saldo geral, desde o início.
6. Os blocos fechados: Relatório e impressão, Importar repasses (Airbnb e Booking) e Histórico de fornecedor.

Receita de reserva aparece como “Reserva (PNL-TNS)”. Os avisos de reserva não aparecem no Caixa: ficam em Pedidos e na Agenda.

5.2 Ver outro mês e filtrar a lista

1. Toque em ‹ para o mês anterior ou › para o próximo (ou toque no mês e escolha).
2. Toque em Receitas para ver só as entradas, Despesas para ver só as saídas, ou Todos.

5.3 Lançar uma despesa ou receita

1. Toque em + Lançar.
2. Marque Despesa ou Receita.
3. Toque num botão rápido de categoria (Energia Gás Limpeza Caseiro Faxineira Internet Manutenção Mercado) ou escreva em Categoria.
4. Digite o Valor (R$) e escolha a Data.
5. Se quiser, escreva uma Observação (quem, nota, mês de referência).
6. Toque em Lançar. O lançamento aparece na lista do mês da data escolhida.

5.4 Corrigir, excluir ou ver a nota de um lançamento

1. Na lista do mês, toque no lançamento. Aparecem os botões Nota Editar Excluir.
2. Editar: mude tipo, categoria, valor, data ou observação → Salvar (ou Cancelar).
3. Excluir: confirme na pergunta. Some do Caixa.
4. Nota: abre a nota amarela do lançamento. Enviar nota manda a imagem da nota para outro aplicativo (WhatsApp, por exemplo).
5. Toque de novo no lançamento para esconder os botões.

5.5 Pagar a equipe (Luiz e Kaeline)

1. Em A conferir aparece o cartão Pagar mensal · Luiz ou Pagar faxina · Kaeline, com o mês, a quantidade de faxinas e o total.
2. Pague pelo PIX: Copiar QR (cole no app do banco como “PIX Copia e Cola”) ou Copiar PIX (a chave).
3. Envie o comprovante: Foto do comprovante (escolha a imagem) ou copie a imagem e toque em Colar. Sem comprovante não dá para marcar pago.
4. Toque em Marcar pago e lançar no caixa. A despesa entra no Caixa uma única vez e a colaboradora vê o pagamento concluído, com o comprovante.

Quando e quanto se paga: seção 14.

5.6 Pagar uma compra de fornecedor e outros itens do “A conferir”

Compra registrada por um comércio (cartão “Aguardando pagamento”):

1. Confira os itens, o total e as fotos da compra.
2. Pague pelo PIX (Copiar QR ou Copiar PIX).
3. Envie o comprovante (Foto do comprovante ou Colar).
4. Toque em Marcar pago. A despesa entra no Caixa. Se a compra estiver errada, use Excluir.

Faxina extra enviada pela equipe: toque em Aprovar (entra no pagamento) ou Recusar.

Áudio da equipe (pedido gravado): ouça e toque em Já ouvi para tirar da lista, ou Excluir.

5.7 Relatório e impressão

1. Toque no bloco Relatório e impressão.
2. Escolha o período: De e Até, ou um atalho (Este mês, Mês passado, Este ano, Tudo).
3. Toque em Ver relatório. Aparecem receitas e despesas por categoria e o saldo do período.
4. Para papel ou PDF: toque em Imprimir e escolha a impressora ou “Salvar como PDF”.

5.8 Importar repasses do Airbnb e da Booking

Coloca nas reservas do Airbnb e da Booking o valor que o canal de fato pagou (já sem a taxa dele) e acerta o Caixa com esse valor, na data do pagamento. São duas partes: baixar o arquivo no canal e importar no Admin.

Parte A — Baixar o arquivo do Airbnb (no computador):

1. No Admin, Caixa → bloco Importar repasses → toque em Abrir pagamentos do Airbnb ↗. Abre a página Pago do Airbnb (se pedir login ou código, entre). Sem o atalho: airbnb.com.br → Menu → Ganhos → Pago.
2. Opcional: no filtro Todas as datas (no alto da lista), escolha só o período que quer importar. Pode também deixar Todas as datas.
3. Toque em Exportar CSV (canto de baixo, à direita).
4. Na janela Exportar transações, deixe marcado Baixar CSV e todos os campos de “O que incluir”.
5. Toque em Exportar CSV. Aparece “Preparando o relatório” e o arquivo airbnb_.csv vai para a pasta Downloads.

Parte A — Baixar o arquivo da Booking (no computador):

1. No Admin, Caixa → bloco Importar repasses → toque em Abrir pagamentos da Booking ↗. Abre Informações dos pagamentos na extranet (se pedir login ou código, entre). Sem o atalho: admin.booking.com → Finanças → Informações dos pagamentos.
2. Em Período de pagamento, escolha Este mês, Mês passado, Este ano ou um intervalo de datas.
3. Toque em Descarregar todos os relatórios (à direita).
4. O arquivo, com nome parecido com 2026-01-01_to_2026-11-05_statements.csv, vai para a pasta Downloads.

Parte B — Importar no Admin:

1. Caixa → toque no bloco Importar repasses (Airbnb e Booking).
2. Em Arquivo CSV, toque em Escolher arquivo e escolha o arquivo baixado. O sistema reconhece sozinho se é do Airbnb ou da Booking.
3. Aparece a lista para conferir: quantas reservas há no arquivo, quantas foram encontradas no sistema e, em cada uma, valor bruto, taxa, repasse, data do pagamento, como estava antes e o que muda no Caixa. Nada foi gravado ainda.
4. Toque em Gravar estes valores. Aparece “Pronto. Repasses gravados nas reservas e no Caixa.”

Quando fazer: na Booking, uma vez por mês, depois do pagamento do dia 1º (ou toda semana, se a Booking passar a pagar semanalmente). No Airbnb, quando quiser conferir os pagamentos.

5.9 Histórico de fornecedor

1. Escolha o mês nas setas ‹ ›.
2. Toque no bloco Histórico de fornecedor. Aparecem as compras de cada comércio já pagas naquele mês.
3. Toque em Nota … para ver a nota da compra; Enviar nota manda a imagem.

6. Equipe e compras (aba Equipe)

6.1 Cadastrar alguém da equipe

1. Abra a aba Equipe e toque no bloco Equipe (Luiz, Kaeline, outros).
2. Preencha Nome e Telefone / WhatsApp.
3. Em Função, escolha Caseiro (mensal), Faxina (por limpeza) ou Outro.
4. Em Senha, coloque 6 números sem sequência e sem repetição (o sistema recusa 123456, 112233, 222222… e sugere uma senha boa).
5. Preencha Chave PIX e PIX — como aparece.
6. Caseiro: preencha Valor mensal (R$) — só caseiro. Faxina: cada faxina vale o valor padrão (R$ 130,00).
7. Toque em Adicionar à equipe. A pessoa aparece na lista.

Mandar o acesso para a pessoa:

1. Na lista, toque em WhatsApp ao lado do nome. Abre o WhatsApp com o link do painel dela (a senha não vai na mensagem).
2. Envie a mensagem e passe a senha à parte.
3. Para ver o painel como ela vê: Abrir painel.

Corrigir ou tirar: Editar carrega os dados no formulário (mude e salve); Excluir tira a pessoa da equipe.

6.2 Relatório da equipe

1. Toque no bloco Relatório da equipe.
2. Escolha o Colaborador (ou Todos) e o Mês (ou Todos).
3. Aparecem as fotos, vídeos, problemas e faxinas registrados.

6.3 Cadastrar um comércio (fornecedor)

1. Toque no bloco Fornecedores (comércios).
2. Preencha Nome do comércio, Telefone / WhatsApp, Chave PIX e PIX — como aparece.
3. Em Senha, 6 números sem sequência e sem repetição.
4. Em Produtos (um por linha), escreva o que ele vende (pode deixar para ele cadastrar).
5. Toque em Adicionar comércio.
6. Na lista, WhatsApp manda o link do painel do comércio (sem a senha); Abrir painel mostra como ele vê; Editar e Excluir corrigem.

Texto do WhatsApp para o comércio: edite em WhatsApp — fornecedor (aceita {nome} e {equipeUrl}) → Salvar texto. Restaurar texto volta ao original.

6.4 Pedidos da equipe (corrigir erro)

1. Toque no bloco Pedidos da equipe (excluir erro).
2. Ache o pedido errado e toque em Excluir → confirme. Recusado some da lista; confirmado que ainda não foi para o caixa também some do pagamento.

6.5 Novo pedido de compra a um comércio

1. Toque no bloco Novo pedido.
2. Em Comércio, escolha o comércio.
3. Escolha o produto, a quantidade e o valor. Para outro produto: Adicionar outro produto a esse pedido.
4. Produto que não existe? Escreva em Novo produto deste comércio e Preço da unidade (R$) → Criar produto. Ele fica gravado no comércio.
5. Confira o Valor da compra e toque em Enviar pedido.
6. Se o comércio confirma pedidos, ele confirma no painel dele; depois o pagamento aparece em Caixa → A conferir (5.6).

7. O que o hóspede vê (aba Hóspede)

Cada bloco é uma parte do painel do hóspede. Para mudar qualquer um:

1. Abra a aba Hóspede.
2. Toque no bloco (ex.: Wi-Fi).
3. Mude os campos.
4. Toque no botão Salvar daquele bloco. O hóspede já vê a mudança.

Trocar o vídeo da caixa d'água ou da cascata:

1. Abra o bloco do vídeo.
2. Toque em Enviar vídeo e escolha um vídeo MP4 ou MOV de até 20 MB (cerca de 40 segundos).
3. Espere terminar o envio. Para tirar o vídeo: Remover vídeo.
4. Se mudou o título ou o texto: Salvar textos.

Mandar o link da avaliação do Google para um hóspede:

1. Abra o bloco Avaliação no Google e confira que o link está salvo.
2. Toque em Copiar link da avaliação (o link com a foto da casa) ou Copiar link do Google.
3. Ou toque em Abrir WhatsApp para abrir a conversa já com o link. (Pela reserva finalizada, use Pedir avaliação, 3.12.)

8. Site (conteúdo da página pública)

Ver o site: na aba Site, toque em Ver o site como o hóspede vê ↗.

Mudar um texto:

1. Abra a aba Site.
2. Toque no bloco: Topo, Sobre a casa, Acomodações, Lazer, Localização ou Convite para reservar.
3. Mude os campos (rótulo, título, textos, itens).
4. Role até o fim e toque em Salvar site. Só grava aqui, para todos os blocos de uma vez.

Trocar o logo (placa):

1. Toque no bloco Logo → em Logo da placa, escolha a imagem.
2. Confira a prévia e toque em Salvar site.

Acrescentar ou apagar fotos da pasta (álbum):

1. Toque no bloco Pasta geral de fotos.
2. Toque em Acrescentar fotos e escolha as fotos. O álbum público mostra todas.
3. Para apagar: toque em Excluir na foto.

Trocar a foto de um lugar do site:

1. Toque no bloco Fotos na página.
2. No lugar desejado, toque em Trocar foto (celular ou arquivo) ou Da pasta (escolha uma foto já enviada e toque nela; Fechar sai sem escolher).
3. Se quiser, mude o título da foto.
4. Toque em Salvar site.

8.1 Avaliações do Airbnb e da Booking

Como aparecem no site (bloco Avaliações dos hóspedes):

• No alto, as duas notas: ★ 4,85 Airbnb · 66 avaliações e 9,3 Booking · 19 comentários.
• Embaixo, uma avaliação por vez. Elas passam sozinhas a cada 6 segundos e meio. As setas ← → passam à mão, e no meio aparece a posição (ex.: 1 / 56). No celular, dá para arrastar com o dedo.
• Cada avaliação mostra a nota (estrelas no Airbnb, nota de 1 a 10 na Booking), o texto e, embaixo, o primeiro nome · canal · mês.
• O botão Ver todas (56) abre a lista completa, com os filtros Todas, Airbnb e Booking. Fechar a lista fecha e volta para o começo do bloco.
• Só entram as avaliações boas e com frase escrita. Na Booking, aparece só o que o hóspede gostou (o título e o “gostou”); a parte “não gostou” nunca vai para o site.

Ligar ou desligar uma avaliação:

1. Abra a aba Site e toque no bloco Avaliações (Airbnb e Booking). A lista carrega, com a contagem (ex.: “56 no site de 63 cadastradas”).
2. Para achar mais rápido, use o filtro: Todas, Só as que aparecem no site, Só as escondidas, Só Airbnb ou Só Booking.
3. Marque ou desmarque Mostrar no site na avaliação. As desmarcadas ficam mais claras.
4. Toque em Salvar avaliações. Aparece “Avaliações salvas. N aparecem no site.”

Corrigir uma avaliação:

1. No bloco, toque em Editar na avaliação.
2. Mude Canal, Nome (só o primeiro nome), Mês da estadia, Nota, Título (só Booking) ou Texto.
3. Toque em Pronto e depois em Salvar avaliações.

Acrescentar uma avaliação nova (quando chegar mais uma no Airbnb ou na Booking):

1. Copie o texto da avaliação. No Airbnb (computador): abra airbnb.com.br/performance/quality/overall (tela Desempenho → Qualidade → Qualidade geral), role até Comentários recentes e toque em Mostrar 66 avaliações (o número muda). Na extranet da Booking: página Comentários de clientes.
2. No Admin, aba Site → bloco Avaliações (Airbnb e Booking) → toque em + Nova avaliação. Abre um quadro em branco no topo da lista.
3. Escolha o Canal, escreva o Nome, confira o Mês da estadia, a Nota (Airbnb de 1 a 5; Booking de 1 a 10) e cole o Texto. Na Booking, o título vai em Título.
4. Toque em Pronto.
5. Atualize também as notas do alto (Nota no Airbnb, Avaliações no Airbnb, Nota na Booking, Comentários na Booking), copiando do anúncio.
6. Toque em Salvar avaliações.

Apagar: toque em Editar → Excluir → confirme → Salvar avaliações. Para só esconder, prefira desmarcar Mostrar no site.

8.2 Idiomas, álbum e mapa

O site existe em português, inglês e espanhol; as traduções ficam nos arquivos do sistema (pedir a quem edita). No álbum, o botão Voltar fica no topo à direita e embaixo das fotos. Abrir no Maps abre o Google Maps no computador e no celular.

9. Configurações (engrenagem ⚙)

Abra tocando no ícone da engrenagem ⚙ no topo do Admin. Aqui fica o que é só do administrador.

9.1 Quem entra no Admin

1. ⚙ → Quem entra no Admin.
2. Em E-mails administradores (um por linha), escreva os e-mails que podem entrar, um em cada linha.
3. Toque em Salvar administradores.

9.2 Trocar a senha do Admin

1. ⚙ → Senha do Admin.
2. Em Nova senha (mínimo 6 caracteres), escreva a senha. Use pelo menos 10 caracteres, misturando letras e números.
3. Em Repetir senha, escreva de novo.
4. Toque em Salvar senha. Aparece “Senha gravada. Na próxima entrada use e-mail e senha.”

9.3 Histórico (o que aconteceu no sistema)

1. ⚙ → toque em Histórico.
2. Use os botões Tudo Versões E-mails Acessos Calendário para filtrar.
3. Versões mostra o que mudou em cada versão; Atividade mostra e-mails enviados, entradas no Admin e sincronizações do calendário.
4. Toque em Voltar às Configurações para voltar.

9.4 Mensagens e e-mails

Textos do WhatsApp (hóspede) — mensagem que abre ao confirmar ou cancelar uma reserva:

1. ⚙ → Mensagens e e-mails → toque em Textos do WhatsApp (hóspede).
2. Edite Confirmação da reserva e/ou Cancelamento. As {chaves}, como {nome} e {entrada}, são preenchidas sozinhas.
3. Toque em Salvar textos. Para voltar ao original: Restaurar confirmação ou Restaurar cancelamento.

Mensagens WhatsApp — textos que o hóspede manda para você a partir do site:

1. Toque em Mensagens WhatsApp.
2. Edite Comprovante de PIX e/ou Reserva pelo WhatsApp (se o site falhar).
3. Toque em Salvar. Para voltar ao original: Restaurar comprovante ou Restaurar reserva.

E-mails do sistema — os e-mails automáticos (nova reserva, sinal por cartão, cancelamento, contrato, chat, faxina, problema na casa, pagamento da equipe…):

1. Toque em E-mails do sistema.
2. Edite o assunto e o texto do e-mail desejado. O “Nova reserva (você)” é o que chega em [email protected].
3. Toque em Salvar e-mails.

9.5 Contrato e Autentique

Configurar (uma vez):

1. ⚙ → Integrações → toque em Contrato Autentique.
2. Em Chave API Autentique, cole a chave (o campo fica vazio de propósito depois de gravada; só cole outra se for trocar).
3. Preencha quem assina pela casa (nome e e-mail), os dados do locador (nome completo, RG, CPF, e-mail, cidade/UF), o Endereço no contrato e as duas testemunhas (nome e e-mail).
4. Toque em Salvar.

Mandar um contrato para assinar:

1. Confira que a reserva tem o e-mail do hóspede (se não tiver, Editar → preencha → Guardar alteração).
2. Abra a reserva e toque em Ver contrato para conferir o PDF (é o mesmo que vai para o Autentique).
3. Toque em Autentique. O Autentique manda o contrato por e-mail para o hóspede, para você e para as duas testemunhas.
4. O cartão mostra Aguardando assinatura. Quando todos assinarem, o PDF assinado volta sozinho e o cartão mostra Contrato assinado ✅ com o link PDF.
5. Se demorar, toque em Buscar assinado (o sistema também confere sozinho a cada 6 horas).

9.6 WhatsApp da Meta (consulta automática)

Liga o robô que responde no WhatsApp se um período está livre e o valor (número de teste da Meta).

1. ⚙ → Integrações → toque em WhatsApp consulta o site.
2. Copie o Endereço do webhook e cole na tela da Meta, com o mesmo Token de verificação.
3. Cole a Identificação do número (Phone number ID) e o Token de acesso da Meta.
4. Toque em Salvar WhatsApp.
5. Para testar sem enviar nada: escreva uma frase em Testar uma frase (ex.: “23/10 a 25/10”) e toque em Ver a resposta.

10. Chat com os hóspedes

1. Abra a aba Chat. Um número vermelho na aba indica mensagens novas.
2. Em Abertos ficam as conversas em andamento; em Histórico, as encerradas. Toque numa conversa.
3. Escreva em Escreva a resposta…. Para mandar foto, PDF ou vídeo, toque no ícone do clipe (no celular há também a câmera).
4. Toque em Enviar. Quando o hóspede estiver digitando, aparece “O hóspede está digitando…”.
5. Para terminar a conversa: Encerrar. Ela vai para o Histórico. Para retomar: abra no Histórico e toque em Reabrir.

11. Painel do hóspede

Hóspede Depois que a reserva é confirmada, o hóspede recebe o link (hospede.html) e uma senha pelo WhatsApp. A senha vale da confirmação até o check-out.

O painel mostra, em ordem: saudação e cronômetro para a chegada, pagamento (sinal e restante), endereço e mapa, como a casa funciona, vídeo da caixa d’água, vídeo da cascata, avisos importantes, internet (Wi-Fi), contatos, contrato, passeios e praia, paróquia, mercantis, farmácias e pizzarias em Caponga e, no fim, a avaliação. A senha do cofre aparece 30 minutos antes do check-in. No dia da saída, o pedido dos 3 vídeos de despedida sobe para o topo.

O hóspede também fala com vocês pelo chat do painel. O painel funciona em português, inglês e espanhol.

Mandar o painel de novo para um hóspede:

1. Pedidos → abra a reserva confirmada.
2. Toque em WhatsApp (abre a conversa com a mensagem e o link) ou em Copiar link (copia o link para colar onde quiser).
3. A senha do hóspede aparece no cartão da reserva, em “Senha do hóspede”.

12. Painel da equipe

Equipe Cada pessoa usa o painel no celular.

Entrar:

1. Abrir o link recebido no WhatsApp (…/prestador.html).
2. Digitar a Senha e tocar em Entrar.
3. No topo ficam os botões Hóspedes, Financeiro e, para quem pode comprar, Pedidos.

12.1 Tela de hóspedes

• Próximos: primeiro Em andamento, depois o mês atual e o seguinte, abertos. Do terceiro mês em diante, cada mês fica recolhido com o botão Abrir.
• Histórico: meses passados, cada um com Abrir; mostra o resumo do mês (ex.: “4 faxinas · R$ 520,00”). Outro mês escolhe um mês específico.
• Os hóspedes aparecem no mês da entrada. Cada cartão tem origem, situação, nome, entrada e saída com horários, noites e pessoas.

12.2 Marcar a faxina concluída (faxina)

1. No cartão do hóspede que saiu, toque em Faxina concluída.
2. Em “Em que dia a faxina foi concluída?”, confira o dia (vem com hoje; não aceita data futura).
3. Se quiser, escreva uma Observação (opcional) (ex.: “faltou produto”). Ela chega ao administrador por e-mail e aparece na reserva.
4. Toque em Confirmar (ou Cancelar). O cartão fica verde com a data e o valor.

• Faixa “Próxima faxina” no topo, com “hoje”, “amanhã” ou “em N dias”.
• Faxinas atrasadas: saída já passou e a faxina não foi marcada → aviso e etiqueta “⚠ Saída já passou · marque a faxina”.
• Faixa do total do mês (verde-escuro): faxinas e valor. Tocar abre o Financeiro.
• Estados do cartão: ✔ data e valor (verde), “Faxina: não foi feita por você” (âmbar), “ainda não marcada” (cinza), “atrasada” (vermelho-claro). Faxina extra aparece como cartão tracejado no mês em que foi feita.

12.3 Fotos, vídeos e problemas (caseiro e outros)

1. No cartão do hóspede, toque para enviar fotos (até 10 por hospedagem) ou vídeos (até 4, de até 40 segundos).
2. Para um problema: escreva em Problema encontrado com essa hospedagem e toque em Registrar problema. O administrador recebe por e-mail.
3. O caseiro tem o botão de WhatsApp no cartão, já com a mensagem de apresentação ao hóspede.

Tudo fica no “Arquivo da casa” da reserva, no Admin. Cada um vê só o que ele mesmo enviou.

12.4 Pedir produtos (quem pode comprar)

1. Toque em Pedidos → Solicitar produtos.
2. Escolha o produto e a Qtd. Para outro: Adicionar outro produto a esse pedido.
3. Se quiser, escreva uma Observação, ou toque em Gravar áudio / Enviar áudio do celular.
4. Toque em Enviar pedido. O administrador vê em Caixa → A conferir.

12.5 Financeiro da equipe

1. Toque em Financeiro.
2. Faxina: lista das faxinas do mês (hóspede, datas, valor) e o total. Caseiro: o valor mensal.
3. Antes do pagamento aparece “Aguardando pagamento”.
4. Em Histórico de pagamentos, um item por mês pago; o último vem aberto. Toque em Abrir comprovante para ver o PIX.

13. Painel do comércio (fornecedor)

Fornecedor O comércio entra em fornecedor.html com a senha cadastrada (6.3). Ele vê Pedidos e Histórico.

Cadastrar um item que vende:

1. Toque em Cadastrar um novo item.
2. Escreva o nome em Novo item e o Valor padrão (R$).
3. Toque em Cadastrar item.

Registrar uma compra:

1. Escolha os produtos, a Qtd e confira Unidade (R$) e Total (R$). Para outro: Adicionar outro produto a esse pedido.
2. Preencha Quem recebeu e a Data da compra, e envie Fotos da compra.
3. Toque em Conferir pedido, revise e toque em Confirmar e registrar (ou Sim, registrar).
4. O pedido fica Aguardando pagamento. O administrador paga em Caixa → A conferir (5.6).

Pedido feito pelo administrador: o comércio confere e toca em Confirmar e registrar ou Recusar.

14. Regras de pagamento da equipe

15. Publicar uma atualização

Quem edita o sistema (Claude ou Grok) entrega cada versão no GitHub privado e diz se é preciso atualizar o Worker, o site ou os dois. O site só muda quando alguém envia os arquivos ao Cloudflare.

15.1 Baixar a versão do GitHub

1. Entre em github.com/srcarneiroapp/belacasapraia com a sua conta (srcarneiroapp).
2. Toque em Tags (ou abra github.com/srcarneiroapp/belacasapraia/tags).
3. Na versão desejada (ex.: v12.61), toque em zip. O arquivo vai para a pasta Downloads.
4. Clique com o botão direito no zip → Extrair tudo → Extrair.

15.2 Atualizar o Worker (casa-api)

1. Na pasta extraída, abra o arquivo worker.js no Bloco de Notas → Ctrl+A → Ctrl+C.
2. No Cloudflare (dash.cloudflare.com): Computação → Workers e Pages → casa-api → Editar código.
3. Clique dentro do editor → Ctrl+A → Delete → Ctrl+V.
4. Clique em Implantar.
5. Abra https://casa-api.srcarneiro-ce.workers.dev/api/version: deve mostrar a versão nova.

15.3 Atualizar o site (Cloudflare Pages)

1. Na pasta extraída, apague estes arquivos: worker.js, enviar-github.sh e .gitignore. Eles não vão para o site.
2. Copie a sua pasta fotos (a do site atual) para dentro da pasta extraída. O GitHub não guarda as fotos.
3. No Cloudflare: Computação → Workers e Pages → clique em belacasapraia.
4. No alto aparecem Implantações, Métrica, Domínios personalizados e Configurações. Clique no botão Criar implantação.
5. Abre a página Carregue seu projeto para implantar um site. Confira que está marcado Produção (não “Versão prévia”).
6. Arraste a pasta inteira (com fotos dentro) para o quadro, ou clique em pasta e escolha a pasta. Aparece o aviso “O conteúdo que você arrastar aqui será carregado na sua conta”.
7. Espere todos os arquivos carregarem e clique em Salvar e implantar.
8. Abra o site numa janela anônima e confira o rodapé: todas as páginas com a versão nova.
9. No Admin, toque em ↻ Atualizar para carregar a versão nova.

16. Problemas comuns

WhatsApp Business não abre no iPhone

Ao tocar em WhatsApp e escolher WhatsApp Business, o sistema tenta abrir o app Business. Se ele não estiver instalado nesse iPhone, abre o WhatsApp comum, sem erro. O iPhone não deixa o site forçar o Business: ele precisa estar instalado no aparelho.

17. Para quem edita o sistema (Claude e Grok)

17.1 Checklist de toda entrega

1. Subir a versão em todos os arquivos: rodapé e ?v= de todos os *.html (inclusive manual.html), sw.js, pwa.js, versao.json, admin.js (ADMIN_VERSION) e worker.js (VERSION e linha nova no topo do CHANGELOG).
2. Atualizar este manual em passo a passo, o selo “Atualizado para a versão X · data” (#mVer e #mDate) e uma linha em Histórico do manual.
3. Dizer ao dono se é preciso atualizar o Worker e/ou o site.
4. Enviar ao GitHub privado (srcarneiroapp/belacasapraia) com o enviar-github.sh e mandar ao dono o link do zip. Nunca publicar no site: zip, página de download, senha de download ou worker.js.

17.2 Como editar o manual

• O manual é o arquivo manual.html, de uma página só. Cada seção é um <section class="sec" id="sN"> com <h2> numerado; as subseções usam <h3 id="sN-M">. O índice da esquerda é gerado sozinho.
• Mantenha a numeração e os links internos (href="#sN-M").
• Passos em <ol class="steps">; botões em <kbd> com o texto exato da tela; .note (informação), .warn (atenção), .tip (dica); tabelas para comparações.
• Português do Brasil, linguagem simples. Nada de senhas reais ou chaves no manual.

18. Histórico do manual