Frenet Shipping Gateway for WooCommerce – Correios, Etiquetas e Rastreio

Installation

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:

• 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 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 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:

• 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 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.