VibeFox DHL Packstation 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.

DHL API key: a lista de pontos vem da API gratuita DHL Location Finder. Cadastre-se no portal de desenvolvedores da DHL (developer.dhl.com), crie um aplicativo, adicione a API "Location Finder - Unified" e copie a chave de API do aplicativo. Para essa API não é necessário contrato comercial com a DHL. Sem a chave, o método fica oculto na finalização de compra. Atenção ao limite de requisições do seu aplicativo DHL: cada nova pesquisa por CEP ou cidade é uma requisição à API.

VibeFox license key: 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_dhl_packstation para /wp-content/plugins/ por FTP.

2. Clique em Activate.

3. Abra as configurações: WooCommerce > Settings > Shipping > DHL Packstation, ou clique em Settings abaixo do nome do plugin na página Plugins.

4. Digite sua chave de licença VibeFox no bloco de licença no topo da página e clique em Activate.

5. Cole a chave de API da DHL, salve, clique em Test API key, escolha os tipos de ponto e informe os preços por país (veja Configuração).

6. Adicione DHL Packstation a uma zona de entrega (por exemplo Alemanha) em WooCommerce > Settings > Shipping > Shipping zones, ou ative Ignore shipping zones.

Configuração

Todas as configurações estão em uma única página: WooCommerce > Settings > Shipping > DHL Packstation. Elas valem para todas as zonas de entrega. Ao adicionar o método a uma zona, a janela da zona tem apenas um campo:

Title (zone): o nome desta opção de entrega na finalização de compra para esta zona. Deixe vazio para usar o Name global.

Avisos acima das configurações informam quando a chave de API da DHL está vazia e quando as entradas de preço por país não estão no formato correto. Sempre que você salva as configurações, o cache de pontos é limpo.

Geral

Enable/Disable: ativa ou desativa o método em todas as zonas de uma vez.

Name: o nome do método de entrega exibido ao cliente. Padrão: DHL Packstation. Uma zona pode substituí-lo pelo próprio Title.

Tax status: Taxable adiciona o imposto do WooCommerce ao custo da entrega; None não adiciona.

DHL Location Finder API

DHL API key: a chave de API do seu aplicativo em developer.dhl.com. Sem ela, o método fica oculto na finalização de compra.

Connection test: o botão Test API key pesquisa pontos próximos a 53113 Bonn com a chave salva e limpa o cache de pontos. Salve as configurações antes. Mostra quantos pontos foram encontrados ou que a DHL rejeitou a chave (401/403).

Pontos de retirada

Location types: quais pontos DHL o cliente pode escolher: Packstation (parcel locker), Post Office (Postfiliale) e DHL Parcel Shop (Paketshop). Todos os três por padrão. Se nenhum for selecionado, o método fica oculto. Para uma Packstation, o cliente precisa informar seu DHL Postnummer.

Search radius (meters): o raio em torno do CEP ou da cidade pesquisados. Padrão: 5000. A DHL permite até 25000 m.

Max results: o número máximo de pontos exibidos por pesquisa. Padrão: 20. A DHL permite até 50.

Shipping address: usa o ponto escolhido como endereço de entrega do pedido. Ativado por padrão. A linha de endereço 1 passa a ser, por exemplo, "Packstation 105", a linha 2 "Postnummer" com o número, além do CEP e da cidade do ponto, para que as etiquetas impressas a partir do pedido cheguem ao lugar certo. O Postnummer também é salvo em _shipping_dhl_postnum, o campo lido pelo plugin oficial "DHL Shipping Germany for WooCommerce".

Preços

Country prices: o preço por país de destino na moeda da loja, no formato CC:PREÇO, separado por vírgulas ou quebras de linha. Padrão: DE:4.99, AT:5.99. Vírgula decimal também funciona (DE:4,99).

Other countries: o preço para um país de destino que não está em Country prices. Padrão: 5.99. Deixe vazio para ocultar o método para esses países.

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

Free shipping from: o subtotal do carrinho a partir do qual esta entrega é grátis. Deixe vazio para nunca ser grátis.

Disponibilidade

Min weight (kg): o peso mínimo do carrinho. Os pesos dos produtos são convertidos da unidade da sua loja. 0 significa sem limite.

Max weight (kg): o método fica oculto acima deste peso de carrinho. Padrão: 31.5, porque uma Packstation aceita pacotes de até 31,5 kg. 0 significa sem limite.

Minimum subtotal: exibe o método somente se o subtotal do carrinho for pelo menos este valor. Deixe vazio para exibi-lo sempre.

Excluded shipping classes: o método fica oculto se o carrinho contiver um produto de uma destas classes de entrega do WooCommerce.

Ignore shipping zones: oferece o método para os países abaixo, mesmo quando a zona correspondente não o inclui.

Countries (ignore zones): os países de destino para esse modo. Deixe vazio para todos os países. Usado apenas com Ignore shipping zones.

Avançado

Debug log: registra requisições de API e etapas da finalização de compra em WooCommerce > Status > Logs, origem vfd-dhl-packstation. Erros de API são sempre registrados, mesmo com esta opção desativada. A chave de API, o Postnummer e os endereços dos clientes nunca são registrados.

Remove data on uninstall: quando ativada, excluir o plugin remove suas configurações e métodos de zona. Desativar nunca apaga nada. Os pontos escolhidos permanecem nos pedidos.

Como funciona na finalização de compra

Quando o cliente informa um endereço de entrega, o WooCommerce pede um preço ao plugin. O plugin verifica o peso do carrinho, o subtotal mínimo e as classes de entrega excluídas, pega o preço do país de destino (ou o preço dos demais países) e aplica entrega grátis se o subtotal for alto o bastante.

O método funciona na finalização de compra clássica e nos blocos de Carrinho e Finalização de compra. É compatível com o WooCommerce High-Performance Order Storage (HPOS).

O plugin não cria envios na DHL, não imprime etiquetas e não rastreia encomendas. Use o portal de clientes comerciais da DHL ou um plugin de etiquetas: o pedido já contém o endereço da Packstation e o Postnummer no formato esperado por eles. O plugin não calcula tarifas DHL em tempo real e não exibe mapa. Se a API da DHL não puder ser acessada, o cliente vê uma mensagem e não consegue usar este método até que ela volte a funcionar. Não há digitação manual de número de Packstation.

Pontos de retirada

Quando o cliente seleciona DHL Packstation, um seletor aparece abaixo da opção de entrega. Os pontos DHL próximos ao CEP ou à cidade de entrega são carregados. O cliente pode pesquisar outro CEP ou cidade. Os pontos são agrupados por tipo (Packstation, Post Office, Parcel Shop) e ordenados por distância.

Para uma Packstation, o cliente precisa informar o DHL Postnummer, o número de cliente DHL de 6 a 12 dígitos do aplicativo ou da conta DHL. Para os outros pontos, é opcional. O pedido não pode ser feito sem um ponto de retirada ou com um Postnummer inválido. Isso é verificado no servidor, inclusive na finalização de compra em blocos.

Os resultados de pesquisa ficam em cache por 12 horas. Uma pesquisa com falha fica em cache por 10 minutos, para que a finalização de compra não espere pela DHL a cada atualização. O tempo limite da API é de 12 segundos.

O ponto (ID, tipo, número, nome, endereço) e o Postnummer são salvos no pedido. Eles aparecem na tela do pedido, abaixo do endereço de entrega, na página de agradecimento, em My account > Orders e nos e-mails de pedido (HTML e texto simples) como DHL pickup location e DHL Postnummer.

Na tela do pedido, clique em Edit ao lado do ponto, pesquise por CEP ou cidade, escolha outro ponto, altere o Postnummer e clique em Save location. Cada alteração adiciona uma nota ao pedido. Se Shipping address estiver ativado, o endereço de entrega também é atualizado. Recarregue a página para vê-lo.

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 > DHL Packstation. 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 inserir 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. Libere-a na sua conta da vibefox.net.

Sem uma chave ativa, a DHL Packstation não é exibida aos clientes na finalização de compra. Gerentes da loja conectados ainda a veem, marcada com (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 Plugins e nas páginas do WooCommerce. Pedidos existentes não são afetados.

Quando uma licença expira, o plugin continua funcionando, mas atualizações e suporte precisam de renovação. O status é verificado novamente de forma automática em segundo plano.

Solução de problemas

DHL Packstation 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á ativo e o país é permitido). Confira se a DHL API key está preenchida, se pelo menos um tipo de ponto está selecionado, se o país de destino tem preço (ou se Other countries está definido) e se as regras de peso, subtotal e classe de entrega não o estão ocultando.

Nenhum ponto é exibido: clique em Test API key. Se a DHL rejeitar a chave (401/403), verifique a chave e se o seu aplicativo tem a API "Location Finder - Unified". Ative o Debug log e abra WooCommerce > Status > Logs, origem vfd-dhl-packstation. Verifique se o limite de requisições do seu aplicativo DHL não foi atingido.

Nenhum ponto perto de um endereço: aumente o Search radius (meters) ou o Max results, ou deixe o cliente pesquisar outro CEP ou cidade.

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 da vibefox.net e clique em Check now. Se o endereço do site mudou, clique em Check now para ativar a chave para o 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. Ele apenas limpa o cache de pontos. Para remover o plugin, 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, assim como o cache de pontos. As configurações e os métodos de zona só são removidos se Remove data on uninstall estiver ativado. Caso contrário, permanecem para uma reinstalação futura. Os pontos escolhidos permanecem nos pedidos, e os pedidos existentes mantêm suas linhas de entrega.

DHL e Packstation são marcas registradas de seus respectivos proprietários. Este plugin não é afiliado nem endossado pela DHL.