VibeFox SmartPost 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, com a extensão SimpleXML (incluída na maioria das instalações do PHP).
SmartPost: não é necessária conta de API nem chave. A lista de pontos de retirada vem da lista aberta de locais do SmartPost. O SmartPost não tem uma API pública de preços, então você informa suas próprias tarifas (contratuais). Crie os envios na sua conta comercial do SmartPost (SmartPosti).
Países: os pontos de retirada do SmartPost existem na Estônia, Letônia, Lituânia e Finlândia. Para outros países de destino, o método não é exibido.
Chave de licença VibeFox: comprada em vibefox.net. Uma chave funciona em um único domínio.
Instalação
1. No WordPress, acesse Plugins > Add New > Upload Plugin, escolha o arquivo ZIP do plugin e clique em Install Now. Você também pode enviar a pasta vfd_smartpost para /wp-content/plugins/ por FTP.
2. Clique em Activate.
3. Abra as configurações: WooCommerce > Settings > Shipping > VibeFox SmartPost, 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. Confira a tabela de preços (os preços padrão já estão preenchidos), os tamanhos das caixas e o status dos pontos de retirada no topo da página.
6. Adicione VibeFox SmartPost à zona ou zonas com Estônia, Letônia, Lituânia e/ou Finlândia em WooCommerce > Settings > Shipping > Shipping zones, ou ative Ignore shipping zones e escolha os países.
Configuração
Todas as configurações estão em uma única página: WooCommerce > Settings > Shipping > VibeFox SmartPost. Elas valem para todas as zonas de envio. Quando você adiciona o método a uma zona, a janela da zona tem apenas um campo:
Title (zone): o nome que os clientes veem para esta zona. Deixe em branco para usar o Method title geral.
No topo da página, avisos mostram problemas e o status dos pontos de retirada. Um aviso vermelho aparece quando nenhum preço está definido, pois nesse caso o método não é exibido no checkout. O bloco Pickup points available at checkout mostra, para cada país, quantos pontos de retirada existem e em quantas cidades. Ele também informa quando uma cópia salva da lista é usada porque a lista do SmartPost está indisponível no momento, quando um país não pôde ser carregado e quando um país não tem preços. O botão Refresh pickup point lists now baixa as listas novamente e mostra os novos números.
Geral
Enable/Disable: ativa ou desativa o SmartPost em todas as zonas de uma vez.
Method title: o nome do método de envio exibido aos clientes. O Title de um método de zona o substitui. Padrão: SmartPost parcel locker.
Tax status: Taxable adiciona o imposto do WooCommerce ao custo de envio; None não adiciona.
Preços (na moeda da sua loja; os decimais podem ser escritos como 3.50 ou 3,50)
Price table: uma linha para cada país (Estônia, Letônia, Lituânia, Finlândia) com um preço para cada tamanho de caixa S, M, L e XL, e uma coluna Free from. 0 significa grátis. Uma célula vazia significa que aquele tamanho de caixa não é oferecido: o método é ocultado quando o pacote precisa daquela caixa. Um país com todas as células vazias não é atendido. Free from é o total do carrinho a partir do qual o SmartPost é grátis naquele país; deixe em branco se não houver frete grátis. Preços que não são números são informados após salvar e deixados em branco. Preços padrão: Estônia 3.50, Letônia 4.00, Lituânia 4.00, Finlândia 5.00 para todas as caixas.
Box sizes (cm): o tamanho interno de cada caixa, com o lado menor primeiro (Side 1 (smallest), Side 2, Side 3 (largest)). Os lados do produto são ordenados da mesma forma e comparados lado a lado, e usa-se a menor caixa que couber. Produtos sem dimensões cabem na caixa S. Um pacote que não cabe em nenhuma caixa oculta o método. As dimensões do produto são convertidas a partir da unidade de dimensão da loja. Padrões: S 12 x 36 x 60, M 20 x 36 x 60, L 36 x 38 x 60, XL 36 x 60 x 60. Tamanhos que não são números positivos são informados após salvar e não são alterados.
Calculation: como o preço é calculado.
Disponibilidade
Minimum weight (kg): oculta o método quando o carrinho é mais leve. Vazio ou 0 significa sem limite.
Maximum weight (kg): oculta o método quando o carrinho é mais pesado. Padrão: 25. 0 significa sem limite.
Minimum cart total: mostra o método somente a partir deste total do carrinho. Deixe vazio para mostrá-lo sempre.
Excluded shipping classes: oculta o método quando o carrinho contém produtos destas classes de envio do WooCommerce.
Ignore shipping zones: oferece o SmartPost para os países abaixo sem adicioná-lo a uma zona. Quando está desativado, os países são definidos pelas zonas de envio em que o método foi adicionado. Recomendado.
Countries (without zones): os países de destino desse modo, entre Estônia, Letônia, Lituânia e Finlândia. Este campo é usado somente quando Ignore shipping zones está ativado. Deixe vazio para oferecer o método nos quatro países.
Pontos de retirada
Pickup point types: quais pontos do SmartPost o cliente pode escolher: Parcel lockers (APT), Parcel boxes (IPB), Parcel shops (PUDO) e Posti post offices (Finland). Deixe vazio para oferecer armários, caixas e pontos de entrega de pacotes (padrão). Quais tipos existem depende do país: por exemplo, a Letônia tem apenas caixas de pacotes, e as agências dos Correios existem somente na Finlândia.
City order: quando ativado, as grandes cidades aparecem primeiro (Tallinn, Riga, Vilnius, Helsinki e outras cidades grandes), e depois o restante em ordem alfabética. Quando desativado, todas as cidades ficam em ordem alfabética.
Avançado
Debug log: registra os detalhes do cálculo de preços e da lista de pontos de retirada em WooCommerce > Status > Logs (origem vfd-smartpost). Erros, como uma lista de pontos de retirada indisponível, são sempre registrados. Nenhum dado de cliente é registrado.
Remove data on uninstall: quando ativado, excluir o plugin remove as configurações, os métodos de zona e os pontos de retirada em cache. Desativar o plugin nunca apaga as configurações. O ponto de retirada salvo nos pedidos é mantido.
Como funciona no checkout
Quando o cliente informa um endereço de entrega, o WooCommerce pede uma tarifa ao plugin. O plugin funciona somente para Estônia, Letônia, Lituânia e Finlândia. Ele verifica o peso do carrinho, o valor mínimo do carrinho e as classes de envio excluídas, encontra a caixa do pacote e pega o preço na linha do país de envio. Se a caixa não tiver preço, ou se o pacote não couber em nenhuma caixa, o método é ocultado. Se o país não tiver pontos de retirada (a lista não pôde ser carregada e não há cópia salva), o método também é ocultado, para que o cliente nunca veja um checkout que não possa ser concluído. Se o total do carrinho atingir o Free from do país, o preço é 0.
A lista de pontos de retirada de cada país fica em cache por 24 horas, e uma cópia da última lista válida é mantida. 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 15 segundos. Grafias diferentes da mesma cidade (por exemplo Riga e Rīga) são exibidas como uma única cidade.
O método funciona no checkout clássico e nos blocos Carrinho e Finalizar compra. É compatível com o armazenamento de pedidos de alta performance (HPOS) do WooCommerce. Os preços estão na moeda da sua loja. O plugin não converte moedas.
O plugin não consulta os preços do SmartPost, não cria envios, não imprime etiquetas, não chama um courier e não rastreia pacotes. Crie os envios na sua conta comercial do SmartPost (SmartPosti). A entrega porta a porta por courier não faz parte deste método, e não há visualização em mapa.
Pontos de retirada
Quando o cliente seleciona o SmartPost, duas listas aparecem abaixo do método: -- Select city -- e -- Select pickup point --. As listas sempre pertencem ao país de envio. No checkout clássico, é o país do endereço de entrega, ou o do endereço de cobrança quando o pedido não é enviado para outro endereço; as listas são refeitas quando o país muda. No checkout em blocos, as listas seguem o país do endereço de entrega. A cidade do endereço de entrega é pré-selecionada quando corresponde a uma cidade da lista. Cada ponto é exibido com nome e endereço. A escolha fica lembrada durante o checkout, então não se perde quando o checkout é atualizado.
Um ponto de retirada é obrigatório. No checkout clássico, o cliente vê Please select a SmartPost pickup point in the shipping country. No checkout em blocos, Place order fica bloqueado até que um ponto seja escolhido. Nos dois checkouts, o servidor verifica o ponto novamente com a lista do país de envio, então um ID de ponto falsificado ou desatualizado, ou um ponto de outro país, é recusado. Se a lista do país estiver temporariamente indisponível, o cliente vê uma mensagem e pode escolher outro método de envio.
O ID, o nome, a cidade e o país do ponto são salvos no pedido. Eles são exibidos na tela do pedido abaixo do endereço de entrega (com o ID do local), na página de pedido recebido, em My account > Orders e nos e-mails do pedido (HTML e texto simples) como SmartPost pickup point.
Para alterar o ponto de um pedido, abra o pedido e clique em Change ao lado de SmartPost pickup point. Escolha uma cidade e um ponto do país de envio do pedido. O novo ponto é salvo na hora, e uma nota do pedido registra o ponto antigo e o novo.
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 SmartPost. 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 único domínio. Remover a chave de um site não libera a vaga de domínio. Libere-a na sua conta na vibefox.net.
Sem uma chave ativa, o SmartPost não é exibido aos clientes no checkout. Os gerentes da loja conectados ainda o veem, marcado 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 automaticamente em segundo plano.
Solução de problemas
O SmartPost não aparece no checkout: verifique se a licença está ativa, se Enable/Disable está ligado, se o país de envio é Estônia, Letônia, Lituânia ou Finlândia, e se o método foi adicionado à zona do país do cliente (ou se Ignore shipping zones está ativado e o país é permitido). Abra a página de configurações: um aviso explica se nenhum preço está definido, se um país não tem preços ou se um país não tem pontos de retirada. Verifique também os limites de peso, Minimum cart total, Excluded shipping classes e os tamanhos das caixas: um pacote que não cabe em nenhuma caixa, ou uma caixa com célula de preço vazia, oculta o método. Com Debug log ativado, WooCommerce > Status > Logs (origem vfd-smartpost) mostra por que o método foi ocultado.
O cliente vê pontos de outro país: as listas seguem o endereço de entrega. Verifique qual país está informado no endereço de entrega (ou no endereço de cobrança, quando o pedido não é enviado para outro endereço). Um ponto de outro país é recusado ao fazer o pedido.
Nenhum ponto de retirada para um país: a lista do SmartPost não pôde ser carregada e não há cópia salva. O plugin tenta novamente a cada 15 minutos. Depois, clique em Refresh pickup point lists now. Verifique também se Pickup point types inclui um tipo que existe naquele país.
A lista de pontos de retirada está desatualizada: clique em Refresh pickup point lists now na página de configurações. As listas também são baixadas novamente a cada 24 horas.
O cliente não consegue fazer o pedido: é preciso escolher um ponto de retirada do país de envio. Se o cliente vir "The SmartPost pickup point list is temporarily unavailable", nenhum ponto daquele país está disponível no momento.
Em qual moeda estão os preços: na moeda da sua loja. O plugin não converte moedas.
Para desenvolvedores: o filtro vfd_smpt_places_url altera a URL da lista de locais de um país (argumentos: URL, código do país), por exemplo para um espelho que retorne o mesmo XML.
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. Somente as listas de pontos de retirada em cache são apagadas. Para remover, desative-o e exclua-o na página Plugins. A chave de licença e o status da licença deste plugin, assim como os caches, são sempre removidos. Configurações, métodos de zona e cópias salvas das listas de pontos de retirada são removidos somente se Remove data on uninstall estava ativado. Caso contrário, permanecem para uma reinstalação posterior. O ponto de retirada salvo nos pedidos nunca é excluído, e os pedidos existentes mantêm suas linhas de envio.
SmartPost e SmartPosti são marcas de seus respectivos proprietários. Este plugin não é afiliado nem endossado pelo SmartPost.