VibeFox PostNord for PrestaShop — Ajuda

Requisitos

PrestaShop: 8.0 a 9.x.

PHP: 8.0 ou superior. O módulo se recusa a ser instalado em versões anteriores do PHP.

Chave de API da PostNord (para o seletor de ponto de serviço): crie uma conta gratuita em developer.postnord.com, adicione um aplicativo e copie a chave de API dele. Sem a chave, as transportadoras continuam funcionando, mas os clientes não conseguem escolher um ponto de serviço.

Contrato com a PostNord: para enviar encomendas, você precisa do seu contrato de cliente habitual com a PostNord, por exemplo MyPack Collect ou MyPack Home.

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, mais tarde, encontre VibeFox PostNord 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. Cole a API key da PostNord, escolha o seu Agreement country, preencha os Country prices (veja Configuração) e clique em Save.

Ao instalar, o módulo cria duas transportadoras. PostNord entrega em um ponto de serviço, com o texto de prazo de entrega Delivery to a PostNord service point. Ela está ativada. PostNord Home delivery entrega no endereço, com o texto PostNord home delivery. Ela fica desativada até você ativar Home delivery. As duas transportadoras estão atribuídas às zonas da Suécia, Dinamarca, Noruega e Finlândia e a todos os grupos de clientes. Você pode alterar zonas, grupos de clientes, texto de prazo, 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 estão na página do módulo: Modules > Module Manager > VibeFox PostNord > Configure. Cada seção tem o seu próprio botão Save, que salva a página inteira. Cada salvamento também limpa as listas de pontos de serviço em cache.

Acima das configurações, a página avisa quando ainda não há chave de API, quando ainda não há preço, quando uma transportadora PostNord foi excluída ou quando o módulo não reconhece a unidade de peso da loja. Nesse caso, os pesos dos produtos são considerados em kg. Use kg, g, lb ou oz em International > Localization (Local units).

Geral

Enable/Disable: liga ou desliga a transportadora com ponto de serviço. É o mesmo interruptor do status da transportadora em Shipping > Carriers.

Name: o nome da transportadora com ponto de serviço na finalização de compra, por exemplo "PostNord MyPack Collect". Padrão: PostNord. Obrigatório.

Home delivery: oferece também a entrega em domicílio da PostNord. É a segunda transportadora, sem ponto de serviço. Desativada por padrão.

Home delivery name: o nome da transportadora de entrega em domicílio na finalização de compra, por exemplo "PostNord MyPack Home". Padrão: PostNord Home delivery. Obrigatório.

Tax status: None significa que os preços abaixo são finais. Taxable: seguido de uma regra de imposto significa que o PrestaShop acrescenta o imposto de frete dessa regra aos preços. Vale para as duas transportadoras.

API da PostNord (seletor de ponto de serviço)

API key: a chave de API do seu aplicativo em developer.postnord.com. Ela é enviada à PostNord somente pelo seu servidor, nunca ao navegador, e nunca é gravada no log. Depois de salvar, o campo fica vazio e mostra Saved - leave empty to keep it. Digite um valor novo somente se quiser alterá-la.

Remove the saved API key: marque a opção e clique em Save para excluir a chave salva.

Test mode: usa o ambiente de teste da PostNord (atapi2.postnord.com). Só para chaves emitidas para o ambiente de teste.

Agreement country: o país do seu contrato de cliente com a PostNord: Suécia, Dinamarca, Noruega ou Finlândia. Ele define quais pontos de serviço são oferecidos. Same as the delivery country (padrão) usa o país do cliente.

Preços

O título da seção mostra a moeda padrão da sua loja. Os preços são nessa moeda, sem impostos, e são os mesmos para as duas transportadoras. A PostNord não tem uma API pública de preços, então você define os seus próprios preços, normalmente os do seu contrato com a PostNord. A ordem é: limite de frete grátis, depois a tabela por país e, por último, o custo de contingência.

Calculation type: Per order cobra o preço uma vez. Per item (price x number of items) multiplica pelo número de itens no carrinho.

Country prices: um preço por país de destino e peso do carrinho. Clique em Add country para adicionar uma linha e no ícone de lixeira para remover uma. Cada linha tem um Price e colunas de peso: XS até 1 kg, S até 2 kg, M até 3 kg, L até 5 kg e XL acima de 5 kg. Uma coluna de peso com 0 usa a coluna Price, e um Price de 0 significa frete grátis. O país * All other countries cobre todos os países sem linha própria. Decimais com vírgula ou ponto (9,99 ou 9.99). Uma nova linha começa como * All other countries com todos os preços em 0. Escolha o país e informe os preços antes de salvar, ou remova a linha. Uma célula vazia é salva como 0. Uma célula que não é um número é salva como 0, com uma mensagem.

Fallback cost: usado quando a tabela por país não tem linha para o destino nem linha *. Deixe vazio para ocultar as transportadoras desses países.

Free shipping from: o subtotal do carrinho (produtos que precisam de envio, após descontos, sem impostos) a partir do qual a PostNord é grátis. É verificado antes da tabela por país, então também vale para um país sem linha de preço. Deixe vazio para nunca oferecer frete grátis.

Disponibilidade

Min weight (kg): oculta as transportadoras quando o carrinho pesa menos. Os pesos dos produtos são convertidos a partir da unidade de peso da sua loja. 0 significa sem limite.

Max weight (kg): oculta as transportadoras quando o carrinho pesa mais. Padrão: 30. 0 significa sem limite. Verifique o limite de peso do seu serviço PostNord: os armários de encomendas aceitam menos que os pontos de serviço. Um Min weight (kg) maior que Max weight (kg) é recusado com um erro, e nada é salvo.

Minimum subtotal: mostra as transportadoras somente se o subtotal do carrinho (produtos que precisam de envio, após descontos, sem impostos) for pelo menos este valor. Deixe vazio para mostrá-las sempre.

Ignore shipping zones: quando ativado, a PostNord é oferecida para os países abaixo, mesmo que as zonas das suas transportadoras não os incluam. As transportadoras são vinculadas a todas as zonas ativas, e uma zona criada depois é vinculada na hora. Quando você desativa de novo, as transportadoras voltam a ter as zonas que tinham antes. Quando desativado, as transportadoras são oferecidas somente nas próprias zonas.

Countries (Ignore shipping zones): os países de destino para esse modo. Deixe vazio para permitir todos os países. Este campo só é usado quando Ignore shipping zones está ativado.

Valores e pesos aceitam vírgula ou ponto. Um valor que não seja um número igual ou maior que 0 não é salvo, e uma mensagem é exibida.

Avançado

Debug log: grava os cálculos de tarifas e as chamadas à API em logs/vfd_ptnd_debug.log.php, na pasta do módulo. O arquivo não pode ser aberto pela web. Os erros da API são sempre registrados. A chave de API nunca é registrada. Desative o log quando terminar.

Log: mostra o tamanho e as entradas mais recentes do log de depuração. Clique em Clear log para esvaziá-lo.

Remove data on uninstall: quando ativado, desinstalar o módulo exclui as configurações e as transportadoras da PostNord. Quando desativado, desinstalar apenas desativa as transportadoras. Os pontos de serviço salvos nos pedidos são sempre mantidos.

Como funciona na finalização de compra

Na etapa de envio, o PrestaShop pede ao módulo o preço de cada transportadora PostNord. Só produtos físicos contam: produtos virtuais não somam peso e não entram no subtotal. O módulo verifica o peso do carrinho e o subtotal mínimo. Se o frete grátis se aplicar, o preço é 0. Caso contrário, o preço vem da tabela por país e, depois, do custo de contingência. Se não houver preço, a transportadora fica oculta. O preço é calculado na moeda padrão da sua loja e depois exibido na moeda do carrinho do cliente.

Para a transportadora com ponto de serviço e um endereço de entrega na Suécia, Dinamarca, Noruega ou Finlândia, o seu servidor pede à PostNord Business Location API os 10 pontos de serviço mais próximos do CEP de entrega. Ele envia o país e o CEP de entrega e o país do contrato. O tempo limite da API é de 10 segundos. As listas ficam em cache por 6 horas por CEP, e as respostas "nenhum ponto" por 1 hora. Os erros da API ficam em cache por 5 minutos, para que uma queda da PostNord não deixe lenta cada atualização da etapa de entrega. A etapa de entrega nunca espera pela PostNord: se a lista ainda não estiver em cache, ela é carregada depois que o cliente seleciona a transportadora.

Para outros destinos, as transportadoras ainda podem ser oferecidas com os seus preços, sem seletor. A transportadora de entrega em domicílio nunca mostra um seletor.

Se você editar uma 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 em tempo real da PostNord e não cria etiquetas de envio, não agenda envios (EDI), não fornece números de rastreamento e não envia e-mails de rastreamento. Não há visualização em mapa. Para os envios, use PostNord Portal, Skicka Direkt Business ou uma ferramenta de etiquetas: essas ferramentas precisam do ID do ponto de serviço salvo.

Pontos de retirada

Quando o cliente seleciona a transportadora com ponto de serviço, aparece abaixo uma lista PostNord service point com os pontos mais próximos, agrupados por cidade com a distância. Antes de o CEP ser informado, o cliente vê a mensagem "Informe o seu CEP para escolher um ponto de serviço PostNord." A escolha é salva com o carrinho e se mantém nas atualizações da etapa de entrega.

Quando a lista é carregada, é obrigatório escolher um ponto. Sem escolha, Continue não avança e exibe "Selecione um ponto de serviço PostNord." O ponto escolhido é verificado no servidor contra a lista da PostNord para o endereço de entrega. Um ponto escolhido para outro CEP não é usado.

O seletor nunca bloqueia uma venda. Se a lista não puder ser carregada (chave de API ainda não informada, API da PostNord indisponível ou nenhum ponto perto do CEP), o cliente vê um aviso e ainda pode fazer o pedido. A PostNord então entrega no ponto de serviço mais próximo do endereço.

Página do pedido no back office: um bloco PostNord service point com o nome, o endereço e o Service point ID. Se nenhum ponto foi escolhido, aparece "não selecionado - a PostNord entrega no ponto de serviço mais próximo do endereço de envio".

Confirmação do pedido e detalhes do pedido do cliente: PostNord service point: com o nome e o endereço.

E-mails de pedido: a confirmação do pedido enviada ao cliente e o alerta de novo pedido enviado à loja mostram o nome, o endereço e o ID do ponto ao lado do nome da transportadora. O alerta da loja também mostra "not selected" quando não há ponto.

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 PostNord é o primeiro bloco na página Modules > Module Manager > VibeFox PostNord > Configure, acima das configurações. Insira 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 ficam a linha Product: presta-shipping-postnord 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, 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, as transportadoras PostNord não são mostradas aos clientes na finalização de compra e nenhum preço de frete é calculado. A vitrine do PrestaShop não sabe que você está conectado ao back office, então as transportadoras também ficam ocultas 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 de novo automaticamente enquanto você trabalha no back office: uma vez por dia nos primeiros 14 dias após a chave ser inserida, depois uma vez por semana. Nenhum cron job é necessário. Desinstalar o módulo sempre remove a chave de licença e o status da licença. O Reset deste módulo não apaga dados, então a chave e o status são mantidos.

Solução de problemas

A PostNord não aparece na finalização de compra: verifique se a licença está ativa e se Enable/Disable (ou Home delivery) 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. Verifique se há um preço para o país (linha do país, linha * ou Fallback cost), os limites de peso e o Minimum subtotal. Os produtos também podem estar limitados a certas transportadoras na página do produto.

O seletor informa que os pontos de serviço não podem ser carregados: verifique a API key e a configuração Test mode. Uma chave de produção não funciona no ambiente de teste, e o contrário também vale. Ative o Debug log, recarregue a finalização de compra e veja o campo Log na página do módulo. O pedido ainda pode ser feito; a PostNord então entrega no ponto de serviço mais próximo.

Pontos de serviço inesperados: verifique o Agreement country. Ele define quais pontos de serviço são oferecidos.

O frete está grátis por engano: verifique em Country prices as linhas com Price de 0, principalmente uma linha * adicionada com Add country e deixada sem preencher, e verifique o Free shipping from.

Os pontos de serviço parecem desatualizados após uma alteração: clique em Save na página do módulo. Isso limpa as listas em cache.

A página diz que uma transportadora PostNord 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 PostNord e escolha Uninstall. A chave de licença e o status da licença são sempre removidos. Desativar o módulo apenas limpa as listas de pontos de serviço em cache. Na desinstalação, as listas em cache são sempre removidas. Se Remove data on uninstall estiver ativado, as transportadoras são excluídas (os pedidos mantêm o histórico) e as configurações e o log são removidos. Se estiver desativado, as transportadoras são apenas desligadas e todas as configurações são mantidas. Instalar o módulo novamente devolve às transportadoras salvas o status que elas tinham. Os pontos de serviço salvos nos pedidos são sempre mantidos.

A PostNord é uma marca registrada de seu respectivo titular. Este módulo não é afiliado nem endossado pela PostNord.