VibeFox Bob Go for WooCommerce — Ajuda
Requisitos
WordPress: 5.8 ou superior.
WooCommerce: 5.0 ou superior, instalado e ativo. O plugin não é ativado sem ele.
PHP: 8.0 ou superior.
Conta Bob Go (somente para tarifas em tempo real): a Bob Go não tem chaves de API. Você precisa de uma conta Bob Go (bobgo.co.za), da sua loja WooCommerce instalada como canal de vendas na sua conta Bob Go (Sales channels) e de "Rates at checkout" ativado para esse canal, com os seus serviços e preços configurados lá. Se você usar apenas preços fixos, não precisa de conta Bob Go.
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_bob_go para /wp-content/plugins/ por FTP.
2. Clique em Activate.
3. Na sua conta Bob Go, instale a sua loja WooCommerce como canal de vendas. Ative "Rates at checkout" para esse canal e configure os seus serviços e preços.
4. Abra as configurações: WooCommerce > Settings > Shipping > VibeFox Bob Go, ou clique em Settings abaixo do nome do plugin na página Plugins.
5. Informe a sua chave de licença VibeFox no bloco de licença no topo da página e clique em Activate.
6. Confira o domínio da loja, o endereço de origem (ship from) e, se a moeda da sua loja não for ZAR, a taxa de conversão para ZAR (veja Configuração).
7. Adicione VibeFox Bob Go a uma zona de entrega para a África do Sul em WooCommerce > Settings > Shipping > Shipping zones, ou ative Ignore shipping zones.
Configuração
Todas as configurações ficam em uma única página: WooCommerce > Settings > Shipping > VibeFox Bob Go. Elas se aplicam a todas as zonas de entrega. Sempre que você salvar as configurações, as tarifas Bob Go em cache são apagadas. Ao adicionar o método a uma zona, a janela da zona tem apenas um campo:
Title (zone): o nome exibido para os preços fixos e o frete grátis nesta zona. Deixe em branco para usar o Method title global. As tarifas Bob Go em tempo real são sempre exibidas com os nomes de serviço configurados na Bob Go.
Geral
Enable/Disable: ativa ou desativa o método em todas as zonas ao mesmo tempo.
Method title: exibido ao cliente para os preços fixos e o frete grátis. Uma zona pode substituí-lo. As tarifas Bob Go em tempo real são exibidas com os nomes de serviço da Bob Go, por exemplo "The Courier Guy - Economy". Padrão: Bob Go.
Shipping cost: como o preço é calculado.
O motivo da ausência de tarifas em tempo real é registrado no log. Ele nunca é exibido ao cliente.
Conta Bob Go
Esta seção mostra a última resposta da Bob Go para o domínio da sua loja: connected, the WooCommerce channel is not installed on Bob Go (HTTP 404), "Rates at checkout" is not enabled for this channel (HTTP 401) ou outro erro. Se a moeda da sua loja não for ZAR e nenhuma taxa de conversão estiver definida, ela também avisa que as tarifas em tempo real não estão sendo solicitadas.
Store domain: a Bob Go identifica a sua loja pelo domínio. Deixe em branco para usar o domínio do seu site. Informe outro domínio somente se o seu canal na Bob Go estiver instalado em um endereço diferente, por exemplo example.co.za/shop para uma loja em uma subpasta.
ZAR conversion rate: a Bob Go cota em rands sul-africanos (ZAR). Se a moeda da sua loja não for ZAR, informe quanto vale 1 ZAR na moeda da sua loja, por exemplo 0.05 para EUR. Com ela, as tarifas são convertidas e os preços dos produtos são enviados à Bob Go em ZAR. Deixe em branco para não usar tarifas Bob Go em tempo real na sua moeda (os preços fixos continuam funcionando). Se a moeda da sua loja for ZAR, deixe em branco. Tanto o ponto quanto a vírgula são aceitos como separador decimal.
Delivery dates: mostra no nome da tarifa a faixa de datas de entrega estimada pela Bob Go. A estimativa é sempre salva com o pedido e fica visível na tela do pedido.
Envio de (endereço de origem)
O endereço de origem é enviado à Bob Go em cada requisição de tarifas. Se o endereço da sua loja em WooCommerce > Settings > General estiver no mesmo país, os campos vazios são preenchidos a partir dele.
Origin country: o país de onde você envia. Padrão: África do Sul. A Bob Go entrega somente dentro da África do Sul.
Origin province: uma província sul-africana, ou Store province (if in South Africa).
Origin city / suburb: a cidade ou o bairro de onde você envia, por exemplo Johannesburgo.
Origin postal code: o código postal de onde você envia, por exemplo 2001.
Origin street address: o endereço da rua de onde você envia.
Preços fixos (usados no modo fixo e como alternativa quando a Bob Go não devolve tarifas)
Price per country: uma linha por país: um código de país de 2 letras, um sinal de igual e o preço na moeda da sua loja, por exemplo ZA=99.99. Use * para todos os outros países, por exemplo *=199.99. Linhas em outro formato são removidas ao salvar.
Flat price: o preço na moeda da sua loja para os países sem uma linha acima. Deixe em branco para ocultar o método nesses países.
Fixed price applies: Per order cobra o preço uma vez. Per item (price × quantity) multiplica o preço pelo número de itens no carrinho. As tarifas Bob Go em tempo real são sempre para o envio inteiro.
Condições
Minimum weight (kg): oculta o método abaixo deste peso do carrinho. 0 significa sem limite.
Maximum weight (kg): oculta o método acima deste peso do carrinho. 0 significa sem limite (padrão).
Minimum order amount: exibe o método somente quando o subtotal do carrinho (após descontos, antes dos impostos) for pelo menos este valor. Deixe em branco para exibi-lo sempre.
Excluded shipping classes: oculta o método se o carrinho tiver um produto de qualquer uma destas classes de entrega do WooCommerce.
Free shipping: ativa o frete grátis quando o valor do pedido indicado abaixo for atingido.
Free shipping from: o subtotal do carrinho (após descontos, antes dos impostos) a partir do qual o frete é grátis. Usado somente quando Free shipping está ativado. Nesse caso, a Bob Go não é consultada.
Tax status: Taxable adiciona o imposto do WooCommerce ao valor do frete; None não adiciona. As tarifas da Bob Go geralmente já incluem o IVA. Nesse caso, escolha None para que o imposto não seja cobrado duas vezes.
Disponibilidade sem zonas de entrega
Ignore shipping zones: oferece a Bob Go para os países indicados abaixo, mesmo que ela não tenha sido adicionada a uma zona de entrega.
Countries: os países de destino para esse modo. Deixe em branco para usar todos os países para os quais você envia. Usado somente quando Ignore shipping zones está ativado.
Avançado
Debug log: registra os cálculos de tarifas e as requisições à Bob Go em WooCommerce > Status > Logs, origem "vfd_bob_go". Os endereços dos clientes não são registrados. Os erros da API são registrados mesmo quando esta opção está desativada.
Remove data on uninstall: quando ativado, excluir o plugin remove todas as configurações da Bob Go, os métodos de zona e as tarifas em cache. Desativar o plugin nunca apaga nada.
Como funciona no checkout
Quando o cliente informa um endereço de entrega, o plugin verifica o peso do carrinho, o Minimum order amount e as Excluded shipping classes. Se o frete grátis se aplicar, o cliente vê o método como Bob Go (free) e nenhuma requisição é enviada à Bob Go.
Nos modos em tempo real, o plugin envia à Bob Go o domínio da sua loja, os endereços de origem e de entrega e os itens do carrinho, com os preços dos produtos em ZAR. As tarifas em tempo real só são solicitadas depois que o cliente informa uma cidade ou um CEP. Cada serviço devolvido pela Bob Go é exibido como uma opção de frete separada, com o nome da Bob Go e, se Delivery dates estiver ativado, com as datas de entrega estimadas. As tarifas em ZAR são convertidas com o ZAR conversion rate quando a moeda da sua loja não é ZAR.
As tarifas ficam em cache por 1 hora por carrinho e endereço, então o mesmo carrinho não gera uma nova requisição. Uma requisição com falha fica em cache por 5 minutos, e o tempo limite é de 12 segundos, para que uma queda da Bob Go não deixe lenta cada atualização do checkout. Uma requisição com falha nunca interrompe o checkout: o método fica oculto ou, no modo com alternativa, o preço fixo é usado. O motivo é registrado no log do WooCommerce.
O código do serviço Bob Go escolhido e a estimativa de entrega são salvos com a linha de frete do pedido e exibidos na tela do pedido como Bob Go service e Estimated delivery.
O método funciona no checkout clássico e nos blocos Carrinho e Finalizar compra. É compatível com o WooCommerce High-Performance Order Storage (HPOS).
O plugin exibe somente tarifas. Ele não cria envios, conhecimentos de transporte ou etiquetas, não rastreia encomendas, não sincroniza pedidos com a Bob Go e não envia notificações por e-mail. Para o atendimento dos pedidos, use o painel da Bob Go (ou a sincronização de pedidos própria da Bob Go). Não há escolha de ponto de retirada ou de armário automático (Bob Box, Pargo) nem campo extra de bairro no checkout. A Bob Go entrega somente dentro da África do Sul.
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 Bob Go. 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 único domínio. Remover a chave de um site não libera a vaga de domínio. Libere a vaga na sua conta vibefox.net.
Sem uma chave ativa, a Bob Go não é exibida aos clientes no checkout. 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 em segundo plano, automaticamente.
Solução de problemas
A Bob Go não aparece no checkout: verifique se a licença está ativa, se Enable/Disable está ativado 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). Confira os limites de peso, o Minimum order amount e as Excluded shipping classes. No modo fixo, confirme que o país, * ou o Flat price têm um preço.
Nenhuma tarifa Bob Go é exibida: abra as configurações do plugin. A seção Bob Go account mostra a última resposta da Bob Go. "Channel is not installed" (HTTP 404) significa que o domínio da loja não é um canal de vendas na Bob Go: verifique o Store domain. "Rates at checkout is not enabled" (HTTP 401) significa que a função está desativada para o canal. Confirme também se o cliente informou uma cidade ou um CEP e, em lojas que não usam ZAR, se o ZAR conversion rate está definido. Ative o Debug log e abra WooCommerce > Status > Logs (origem "vfd_bob_go") para ver os detalhes. Com a opção Bob Go live rates, fixed prices if Bob Go returns no rates, os clientes continuam recebendo o preço fixo enquanto você resolve o problema.
Minha loja não é em rand: a Bob Go cota em ZAR. Informe quanto vale 1 ZAR na moeda da sua loja (por exemplo 0.05 para EUR). Sem isso, o plugin não pede tarifas à Bob Go. Os preços fixos continuam funcionando.
O imposto é cobrado duas vezes no frete: as tarifas da Bob Go normalmente já incluem o IVA. Defina o Tax status como None.
As tarifas parecem desatualizadas depois de uma mudança: salve a página de configurações. Isso limpa as tarifas Bob Go em cache. Alterações na sua conta Bob Go são captadas após o cache de 1 hora ou quando você salva as configurações.
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 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 todos os dados. Para removê-lo, 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. As configurações, os métodos de zona e as tarifas em cache só são removidos se Remove data on uninstall estava ativado. Caso contrário, permanecem para uma reinstalação futura. Os pedidos existentes mantêm suas linhas de frete.
Bob Go é uma marca registrada de seu respectivo titular. Este plugin não é afiliado nem endossado pela Bob Go.