Gorjeta no Checkout: guia completo
Instalar, configurar e utilizar a gorjeta opcional (percentagem, valor fixo ou valor livre) no carrinho e no checkout do PrestaShop 8 e 9.
Apresentação
O módulo Gorjeta no Checkout (dftip) acrescenta à página de carrinho da sua loja um bloco «Acrescentar uma gorjeta» que permite ao cliente deixar uma gorjeta opcional: uma percentagem, um valor fixo ou um valor livre. A gorjeta passa depois a integrar nativamente a encomenda, sem qualquer sobreposição do núcleo do PrestaShop. Ideal para artesãos, criadores e restauração.
A gorjeta é suportada por uma linha de encomenda dedicada, cujo preço é fixado para o carrinho em curso através de um specific_price limitado a esse carrinho. Circula, por isso, corretamente no total pago, no IVA, na fatura e nas eventuais notas de crédito, exatamente o mecanismo que o PrestaShop usa para os preços personalizados em edição de encomenda.
Compatibilidade
- PrestaShop 8.0 a 9.x
- PHP 7.4 a 8.3
- Loja única e multiloja
- 5 idiomas: FR, EN, ES, DE, IT
- Tema Classic e temas personalizados
- Sem dependências (nem Composer nem frameworks)
O pacote de traduções não inclui o português. Os textos do bloco (título e subtítulo) são campos multi-idioma que preenche você mesmo, mas as restantes cadeias do módulo aparecem no idioma de recurso enquanto não as traduzir em Parâmetros avançados > Traduções > Traduções dos módulos.
Instalação
- No back-office, abra Módulos > Gestor de módulos.
- Clique em Carregar um módulo e selecione o ficheiro
dftip.zip. - Depois de instalado, clique em Configurar.
Na instalação, o módulo regista os seus hooks, cria um produto virtual oculto «Gorjeta» (fora do catálogo e fora da pesquisa, sem portes) destinado a suportar o valor da gorjeta, e aplica as suas definições predefinidas: gorjeta em percentagem de 5, 10 e 15 %, valor livre permitido e sem IVA.
Configuração
Todas as definições estão na página de configuração do módulo.
- Ativar o módulo: mostra ou oculta o bloco de gorjeta.
- Título e subtítulo: textos do bloco, personalizáveis e traduzíveis em cada idioma.
- Tipo de gorjeta: Percentagem, Valor fixo ou Ambos.
- Percentagens propostas: lista separada por vírgulas, por exemplo
5,10,15. - Valores fixos propostos: lista separada por vírgulas na moeda predefinida, por exemplo
1,2,5. - Base de cálculo da percentagem: total de produtos com IVA ou sem IVA.
- Permitir um valor livre: acrescenta um campo de introdução livre.
- Valor livre mínimo / máximo: limites aplicados ao valor livre.
- Imposto aplicado à gorjeta: Sem imposto por predefinição; pode selecionar um grupo de imposto se o seu caso o exigir.
- Mostrar o bloco na página do carrinho: ativa a apresentação do seletor na página do carrinho.
O título e o subtítulo são campos multi-idioma: selecione cada idioma no seletor do campo para adaptar o texto. São fornecidos valores predefinidos nos cinco idiomas logo na instalação, sem português.
Funcionamento
Como a gorjeta é acrescentada
Quando o cliente escolhe uma gorjeta, o módulo memoriza a sua escolha (tipo e valor) para o carrinho em curso, acrescenta a linha «Gorjeta» ao carrinho e fixa o seu preço exato com um specific_price limitado a esse carrinho. A operação decorre em AJAX, sem recarregamento, e o total é atualizado de imediato.
Percentagem recalculada automaticamente
Numa gorjeta em percentagem, o valor acompanha o conteúdo do carrinho: se o cliente acrescentar ou retirar um produto, o módulo recalcula o valor e ressincroniza a linha antes do pagamento. A base de cálculo (total de produtos com ou sem IVA) é definida na configuração e exclui sempre a própria linha de gorjeta e os portes.
Integração nativa na encomenda
Como a gorjeta é uma verdadeira linha de carrinho, fica incluída no total efetivamente pago e é registada na encomenda no momento da validação. Aparece corretamente na fatura, na contabilidade e nas eventuais notas de crédito, sem qualquer override do núcleo.
IVA da gorjeta
Como uma gorjeta voluntária está em regra fora do âmbito do IVA, a linha é entregue sem imposto por predefinição. Se associar um grupo de imposto à gorjeta, o valor introduzido ou calculado é tratado como base sem imposto.
Numa loja portuguesa, a gorjeta é faturada como uma linha da encomenda e entra no documento emitido pelo seu software de faturação certificado pela AT. Confirme com o seu contabilista certificado o tratamento a dar-lhe, nomeadamente a taxa de IVA a associar (ou a isenção a aplicar) e a conta a utilizar, antes de ativar o módulo em produção.
O produto «Gorjeta» criado pelo módulo não deve ser eliminado nem tornado visível no catálogo: serve apenas para suportar o valor da gorjeta. Está oculto da pesquisa e das listagens e mantém-se sem portes.
Retirar a gorjeta
O cliente pode retirar a sua gorjeta a qualquer momento através da opção «Sem gorjeta». Se eliminar manualmente a linha «Gorjeta» a partir do carrinho, o módulo apaga também a escolha memorizada, para não a voltar a acrescentar.
Perguntas frequentes e resolução de problemas
O bloco de gorjeta não aparece na página do carrinho
Confirme que o módulo está ativo e que a opção «Mostrar o bloco na página do carrinho» está assinalada. Limpe depois a cache do PrestaShop (Parâmetros avançados > Desempenho) e, durante os testes, desative a combinação e compressão (CCC). O bloco aparece quando o carrinho tem pelo menos um artigo.
A gorjeta em percentagem não é atualizada quando altero o carrinho
O recálculo ocorre na gravação do carrinho e no carregamento da página do carrinho ou do checkout. Se alterar o carrinho através de uma ação AJAX do tema, recarregue a página: o valor será ressincronizado antes do pagamento.
A gorjeta aparece na fatura?
Sim. A gorjeta é uma linha de encomenda de pleno direito: consta do detalhe da encomenda e da fatura, e é tida em conta nas notas de crédito.
Posso aplicar IVA à gorjeta?
Sim, selecionando um grupo de imposto na configuração. Por predefinição, a gorjeta é entregue sem imposto, em linha com a natureza de uma gorjeta voluntária.
É compatível com o PrestaShop 9 e com multiloja?
Sim. O módulo é compatível com PrestaShop 8 e 9, em loja única ou multiloja, e é multi-idioma, sem dependências Composer nem frameworks.