VibeFox DPD Pickup for WooCommerce — Ajuda
Requisitos
WordPress: 5.8 ou superior.
WooCommerce: 7.0 ou superior, instalado e ativo. O plugin não é ativado sem ele.
PHP: 8.0 ou superior.
Credenciais da DPD Baltic (Lituânia, Letônia, Estônia): a lista de pontos de retirada vem do serviço web da DPD Baltic. Você precisa do nome de usuário e da senha da API que a DPD fornece a seus clientes empresariais. Peça-os ao seu gerente de conta na DPD ou ao atendimento ao cliente da DPD do seu país. Uma única conta lista os pontos de retirada da Lituânia, Letônia e Estônia.
DPD Eslováquia: a busca pública de parcelshops da DPD Eslováquia não exige credenciais.
Chave de licença VibeFox: comprada em vibefox.net. Uma chave funciona em um único 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_dpd_pickup para /wp-content/plugins/ por FTP.
2. Clique em Activate.
3. Abra as configurações: WooCommerce > Settings > Shipping > VibeFox DPD Pickup, ou clique em Settings abaixo do nome do plugin na página Plugins.
4. Insira sua chave de licença VibeFox no bloco de licença no topo da página e clique em Activate.
5. Escolha sua API da DPD. Para DPD Lituânia, Letônia ou Estônia, informe o nome de usuário e a senha da API. Informe os valores por país e salve. Clique em Refresh pickup points para verificar a conexão (veja Configuração).
6. Adicione o VibeFox DPD Pickup às suas zonas de envio 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 > VibeFox DPD Pickup. Elas valem para todas as zonas de envio. Ao adicionar o método a uma zona, a janela da zona tem apenas um campo:
Title (zone): o nome desta opção na finalização de compra para esta zona. Deixe vazio para usar o Name global.
Os avisos acima das configurações indicam quando o nome de usuário ou a senha da DPD Baltic estão vazios e quando nenhum valor está definido. Sempre que você salva as configurações, o cache dos pontos de retirada é limpo.
Geral
Enable/Disable: ativa ou desativa o método em todas as zonas ao mesmo tempo.
Name: o nome do método de envio exibido na finalização de compra. Padrão: DPD Pickup Point.
Tax status: Taxable adiciona o imposto do WooCommerce ao valor do frete, None não adiciona.
Lista de pontos de retirada da DPD
Os pontos de retirada são carregados da DPD e ficam em cache por 24 horas.
DPD API: a empresa DPD com a qual você tem sua conta. Contas Baltic usam o serviço web do próprio país.
API username (Baltic): seu nome de usuário do serviço web da DPD Baltic. Não é necessário para a DPD Eslováquia.
API password (Baltic): sua senha do serviço web da DPD Baltic. Não é necessária para a DPD Eslováquia.
Pickup points: o botão Refresh pickup points limpa o cache e carrega agora os pontos de retirada da DPD: Lituânia, Letônia e Estônia com a API Baltic, ou uma busca de teste em Bratislava para a DPD Eslováquia. Ele mostra o resultado por país. Salve as configurações antes.
Preços
Os valores de frete são fixos por país, na moeda da loja. Os preços da DPD não são consultados pela API.
Country prices: uma linha por país: CC:price, por exemplo EE:3.50. Vírgula decimal é aceita. Padrão: SK:3.50, LT:4.00, LV:4.00, EE:4.00.
Fallback cost: o valor para os países que não estão em Country prices. Padrão: 5.00. Deixe vazio para oferecer o método somente nos países listados.
Calculation type: Per order cobra o valor uma única vez. Per item (price x quantity) multiplica o valor pela quantidade de itens no carrinho.
Free shipping from: o frete é grátis quando o subtotal do pedido (após cupons) atinge este valor. Deixe vazio para desativar.
Disponibilidade
O método também fica oculto quando a DPD não retorna pontos de retirada para o endereço do cliente ou quando a API da DPD não pode ser acessada, porque um pedido não pode ser entregue sem ponto de retirada.
Min weight (kg): o peso mínimo do carrinho. Os pesos dos produtos são convertidos a partir da unidade de peso da sua loja. Vazio ou 0 significa sem limite.
Max weight (kg): carrinhos mais pesados não veem o método. Padrão: 31.5. 0 significa sem limite. Confira os limites de peso de pacotes dos pontos de retirada e armários da DPD Pickup no seu país.
Minimum subtotal: mostra o método somente quando o subtotal do pedido é de pelo menos este valor. Deixe vazio para sempre mostrá-lo.
Excluded shipping classes: o método fica oculto quando o carrinho contém um produto de uma destas classes de envio do WooCommerce.
Ignore shipping zones: oferece o método para os países indicados abaixo, mesmo quando a zona de envio do cliente não o inclui. Desativado significa que você adiciona o método às zonas de envio normalmente.
Countries: os países de destino para esse modo. Deixe vazio para todos os países. Usado apenas com Ignore shipping zones.
Seletor de ponto de retirada
City order: mostra primeiro as principais cidades (Tallinn, Riga, Vilnius, Bratislava e outras). Ativado por padrão.
City list width: a largura CSS da lista de cidades, por exemplo 100% ou 300px. Padrão: 100%.
Pickup point list width: a largura CSS da lista de pontos de retirada, por exemplo 100% ou 400px. Padrão: 100%.
Avançado
Debug log: registra as requisições à API e as etapas da finalização de compra em WooCommerce > Status > Logs, origem vfd-dpd-pickup. Erros da API são sempre registrados, mesmo com esta opção desativada. As credenciais nunca são registradas.
Remove data on uninstall: quando ativada, excluir o plugin remove suas configurações e os métodos de zona. Desativar o plugin nunca apaga as configurações. O ponto de retirada salvo nos pedidos é sempre mantido.
Como funciona na finalização de compra
Quando o cliente informa um endereço de entrega, o WooCommerce pede um valor ao plugin. O plugin verifica o peso do carrinho, o subtotal mínimo e as classes de envio excluídas, usa o valor do país (ou o custo alternativo) e aplica o frete grátis se o subtotal for alto o suficiente. Depois carrega os pontos de retirada da DPD para o endereço. Se a DPD não retornar nenhum, não puder ser acessada ou as credenciais Baltic estiverem ausentes, o método fica oculto.
A lista de pontos de retirada fica em cache por 24 horas. Uma requisição com falha é lembrada por 5 minutos, para que uma queda da DPD nunca deixe a finalização de compra mais lenta. O tempo limite da API é de 15 segundos.
O método funciona na finalização de compra clássica e nos blocos Carrinho e Finalização de compra. Ele é compatível com o High-Performance Order Storage (HPOS) do WooCommerce.
O plugin não consulta preços na DPD, não cria envios da DPD, não imprime etiquetas, não gera manifestos, não agenda coletas de courier, não rastreia encomendas e não mostra mapa. Somente o serviço web da DPD Baltic e a busca de parcelshops da DPD Eslováquia são suportados.
Pontos de retirada
Quando o cliente seleciona a DPD Pickup, uma lista de cidades e uma lista de pontos de retirada aparecem abaixo do método. A cidade do endereço do cliente já vem selecionada. Com a DPD Eslováquia, o cliente primeiro informa a cidade e o CEP e depois vê os pontos próximos. Um ponto de retirada é obrigatório. O servidor confere se o ponto pertence ao país e ao endereço do cliente, então uma escolha forjada ou desatualizada é recusada.
O ponto escolhido é salvo no pedido. Ele aparece na tela do pedido abaixo do endereço de entrega, na página de agradecimento, em My account > Orders e nos e-mails do pedido (HTML e texto simples) como DPD pickup point. O nome salvo no pedido vem da DPD, não do navegador.
Na tela do pedido, clique em Edit ao lado do ponto de retirada, escolha uma cidade e outro ponto. O ponto é conferido com a lista da DPD para o endereço do pedido. O pedido precisa ter cidade e CEP de entrega para que o ponto possa ser alterado.
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 DPD Pickup. 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 em vibefox.net.
Uma chave funciona em um único domínio. Remover a chave de um site não libera a vaga do domínio. Libere a vaga na sua conta em vibefox.net.
Sem uma chave ativa, a DPD Pickup não é exibida aos 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 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 novamente de forma automática em segundo plano.
Solução de problemas
A DPD Pickup 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). Confira os avisos no topo da página de configurações e clique em Refresh pickup points. Confira os limites de peso e de subtotal, as classes de envio excluídas e se o país tem um valor (ou um custo alternativo).
"Login failed" após Refresh pickup points: a DPD recusou as credenciais Baltic, então nenhum ponto de retirada pode ser carregado. Confira o nome de usuário e a senha da API com a DPD.
A DPD Eslováquia não mostra pontos: os pontos aparecem depois que o cliente informa a cidade e o CEP. A DPD lista somente os pontos a até 50 km desse endereço.
Descobrir o motivo: ative o Debug log. Cada decisão é gravada em WooCommerce > Status > Logs, origem vfd-dpd-pickup. Erros da API são sempre registrados. Nomes de usuário e senhas da API nunca são gravados no log.
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 em 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 dos pontos de retirada. Para remover o plugin, desative-o e exclua-o na página Plugins. A chave de licença e o status da licença deste plugin são sempre removidos, assim como o cache dos pontos de retirada. As configurações e os métodos de zona são removidos somente se Remove data on uninstall estiver ativado. Caso contrário, ficam guardados para uma reinstalação posterior. O ponto de retirada salvo nos pedidos nunca é excluído, e os pedidos existentes mantêm as suas linhas de envio.
DPD é uma marca comercial de seu respectivo proprietário. Este plugin não é afiliado à DPD nem endossado pela DPD.