Definições e resolução de problemas

Todos os separadores das Definições que não são tratados noutras páginas – Geral, Sincronização de calendários, Módulos, Moedas para hóspedes, Privacidade, Licença e Sistema – seguidos de um guia de resolução dos problemas que os anfitriões encontram com mais frequência.

Como estão organizadas as Definições

Abra JetBookIn → Definições. Os separadores à esquerda são:

• Geral, Pagamentos, E-mails, Sincronização de calendários, Módulos – estão sempre presentes.
• Um separador por cada módulo que tem definições, visível apenas enquanto esse módulo estiver ativado: Registo de e-mails Pro, Moedas para hóspedes, Privacidade (RGPD), Conformidade grega, Recibos e faturas, Faturação myDATA (AADE).
• Licença e Sistema – estão sempre presentes.

As alterações só são guardadas quando clica em Guardar definições (no canto superior direito, ou na barra que aparece em baixo com Alterações não guardadas). Descartar alterações repõe tudo. Se tentar sair da página com alterações por guardar, o navegador pergunta primeiro. Os interruptores dos módulos e a licença são a exceção: aplicam-se de imediato.

O separador Pagamentos está explicado em Pagamentos, e os separadores E-mails e Registo de e-mails em E-mails. Só os administradores podem alterar os fornecedores de pagamento, as respetivas chaves e os dados bancários, o servidor de e-mail e as definições do registo de e-mails; um Gestor de reservas pode alterar o resto.

Geral

O cartão Geral

Por baixo dos campos:

• Confirmar reservas sem pagamento online quando não há método de pagamento configurado (desativado): permite aos hóspedes reservar enquanto nenhum fornecedor de pagamento estiver configurado, p. ex. enquanto ainda está a configurar tudo.
• Garantia de cartão: quando nada é pago antecipadamente, o hóspede guarda um cartão no Stripe (nada é cobrado) (desativado, Pro): para taxas de não comparência e de cancelamento tardio. Precisa do Stripe. Com a opção ativada, Se um cartão de garantia deixar de funcionar permite escolher entre Cancelar a reserva e libertar as datas (predefinição) e Manter a reserva e apenas adicionar uma nota para mim.
• As reservas sem pagamento online (pagamento no alojamento) são primeiro confirmadas pelo hóspede por e-mail (ativado): o hóspede recebe um e-mail Confirmar a minha reserva e as datas ficam retidas durante 30 minutos até clicar. Isto impede que endereços de e-mail falsos bloqueiem o seu calendário. Não é necessário enquanto a garantia de cartão estiver ativada.

Ambas as opções estão explicadas em detalhe em Pagamentos.

Janela de reserva

Ambas usam o fuso horário do site (WordPress Definições → Geral → Fuso horário). Aplicam-se apenas aos hóspedes que reservam online; pode sempre acrescentar uma reserva você mesmo.

Manter o calendário aberto e Preencher intervalos curtos

Manter aberto com antecedência (meses) (0 = desativado; 12–18 serve a maioria dos alojamentos) preenche, todas as noites, os dias a seguir ao último que definiu, a partir do mesmo dia da semana de há um ano. Preencher intervalos curtos vende as noites que uma estadia mínima deixaria vazias: Última hora: chegadas dentro de (dias) com … podem ficar pelo menos (noites), Permitir estadias que preencham exatamente as noites livres entre duas reservas com Só para chegadas dentro de (dias) e Alteração de preço para estas estadias mais curtas (%). Ambas estão explicadas em Tarifas e disponibilidade.

Sincronização de calendários

As importações são executadas em segundo plano (veja Sistema), por isso só mantêm este ritmo quando as tarefas em segundo plano correm a horas. As ligações, os alertas de sincronização e os registos estão em Sincronização de calendários.

Módulos

Cada funcionalidade opcional é um módulo que pode desativar. Quando um módulo está desativado, os respetivos ecrãs e definições desaparecem; nada é eliminado, e voltar a ativá-lo repõe tudo. O separador indica quantos módulos estão ativados. Cada módulo mostra o seu nível – Incluído, Pro ou um pacote por país – e, depois de ativado, um botão para onde o configura (Configurar em …) ou Nada a configurar. Um módulo que a sua licença não cobre aparece a cinzento com Precisa de uma licença Pro ou Precisa do pacote Grécia na sua licença e um link Ver planos.

Para o pacote Grécia, veja Grécia.

Moedas para hóspedes Pro

Os hóspedes podem passar os preços que estão a consultar para outra moeda, com as taxas do Banco Central Europeu, atualizadas diariamente. As reservas são sempre cobradas na sua moeda, e o checkout di-lo claramente. Clique nas moedas que quer oferecer (USD, GBP, CHF, SEK, NOK, DKK, PLN, CZK e outras); o separador mostra a data das taxas atuais. Boas escolhas para uma ilha grega: GBP, USD, SEK, NOK, DKK, PLN.

Privacidade (RGPD)

• Anonimizar os dados dos hóspedes após (anos) (predefinição 5, até 20, 0 = nunca): nomes, e-mails e números de telefone são removidos das reservas terminadas há mais tempo; os montantes mantêm-se para os seus registos fiscais. Os dados de identificação dos hóspedes são removidos em conjunto. Pergunte ao seu contabilista durante quanto tempo tem de conservar os registos.
• Os hóspedes têm de aceitar a sua política de privacidade no checkout assim que houver uma página de política de privacidade publicada (WordPress Definições → Privacidade).
• Os pedidos de exportação e de apagamento de dados tratam-se no WordPress, em Ferramentas → Exportar dados pessoais e Ferramentas → Apagar dados pessoais; as reservas do JetBookIn estão incluídas. As estadias futuras e em curso são mantidas para que a estadia possa realizar-se.

Conformidade grega, Recibos e faturas, myDATA

Estes separadores aparecem quando o respetivo módulo está ativado. Conformidade grega contém o e-mail do contabilista e o e-mail mensal; Recibos e faturas define a emissão automática e quem recebe os documentos; Faturação myDATA (AADE) contém as credenciais da AADE. Os três estão explicados em Grécia.

Licença

O separador Licença mostra o estado da licença, o plano (Core ou Pro), os extras como o pacote Grécia e até quando recebe atualizações. Só os administradores o podem alterar.

Ativar, alterar ou mudar uma licença

1. Cole a sua Chave de licença e clique em Ativar.
2. Verificar agora volta a perguntar ao servidor de licenças (também verifica todos os dias).
3. Alterar chave substitui a chave; Desativar neste site liberta-a para outro site.
4. Comprar uma licença, Renovar licença e Mais sites ou Pro abrem a loja em jetbookin.com com a sua chave já preenchida.

Estados

A partir de 30 dias antes da expiração, o ecrã Hoje lembra-o, e depois da expiração indica a data em que as funcionalidades Pro se desligam.

Dica: a licença é verificada em todos os sites, incluindo cópias locais e de testes: não há nenhum endereço que ative o Pro sem chave.

Sistema: tarefas em segundo plano e desinstalação

Tarefas em segundo plano

As importações de calendários, os lembretes e e-mails pré-chegada, as cobranças automáticas do saldo, a anonimização de hóspedes e o e-mail mensal para o contabilista são todos executados em segundo plano. O WordPress só executa as tarefas agendadas quando alguém visita o site, por isso, em noites calmas, podem atrasar-se. O cartão Tarefas em segundo plano mostra:

• o estado – A funcionar normalmente. ou Atrasado: …,
• Última execução das tarefas horárias,
• Última execução do cron do servidor (não configurado até acrescentar um),
• Tarefas atrasadas,
• Calendários com falha na importação (ligações que falharam três ou mais vezes seguidas).

Clique em Atualizar para verificar de novo.

Configurar uma tarefa cron no servidor (recomendado para sites em produção)

Uma tarefa cron no servidor executa as tarefas de 5 em 5 minutos, quer alguém visite o site ou não. O cartão mostra a linha exata para o seu site com um botão Copiar. É assim:

*/5 * * * * cd /path/to/wordpress && wp jetbookin run-jobs --quiet

1. Copie a linha de Definições → Sistema (tem o caminho real do seu WordPress).
2. No painel da sua hospedagem, abra Tarefas cron (o cPanel, o Plesk e o hPanel têm todos uma) e adicione-a com a periodicidade “a cada 5 minutos”. Ou envie-a ao suporte da sua hospedagem.
3. Passados 5–10 minutos, clique em Atualizar: Última execução do cron do servidor mostra uma hora.

É necessário o WP-CLI no servidor. Sem WP-CLI, também funciona uma tarefa cron que abra o endereço wp-cron.php do seu site de 5 em 5 minutos; o cartão mostra também esse endereço.

Avisos de estado e como corrigi-los

Uma instalação nova espera duas horas antes de avisar. O banner vermelho As tarefas em segundo plano não estão a ser executadas a horas, que aparece em todos os ecrãs, remete para aqui com Como corrigir.

Endereço do visitante

Os limites das tentativas de reserva, de Encontrar a sua reserva e das reservas por pagar (uma por endereço de e-mail, três por rede) contam por endereço do visitante. Atrás de uma CDN ou de um proxy, todos os visitantes chegam a partir do endereço do proxy, pelo que esses limites se aplicariam a todos os visitantes de uma só vez. Ler o endereço do visitante de escolhe de onde vem o endereço real:

• Automático (predefinição): o cabeçalho da Cloudflare quando a visita passa mesmo pela Cloudflare, e os cabeçalhos do proxy quando há um proxy no seu próprio servidor; caso contrário, a própria ligação.
• Só a ligação: para sites sem CDN nem proxy.
• CF-Connecting-IP, X-Forwarded-For ou X-Real-IP: para uma CDN que o JetBookIn não reconhece, como a CDN do seu alojamento. Escolha uma delas só se todas as visitas chegarem ao site através dessa CDN; caso contrário, os visitantes poderiam falsificar o endereço.

Por baixo, O seu endereço como o site o vê mostra o resultado para si neste momento. Para confirmar a escolha, abra a página no telemóvel com dados móveis: o endereço mostrado deve ser o do telemóvel, não o mesmo que no computador. Só os administradores podem alterar esta definição.

Desinstalação

Eliminar todos os dados do JetBookIn (reservas, tarifas, calendários) quando o plugin for eliminado está desativado por predefinição, por isso eliminar o plugin mantém os seus dados e, ao reinstalá-lo, eles regressam. Quando está assinalado, eliminar o plugin em WordPress, em Plugins, remove tudo: reservas, pagamentos, tarifas, ligações de calendários, alojamentos e tipos de quarto, avaliações, registos de proprietários, recibos e faturas, definições e as funções Gestor de reservas, Empregado(a) de limpeza e Proprietário do alojamento.

Importante: isto não pode ser desfeito. Exporte o que o seu contabilista precisa (Relatórios, Pagamentos, Faturas) e faça uma cópia de segurança antes de assinalar. Desativar o plugin nunca elimina nada.

Para programadores: WP-CLI e REST

Comandos WP-CLI

Endpoints REST para as definições

Namespace /wp-json/jetbookin/v1/. Estas rotas exigem um utilizador com sessão iniciada e com a capability manage_jetbookin (administradores e Gestores de reservas).

• GET /settings, PUT /settings – todas as definições; as chaves secretas voltam mascaradas e só os administradores podem alterar as chaves de pagamento.
• GET /modules, PUT /modules – o estado dos módulos, p. ex. {"housekeeping": true}.
• GET /jobs – o estado das tarefas em segundo plano, incluindo o comando cron.
• GET /license – o estado da licença (ativar e remover uma chave é só para administradores).
• GET /audit – o registo de atividade.

Resolução de problemas

Os e-mails não chegam

1. Em E-mails, abra um modelo e use Enviar um teste para → Enviar teste. Se o teste também não chegar, o problema é o envio de e-mail do site, não o JetBookIn.
2. Verifique a pasta de spam.
3. Em Definições → E-mails, defina E-mail do remetente para um endereço do seu próprio domínio (p. ex. bookings@your-villa.gr). As mensagens “de” um endereço Gmail ou Hotmail enviadas pelo seu servidor web são muitas vezes rejeitadas.
4. Ative Definições → E-mails → E-mail de saída (SMTP) e envie através do servidor da sua caixa de correio (ver E-mails). Certifique-se de que os registos SPF e DKIM do seu domínio incluem o remetente – a sua hospedagem pode ajudar.
5. Abra Definições → Registo de e-mails: um e-mail falhado mostra a resposta do servidor de correio, e Reenviar envia-o mais uma vez.
6. Verifique se o modelo está ativado (Enviar este e-mail) na lista de E-mails.
7. Os alertas de novas reservas vão para o endereço em Enviar alertas de novas reservas para (Definições → E-mails), ou para o e-mail do administrador do site se estiver vazio.
8. Os lembretes e os e-mails pré-chegada e de check-in são enviados por tarefas em segundo plano: se estas estiverem atrasadas (veja Sistema), os e-mails também se atrasam.

Os pagamentos não são confirmados

Os fornecedores de pagamento informam o seu site de um pagamento através de um webhook – uma chamada do servidor deles para o seu.

• Stripe: os pagamentos são confirmados quando o hóspede regressa do Stripe, através do webhook, e perguntando ao Stripe de 5 em 5 minutos – por isso um webhook avariado não atrasa nada, mas corrija-o na mesma. Definições → Pagamentos → Pagamentos Stripe mostra quando chegou o último webhook, ou porque foi recusado. Verifique se o Webhook signing secret corresponde ao modo (teste ou real) e se o endpoint no Stripe tem os quatro eventos indicados aí. Para um pagamento isolado, use Verificar no Stripe em Receita → Pagamentos.
• Viva Wallet: adicione o URL do webhook na Viva para o evento Transaction Payment Created, depois de guardar o Merchant ID e a chave API.
• PayPal: adicione o URL do webhook à sua app REST com Checkout order approved e Payment capture completed.
• As chaves de teste e reais têm de corresponder ao Modo.
• Firewalls, plugins de segurança e CDNs (Cloudflare, Wordfence e semelhantes) bloqueiam ou redirecionam, por vezes, as chamadas para /wp-json/. Permita os endereços dos webhooks mostrados em Definições → Pagamentos.
• Um pagamento que chega depois de expirar o Bloqueio para pagamento é assinalado como Pago depois de expirar a retenção em Hoje e em Pagamentos: verifique a reserva.

Mais informações em Pagamentos.

Os calendários não sincronizam

• Abra Canais. Cada ligação mostra A sincronizar, A última sincronização falhou, Com falhas, A aguardar a primeira sincronização ou Apenas exportação. Clique em Sincronizar agora (ou Sincronizar tudo agora) e leia o Registo de sincronização.
• Se as importações estiverem atrasadas, verifique as tarefas em segundo plano (Sistema). As importações correm a cada Importar a cada (minutos) apenas quando as tarefas são executadas a horas.
• Se a plataforma não vê as suas alterações: a plataforma lê o seu link ao seu próprio ritmo, o que em algumas plataformas pode demorar algumas horas. Em Hoje, … não lê o nosso significa que uma plataforma deixou de ler o seu link – volte a adicioná-lo na plataforma.
• Os links dos seus calendários dizem às caches de páginas para nunca os guardarem. Se atualizou de uma versão mais antiga, limpe uma vez a cache de páginas (no LiteSpeed: Purge All).
• Com o Pro, os Alertas de sincronização de calendários enviam-lhe um e-mail quando um calendário não sincroniza há algumas horas.

Mais informações em Sincronização de calendários.

“As tarefas em segundo plano estão atrasadas”

Configure a tarefa cron no servidor. Se já estiver configurada e Última execução do cron do servidor mostrar uma hora recente, clique em Atualizar – as versões mais antigas podiam mostrar um falso aviso em sites com uma cache de objetos persistente (LiteSpeed, Redis); as versões atuais leem a hora diretamente da base de dados. Se o cron do servidor mostrar não configurado apesar de o ter adicionado, verifique o caminho da tarefa e se o WP-CLI (wp) está disponível para ela; execute wp jetbookin status manualmente para ver o erro.

Plugins de cache (LiteSpeed, WP Rocket e outros)

O JetBookIn carrega preços e disponibilidade em tempo real, por isso as páginas dos quartos e de pesquisa podem ficar em cache. Algumas coisas a saber:

• Limpe a cache de páginas depois de alterar as Definições. A caixa de reserva lê algumas definições da própria página – métodos de pagamento, bloqueio para pagamento, moedas para hóspedes, a primeira data que pode ser reservada (antecedência mínima, encerramento no próprio dia). Uma página antiga em cache mantém os valores antigos.
• Não mantenha páginas em cache durante mais de um dia, ou exclua as suas páginas de reserva. Uma página guardada em cache ontem ainda pensa que “hoje” é a data de ontem. Em caso de dúvida, exclua da cache a página de confirmação da reserva e a página de checkout.
• Os links dos calendários, a página de limpeza e a página do proprietário dizem às caches para não os guardarem. Não force o seu armazenamento em cache.
• Se uma cache ou CDN guardar as respostas da API REST, exclua /wp-json/jetbookin/.
• Se a caixa de reserva ou o seletor de datas só aparecer depois de deslocar a página ou clicar, uma opção como “Delay JavaScript” está a reter o script do JetBookIn: exclua-o dessa opção.

As datas não aparecem ou não podem ser reservadas

• Sem preço ou fechado: as datas sem preço, ou fechadas em Tarifas e disponibilidade, não podem ser reservadas. O ecrã Hoje avisa Os hóspedes não conseguem reservar com muita antecedência quando um tipo de quarto fica sem datas com preço; ative Manter o calendário aberto em Definições → Geral.
• Demasiado longe: para além de Reservável até (dias de antecedência).
• Demasiado cedo: dentro da Antecedência mínima antes da chegada, ou depois da hora definida em As reservas para o próprio dia encerram às. Verifique o fuso horário do WordPress.
• Estadia mínima ou restrições de chegada/partida nessas datas.
• Tipo de quarto definido como Rascunho (oculto no website), ou todas as suas unidades inativas.
• Uma página em cache de um dia anterior (veja acima).
• Reserva bloqueada no checkout: se uma tarifa exige um sinal e não há método de pagamento configurado, aparece no painel o banner vermelho Os hóspedes não podem reservar a tarifa … online.

Problemas de tradução

• O JetBookIn está disponível em inglês, grego, alemão, francês, italiano, espanhol, português, neerlandês, polaco, dinamarquês, sueco, finlandês, búlgaro e russo. O painel segue o idioma do seu utilizador do WordPress; as páginas dos hóspedes seguem o idioma da página.
• Os hóspedes recebem os e-mails no idioma em que reservaram. Cada idioma tem os seus próprios textos de e-mail em E-mails (escolha o idioma no topo).
• Em sites com Polylang ou WPML, traduza os nomes dos planos tarifários, extras, promoções e taxas em Noutras línguas, por baixo de cada nome no painel. Os campos vazios mostram o original.
• Continua em inglês depois de uma atualização? Recarregue o painel (oferece Recarregar quando é instalada uma nova versão) e limpe a cache de páginas, para que os novos ficheiros de tradução sejam carregados.

Perguntas

Posso alterar a moeda mais tarde?

Sim, mas os preços não são convertidos: volte a introduzi-los na nova moeda. As reservas existentes mantêm a sua própria moeda.

O bloqueio para pagamento pode durar mais de 10 minutos?

Não. De 5 a 10 minutos evita que as datas fiquem bloqueadas por hóspedes que desistem. A transferência bancária tem a sua própria definição, Dias para pagar.

O que acontece aos dados quando desativo um módulo?

Nada é eliminado. Os respetivos ecrãs e definições ficam ocultos até o voltar a ativar.

A minha licença expirou. Perco as reservas?

Não. As funcionalidades Pro continuam a funcionar durante 14 dias; depois o site continua com o Core, com todas as reservas e definições preservadas. Renove para voltar a ativar o Pro.

Preciso de uma segunda licença para uma cópia de teste?

Uma cópia de testes precisa de licença para as funcionalidades Pro, como qualquer site (ver Licença). Mude a sua chave para lá enquanto testa – Desativar num site, ativar no outro – ou use um plano com espaço para mais sites.

A minha hospedagem partilhada não tem WP-CLI.

Use uma tarefa cron que abra wp-cron.php de 5 em 5 minutos – o endereço é mostrado em Definições → Sistema.