VibeFox LP Express for PrestaShop — Ajuda
Requisitos
PrestaShop: 8.0 a 9.x.
PHP: 8.0 ou superior. O módulo se recusa a instalar em versões anteriores do PHP.
LP Express: não é necessária uma conta de API. A LP Express não tem uma API pública de preços, e o módulo não usa a API da Unisend, então você insere os seus próprios preços (contratuais). Crie os pacotes na sua conta da Unisend ("Mano siuntos").
Lista de terminais de pacotes: o módulo usa a lista pública de terminais da LP Express (https://www.lpexpress.lt/index.php?cl=terminals&fnc=getTerminals). Não é necessária nenhuma chave. Se essa lista online não estiver disponível, o módulo usa a última cópia baixada, se houver, ou então a sua própria lista. Esteja preparado para inserir a sua própria lista (veja Configuração).
Chave de licença VibeFox: comprada em vibefox.net. Uma chave funciona em um domínio.
Instalação
1. No back office, vá em Modules > Module Manager e clique em Upload a module. Escolha o arquivo ZIP do módulo.
2. Quando o envio terminar, clique em Configure, ou encontre VibeFox LP Express depois 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. Preencha a tabela de preços (pelo menos uma linha) ou um custo alternativo. Verifique a linha de status sobre os terminais de pacotes no topo da página e adicione a sua própria lista de terminais se a lista online não estiver disponível. Clique em Save.
Na instalação, o módulo cria a transportadora LP Express parcel terminal com o texto de prazo de entrega Delivery to an LP Express parcel terminal. A transportadora é atribuída à zona da Lituânia e a todos os grupos de clientes. Você pode adicionar zonas e alterar grupos de clientes, prazo de entrega, logotipo e limites de tamanho em Shipping > Carriers. Não defina preços ali: o preço sempre vem do módulo.
Configuração
Todas as configurações ficam na página do módulo: Modules > Module Manager > VibeFox LP Express > Configure. Cada seção tem o seu próprio botão Save, que salva a página inteira. Cada salvamento também recarrega a lista de terminais.
No topo da página, avisos mostram problemas e o status dos terminais. Um alerta aparece quando nenhum preço está definido ou nenhum terminal de pacotes está disponível, porque nesse caso a transportadora não é exibida no checkout; quando a transportadora foi excluída; e quando a unidade de peso da loja não é uma que o módulo reconhece (kg, g, lb, oz), porque nesse caso os pesos dos produtos são lidos como kg. Uma linha de informação mostra quantos terminais de pacotes, em quantas cidades, estão disponíveis e de qual fonte: a lista online, uma cópia salva da lista online (com a data) ou a sua própria lista.
Ao salvar, um título de método vazio ou não válido como nome de transportadora é recusado com Enter a valid method title., e um título com mais de 64 caracteres também é recusado. Nos dois casos, nada é salvo. Um valor ou peso que não seja um número (ou que seja negativo) é informado, e o valor anterior é mantido. Um Minimum weight (kg) maior que o Maximum weight (kg) (30 kg quando o máximo está vazio) também é informado, porque a transportadora nunca seria exibida, e os dois pesos mantêm os valores anteriores. Preços da tabela que não sejam números são informados e deixados em branco.
Geral
Enable/Disable: ativa ou desativa a LP Express. É o mesmo interruptor do status da transportadora em Shipping > Carriers.
Method title: o nome da transportadora exibido aos clientes no carrinho e no checkout. Padrão: LP Express parcel terminal. Obrigatório.
Tax status: None significa que os preços abaixo são finais. Taxable com uma regra de imposto (uma opção para cada regra de imposto da sua loja) significa que o PrestaShop acrescenta esse imposto de envio aos preços abaixo. Esta é a regra de imposto da transportadora.
Preços (na moeda padrão da sua loja; os decimais podem ser escritos como 2.99 ou 2,99)
Price table: uma linha por país de destino. Clique em + Add country para adicionar uma linha e no ícone da lixeira para remover uma. Escolha * Any other country para todos os países que não tenham linha própria. Cada linha tem um Base price e colunas de peso: XS (≤1 kg), S (≤2 kg), M (≤3 kg), L (≤5 kg) e XL (>5 kg). O peso é o do carrinho, ou o peso de um item com Per item. Uma coluna vazia usa o preço base da linha. 0 significa grátis.
Fallback cost: usado quando a tabela de preços não tem uma linha para o país de destino. Deixe em branco para ocultar a transportadora para esses países.
Calculation: como o preço é calculado.
Free shipping from: o total do carrinho (produtos que precisam de envio, após descontos, sem impostos) a partir do qual a LP Express é grátis. Deixe em branco para não ter frete grátis.
Disponibilidade
Minimum weight (kg): oculta a transportadora quando o carrinho é mais leve. Vazio ou 0 significa sem limite.
Maximum weight (kg): oculta a transportadora quando o carrinho é mais pesado. Os terminais LP Express aceitam pacotes de até 30 kg. Padrão: 30. 0 significa sem limite. Vazio significa 30 kg nas zonas da transportadora, e sem limite apenas para os países de Ignore shipping zones fora delas.
Minimum cart total: exibe a transportadora somente a partir deste total do carrinho (produtos que precisam de envio, após descontos, sem impostos). Deixe em branco para exibi-la sempre.
Ignore shipping zones: oferece a LP Express para os países abaixo sem que você precise definir zonas. A transportadora fica então vinculada a todas as zonas ativas (também às zonas criadas depois). As zonas que a transportadora tinha antes continuam permitidas para todos os países delas. Quando você desativa a opção de novo, a transportadora recupera as zonas que tinha antes. Quando ela está desativada, os países são definidos pelas zonas da transportadora em Shipping > Carriers. Isso é recomendado.
Countries (without zones): os países de destino para esse modo. Este campo só é usado quando Ignore shipping zones está ativado. Deixe-o em branco para oferecer a transportadora em todos os países.
Terminais de pacotes
Terminal list: de onde vêm os terminais.
Own terminal list: um terminal por linha, no formato ID | Name | City | Address | ZIP, por exemplo 1234 | LP EXPRESS Akropolis | Vilnius | Ozo g. 25 | LT-07150. ID e City são obrigatórios. Linhas que começam com # são ignoradas. Use os IDs de terminal que a sua conta da Unisend espera.
Avançado
Debug log: grava os detalhes do cálculo de preços e da lista de terminais em logs/vfd_lpex_debug.log.php, na pasta do módulo. O arquivo não pode ser aberto pela web. Erros, como uma lista de terminais indisponível, são sempre registrados. Nenhum dado do cliente é registrado.
Log: mostra o tamanho e as últimas entradas do log. Clique em Clear log para esvaziá-lo.
Remove data on uninstall: quando ativado, ao desinstalar o módulo são excluídos as configurações, a transportadora e a lista de terminais salva. Quando desativado, desinstalar apenas desativa a transportadora. O terminal salvo nos pedidos é sempre mantido.
Como funciona no checkout
Na etapa de envio, o PrestaShop pede ao módulo o preço da LP Express. Só os produtos físicos contam: produtos virtuais não somam peso e não entram no total do carrinho. O módulo verifica os países de Ignore shipping zones, o peso do carrinho e o valor mínimo do carrinho. Se o frete grátis se aplicar, o preço é 0. Caso contrário, o preço vem da linha do país (ou da linha *): a coluna de peso; se não houver, o preço base; se também não houver, o custo alternativo. Se não houver preço, ou se nenhum terminal de pacotes estiver disponível, a transportadora é ocultada, para que o cliente nunca veja um checkout que não possa ser concluído.
Preços e valores estão na moeda padrão da sua loja. Depois, o preço é exibido na moeda do carrinho do cliente, usando a taxa de câmbio do PrestaShop.
A lista online de terminais fica em cache por 24 horas. Um download que falhou fica registrado por 15 minutos, para que o checkout não espere pela lista a cada atualização. O tempo limite do download é de 10 segundos. Somente os terminais ativos da lista são oferecidos.
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 solicita preços da LP Express ou da Unisend, não cria envios, não imprime etiquetas, não chama um courier e não rastreia pacotes. Crie os pacotes na sua conta da Unisend ("Mano siuntos"). A entrega porta a porta por courier não faz parte desta transportadora.
Pontos de retirada
Quando o cliente seleciona a LP Express, o bloco LP Express parcel terminal aparece abaixo da transportadora com duas listas: -- Select city -- e -- Select parcel terminal --. A cidade do endereço de entrega é pré-selecionada quando corresponde a uma cidade da lista. Cada terminal é exibido com nome, endereço e CEP. A escolha é salva no carrinho imediatamente, então não se perde quando o checkout é atualizado. Funciona com os temas Classic e Hummingbird.
Um terminal é obrigatório. Sem um, Continue na etapa de envio e Place order exibem Please select an LP Express parcel terminal. Quando o cliente clica em Continue, o servidor verifica o terminal na lista novamente, então um ID de terminal falsificado ou desatualizado é recusado com The selected LP Express parcel terminal is not available any more. Please select a parcel terminal again.
O ID, o nome e a cidade do terminal são salvos com o pedido. Eles aparecem no bloco LP Express parcel terminal da página do pedido no back office (com Terminal ID), na página de confirmação do pedido e nos detalhes do pedido do cliente. No e-mail de confirmação do pedido e no e-mail de novo pedido ao lojista, eles são acrescentados ao nome da transportadora como LP Express parcel terminal: seguido do terminal. Se um pedido não tiver terminal, a página do pedido no back office mostra No parcel terminal was chosen for this order.
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 LP Express é o primeiro bloco em Modules > Module Manager > VibeFox LP Express > Configure, acima das configurações. Cole a chave em License key e clique em Activate. Depois disso, o bloco mostra 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-lp-express 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 do 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 domínio: o domínio da loja principal, inclusive 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 LP Express não é exibida aos clientes no checkout 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 no checkout. 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 nos primeiros 14 dias após a chave ser inserida e depois uma vez por semana. Não é necessário nenhum cron job. Desinstalar ou redefinir o módulo sempre remove a chave de licença e o status da licença.
Solução de problemas
A LP Express não aparece no checkout: 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 se Ignore shipping zones está ligado e o país é permitido). Abra a página do módulo: um alerta explica se nenhum preço está definido ou se nenhum terminal de pacotes está disponível. Verifique também os limites de peso e o Minimum cart total. Os produtos também podem ser limitados a certas transportadoras na página do produto. Com o Debug log ligado, o campo Log na página do módulo mostra por que a transportadora foi ocultada.
Nenhum terminal de pacotes: a lista online não pôde ser carregada e não há cópia salva nem lista própria. O módulo tenta de novo a cada 15 minutos. Insira a sua própria lista em Own terminal list, ou escolha Only my own list.
A lista de terminais está desatualizada: clique em Save na página do módulo. Isso recarrega a lista de terminais. Com a sua própria lista, atualize as linhas manualmente.
O cliente não consegue continuar: é preciso escolher um terminal de pacotes. Se o cliente vir The LP Express parcel terminal list is temporarily unavailable. Please try again later or choose another shipping method., nenhum terminal está disponível agora. Adicione a sua própria lista.
Em qual moeda estão os preços: na moeda padrão da sua loja. Clientes que pagam em outra moeda veem o preço convertido com a taxa de câmbio do PrestaShop.
A página informa que a transportadora LP Express não foi encontrada: a transportadora foi excluída em Shipping > Carriers. Redefina o módulo em Modules > Module Manager para criá-la novamente.
Desinstalação
Vá em Modules > Module Manager, abra o menu ao lado de VibeFox LP Express e escolha Uninstall. A chave de licença e o status da licença são sempre removidos. A lista de terminais em cache é sempre limpa. Se Remove data on uninstall estiver ligado, a transportadora é excluída (os pedidos mantêm o histórico), e as configurações, o log e a cópia salva da lista de terminais são removidos. Se estiver desligado, a transportadora é apenas desativada e todas as configurações e a cópia salva são mantidas. Instalar o módulo novamente devolve à transportadora salva o status que ela tinha. O terminal salvo nos pedidos nunca é excluído.
A LP Express é uma marca registrada de seu respectivo titular. Este módulo não é afiliado à LP Express nem por ela endossado.