VibeFox Frenet 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 na Frenet (somente para cotações ao vivo): crie uma conta gratuita no painel da Frenet (painel.frenet.com.br), ative as transportadoras que você usa e copie o seu token de API. Se você usa apenas preços fixos, não precisa de conta na Frenet.

Produtos: preencha peso e dimensões para preços precisos. Produtos sem eles são cotados como 0,3 kg e 16 × 11 × 2 cm (a menor caixa dos Correios).

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_frenet para /wp-content/plugins/ por FTP.

2. Clique em Activate.

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

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

5. Cole o token de API e informe o CEP de origem. Se a moeda da sua loja não for BRL, informe a taxa de câmbio do BRL. Opcionalmente, adicione preços fixos e um custo de reserva.

6. Adicione o VibeFox Frenet a uma zona de envio para o Brasil 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 Frenet. 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 o cliente vê nesta zona. Deixe em branco para usar o Method title global.

No topo da página, o plugin exibe avisos: sem token de API (são usados apenas preços fixos, ou o método nunca aparece se também não houver preços fixos), sem CEP de origem de 8 dígitos, ou moeda da loja diferente de BRL sem taxa de câmbio. Sempre que você salva as configurações, as cotações em cache são apagadas. Os campos de preço aceitam tanto ponto quanto vírgula como separador decimal.

Geral

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

Method title: o nome do método de envio exibido no carrinho e na finalização de compra. Uma zona pode substituí-lo. Padrão: Frenet.

Cotações ao vivo da Frenet

A Frenet compara as transportadoras ativadas na sua conta e retorna os preços delas para o carrinho. As cotações ao vivo são solicitadas apenas para endereços no Brasil com CEP completo de 8 dígitos.

API token: seu token de API da Frenet, obtido no painel da Frenet. Deixe em branco para usar apenas preços fixos.

Origin CEP: o CEP de onde os pacotes são enviados, por exemplo 00000-000. Deixe em branco para usar o CEP da loja, se o endereço da loja estiver no Brasil. Um CEP sem 8 dígitos é informado ao salvar.

Service to offer: Cheapest service (padrão) ou Fastest service. A Frenet retorna vários serviços, e o método mostra um único preço.

BRL exchange rate: a Frenet cota em reais. Se a moeda da sua loja não for BRL, informe quanto vale 1 BRL na moeda da loja, por exemplo 0.16. A cotação e o valor declarado do pedido são convertidos com essa taxa. Sem ela, as cotações ao vivo não são usadas. Não é necessário se a moeda da loja for BRL.

Preços fixos

Usados quando não há token de API, para países que a Frenet não atende e sempre que a Frenet não retorna preço (API indisponível, CEP não atendido).

Price per country: uma tabela com as colunas Country, Price, XS, S, M, L e XL, com preços na moeda da loja. Clique em + Add country para adicionar uma linha e no X (×) para remover uma. As colunas de tamanho dependem do peso do carrinho: XS até 1 kg, S até 2 kg, M até 3 kg, L até 5 kg, XL acima de 5 kg. O Price é usado quando a coluna de tamanho está vazia. Um Price de 0 significa frete grátis para esse país. Use * Default para todos os outros países. Linhas sem nenhum preço são removidas ao salvar.

Fallback cost: usado quando nem a Frenet nem a tabela fornecem um preço. Deixe em branco para ocultar o método.

Fixed price applies: Per order cobra o preço uma vez. Per item (price × quantity) multiplica o preço pela quantidade de itens. Isso se aplica apenas aos preços fixos e ao custo de reserva. As cotações da Frenet já cobrem o carrinho 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. Padrão: 30. 0 significa sem limite.

Minimum order amount: mostra o método somente quando o subtotal do carrinho (após descontos, antes dos impostos) for pelo menos este valor. Deixe em branco para mostrar sempre.

Excluded shipping classes: oculta o método se o carrinho contiver um produto de qualquer uma destas classes de envio do WooCommerce.

Free shipping from: o subtotal do carrinho (após descontos, antes dos impostos) a partir do qual o frete é grátis. Deixe em branco para nunca oferecer frete grátis.

Tax status: Taxable adiciona o imposto do WooCommerce ao custo do frete; None não adiciona. Os preços da Frenet são preços finais da transportadora; escolha None se o WooCommerce não deve acrescentar imposto a eles.

Os pesos dos produtos são convertidos da unidade da loja para kg.

Disponibilidade sem zonas de envio

Ignore shipping zones: oferece a Frenet para os países abaixo, mesmo que ela não tenha sido adicionada a uma zona de envio.

Countries: os países de destino para esse modo. Deixe em branco para usar todos os países para os quais você envia. Usado apenas quando Ignore shipping zones está ativado.

Avançado

Debug log: registra cada requisição e resposta de cotação em WooCommerce > Status > Logs, origem vfd-frenet. Erros da API são sempre registrados. O token nunca é registrado e o CEP do cliente é abreviado. Desative quando terminar.

Remove data on uninstall: quando ativado, excluir o plugin remove todas as configurações da Frenet e os métodos das zonas. Desativar o plugin nunca apaga configurações. As cotações em cache são sempre removidas.

Como funciona na finalização de compra

Quando o cliente informa um endereço de entrega, o WooCommerce pede uma tarifa ao plugin. O plugin verifica primeiro o peso do carrinho, o valor mínimo do pedido e as classes de envio excluídas. Se o frete grátis se aplicar, o método é exibido com preço zero e nenhuma requisição é enviada à Frenet.

Para um endereço no Brasil com CEP completo de 8 dígitos, o plugin envia à Frenet os CEPs de origem e de destino, cada item do carrinho (peso em kg, dimensões em cm, quantidade, SKU e categorias), o valor do pedido em BRL e o primeiro cupom aplicado. Nenhuma requisição é feita enquanto o CEP estiver incompleto. A Frenet retorna os serviços das transportadoras ativadas. Serviços com erro ou sem preço são ignorados. O plugin escolhe o serviço mais barato ou o mais rápido e converte o preço para a moeda da loja. A transportadora, o serviço e o prazo de entrega são salvos com a linha de frete do pedido e exibidos na tela do pedido no admin.

Cada resposta fica em cache por 1 hora para o mesmo carrinho e endereço. Uma requisição com falha, ou um CEP que nenhuma transportadora ativada atende, fica lembrado por 10 minutos. O tempo limite da API é de 10 segundos. Nesses casos, o cliente não vê nenhum erro: é usado o preço fixo ou o custo de reserva, ou o método fica oculto se não houver nenhum dos dois. Para endereços fora do Brasil, são usados apenas preços fixos.

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

O plugin calcula apenas as tarifas. Ele não cria envios, não imprime etiquetas nem rastreia encomendas; a Frenet oferece esses recursos no próprio painel. Ele mostra um serviço da Frenet por carrinho, e não vários, e não tem pontos de retirada nem armários. A Frenet cota apenas dentro do Brasil; use os preços fixos para os outros países.

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 Frenet. 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 do domínio. Libere a vaga na sua conta da vibefox.net.

Sem uma chave ativa, a Frenet 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 de 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

A Frenet não aparece na finalização de compra: 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 avisos no topo da página de configurações, os limites de peso, Minimum order amount e Excluded shipping classes. Motivos comuns: o cliente ainda não informou um CEP completo de 8 dígitos e não há preços fixos, ou a Frenet não retornou nenhum serviço para a rota e não há preço fixo.

As cotações ao vivo não aparecem: ative Debug log, recarregue a finalização de compra e abra WooCommerce > Status > Logs, origem vfd-frenet. Ali está o motivo: token recusado (HTTP 401 ou 403), falta o CEP de origem, falta a taxa de câmbio do BRL, nenhuma transportadora ativada no painel da Frenet, ou as mensagens dos serviços ignorados.

Minha loja vende em euros ou dólares: a Frenet responde em BRL. Informe a BRL exchange rate (quanto vale 1 BRL na moeda da sua loja).

As tarifas parecem desatualizadas após uma mudança: salve a página de configurações. Isso limpa as cotações em cache.

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 no novo domínio. Se o servidor de licenças estiver inacessível, o plugin continua funcionando com o último status conhecido.

Desinstalação

Desativar o plugin mantém todas as configurações e apenas limpa as cotações em cache. Para removê-lo, desative-o e exclua-o na página Plugins. A chave de licença e o status de licença deste plugin, as cotações em cache e os arquivos de log antigos são sempre removidos. As configurações e os métodos das zonas são removidos somente se Remove data on uninstall estava ativado. Caso contrário, permanecem para uma reinstalação posterior. Os pedidos existentes mantêm suas linhas de frete com a transportadora da Frenet.

A Frenet é uma marca registrada de seu respectivo titular. Este plugin não é afiliado nem endossado pela Frenet.