VibeFox Bob Go for PrestaShop — Ajuda
Requisitos
PrestaShop: 8.0 a 9.x.
PHP: 8.0 ou superior. O módulo não é instalado em versões anteriores do PHP.
Conta Bob Go (apenas para tarifas em tempo real): a Bob Go não usa chaves de API. Você precisa de uma conta Bob Go (bobgo.co.za), da sua loja instalada como canal de vendas WooCommerce na sua conta Bob Go (Sales channels) e de "Rates at checkout" ativado para esse canal. Serviços, preços e regras são configurados na Bob Go. Se você usa apenas preços fixos, não precisa de uma conta Bob Go.
Chave de licença VibeFox: comprada em vibefox.net. Uma chave funciona em um domínio.
Instalação
1. No back office, vá em Modules > Module Manager e clique em Upload a module. Escolha o arquivo ZIP do módulo.
2. Quando o envio terminar, clique em Configure ou, depois, localize VibeFox Bob Go na lista de módulos e clique em Configure.
3. Insira sua chave de licença VibeFox em License key, no bloco de licença no topo da página Configure, e clique em Activate (veja Chave de licença).
4. Na sua conta Bob Go, instale sua loja como canal de vendas. Ative "Rates at checkout" para esse canal e configure seus serviços e preços.
5. Na página Configure, confira o domínio da loja, o endereço de origem (de onde você envia) e, se a moeda da loja não for ZAR, a taxa de conversão para ZAR (veja Configuração). Se os endereços sul-africanos da sua loja não tiverem província, clique em Add South African provinces. Clique em Save.
Na instalação, o módulo cria a transportadora Bob Go com o texto de prazo de entrega Courier delivery (South Africa). A transportadora fica ativa, vinculada a todas as zonas e a todos os grupos de clientes, e usa por padrão as tarifas Bob Go em tempo real. Você pode alterar zonas, grupos de clientes, prazo de entrega, logotipo e limites de tamanho em Shipping > Carriers. Não defina preços ali: o preço sempre vem do módulo.
Configuração
Todas as configurações estão na página do módulo: Modules > Module Manager > VibeFox Bob Go > Configure. Elas valem para todas as zonas da transportadora. Cada seção tem seu próprio botão Save, que salva a página inteira. Cada salvamento também limpa as tarifas Bob Go em cache. Os números aceitam ponto ou vírgula como separador decimal. Se um valor estiver errado, a página mostra um erro e nada é salvo: um valor que não é número ("…" must be a number.), um valor ou peso negativo ("…" must be a number of 0 or more.), uma ZAR conversion rate igual ou menor que 0, um Minimum weight maior que o Maximum weight, ou um Method title com mais de 64 caracteres.
Acima do formulário, a página avisa quando as tarifas em tempo real não podem funcionar: Live rates are not requested: your store currency is … — set the "ZAR conversion rate"., quando os endereços sul-africanos não têm província (veja Províncias da África do Sul mais abaixo), ou quando a unidade de peso ou de dimensão da loja não é reconhecida e é tratada como kg ou cm. Defina as unidades em International > Localization (Local units).
Geral
Enable Bob Go: liga ou desliga a transportadora. É o mesmo interruptor do status da transportadora em Shipping > Carriers.
Method title: o nome da transportadora mostrado ao cliente. Os serviços da Bob Go, por exemplo "The Courier Guy - Economy", aparecem abaixo dele no checkout com os nomes da Bob Go. Padrão: Bob Go. Obrigatório, no máximo 64 caracteres.
Shipping cost: como o preço é calculado.
O motivo da falta de tarifas em tempo real é gravado no log. Ele nunca é mostrado ao cliente.
Conta Bob Go
Esta seção explica o que você precisa ter na Bob Go e 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 request failed com o código de erro, ou no connection.
Store domain: a Bob Go identifica sua loja pelo domínio. Deixe em branco para usar o domínio da sua loja, mostrado como texto de exemplo. Informe outro domínio apenas se o seu canal na Bob Go estiver instalado com outro endereço, por exemplo example.co.za/shop para uma loja em uma subpasta. O esquema e a barra final são removidos.
ZAR conversion rate: a Bob Go cota em rand sul-africano (ZAR). Se a moeda padrão da sua loja não for ZAR, informe quanto vale 1 ZAR na sua moeda, por exemplo 0.05. As tarifas são convertidas com esse valor 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). A taxa deve ser maior que 0. Se a moeda da loja for ZAR, deixe em branco.
Delivery dates: mostra a faixa estimada de datas de entrega da Bob Go ao lado de cada serviço no checkout. A estimativa é sempre salva com o pedido e aparece na página do pedido.
Envio a partir de (endereço de origem)
O endereço de origem é enviado à Bob Go em cada requisição de tarifas. Se o endereço da loja em Shop Parameters > Contact > Stores 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 apenas 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 bairro de onde você envia, por exemplo Joanesburgo.
Origin postal code: o CEP de onde você envia, por exemplo 2001.
Origin street address: o endereço da rua de onde você envia.
Províncias da África do Sul: o PrestaShop não tem províncias para a África do Sul, então os endereços de clientes ali não têm província, enquanto a Bob Go exige uma. Clique em Add South African provinces para adicionar as 9 províncias (códigos EC, FS, GP, KZN, LP, MP, NC, NW, WC) como estados da África do Sul e mostrar o campo de estado nos endereços sul-africanos. As províncias que já existem, por código ou nome, não são adicionadas de novo. Nada muda até você clicar no botão. Quando as províncias estiverem configuradas, o campo mostra South African addresses have a province com a quantidade.
Preços fixos (usados quando Shipping cost está em Fixed prices (below), 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 padrão da loja, sem impostos, por exemplo ZA=99.99. Use * para todos os outros países, por exemplo *=199.99 na linha seguinte. Linhas em outro formato são removidas ao salvar, e a página as lista em um aviso.
Flat price: o preço para países sem linha acima. Deixe em branco para ocultar a transportadora nesses países.
Fixed price applies: Per order cobra o preço uma vez. Per item (price × quantity) multiplica 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: oculta a transportadora abaixo deste peso do carrinho, em kg. 0 significa sem limite (padrão).
Maximum weight: oculta a transportadora acima deste peso do carrinho, em kg. 0 significa sem limite (padrão). Quando os dois limites são definidos, o mínimo não pode ser maior que o máximo.
Minimum order amount: mostra a transportadora apenas quando o subtotal do carrinho (produtos que precisam de envio, após descontos, antes de impostos) é pelo menos este valor. Deixe em branco para mostrar sempre.
Free shipping: ativa o frete grátis quando o valor de pedido abaixo é atingido.
Free shipping from: o subtotal do carrinho (após descontos, antes de impostos) a partir do qual o frete é grátis. Usado apenas quando Free shipping está ativado. Nesse caso a Bob Go não é consultada.
Tax: a regra de imposto da transportadora, ou No tax (padrão). As tarifas da Bob Go geralmente já incluem o IVA. Nesse caso, mantenha No tax para não cobrar o imposto duas vezes.
Disponibilidade sem zonas de entrega
Ignore shipping zones: quando ativado, a transportadora é vinculada a todas as zonas, inclusive às criadas depois, e oferecida para os países abaixo. Quando desativado, é oferecida apenas nas zonas da transportadora em Shipping > Carriers; as zonas que ela tinha antes são devolvidas.
Countries: os países de destino para esse modo. Deixe em branco para permitir todos os países para os quais você envia. Usado apenas quando Ignore shipping zones está ativado.
Avançado
Debug log: registra os cálculos de tarifas e as requisições à Bob Go em logs/vfd_bobg_debug.log.php, na pasta do módulo. O arquivo não pode ser aberto pela web. Endereços de clientes não são registrados. Erros da Bob Go são registrados mesmo quando está desativado. Desative quando terminar.
Log: mostra o tamanho e as entradas mais recentes do log. Clique em Clear log para esvaziá-lo.
Remove data on uninstall: quando ativado, desinstalar o módulo apaga as configurações da Bob Go, a transportadora, as tarifas em cache e os logs. O serviço da Bob Go salvo com os pedidos é mantido. Quando desativado, tudo é mantido para uma reinstalação.
Como funciona no checkout
Na etapa de frete, o PrestaShop pede ao módulo o preço da Bob Go. Só contam produtos físicos: produtos virtuais não somam peso e não entram no valor do pedido. O módulo verifica primeiro o país de destino (com Ignore shipping zones), o peso do carrinho e o Minimum order amount. Se o frete grátis se aplicar, a transportadora aparece como grátis e nenhuma requisição é enviada à Bob Go.
Nos modos em tempo real, o módulo envia à Bob Go o domínio da sua loja, os endereços de origem e de entrega (com a província) 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. As tarifas em ZAR são convertidas com a ZAR conversion rate quando a moeda da loja não é ZAR. O preço é calculado na moeda padrão da loja e depois mostrado na moeda do carrinho do cliente.
Abaixo da transportadora Bob Go, o cliente vê Choose a delivery service: e uma opção por serviço da Bob Go, com o nome, o preço e, se Delivery dates estiver ativado, as datas estimadas de entrega. O primeiro serviço vem selecionado por padrão. Quando o cliente escolhe outro serviço, a escolha é salva na hora e o preço da transportadora e o total do carrinho são atualizados. A transportadora custa o mesmo que o serviço escolhido. Se um serviço não for mais oferecido para o endereço, o cliente vê This service is not available for your address any more. Please choose another one. Se o salvamento falhar, a mensagem é The service could not be saved. Please try again. A lista de serviços funciona com os temas Classic e Hummingbird.
As tarifas ficam em cache por 1 hora para cada requisição completa, 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 atrase cada atualização do checkout. Uma requisição com falha nunca interrompe o checkout: a transportadora fica oculta ou, no modo de alternativa, usa-se o preço fixo. O motivo é gravado no log.
Se você editar a transportadora em Shipping > Carriers depois que ela tiver pedidos, o PrestaShop a salva como uma nova versão da transportadora. O módulo segue a nova versão automaticamente.
O módulo mostra apenas 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. Use o painel da Bob Go para o atendimento dos pedidos. Não há escolha de ponto de retirada nem de armário. A Bob Go entrega apenas dentro da África do Sul.
Pedidos
Quando o pedido é feito, o serviço da Bob Go escolhido, seu código e a estimativa de entrega são salvos com o pedido. Alterações posteriores no carrinho ou nos preços da Bob Go não os modificam.
No back office, a página do pedido mostra um bloco Bob Go com Bob Go service (nome e código) e Estimated delivery. O cliente vê Bob Go service e Estimated delivery na página de detalhes do pedido na conta dele. Pedidos com preço fixo ou frete grátis não têm serviço da Bob Go.
Chave de licença
O módulo funciona com uma chave de licença VibeFox obtida em vibefox.net. O bloco de licença License — VibeFox Bob Go é o primeiro bloco em Modules > Module Manager > VibeFox Bob Go > Configure, acima das configurações. Insira a chave em License key e clique em Activate. Depois disso, o bloco mostra a chave mascarada, o status (por exemplo, a data até a qual a licença está ativa e o seu domínio) e os botões Check now para verificar o status novamente, Change key para inserir outra chave e Remove key para remover a chave desta loja. Abaixo deles ficam a linha Product: presta-shipping-bob-go e o link Manage licenses and domains in your account, que abre a sua conta vibefox.net. Somente funcionários com a permissão Configure para o módulo podem alterar a chave. Os textos do bloco seguem o idioma do back office (inglês e russo estão incluídos).
Se a chave não for aceita, o bloco informa o motivo, por exemplo Key not found, This key belongs to another product, Domain limit reached ou License expired on com uma data. Depois que o endereço da loja mudar, ou depois de liberar uma vaga de domínio na sua conta, clique em Check now. Se o servidor de licenças não puder ser acessado, o módulo continua funcionando com o último status conhecido.
Uma chave funciona em um domínio: o domínio da loja principal, também em uma configuração multiloja. Remover a chave da loja não libera a vaga de domínio. Libere a vaga na sua conta vibefox.net.
Sem uma chave ativa, a transportadora Bob Go não é exibida aos clientes na finalização de compra e nenhuma tarifa é calculada. A vitrine do PrestaShop não sabe que você está conectado ao back office, então a transportadora também fica oculta para você: é possível configurar o módulo antes de comprar uma chave, mas não testá-lo na finalização de compra. Um lembrete aparece em Modules > Module Manager, na aba Alerts. Os pedidos existentes não são afetados.
Quando uma licença expira, o módulo continua funcionando, mas atualizações e suporte exigem renovação. O status é verificado novamente de forma automática enquanto você trabalha no back office: uma vez por dia nos primeiros 14 dias após a chave ser inserida, depois uma vez por semana. Não é necessário cron job. Desinstalar ou redefinir o módulo sempre remove a chave de licença e o status da licença.
Solução de problemas
A Bob Go não aparece no checkout: verifique se a licença está ativa e se Enable Bob Go está ligado. Em Shipping > Carriers, verifique se a transportadora cobre a zona do país do cliente e o grupo do cliente, ou ligue Ignore shipping zones e confira Countries. Verifique os limites de peso e o Minimum order amount. No modo de preços fixos, confirme que o país, * ou o Flat price têm um preço. Produtos também podem ser limitados a certas transportadoras na página do produto.
Nenhuma tarifa da Bob Go é mostrada: abra a página do módulo. A seção Conta Bob Go mostra a última resposta da Bob Go. "The WooCommerce channel is not installed on Bob Go" (HTTP 404) significa que o domínio da loja não é um canal de vendas na Bob Go: confira o Store domain. "Rates at checkout is not enabled" (HTTP 401) significa que o recurso está desativado para o canal. Confirme também que o cliente informou uma cidade ou CEP e, em lojas que não usam ZAR, que a ZAR conversion rate está definida. Ligue o Debug log, recarregue o checkout e veja o campo Log. Com Bob Go live rates, fixed prices if Bob Go returns no rates, os clientes continuam recebendo o preço fixo enquanto você corrige o problema.
Minha loja não está em rand: a Bob Go cota em ZAR. Informe quanto vale 1 ZAR na moeda da sua loja. Sem isso, o módulo não pede tarifas à Bob Go. Os preços fixos continuam funcionando.
A página avisa que os endereços sul-africanos não têm província: clique em Add South African provinces na seção Envio a partir de (endereço de origem). Endereços de clientes já existentes só recebem uma província quando forem editados.
O imposto é cobrado duas vezes no frete: as tarifas da Bob Go normalmente incluem o IVA. Defina Tax como No tax.
As tarifas parecem desatualizadas após uma mudança: clique em Save na página do módulo. Isso limpa o cache de tarifas da Bob Go. Alterações na sua conta Bob Go passam a valer quando o cache de 1 hora expira ou quando você salva as configurações.
A página diz que a transportadora Bob Go não foi encontrada: a transportadora foi excluída em Shipping > Carriers. Redefina o módulo em Modules > Module Manager para criá-la novamente.
Desinstalação
Vá em Modules > Module Manager, abra o menu ao lado de VibeFox Bob Go e escolha Uninstall. A chave de licença, o status da licença e as tarifas em cache são sempre removidos. Se Remove data on uninstall estiver ligado, a transportadora é excluída (os pedidos mantêm o histórico) e as configurações, o log e as escolhas de serviço dos carrinhos abertos são removidos. Se estiver desligado, a transportadora apenas é desativada e todas as configurações são mantidas. Reinstalar o módulo, ou Reset, devolve à transportadora salva o status que ela tinha antes: uma transportadora ativa volta a ficar ativa, uma desativada continua desativada. O serviço da Bob Go salvo com os pedidos é sempre mantido.
A Bob Go é uma marca registrada de seu respectivo titular. Este módulo não é afiliado nem endossado pela Bob Go.