VibeFox PostNord for WooCommerce — Ajuda
Requisitos
WordPress: 5.8 ou superior.
WooCommerce: 7.0 ou superior, instalado e ativo. O plugin não ativa sem ele.
PHP: 8.0 ou superior.
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, o método continua 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 PostNord habitual, 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 WordPress, vá em Plugins > Add New > Upload Plugin, escolha o arquivo ZIP do plugin e clique em Install Now. Você também pode enviar a pasta vfd_postnord para /wp-content/plugins/ por FTP.
2. Clique em Activate.
3. Abra as configurações: WooCommerce > Settings > Shipping > VibeFox PostNord, ou clique em Settings embaixo do nome do plugin na página de Plugins.
4. Digite a sua chave de licença VibeFox no bloco de licença no topo da página e clique em Activate.
5. Cole a API key da PostNord, escolha o seu Agreement country e preencha os Country prices (veja Configuração).
6. Adicione o VibeFox PostNord às zonas de envio da Suécia, Dinamarca, Noruega ou Finlândia em WooCommerce > Settings > Shipping > Shipping zones. Nas configurações do método, defina o seu Title e o Delivery type. Ou ative Ignore shipping zones.
Configuração
Todas as configurações, exceto o título e o tipo de entrega, estão em uma única página: WooCommerce > Settings > Shipping > VibeFox PostNord. Elas valem para todas as zonas de envio. Ao adicionar o método a uma zona, a janela da zona tem dois campos:
Title (zone): o nome desta opção na finalização de compra, por exemplo "PostNord MyPack Collect". Deixe vazio para usar o Name global.
Delivery type (zone): Same as global setting (padrão), Service point / parcel locker ou Home delivery. Adicione dois métodos PostNord a uma zona para oferecer os dois.
Acima das configurações, a página avisa quando ainda não há chave de API ou preço. Sempre que você salva as configurações, as listas de pontos de serviço em cache são limpas.
Geral
Enable/Disable: quando desmarcado, o método fica oculto em todos os lugares, inclusive nas zonas de envio.
Name: o nome do método de envio exibido na finalização de compra. Um método de zona pode substituí-lo pelo seu próprio Title. Padrão: PostNord.
Delivery type: o padrão para todos os métodos PostNord; cada método de zona pode escolher o seu.
Tax status: Taxable adiciona o imposto do WooCommerce ao custo de envio, None não adiciona.
API 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 é registrada em log.
Test mode: usa o ambiente de teste da PostNord (atapi2.postnord.com). Somente para chaves emitidas para o ambiente de teste.
Agreement country: o país do seu contrato de cliente 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
Os preços estão na moeda da loja. 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 é: primeiro a tabela por país, depois o custo de contingência; o frete grátis vale apenas onde um dos dois gera um preço.
Calculation type: Per order cobra o preço uma vez. Per item (price × number of items) o multiplica pela quantidade 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 X 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. 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, o que significa frete grátis. Escolha o país e informe os preços antes de salvar, ou remova a linha. Uma célula que não é um número é salva como 0, com uma mensagem.
Fallback cost: usado quando a tabela de países não tem linha para o destino nem linha *. Deixe vazio para ocultar o método para esses países.
Free shipping from: o subtotal do carrinho (após descontos, sem impostos) a partir do qual a PostNord é gratuita. Vale apenas onde há preço definido: uma linha de país, a linha * ou o custo de contingência. Deixe vazio para nunca oferecer frete grátis.
Disponibilidade
Min weight (kg): oculta o método 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 o método quando o carrinho pesa mais. Padrão: 30. 0 significa sem limite. Confira o limite de peso do seu serviço PostNord: os armários de encomendas aceitam menos do que os pontos de serviço.
Minimum subtotal: mostra o método somente se o subtotal do carrinho for pelo menos este valor. Deixe vazio para sempre mostrar.
Disabled shipping classes: oculta o método quando o carrinho contém um produto de qualquer uma destas classes de envio do WooCommerce.
Ignore shipping zones: quando ativado, a PostNord é oferecida para os países abaixo com as configurações globais, mesmo que não esteja adicionada a uma zona de envio. Quando desativado, somente nas zonas de envio onde você a adicionou.
Countries (Ignore shipping zones): os países de destino para esse modo. Deixe vazio para usar todos os países de envio. Este campo é usado somente quando Ignore shipping zones está ativado.
Valores e pesos aceitam vírgula ou ponto. Um número inválido não é salvo, com uma mensagem.
Avançado
Debug log: grava os cálculos de tarifas e as chamadas de API em WooCommerce > Status > Logs (origem "vfd-postnord"). Erros de API são sempre registrados. A chave de API nunca é registrada. Desative o log quando terminar.
Remove data on uninstall: quando ativado, excluir o plugin remove as configurações da PostNord e os métodos de zona. A desativação nunca apaga as configurações. Os pontos de serviço salvos nos pedidos são sempre mantidos.
Como funciona na finalização de compra
Quando o cliente informa um endereço de entrega, o WooCommerce pede uma tarifa ao plugin. O plugin verifica as condições: peso do carrinho, subtotal mínimo e classes de envio desativadas. O preço vem da tabela de países e, depois, do custo de contingência. Se não houver preço, o método fica oculto. Se o frete grátis se aplicar, o cliente vê o método sem custo.
Para um método de ponto de serviço e um endereço de entrega na Suécia, Dinamarca, Noruega ou Finlândia, o seu servidor consulta a PostNord Business Location API para obter os pontos de serviço mais próximos do CEP de entrega. Ele envia o país, 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 "sem pontos" 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 finalização de compra.
Para outros destinos, o método ainda pode ser oferecido com os seus preços, sem seletor.
O método funciona na finalização de compra clássica e nos blocos Carrinho e Finalização de compra. É compatível com o WooCommerce High-Performance Order Storage (HPOS).
O plugin não consulta 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 nem envia e-mails de rastreamento. Não há visualização em mapa. Use o PostNord Portal, o Skicka Direkt Business ou um plugin de etiquetas para os envios; o ID do ponto de serviço salvo é o que essas ferramentas precisam.
Pontos de retirada
Quando o cliente seleciona um método de ponto de serviço, aparece embaixo 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ê "Enter your postcode to choose a PostNord service point.". A escolha se mantém durante as atualizações da finalização de compra.
Quando a lista está carregada, um ponto é obrigatório. Sem ele, a finalização de compra para com "Please select a PostNord service point.". O ponto escolhido é conferido no servidor contra a lista, tanto na finalização de compra clássica quanto na de blocos.
O seletor nunca bloqueia uma venda. Se a lista não puder ser carregada (ainda sem chave de API, API da PostNord fora do ar, nenhum ponto perto do CEP), o cliente vê uma observação e pode fazer o pedido mesmo assim. Nesse caso, a PostNord entrega no ponto de serviço mais próximo do endereço.
Tela de pedido do administrador: PostNord service point com o nome, o endereço e o Service point ID, abaixo do endereço de envio. Se nenhum ponto foi escolhido, aparece "not selected — PostNord delivers to the service point nearest to the shipping address".
Página de agradecimento e visualização do pedido em Minha conta: PostNord service point: com o nome e o endereço.
E-mails de pedido: o nome, o endereço e o ID do ponto nos e-mails em HTML e em texto simples.
No banco de dados, o ponto é salvo nos metadados do pedido _vfd_ptnd_servicepoint_id, _vfd_ptnd_servicepoint_name e _vfd_ptnd_servicepoint_address.
Chave de licença
O plugin funciona com uma chave de licença VibeFox obtida em vibefox.net. O bloco de licença fica no topo de WooCommerce > Settings > Shipping > VibeFox PostNord. Cole a chave em License key e clique em Activate. O bloco mostra o status, por exemplo a data até a qual a licença está ativa e o seu domínio. Use Check now para verificar o status novamente, Change key para informar outra chave e Remove key para removê-la deste site. O link Manage licenses and domains in your account abre a sua conta na vibefox.net.
Uma chave funciona em um domínio. Remover a chave de um site não libera a vaga de domínio dela. Libere a vaga na sua conta na vibefox.net.
Sem uma chave ativa, a PostNord não aparece para os clientes na finalização de compra. Os gerentes da loja conectados ainda a veem, marcada como (unlicensed — visible to admins only), para que você possa configurar e testar o plugin antes de comprar uma chave. Um lembrete aparece na página de Plugins e nas páginas do WooCommerce. Os pedidos existentes não são afetados.
Quando uma licença expira, o plugin continua funcionando, mas atualizações e suporte exigem renovação. O status é verificado de novo automaticamente em segundo plano.
Solução de problemas
A PostNord não aparece na finalização de compra: verifique se a licença está ativa, se Enable/Disable está ligado e se o método foi adicionado à zona do país do cliente (ou se Ignore shipping zones está ligado e o país é permitido). Verifique se há preço definido para o país (linha do país, linha * ou Fallback cost), os limites de peso, Minimum subtotal e Disabled shipping classes.
O seletor diz 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 e veja em WooCommerce > Status > Logs, origem "vfd-postnord". O pedido ainda pode ser feito; a PostNord entrega então 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 os Country prices de linhas com Price 0, principalmente uma linha * adicionada com + Add country e deixada sem preencher, e verifique o Free shipping from.
O bloco de licença mostra um erro: siga a mensagem exibida no bloco. Por exemplo, se a chave já estiver em uso em outro domínio, libere uma vaga na sua conta na vibefox.net e clique em Check now. Se o endereço do site mudou, clique em Check now para ativar a chave no novo domínio. Se o servidor de licenças não puder ser acessado, o plugin continua funcionando com o último status conhecido.
Desinstalação
Desativar o plugin mantém todas as configurações e apenas limpa as listas de pontos de serviço em cache. Para removê-lo, desative-o e exclua-o na página Plugins. A chave de licença e o status de licença deste plugin são sempre removidos, junto com as listas de pontos de serviço em cache. As configurações e os métodos de zona são removidos somente se Remove data on uninstall estiver ativado. Caso contrário, permanecem para uma reinstalação posterior. Os pedidos existentes mantêm as suas linhas de envio e o ponto de serviço salvo.
A PostNord é uma marca registrada de seu respectivo proprietário. Este plugin não é afiliado nem endossado pela PostNord.