Instale a Frenet no seu WooCommerce seguindo o passo a passo do tutorial de integração disponível na Central de Ajuda.
Importante : Para integrar a Frenet, é necessário realizar a instalação do plugin. Este plugin não está disponível para contas de teste. Sendo assim, você precisa ter um plano assinado no WooCommerce.
Após a instalação, aprenda como integrar seus pedidos na Frenet e gerar etiquetas de frete com apenas um clique.
Instalação do plugin:
- 01Envie os arquivos do plugin para o seu diretório de plugins ou instale usando a ferramenta “Adicionar novo plugin” do WordPress;
- 02Ative o plugin;
- 03Visite WooCommerce > Configurações > Entrega, escolha Frenet e preencha as configurações;
- 04Cadastre-se no Painel Administrativo Frenet e obtenha uma chave de acesso.
Requerimentos:
Possuir instalada a extensão SimpleXML (que já é instalada por padrão com o PHP 5).
CONFIGURAÇÕES DO PLUGIN:
- 05Com o plugin instalado, navegue até WooCommerce > Configurações > Entrega > Frenet;
- 06Nesta tela configure o seu Token, obtido no Painel Administrativo Frenet;
- 07Também é possível configurar um “Pacote Padrão” que será utilizado para definir as medidas mínimas do pacote de entrega.
- 08Em “Tempo Limite da Requisição” e “Tentativas de Requisição”, defina quanto tempo esperar pela API da Frenet e quantas vezes tentar de novo em caso de falha. Veja os detalhes em “Tempo Limite e Tentativas”, abaixo.
- 09Na mesma tela, em “Limite de Cotações do Simulador”, defina quantas cotações o simulador de frete da página do produto aceita por visitante por minuto (padrão: 60; use 0 para não limitar).
- 10Em “Produtos Virtuais”, é possível cobrar uma taxa fixa como frete em pedidos com produtos virtuais. Veja como configurar em “Taxa para Produtos Virtuais”, abaixo.
CONFIGURAÇÕES DOS PRODUTOS:
- 11Para que seja possível calcular o frete, os seus produtos precisam ser do tipo simples ou variável, e não estarem marcados com “virtual” ou “baixável”. Qualquer outro tipo de produto será ignorado na cotação. A exceção são os pedidos com produtos virtuais quando a “Taxa para Produtos Virtuais” está ativada (veja abaixo);
- 12É necessário configurar o peso e dimensões de todos os seus produtos, caso você queira que a cotação de frete seja exata;
- 13Alternativamente, você pode configurar apenas o peso e deixar as dimensões em branco, pois neste caso serão utilizadas as configurações do Pacote Padrão para as dimensões. Porém, neste caso, pode ocorrer uma variação no valor do frete.
TEMPO LIMITE E TENTATIVAS:
Controlam quanto tempo a loja espera pela API da Frenet e quantas vezes tenta de novo quando a cotação falha. Ficam em WooCommerce > Configurações > Entrega > (sua zona de entrega) > Frenet.
Campos:
- 14Tempo Limite da Requisição (segundos) : tempo máximo de espera pela resposta da API da Frenet em cada tentativa. Padrão: 5. Aceita de 2 a 10 segundos.
- 15Tentativas de Requisição : quantas vezes a cotação é tentada antes de desistir (1 = sem nova tentativa). Padrão: 3. Aceita de 1 a 3.
Como funciona:
- 16Se a API não responder no tempo limite, ou responder com erro, a cotação é tentada de novo, até o número de tentativas configurado.
- 17O pior caso de espera é Tentativas × Tempo Limite. Com os padrões, até 15 segundos.
- 18Erros que não mudam ao repetir, como um Token inválido, não são tentados de novo.
- 19Valores fora da faixa são ajustados automaticamente ao salvar, e o painel mostra um aviso com o valor que foi gravado.
- 20Se todas as tentativas falharem, o cliente é avisado e a finalização do pedido fica bloqueada enquanto a Frenet for a forma de entrega escolhida. Com outra transportadora selecionada, o pedido segue normalmente.
- 21As falhas de cotação são registradas sempre em WooCommerce > Status > Logs (origem “frenet”), mesmo com o “Relatório de Depuração” desligado.
Recomendação: mantenha os padrões. Diminua o Tempo Limite se preferir que o checkout desista mais rápido em caso de instabilidade, ou aumente se a sua hospedagem tiver conexões mais lentas.
TAXA PARA PRODUTOS VIRTUAIS:
Permite cobrar um valor fixo como frete em pedidos com produtos virtuais, por exemplo uma taxa de processamento do pedido ou de envio do produto digital. A taxa vem desativada e é configurada por zona de entrega.
Onde configurar: WooCommerce > Configurações > Entrega > (sua zona de entrega) > Frenet, na seção “Produtos Virtuais”.
Campos:
- 22Taxa para Produtos Virtuais : marque “Ativar” para cobrar a taxa. Desmarcado (padrão), os produtos virtuais seguem sem frete, como antes.
- 23Valor da Taxa para Produtos Virtuais : valor fixo cobrado uma vez por pedido, independentemente da quantidade de produtos virtuais. Use o mesmo separador decimal da loja (ex.: 10,00). Com valor zero ou vazio, a taxa não é cobrada.
- 24Nome da Taxa para Produtos Virtuais : nome exibido ao cliente no carrinho, no checkout, no e-mail e no pedido. Padrão: “Taxa de processamento do pedido”. Se ficar vazio, o padrão é usado.
Passo a passo:
- 25Acesse WooCommerce > Configurações > Entrega e clique na zona de entrega em que a taxa deve valer (ex.: Brasil);
- 26Clique em “Editar” no método Frenet;
- 27Na seção “Produtos Virtuais”, marque “Ativar” em “Taxa para Produtos Virtuais”;
- 28Informe o valor da taxa (ex.: 10,00) e, se quiser, altere o nome (ex.: “Taxa de processamento do pedido”);
- 29Clique em “Salvar alterações”. Repita nas outras zonas em que a taxa deve ser cobrada.
Como a taxa aparece para o cliente:
- 30Carrinho só com produtos virtuais : a taxa é a única opção de entrega, com o nome e o valor configurados (ex.: “Taxa de processamento do pedido: R$ 10,00”). Os demais métodos de entrega da zona ficam ocultos. No pedido, ela é gravada como o frete, com o nome configurado, e somada ao total.
- 31Carrinho com produtos físicos e virtuais : o valor da taxa é somado a cada cotação da Frenet, e o nome do frete passa a indicá-la (ex.: “PAC (Entrega em 5 dias úteis) + Taxa de processamento do pedido (R$ 10,00)”). No pedido, o valor da taxa também fica registrado separadamente nos detalhes do item de frete. Outras transportadoras da zona não recebem a taxa.
- 32Carrinho só com produtos físicos : nada muda.
Observações:
- 33Com a taxa ativada, pedidos só com produtos virtuais passam a pedir endereço de entrega no checkout, pois a taxa é cobrada como frete.
- 34A taxa vale para a zona de entrega do endereço do cliente. Em zonas sem a taxa ativada, os produtos virtuais seguem sem frete.
- 35O simulador de frete da página do produto continua oculto para produtos virtuais.
English INSTALLATION:
Install Frenet in your WooCommerce store by following the integration tutorial available in our Help Center.
Important: To use Frenet, you need to install the plugin. It’s not available for test accounts. You must have a signed WooCommerce plan.
After installation, learn how to integrate your orders in Frenet and generate shipping labels with just one click.
PLUGIN INSTALLATION:
- 36Upload the plugin files to your plugin directory or use the “Add New Plugin” feature in WordPress;
- 37Activate the plugin;
- 38Go to WooCommerce > Settings > Shipping, select Frenet, and fill in the configuration fields;
- 39Sign up in the Frenet Admin Panel and get your access key.
REQUIREMENTS:
SimpleXML extension (already included in PHP 5).
PLUGIN SETTINGS:
- 40With the plugin installed, go to WooCommerce > Settings > Shipping > Frenet;
- 41On this screen, enter your Token, obtained from the Frenet Admin Panel;
- 42You can also configure a “Default Package” to define minimum package dimensions.
- 43“Request Timeout” and “Request Attempts” set how long to wait for the Frenet API and how many times to retry on failure. See the details in “Request Timeout and Attempts” below.
- 44On the same screen, “Simulator Quote Limit” sets how many quotes the product page shipping simulator accepts per visitor per minute (default: 60; use 0 for no limit).
- 45Under “Virtual Products”, you can charge a fixed fee as shipping on orders with virtual products. See how to set it up in “Virtual Products Fee” below.
PRODUCT SETTINGS:
- 46To allow shipping calculation, products must be simple or variable and not marked as “virtual” or “downloadable”. Any other type of product will be ignored in the quote. The exception is orders with virtual products when the “Virtual Products Fee” is enabled (see below);
- 47Weight and dimensions must be configured for accurate quoting;
- 48If only weight is set, the system will use Default Package dimensions, which may result in variations in shipping cost.
REQUEST TIMEOUT AND ATTEMPTS:
These settings control how long the store waits for the Frenet API and how many times it retries when a quote fails. They are in WooCommerce > Settings > Shipping > (your shipping zone) > Frenet.
Fields:
- 49Request Timeout (seconds) : maximum time to wait for the Frenet API on each attempt. Default: 5. Accepts 2 to 10 seconds.
- 50Request Attempts : how many times the quote is tried before giving up (1 = no retry). Default: 3. Accepts 1 to 3.
How it works:
- 51If the API does not answer within the timeout, or answers with an error, the quote is tried again, up to the configured number of attempts.
- 52The worst-case wait is Attempts × Timeout. With the defaults, up to 15 seconds.
- 53Errors that would not change on a retry, such as an invalid Token, are not retried.
- 54Out-of-range values are adjusted automatically on save, and the admin shows a notice with the value that was saved.
- 55If every attempt fails, the customer is notified and placing the order is blocked while Frenet is the chosen shipping method. With another carrier selected, the order goes through normally.
- 56Quote failures are always logged in WooCommerce > Status > Logs (source “frenet”), even with the “Debug Log” disabled.
Recommendation: keep the defaults. Lower the timeout if you prefer checkout to give up faster during instability, or raise it if your hosting has slower connections.
VIRTUAL PRODUCTS FEE:
Lets you charge a fixed amount as shipping on orders with virtual products, such as an order processing fee or a digital delivery fee. The fee is disabled by default and is set per shipping zone.
Where to set it: WooCommerce > Settings > Shipping > (your shipping zone) > Frenet, under “Virtual Products”.