VibeFox GLS ParcelShop for PrestaShop — Ajuda
Requisitos
PrestaShop: 8.0 a 9.x. A seleção de ParcelShop funciona nos temas Classic e Hummingbird.
PHP: 8.0 ou superior. O módulo não é instalado em versões mais antigas do PHP.
GLS: o módulo não usa nem precisa de conta na GLS ou de chave de API. O mapa dos ParcelShop é público. Você precisa de um contrato com a GLS para enviar as encomendas para os ParcelShop escolhidos.
Chave de licença VibeFox: comprada em vibefox.net. Uma chave funciona em um domínio.
Instalação
1. No back office, acesse Modules > Module Manager e clique em Upload a module. Escolha o arquivo ZIP do módulo.
2. Quando o upload terminar, clique em Configure, ou encontre depois o VibeFox GLS ParcelShop na lista de módulos e clique em Configure.
3. Insira a sua chave de licença VibeFox em License key, no bloco de licença no topo da página Configure, e clique em Activate (veja Chave de licença).
4. Defina os seus preços: pelo menos uma linha de Country prices (por exemplo * Default) ou um Fallback cost (veja Configuração), e clique em Save.
Na instalação, o módulo cria a transportadora GLS ParcelShop com o texto de prazo de entrega Delivery to a GLS ParcelShop of your choice. A transportadora é atribuída a todos os grupos de clientes e às zonas dos países do mapa da GLS (em uma loja padrão, geralmente Europe e Europe (non-EU)). Você pode alterar zonas, grupos de clientes, texto do prazo de entrega e logotipo em Shipping > Carriers. Não defina preços ali: o preço sempre vem do módulo.
Configuração
Todas as configurações estão na página do módulo: Modules > Module Manager > VibeFox GLS ParcelShop > Configure. Cada seção tem o seu próprio botão Save, que salva a página inteira.
Os avisos no topo da página apontam problemas de configuração: a transportadora não foi encontrada, a unidade de peso da loja não é reconhecida pelo módulo (defina kg, g, lb ou oz em International > Localization, Local units), nenhum preço está definido, ou alguns ou todos os Countries (ignore zones mode) selecionados não são cobertos pelo mapa da GLS. Um número inválido ou negativo é recusado com uma mensagem que indica o campo, e o valor anterior é mantido. Os demais campos são salvos normalmente.
General
A seção lista os países cobertos pelo mapa da GLS. A transportadora não é oferecida para outros países de destino.
Enable/Disable: ativa ou desativa o GLS ParcelShop. É a mesma chave do status da transportadora em Shipping > Carriers.
Name: o nome do método de envio exibido ao cliente (o nome da transportadora). Padrão: GLS ParcelShop. Obrigatório, no máximo 64 caracteres.
Tax status: a regra de imposto da transportadora. None significa que o envio não é tributado. Escolha uma regra de imposto para tornar o envio tributável.
Prices
Os preços são informados na moeda padrão da sua loja, sem impostos. As casas decimais podem usar vírgula ou ponto (4,99 ou 4.99). O preço é exibido ao cliente na moeda do carrinho.
Calculation type: como o preço é aplicado.
Country prices: uma tabela com uma linha por país de destino. Clique em Add country para adicionar uma linha e no ícone de lixeira para remover uma. Cada linha tem um Country, um Price e cinco colunas de peso: XS até 1 kg, S 1-2 kg, M 2-3 kg, L 3-5 kg e XL acima de 5 kg. É usada a coluna do peso do carrinho. Uma coluna de peso deixada em 0 usa a coluna Price. A linha * Default é usada para os países que não têm linha própria. Novas linhas começam com * Default e 0 em todas as colunas, e uma linha em que todos os preços são 0 dá entrega grátis; por isso, escolha o país e preencha os preços antes de salvar. Se um valor da tabela não for um número válido, a tabela inteira não é salva e a mensagem lista os valores incorretos.
Fallback cost: o preço usado quando a tabela não tem linha para o país de destino e não há linha * Default. Deixe em branco para ocultar a transportadora para esses países.
Free shipping from: o subtotal do carrinho (após descontos, sem impostos) a partir do qual a entrega com GLS ParcelShop é grátis. Deixe em branco se a entrega nunca for grátis.
Availability
Minimum weight (kg): oculta a transportadora quando o carrinho pesa menos. O peso é convertido da unidade de peso da sua loja. Vazio ou 0 significa sem limite.
Maximum weight (kg): oculta a transportadora quando o carrinho pesa mais. Padrão: 20. Os GLS ParcelShop costumam aceitar pacotes de até 20 kg, então confira o seu contrato com a GLS. Vazio ou 0 significa sem limite. Se o mínimo for maior que o máximo, os dois pesos são recusados com uma mensagem e os valores anteriores são mantidos.
Minimum cart subtotal: oferece a transportadora somente quando o subtotal do carrinho (após descontos, sem impostos) atinge este valor. Deixe em branco se não houver mínimo.
Ignore shipping zones: quando ativado, a transportadora é vinculada a todas as zonas, inclusive as desativadas, e é oferecida para os países selecionados abaixo, mesmo que não estejam nas suas zonas. Zonas criadas depois também são vinculadas. Ao desativar, a transportadora volta a ter as zonas que tinha antes e é oferecida somente nelas. Padrão: desativado.
Countries (ignore zones mode): os países de destino para esse modo. Deixe em branco para usar todos os países do mapa da GLS. Os países não cobertos pelo mapa da GLS são ignorados. Este campo só é usado quando Ignore shipping zones está ativado.
Advanced
Debug log: grava os cálculos de tarifas e as escolhas de ParcelShop em logs/vfd_glps_debug.log.php, na pasta do módulo. O arquivo não pode ser aberto pela web. Os erros são sempre registrados. Nenhum dado pessoal do cliente é registrado. Desative o log quando terminar.
Log: mostra o tamanho e as últimas entradas do log de depuração. Clique em Clear log para limpá-lo.
Remove data on uninstall: quando ativado, desinstalar o módulo apaga as configurações, a transportadora e o log. Quando desativado, tudo é mantido para uma reinstalação. O ParcelShop salvo nos pedidos é sempre mantido.
Como funciona na finalização de compra
Quando o PrestaShop mostra a etapa de entrega, ele pede ao módulo o preço do GLS ParcelShop. Só contam os produtos físicos: produtos virtuais não somam peso e não entram no subtotal do carrinho. O módulo verifica primeiro as condições: o país de entrega é coberto pelo mapa da GLS (e está selecionado em Countries (ignore zones mode) quando esse modo está ativado), o peso do carrinho e o subtotal mínimo do carrinho. Se o subtotal do carrinho atingir Free shipping from, a entrega é grátis. Caso contrário, o preço vem da linha do país (ou da linha * Default) e da coluna de peso, ou de Fallback cost. Se nenhum preço for encontrado, a transportadora é ocultada.
Quando o cliente seleciona o GLS ParcelShop, aparece abaixo da transportadora uma caixa GLS ParcelShop com o botão Select GLS ParcelShop. Ele abre o mapa oficial dos GLS ParcelShop para o país de entrega. Depois de escolher um ParcelShop, o nome e o endereço dele são exibidos, e o botão muda para Change ParcelShop. A escolha é salva no carrinho, então continua disponível quando a etapa de entrega é atualizada ou a página é recarregada. Se o endereço de entrega mudar para outro país, o cliente precisa escolher um ParcelShop novamente.
Quando o cliente clica em Continue na etapa de entrega, o módulo verifica se um ParcelShop foi escolhido e se ele está no país de entrega. Caso contrário, o cliente vê Please select a GLS ParcelShop. ou The selected GLS ParcelShop is not in your shipping country. Please choose a ParcelShop again. e permanece na etapa de entrega. Se o ParcelShop não puder ser salvo, o cliente vê The ParcelShop could not be saved. Please try again. Se o script do mapa da GLS não puder ser carregado, o cliente vê uma mensagem pedindo para recarregar a página ou escolher outro método de envio.
O mapa da GLS é executado no navegador do cliente. Na finalização de compra, o módulo carrega o script do mapa a partir de map.gls-croatia.com, e o mapa carrega os dados dos ParcelShop e os blocos do mapa da GLS. A GLS recebe os dados habituais da requisição do visitante (endereço IP, navegador). Nada é enviado do seu servidor para a GLS.
Se você editar a transportadora em Shipping > Carriers depois que ela tiver pedidos, o PrestaShop a salva como uma nova versão da transportadora. O módulo segue a nova versão automaticamente.
O módulo não obtém tarifas em tempo real da GLS, não cria envios da GLS, não imprime etiquetas e não rastreia encomendas. Ele não tem uma lista de ParcelShop no seu servidor, então não consegue verificar o ID do ParcelShop junto à GLS. Informe o ID do ParcelShop do pedido à GLS da forma habitual (MyGLS, o seu software da GLS ou outro módulo).
Pontos de retirada
Quando o pedido é feito, o ParcelShop do carrinho é salvo com o pedido: o seu ID, o nome com o endereço e o país. Ele não muda mais com o carrinho.
Página do pedido no administrador: um bloco GLS ParcelShop mostra o nome e o endereço do ParcelShop, com o ParcelShop ID e o país. Se um pedido GLS ParcelShop não tiver ParcelShop, o bloco mostra No ParcelShop was selected for this order.
Páginas do cliente: o ParcelShop é exibido na página de confirmação do pedido e na página de detalhes do pedido na conta do cliente.
E-mails: o ParcelShop é acrescentado ao nome da transportadora no e-mail de confirmação do pedido enviado ao cliente. O e-mail de novo pedido para o lojista (módulo Mail alerts) também inclui o ID do ParcelShop.
Chave de licença
O módulo funciona com uma chave de licença VibeFox obtida em vibefox.net. O bloco de licença License — VibeFox GLS ParcelShop é o primeiro bloco em Modules > Module Manager > VibeFox GLS ParcelShop > Configure, acima das configurações. Insira a chave em License key e clique em Activate. Depois disso, o bloco exibe a chave mascarada, o status (por exemplo, a data até a qual a licença está ativa e o seu domínio) e os botões Check now para verificar o status novamente, Change key para inserir outra chave e Remove key para remover a chave desta loja. Abaixo deles estão a linha Product: presta-shipping-gls-parcelshop e o link Manage licenses and domains in your account, que abre a sua conta vibefox.net. Somente funcionários com a permissão Configure para o módulo podem alterar a chave. Os textos do bloco seguem o idioma do back office (inglês e russo estão incluídos).
Se a chave não for aceita, o bloco informa o motivo, por exemplo Key not found, This key belongs to another product, Domain limit reached ou License expired on seguido de uma data. Depois que o endereço da loja mudar, ou depois que você liberar uma vaga de domínio na sua conta, clique em Check now. Se o servidor de licenças não puder ser acessado, o módulo continua funcionando com o último status conhecido.
Uma chave funciona em um único domínio: o domínio da loja principal, também em uma configuração multiloja. Remover a chave da loja não libera a vaga de domínio. Libere a vaga na sua conta vibefox.net.
Sem uma chave ativa, a transportadora GLS ParcelShop não é mostrada aos clientes na finalização de compra e nenhuma tarifa é calculada. A vitrine do PrestaShop não sabe que você está conectado ao back office, então a transportadora também fica oculta para você: você pode configurar o módulo antes de comprar uma chave, mas não pode testá-lo na finalização de compra. Um lembrete aparece em Modules > Module Manager, na aba Alerts. Os pedidos existentes não são afetados.
Quando uma licença expira, o módulo continua funcionando, mas atualizações e suporte precisam de renovação. O status é verificado novamente de forma automática enquanto você trabalha no back office: uma vez por dia durante os primeiros 14 dias após a chave ser inserida, depois uma vez por semana. Nenhum cron job é necessário. Desinstalar ou redefinir o módulo sempre remove a chave de licença e o status da licença.
Solução de problemas
O GLS ParcelShop não aparece na finalização de compra: verifique se a licença está ativa e se Enable/Disable está ligado. Em Shipping > Carriers, verifique se a transportadora cobre a zona do país do cliente e o grupo do cliente (ou ative Ignore shipping zones e confira Countries (ignore zones mode)). Verifique se o país de destino é um dos países do mapa da GLS e se tem um preço (uma linha do país, a linha * Default ou Fallback cost). Confira os limites de peso e o Minimum cart subtotal. Os produtos também podem estar limitados a certas transportadoras na página do produto. Ative o Debug log e veja o campo Log para descobrir o motivo.
O mapa não abre: o cliente vê "The GLS ParcelShop map could not be loaded..." quando o script da GLS é bloqueado, por exemplo por um bloqueador de anúncios ou de privacidade, por uma política de segurança de conteúdo (CSP) ou por uma queda da GLS. Permita map.gls-croatia.com na sua política de segurança de conteúdo.
A entrega está grátis para um país por engano: verifique a linha desse país em Country prices. Uma linha em que o Price e todas as colunas de peso são 0 dá entrega grátis.
A tabela ou um campo não foi salvo: um valor não é um número válido. A mensagem no topo da página indica o valor. Use números com vírgula ou ponto como separador decimal.
A página diz que a transportadora GLS ParcelShop não foi encontrada: a transportadora foi excluída em Shipping > Carriers. Redefina o módulo em Modules > Module Manager para criá-la novamente. O Reset mantém o status de uma transportadora existente: uma transportadora desativada continua desativada.
Um pedido não tem ParcelShop e o log indica que o ParcelShop do carrinho já está salvo em outro pedido: um carrinho virou dois pedidos. O primeiro pedido mantém o ParcelShop. Informe o segundo pedido à GLS manualmente.
Desinstalação
Acesse Modules > Module Manager, abra o menu ao lado de VibeFox GLS ParcelShop e escolha Uninstall. A chave de licença e o status da licença são sempre removidos.Se Remove data on uninstall estiver ativado, a transportadora é excluída (os pedidos mantêm o histórico), e as configurações, o log e os ParcelShop de carrinhos sem pedido são removidos. Se estiver desativado, a transportadora apenas é desativada e todas as configurações são mantidas. Ao instalar o módulo novamente, a transportadora salva recupera o status anterior. O ParcelShop salvo nos pedidos é sempre mantido.
GLS é uma marca registrada do respectivo proprietário. Este módulo não é afiliado à GLS nem endossado por ela.