## Frenet Shipping Gateway for WooCommerce - Correios, Etiquetas e Rastreio
Contributors: frenet, apiki, aguiart0, pedroasa
Donate link: http://www.frenet.com.br/  
Tags: shipping, delivery, woocommerce, correios, jamef, jadlog, tnt, braspress  
Requires at least: 3.5  
Tested up to: 7.1
Version: 2.1.25
Stable tag: 2.1.25
License: GPLv2 or later  
License URI: http://www.gnu.org/licenses/gpl-2.0.html  

Frete inteligente, simples e acessível para negócios que querem crescer  

### Frete inteligente, simples e acessível para negócios que querem crescer ###

Com a Frenet, você centraliza toda a sua operação de frete em uma única plataforma, com tecnologia robusta, integração fácil e recursos completos para vender mais e entregar com agilidade.

O plugin da Frenet para WooCommerce conecta sua loja às principais transportadoras do Brasil com fretes até 90% mais baratos, cálculo automático no checkout, emissão de etiquetas, rastreio automático, regras personalizadas e muito mais, tudo em um só lugar.

#### PRINCIPAIS BENEFÍCIOS:

- Cálculo automático de frete no checkout com alta performance
- Fretes com até 90% de desconto, sem contrato nem mensalidade
- Emissão de etiquetas com rastreio automático
- Logística reversa simplificada com PAC e Sedex
- Integração com +700 transportadoras e +200 plataformas
- Regras de frete personalizadas para promoções, restrições e prazos
- Frete próprio, retirada na loja e cálculo para motoboys
- Plataforma fácil de usar, com instalação rápida e suporte completo
- SOS Proteção de Envios para cobertura contra roubo, perda e danos
- Cotações Frenet apenas para as classes de entrega que desejar
- Taxa fixa configurável para pedidos com produtos virtuais

Com a Frenet, você tem liberdade para configurar sua logística do jeito certo para o seu e-commerce no WordPress, em qualquer estágio de crescimento.
Instale o plugin hoje mesmo e experimente!

#### FUNCIONALIDADES:

- **Cálculo de frete automático no checkout**

Mostre aos seus clientes os valores e prazos de entrega em tempo real, usando transportadoras como Correios, Jadlog, Loggi, entre outras. Compatível com produtos variáveis e com opção de exibir ou ocultar prazos de entrega.

- **Emissão de etiquetas com desconto**

Gere etiquetas dos Correios, Jadlog, Loggi e mais transportadoras com até 90% de desconto, sem precisar de contrato próprio ou mínimo de envios mensais. Se já tiver contrato com os Correios, você também pode integrar.

- **Integração com transportadoras próprias**

Conecte transportadoras que você já utiliza com suas próprias tabelas de frete. A Frenet também ajuda a indicar a melhor transportadora para seu tipo de produto ou região.

- **Integração automática de pedidos**

As informações dos pedidos da sua loja são integradas automaticamente, o que significa que você não precisa ter trabalho manual digitando as informações das etiquetas.

- **Rastreio automático**

As etiquetas geradas pela Frenet contam com rastreamento automático e notificações por e-mail, mantendo seus clientes sempre informados sobre o status da entrega.

- **Logística reversa descomplicada**

Ofereça devoluções e trocas com facilidade usando PAC e Sedex, direto na plataforma da Frenet, sem burocracia.

- **Regras de frete personalizadas**

Crie regras para frete grátis, faixas de preço, aumento/redução de prazo, restrições por região, tipo de produto, valor do pedido e muito mais.

- **SOS Proteção de Envios**

Mais segurança para os envios com proteção que cabe no seu bolso. Cobertura contra roubo, perda e danos, com processo de reembolso simples e direto. Mais tranquilidade para você e seu cliente.

- **Segmentação por classe de entrega**

Configure a Frenet para realizar cotações apenas para produtos vinculados a determinadas classes de entrega, garantindo flexibilidade na sua estratégia logística.

- **Taxa para produtos virtuais**

Cobre um valor fixo como frete em pedidos com produtos virtuais, como uma taxa de processamento do pedido ou de envio do produto digital, com o nome que você escolher. A taxa aparece discriminada no carrinho, no checkout e no pedido.

#### MAIS VANTAGENS:

- Menos abandono de carrinho com fretes mais atrativos
- Emissão de etiquetas com desconto com ativação imediata
- Cálculo de frete para veículos próprios, motoboys e retirada na loja
- Plataforma fácil e painel super intuitivo
- Estabilidade nas cotações em tempo real
- Suporte e atendimento técnico especializados

Não perca tempo e instale o plugin agora mesmo para experimentar!

#### INSTALAÇÃO E MAIS DETALHES:

Confira o tutorial de integração na aba “Instalação” ou [acesse o artigo](https://ajuda.frenet.com.br/s/article/integracao-plataforma-woocommerce?utm_source=woocommerce&utm_medium=artigo&utm_campaign=parceria) na Central de Ajuda. 

Após a instalação, é necessário criar uma conta no painel administrativo Frenet para obter um token de acesso. Este plugin é gratuito, mas para acessar todas as funcionalidades é necessário assinar um plano de pagamentos de acordo com a política de preços publicada em nosso site: [Planos e Preços Frenet](https://www.frenet.com.br/planos-e-precos/?utm_source=woocommerce&utm_medium=artigo&utm_campaign=parceria).

WOOCOMMERCE: Testado até a versão 10.4.3

#### DÚVIDAS?

Tire suas dúvidas de várias formas:

- Visite a [Central de Ajuda](https://ajuda.frenet.com.br/s/?utm_source=woocommerce&utm_medium=artigo&utm_campaign=parceria)
- Visite o [site da Frenet](https://www.frenet.com.br/?utm_source=woocommerce&utm_medium=artigo&utm_campaign=parceria)
- Crie um tópico no fórum de ajuda do WordPress (apenas em inglês)
- Envie um e-mail para o suporte técnico em [suporte@frenet.com.br](suporte@frenet.com.br)

#### LICENÇA

WooCommerce Frenet é um software livre: você pode redistribuí-lo e/ou modificá-lo sob os termos da GNU (General Public License) conforme publicado pela Free Software Foundation, seja a versão 3 da licença ou (a seu critério) qualquer versão posterior.

WooCommerce Frenet é distribuído na esperança de que seja útil, mas SEM QUALQUER GARANTIA; nem mesmo a garantia implícita de COMERCIALIZAÇÃO ou ADEQUAÇÃO À UM DETERMINADO FIM. Confira a GNU para mais detalhes.

Você já deve ter recebido uma cópia da GNU junto com o WooCommerce Frenet. Caso contrário, consulte em [GNU](http://www.gnu.org/licenses/?utm_source=woocommerce&utm_medium=artigo&utm_campaign=parceria).

== Screenshots ==

1. Cálculo de frete automático no checkout da sua loja.
2. Emissão de etiquetas com até 90% de desconto.
3. Integração com mais transportadoras.
4. Rastreio automático com envio de e-mails para os clientes.
5. Regras de frete personalizadas e logística reversa.
6. SOS Proteção de Envios para cobertura contra roubo, perda e danos.
7. Solução completa de frete na palma da mão.
8. Plataforma intuitiva em qualquer dispositivo.


### English Description: ###

With Frenet, you centralize your entire shipping operation on a single platform, with robust technology, easy integration, and a full set of features to help you sell more and deliver faster.
The Frenet plugin for WooCommerce connects your store to the main carriers in Brazil with shipping up to 90% cheaper, automatic rate calculation at checkout, label printing, auto-tracking, custom rules, and much more, all in one place.

### KEY BENEFITS:

- High-performance automatic shipping calculation at checkout
- Discounts of up to 90% with no contracts or monthly fees
- Label printing with automatic tracking
- Simplified reverse logistics with PAC and Sedex
- Integration with 700+ carriers and 200+ platforms
- Custom shipping rules for promotions, restrictions, and delivery times
- Support for own delivery, in-store pickup, and motorcycle couriers
- Easy-to-use platform with fast setup and full support
- SOS Shipping Protection for theft, loss, and damage coverage
- Frenet quotes only for selected shipping classes
- Configurable fixed fee for orders with virtual products

With Frenet, you’re free to set up your logistics the right way for your WordPress e-commerce, at any growth stage.

Install the plugin today and try it out!

### FEATURES:

**Automatic shipping calculation at checkout**

Show your customers real-time delivery times and shipping costs using carriers like Correios, Jadlog, Loggi, and more. Compatible with variable products and optional delivery time display.

**Discounted label printing**

Generate shipping labels from Correios, Jadlog, Loggi, and other carriers with up to 90% off, no need for your own contract or a minimum shipment volume. Already have a Correios contract? You can integrate that too.

**Integration with your own carriers**

Connect carriers you already use with your own shipping rate tables. Frenet also helps you find the best carrier for your product or region.

**Automatic order integration**

Order data from your store is automatically synced, so you don’t have to manually enter label information.

**Automatic tracking**

Labels generated through Frenet come with auto-tracking and email notifications, keeping your customers updated about delivery status.

**Simplified reverse logistics**

Easily handle returns and exchanges via PAC and Sedex directly in the Frenet platform without any hassle.

**Custom shipping rules**

Create rules for free shipping, price ranges, delivery time adjustments, regional or product restrictions, order value filters, and more.

**SOS Shipping Protection**

More safety for your shipments at a fair price. Coverage for theft, loss, and damages with a straightforward reimbursement process. Peace of mind for you and your customers.

**Shipping class targeting**

Set Frenet to quote rates only for products linked to specific shipping classes, giving you more flexibility in your logistics strategy.

**Virtual products fee**

Charge a fixed amount as shipping on orders with virtual products, such as an order processing fee or a digital delivery fee, with the name you choose. The fee is itemized in the cart, checkout and order.

### MORE ADVANTAGES:

- Reduce cart abandonment with more attractive shipping rates
- Discounted label printing with instant activation
- Shipping calculations for in-store pickup, own vehicles, and motorcycle couriers
- Easy-to-use platform with an intuitive dashboard
- Stable real-time quoting
- Specialized tech support and customer service

Don’t waste time, install the plugin now and give it a try!

### INSTALLATION AND MORE DETAILS: 

- Check the integration tutorial under the "Installation" tab or visit [the Help Center article.](https://ajuda.frenet.com.br/s/article/integracao-plataforma-woocommerce?utm_source=woocommerce&utm_medium=artigo&utm_campaign=parceria)
After installation, create an account in the Frenet admin panel to obtain an access token. This plugin is free, but accessing all features requires a paid plan according to the pricing policy on our website: Frenet Plans and Pricing.

WOOCOMMERCE: Tested up to 11.0.1

### QUESTIONS?

You can get support in several ways:
- Visit the [Help Center](https://ajuda.frenet.com.br/s/?utm_source=woocommerce&utm_medium=artigo&utm_campaign=parceria)
- Visit the [Frenet website](https://www.frenet.com.br/?utm_source=woocommerce&utm_medium=artigo&utm_campaign=parceria)
- Open a topic in the WordPress support forum (English only)
- Email our support team at [suporte@frenet.com.br](suporte@frenet.com.br)

### LICENSE

WooCommerce Frenet is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the license or (at your discretion) any later version.

WooCommerce Frenet is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU License for more details.

You should have received a copy of the GNU License along with WooCommerce Frenet. If not, visit [GNU](http://www.gnu.org/licenses/?utm_source=woocommerce&utm_medium=artigo&utm_campaign=parceria).

== Screenshots ==

1. Automatic shipping calculation at your store's checkout.
2. Print shipping labels with up to 90% discount.
3. Integration with more carriers.
4. Auto-tracking with email updates for your customers.
5. Custom shipping rules and reverse logistics.
6. SOS Shipping Protection for coverage against theft, loss, and damage.
7. Full-featured shipping solution at your fingertips.
8. Easy-to-use platform on any device.


== Frequently Asked Questions ==

= Qual é a licença do plugin? =

* Este plugin está licenciado como GNU (General Public License).

= O que eu preciso para utilizar este plugin? =

* Ter instalado o plugin WooCommerce;
* Possuir instalada em sua hospedagem a extensão de SimpleXML;
* Configurar o seu acesso nas configurações do plugin;
* Adicionar peso e dimensões dos produtos que pretende enviar;
* Criar uma conta no painel administrativo da Frenet.

**Atenção**: É obrigatório ter o peso configurado em cada produto para que seja possível calcular o frete de forma eficiente. As dimensões podem ficar em branco e, neste caso, serão utilizadas as medidas da opção Pacote Padrão da configuração do plugin. Porém, é recomendado que cada produto tenha suas configurações próprias de peso e dimensão.

= A Frenet é uma transportadora? =

Não somos uma transportadora. A Frenet é uma plataforma completa de frete que conecta sua loja às principais transportadoras do mercado, automatizando o cálculo, emissão de etiquetas, rastreio e gestão logística, tudo em um só lugar, com foco em performance, economia e simplicidade.

= Preciso pagar algo para usar a Frenet? =

Temos um plano gratuito e outras opções com mensalidade. Você pode começar utilizando o plugin sem nenhum custo e, posteriormente, pode fazer um upgrade para ter mais funcionalidades se assim desejar.

= Posso cobrar uma taxa em pedidos de produtos virtuais? =

Sim. Ative a “Taxa para Produtos Virtuais” nas configurações da Frenet, informe o valor e o nome da taxa. Ela é cobrada como frete, uma vez por pedido, e aparece com o nome configurado no carrinho, no checkout e no pedido. Veja o passo a passo em “Taxa para Produtos Virtuais”, na seção de instalação.

### English FAQ: ###

= What is the license of the plugin? =

* This plugin is licensed under the GNU General Public License.

= What do I need to use this plugin? =

* WooCommerce installed;
* SimpleXML extension installed on your hosting (included by default in PHP 5);
* Plugin access configured;
* Weight and dimensions added to products you want to deliver;
* [Create an account](https://cadastro.frenet.com.br/?utm_source=woocommerce&utm_medium=artigo&utm_campaign=parceria) in the Frenet admin panel.

**Note:** Each product must have its weight configured to allow accurate shipping calculations. If dimensions are left blank, the plugin will use the Default Package settings, but it's best to provide weight and dimensions for each product.

**Is Frenet a carrier?**
We are not a carrier. Frenet is a full-featured shipping platform that connects your store to the leading carriers in the market, automating rate calculation, label printing, tracking, and logistics management, all in one place, with a focus on performance, savings, and simplicity.

**Do I have to pay to use Frenet?**
We offer a free plan and other subscription options. You can start using the plugin at no cost and upgrade later if you need more features.

**Can I charge a fee on orders with virtual products?**
Yes. Enable the "Virtual Products Fee" in the Frenet settings and set the fee amount and name. It is charged as shipping, once per order, and shows up with the configured name in the cart, checkout and order. See the step by step in "Virtual Products Fee", in the installation section.



== Installation ==

Instale a Frenet no seu WooCommerce seguindo o passo a passo do [tutorial de integração](https://ajuda.frenet.com.br/s/article/integracao-plataforma-woocommerce?utm_source=woocommerce&utm_medium=artigo&utm_campaign=parceria) 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](https://ajuda.frenet.com.br/s/article/configurar-e-sincronizar-os-pedidos-do-woocommerce?utm_source=woocommerce&utm_medium=artigo&utm_campaign=parceria) na Frenet e gerar etiquetas de frete com apenas um clique.

= Instalação do plugin: =

- Envie os arquivos do plugin para o seu diretório de plugins ou instale usando a ferramenta “Adicionar novo plugin” do WordPress;
- Ative o plugin;
- Visite WooCommerce > Configurações > Entrega, escolha Frenet e preencha as configurações;
- Cadastre-se no [Painel Administrativo Frenet](https://painel.frenet.com.br/?utm_source=woocommerce&utm_medium=artigo&utm_campaign=parceria) 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: =

- Com o plugin instalado, navegue até WooCommerce > Configurações > Entrega > Frenet;
- Nesta tela configure o seu Token, obtido no Painel Administrativo Frenet;
- Também é possível configurar um “Pacote Padrão” que será utilizado para definir as medidas mínimas do pacote de entrega.
- Em “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.
- Na 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).
- Em “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: =

- Para 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);
- É necessário configurar o peso e dimensões de todos os seus produtos, caso você queira que a cotação de frete seja exata;
- Alternativamente, 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:

- **Tempo 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.
- **Tentativas 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:

- Se 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.
- O pior caso de espera é Tentativas × Tempo Limite. Com os padrões, até 15 segundos.
- Erros que não mudam ao repetir, como um Token inválido, não são tentados de novo.
- Valores fora da faixa são ajustados automaticamente ao salvar, e o painel mostra um aviso com o valor que foi gravado.
- Se 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.
- As 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:

- **Taxa para Produtos Virtuais**: marque “Ativar” para cobrar a taxa. Desmarcado (padrão), os produtos virtuais seguem sem frete, como antes.
- **Valor 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.
- **Nome 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:

1. Acesse WooCommerce > Configurações > Entrega e clique na zona de entrega em que a taxa deve valer (ex.: Brasil);
2. Clique em “Editar” no método Frenet;
3. Na seção “Produtos Virtuais”, marque “Ativar” em “Taxa para Produtos Virtuais”;
4. Informe o valor da taxa (ex.: 10,00) e, se quiser, altere o nome (ex.: “Taxa de processamento do pedido”);
5. Clique em “Salvar alterações”. Repita nas outras zonas em que a taxa deve ser cobrada.

Como a taxa aparece para o cliente:

- **Carrinho 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.
- **Carrinho 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.
- **Carrinho só com produtos físicos**: nada muda.

Observações:

- Com a taxa ativada, pedidos só com produtos virtuais passam a pedir endereço de entrega no checkout, pois a taxa é cobrada como frete.
- A taxa vale para a zona de entrega do endereço do cliente. Em zonas sem a taxa ativada, os produtos virtuais seguem sem frete.
- O 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](https://ajuda.frenet.com.br/s/article/integracao-plataforma-woocommerce?utm_source=woocommerce&utm_medium=artigo&utm_campaign=parceria) 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](https://ajuda.frenet.com.br/s/article/configurar-e-sincronizar-os-pedidos-do-woocommerce?utm_source=woocommerce&utm_medium=artigo&utm_campaign=parceria) in Frenet and generate shipping labels with just one click.

= PLUGIN INSTALLATION: =

- Upload the plugin files to your plugin directory or use the “Add New Plugin” feature in WordPress;
- Activate the plugin;
- Go to WooCommerce > Settings > Shipping, select Frenet, and fill in the configuration fields;
- Sign up in the [Frenet Admin Panel](https://painel.frenet.com.br/?utm_source=woocommerce&utm_medium=artigo&utm_campaign=parceria) and get your access key.

= REQUIREMENTS: =  

SimpleXML extension (already included in PHP 5).

= PLUGIN SETTINGS: =
- With the plugin installed, go to WooCommerce > Settings > Shipping > Frenet; 
- On this screen, enter your Token, obtained from the Frenet Admin Panel;
- You can also configure a "Default Package" to define minimum package dimensions.
- "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.
- On 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).
- Under "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: = 

- To 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);
- Weight and dimensions must be configured for accurate quoting;
- If 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:

- **Request Timeout (seconds)**: maximum time to wait for the Frenet API on each attempt. Default: 5. Accepts 2 to 10 seconds.
- **Request Attempts**: how many times the quote is tried before giving up (1 = no retry). Default: 3. Accepts 1 to 3.

How it works:

- If 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.
- The worst-case wait is Attempts × Timeout. With the defaults, up to 15 seconds.
- Errors that would not change on a retry, such as an invalid Token, are not retried.
- Out-of-range values are adjusted automatically on save, and the admin shows a notice with the value that was saved.
- If 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.
- Quote 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".

Fields:

- **Virtual Products Fee**: check "Enable" to charge the fee. When unchecked (default), virtual products stay without shipping, as before.
- **Virtual Products Fee Amount**: fixed amount charged once per order, regardless of how many virtual products are in the cart. Use the store's decimal separator (e.g. 10.00). A zero or empty amount disables the fee.
- **Virtual Products Fee Name**: name shown to the customer in the cart, checkout, e-mail and order. Default: "Order processing fee". If left empty, the default is used.

Step by step:

1. Go to WooCommerce > Settings > Shipping and open the shipping zone where the fee applies (e.g. Brazil);
2. Click "Edit" on the Frenet method;
3. Under "Virtual Products", check "Enable" in "Virtual Products Fee";
4. Enter the fee amount (e.g. 10.00) and, optionally, change its name;
5. Click "Save changes". Repeat for every zone where the fee should be charged.

How the customer sees the fee:

- **Cart with only virtual products**: the fee is the only shipping option, with the configured name and amount. The zone's other shipping methods are hidden. The order stores it as the shipping line, with the configured name, added to the order total.
- **Cart with physical and virtual products**: the fee amount is added to every Frenet quote, and the shipping name shows it (e.g. "PAC (Delivery in 5 working days) + Order processing fee (R$ 10.00)"). The order also stores the fee amount separately in the shipping line details. Other carriers in the zone do not get the fee.
- **Cart with only physical products**: nothing changes.

Notes:

- With the fee enabled, orders with only virtual products ask for a shipping address at checkout, because the fee is charged as shipping.
- The fee applies to the shipping zone of the customer's address. In zones without the fee enabled, virtual products stay without shipping.
- The product page shipping simulator remains hidden for virtual products.

== Changelog ==

= 2.1.25 - 15/10/2026 =

* Corrige o cupom enviado à Frenet na cotação quando o cliente aplica mais de um cupom e remove o primeiro: o cupom que ficou no carrinho deixava de ser enviado, as regras de frete por cupom do painel Frenet deixavam de valer e o PHP registrava o aviso "Undefined array key 0".
* Correção de segurança: a descrição da tela de configuração do método Frenet passa a ser escapada depois de traduzida, e o texto volta a ser encontrado pelas ferramentas de tradução.
* Atualiza a versão testada para WooCommerce 11.1.2.

= 2.1.24 - 07/10/2026 =

* Corrige o simulador de frete da página do produto para produtos variáveis: ele passa a aparecer e a cotar a variação escolhida por qualquer controle (lista, radio, botão, swatch de cor ou de imagem), inclusive com plugins como Variation Swatches e Kadence Shop Kit.
* Adiciona suporte ao simulador de frete no bloco "Add to Cart + Options" dos temas de bloco do WooCommerce.
* O link "Limpar" das variações passa a esconder o simulador e apagar a cotação anterior; ao trocar de variação, a cotação antiga também é apagada.
* Oculta o simulador para produtos e variações que não precisam de envio, que estão indisponíveis ou fora de estoque.
* Redesenha o resultado da cotação do simulador em colunas (Entrega e Custo), com o prazo de entrega abaixo de cada serviço; os textos e o valor do frete seguem as cores do tema da loja.
* O botão do simulador passa a se chamar "Calcular" (antes, "Ok").
* O campo de CEP do simulador ganha um ícone, o texto de exemplo "Digite seu CEP" e o estilo de campos do tema, com teclado numérico no celular.
* Corrige o prazo estimado de entrega no simulador, que não aparecia mesmo com a opção "Estimativa de entrega" ativada.
* Exibe o valor do frete no simulador com a formatação de moeda da loja.
* Passa a cotar a quantidade informada no formulário do próprio produto, sem interferência de outros campos de quantidade da página.
* Corrige o simulador que ficava preso em "Aguarde..." ao clicar em OK com o CEP vazio, e o resultado duplicado ao clicar em OK mais de uma vez.
* Adiciona um limite de cotações do simulador por visitante (padrão: 60 por minuto), configurável no novo campo "Limite de Cotações do Simulador" (0 desativa o limite), para proteger a cota da sua API Frenet. Quando um visitante atinge o limite, o bloqueio é registrado em WooCommerce > Status > Logs (origem "frenet") com o IP e, se houver, o ID e o nome da conta.
* Passa a validar no servidor os dados da cotação do simulador (quantidade, produto, variação e forma de entrega).
* Correção de segurança: o CEP salvo do cliente passa a ser escapado ao ser exibido no simulador.
* Evita conflitos do simulador com temas e outros plugins (formulário e campos com identificação própria) e corrige o rótulo do campo de CEP.
* Melhora o desempenho da página de produtos variáveis, que carregava os dados de todas as variações para montar o simulador.
* Os textos do simulador passam a ser traduzíveis, e as traduções incluídas no plugin passam a complementar o pacote de idioma do WordPress.org.
* Os arquivos JS e CSS do simulador passam a ser atualizados no navegador sempre que mudam, evitando versões antigas em cache.
* Registra como depuração, e não como erro, a cotação ignorada quando o carrinho não tem itens com envio.
* Remove textos não utilizados dos arquivos de tradução.
* Adiciona a "Taxa para Produtos Virtuais", na nova seção "Produtos Virtuais" das configurações da Frenet: um valor fixo cobrado como frete em pedidos com produtos virtuais, por exemplo uma taxa de processamento do pedido. Vem desativada e é configurada por zona de entrega.
* Novos campos "Taxa para Produtos Virtuais" (ativar/desativar), "Valor da Taxa para Produtos Virtuais" (cobrado uma vez por pedido; zero desativa a cobrança) e "Nome da Taxa para Produtos Virtuais" (padrão: "Taxa de processamento do pedido").
* Com apenas produtos virtuais no carrinho, a taxa passa a ser a única opção de entrega, com o nome e o valor configurados, e os demais métodos de entrega da zona ficam ocultos. No pedido, a taxa é gravada como o frete e somada ao total.
* Com produtos físicos e virtuais no carrinho, a taxa é somada a cada cotação da Frenet e identificada no nome do frete; no pedido, o valor da taxa também fica registrado separadamente nos detalhes do item de frete. Outras transportadoras não recebem a taxa.
* Funciona no checkout em blocos e no checkout clássico do WooCommerce.
* Traduz para pt-BR os textos da nova seção "Produtos Virtuais".
* Declara compatibilidade com os blocos de carrinho e checkout do WooCommerce e atualiza as versões testadas para WordPress 7.1 e WooCommerce 11.0.1.

= 2.1.23 - 31/08/2026 =

* Corrige aviso de PHP no simulador de frete quando a loja não possui nenhuma classe de entrega cadastrada.
* Remove a autenticação legada por usuário/senha e o webservice SOAP, que não é mais aceito pela Frenet. A cotação passa a exigir um Token, configurado no campo já existente.
* Adiciona timeout configurável (2 a 10 segundos) para a requisição de cotação à API da Frenet.
* Adiciona número de tentativas configurável (1 a 3) com nova tentativa automática em caso de falha.
* Para de tentar novamente quando a Frenet responde com um erro do cliente (ex.: token inválido), evitando esperar todas as tentativas numa requisição que nunca vai funcionar.
* Passa a validar a resposta da API (erro de rede, status HTTP, Content-Type e JSON), em vez de tratar qualquer falha como "sem frete disponível".
* Passa a tratar como falha também a resposta HTTP 200 sem transportadoras utilizáveis (retorno vazio ou todas as transportadoras com erro), e não apenas erros de rede/HTTP.
* Passa a registrar erros de cotação sempre no log do WooCommerce (independente da opção "Debug Log"), identificando a sessão/carrinho e a instância/zona de frete afetados.
* Quando a cotação da Frenet falha, avisa o cliente e bloqueia a finalização do pedido apenas se a forma de entrega escolhida for da Frenet; com outra transportadora selecionada, o pedido segue normalmente.
* Expira o cache de frete do WooCommerce enquanto a cotação da Frenet está falhando, para que a loja volte a cotar a Frenet assim que a API se recuperar, sem o cliente precisar alterar o carrinho ou o endereço.
* Exibe um aviso no painel quando o Tempo Limite ou as Tentativas configuradas estão fora da faixa permitida e são ajustadas automaticamente.
* Traduz para pt-BR os textos dos novos campos de configuração (Tempo Limite, Tentativas) e do aviso de falha de cotação.

= 2.1.22 - 19/01/2026 =

* Atualização de compatibilidade com o WooCommerce e o WordPress, incluindo a versão do plugin no gerador de logs.

= 2.1.21 - 05/01/2026 =

* Atualização de compatibilidade com o WooCommerce e o WordPress, incluindo melhorias na proteção de variáveis.

= 2.1.20 - 05/08/2025 =

* Rebranding.

= 2.1.19 - 20/05/2025 =

* Atualizando para o PHP 8.2.

= 2.1.18 - 05/03/2024 =

* Corrige verificação de classe de entrega. Para exibição no checkout.

= 2.1.17 - 08/02/2024 =

* Verifica se a loja já possui a configuração de classe de entrega. Caso não possua utiliza 'Qualquer classe de entrega' como padrão

= 2.1.16 - 04/12/2023 =

* Adaptação do plugin para classes de entrega
* Compatibilidade da calculadora de frete para produtos do tipo Composite Products
* Correção da opção de não mostrar estimativa de entrega na página de produtos

= 2.1.15 - 19/08/2022 =

* Atualiza $variation->variation_id para $variation->get_id()

= 2.1.14 - 18/10/2023 =

* Tratamento das informações de produto que estão disponiveis no html padrão do simulador de frete

= 2.1.13 - 04/11/2022 =

* Alteração na descrição de testes de versionamento do WooCommerce e Wordpress

= 2.1.12 - 19/08/2022 =

* Corrigido problemas se desativar Woocommerce e não desativar o plugin Frenet

= 2.1.11 - 24/02/2022 =

* Validações e testes para garantir estabilidade do módulo com as novas versões do Wordpress e Woocommerce

= 2.1.10 - 20/01/2021 =

* Corrigido problemas de logs, CRITICAL Uncaught Error: Cannot use object of type WP_Error as array

= 2.1.9 - 09/01/2021 =

* Remover função get_product

= 2.1.8 - 28/12/2020 =

* Ajustes de nova padronização do Woocommerce 

= 2.1.7 - 07/02/2019 =

* Ajustes na calculadora da página do produto

= 2.1.6 - 07/02/2019 =

* Ajuste na compatibilidade com a nova versão Wordpress/Woocommerce

= 2.1.5 - 05/06/2018 =

* Agora o campo CUPOM de DESCONTO pode ser utilizado em conjunto com as regras de Fretes criadas dentro do painel do Frenet

= 2.1.4 - 05/06/2018 =

* Para a nova versão do Woocommerce foi necessário utilizar metadata para armazenar o código do método de entrega escolhido na cotação;

= 2.1.3 - 02/04/2018 =

* Envio de dados de categoria de produtos para a cotação;

= 2.1.2 - 03/07/2017 =

* Bug Fix - Correção post data Json;

= 2.1.1 - 12/01/2017 =

* Bug Fix - Cálculo na página do produto - valor e quantidade; Quantidade do mesmo produto;

= 2.1.0 - 07/11/2016 =

* Adicionado cálculo de frete na página do produto - Grande contribuição de Bruno Rodrigues (https://github.com/bruno-rodrigues) e Flávia Amaral (https://github.com/flavia-programmer)

= 2.0.1 =

* Versão compativel com Woocommerce 2.6.x - Shipping zones; Bug Fixes - Token

= 2.0.0 =

* Versão compativel com Woocommerce 2.6.x - Shipping zones

= 1.0.2 =

* Bug Fix - Tradução

= 1.0.1 =

* Bug Fixes

= 1.0.0 =

* Versão inicial do plugin.

== Upgrade Notice ==

= 2.1.25 =

* Corrige o envio do cupom à Frenet quando o cliente remove um de dois cupons aplicados, para que as regras de frete por cupom voltem a valer, e escapa a descrição da tela de configuração do método. Não exige mudanças de configuração.

= 2.1.24 =

* Se a loja ainda usa usuário/senha da Frenet, configure um Token em WooCommerce > Configurações > Entrega > Frenet antes de atualizar (removidos na 2.1.23). Nova Taxa para Produtos Virtuais, desativada por padrão. Temas que sobrescrevem o template do simulador devem atualizar a cópia.

= 2.1.23 =

* IMPORTANTE: a autenticação por usuário/senha (webservice SOAP) foi removida, pois não é mais aceita pela Frenet. Se sua loja ainda não tem um Token configurado, configure um em WooCommerce > Configurações > Entrega > Frenet antes de atualizar, ou o cálculo de frete vai parar de funcionar.
* Corrige o problema em que uma falha temporária na cotação da Frenet podia deixar o pedido ser finalizado sem cobrar frete. Agora, quando a cotação falha, o cliente é avisado e a finalização fica bloqueada enquanto a Frenet for a forma de entrega escolhida — com outra transportadora selecionada o pedido segue normalmente.

= 2.1.15 =

* Atualiza $variation->variation_id para $variation->get_id()

= 2.1.14 =

* Tratamento das informações de produto que estão disponiveis no html padrão do simulador de frete

= 2.1.13 =

* Alteração na descrição de testes de versionamento do WooCommerce e Wordpress

= 2.1.12 =

* Corrigido problemas se desativar Woocommerce e não desativar o plugin Frenet

= 2.1.11 =

* Validações e testes para garantir estabilidade do módulo com as novas versões do Wordpress e Woocommerce

= 2.1.10 =

* Corrigido problemas de logs, CRITICAL Uncaught Error: Cannot use object of type WP_Error as array

= 2.1.9 =

* Remover função get_product

= 2.1.4 =

* Para a nova versão do Woo foi necessário utilizar metadata para armazenar o código do método de entrega escolhido na cotação

= 2.1.3 =

* Envio de dados de categoria de produtos para a cotação;

= 2.1.2 =

* Bug Fix - Correção post data Json;

= 2.1.1 =

* Bug Fix - Cálculo na página do produto - valor e quantidade; Quantidade do mesmo produto;
