VibeFox Estafeta for WooCommerce — Ajuda

Requisitos

WordPress: 5.8 ou superior.

WooCommerce: 7.0 ou superior, instalado e ativo. O plugin não ativa sem ele.

PHP: 8.0 ou superior.

Conta da DrEnvio (somente para tarifas em tempo real): as tarifas em tempo real da Estafeta vêm da DrEnvio, parceira da Estafeta no México. Crie uma conta em drenvio.com, ative a Estafeta, configure lá o seu endereço de coleta e copie a chave de API do painel da DrEnvio. É a mesma chave usada pelo plugin oficial da DrEnvio. Se você usa apenas os seus próprios preços, não precisa de conta na DrEnvio.

Produtos: os produtos precisam ter peso para as tarifas em tempo real.

Chave de licença do 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_estafeta para /wp-content/plugins/ por FTP.

2. Clique em Activate.

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

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

5. Insira a chave de API da DrEnvio e, opcionalmente, o código postal de origem. Se a moeda da sua loja não for MXN, informe a MXN exchange rate. Defina um preço por país para MX ou um custo de reserva se o método deve continuar visível quando a DrEnvio não tiver tarifa.

6. Adicione o VibeFox Estafeta à sua zona do México 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 Estafeta. Elas valem para todas as zonas de envio. Ao adicionar o método a uma zona, a janela da zona tem apenas um campo:

Title (zone): o nome desta opção na finalização de compra. Deixe em branco para usar o Name global.

No topo da página, o plugin exibe avisos: chave de API da DrEnvio ausente, moeda da loja diferente de MXN sem taxa de câmbio, ou nenhum preço por país para MX e nenhum custo de reserva (nesse caso o método fica oculto quando não há tarifa em tempo real). Sempre que você salva as configurações, as tarifas da DrEnvio em cache são limpas. Campos numéricos aceitam ponto ou vírgula decimal. Um valor que não é um número válido é apagado e informado ao salvar.

Geral

Enable/Disable: liga ou desliga o envio pela Estafeta em todas as zonas de uma vez. Padrão: ativado.

Name: o nome do método de envio exibido ao cliente na finalização de compra. Padrão: Estafeta.

Tax status: Taxable permite que o WooCommerce some imposto ao custo de envio; None não faz isso. Se os preços da DrEnvio incluem IVA depende da sua conta na DrEnvio. Se já incluírem IVA, escolha None. Padrão: Taxable.

Tarifas em tempo real (API da DrEnvio)

É oferecido o serviço da Estafeta mais barato para o endereço. Sem chave, são usados os preços da seção seguinte.

DrEnvio API key: a chave de API do seu painel da DrEnvio.

Origin country: o código de dois letras do país do endereço de coleta. Padrão: MX. Enviado somente junto com o código postal de origem.

Origin postcode: o código postal de 5 dígitos do endereço de coleta. Deixe em branco para usar o endereço de origem salvo na sua conta da DrEnvio. Um código postal que não tenha 5 dígitos é apagado ao salvar.

MXN exchange rate: a DrEnvio cota em pesos mexicanos. Só é necessário se a moeda da sua loja não for MXN: o valor de 1 MXN na moeda da sua loja, por exemplo 0.05. Sem ela, as tarifas em tempo real não são usadas.

Preços sem tarifa em tempo real

Usados quando não há chave de API ou a DrEnvio não retorna tarifa da Estafeta (API indisponível, código postal desconhecido, nenhum código postal informado ainda). Os preços estão na moeda da sua loja.

Country prices: um país de destino por linha, no formato CC:PRICE, por exemplo MX:150. Use ponto ou vírgula decimal, sem separador de milhar. Partes em outro formato são ignoradas e informadas ao salvar.

Fallback cost: o preço quando não há tarifa em tempo real nem preço por país. Deixe em branco para ocultar o método; 0 significa frete grátis.

Calculation type: Per order cobra o preço uma única vez. Per item (price x number of items) multiplica pelo número de itens enviáveis. Isso vale para Country prices e Fallback cost. Uma tarifa em tempo real da DrEnvio é sempre o preço do pacote inteiro.

Condições

Free shipping from: o frete é grátis quando o subtotal do carrinho atinge este valor. Nesse caso, nenhuma requisição é feita à DrEnvio. Deixe em branco para nunca oferecer frete grátis.

Minimum subtotal: exibe o método somente quando o subtotal do carrinho é pelo menos este valor. Deixe em branco para exibi-lo sempre.

Min weight (kg): o peso mínimo do carrinho para o método aparecer. 0 significa sem limite.

Max weight (kg): o peso máximo do carrinho. O método fica oculto se ele for ultrapassado. Padrão: 30. 0 significa sem limite.

Excluded shipping classes: se algum item do carrinho pertencer a uma destas classes de envio do WooCommerce, o método fica oculto.

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

Disponibilidade sem zonas de envio

Ignore shipping zones: oferece o método para os países abaixo, mesmo sem tê-lo adicionado a uma zona de envio.

Countries: os países de destino para esse modo. Deixe em branco para todos os países. Usado somente quando Ignore shipping zones está ativado.

Avançado

Debug log: registra as requisições à API e o cálculo das tarifas em WooCommerce > Status > Logs, origem vfd-estafeta. Erros da API são sempre registrados. A chave de API e os endereços dos clientes nunca são registrados.

Remove data on uninstall: quando ativado, ao excluir o plugin são removidas todas as suas configurações e os métodos das zonas. Desativar o plugin nunca apaga nada.

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 subtotal mínimo 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 à DrEnvio.

Caso contrário, o plugin envia à DrEnvio o país e o código postal de destino, o peso do carrinho, a quantidade de itens e o subtotal, além do código postal de origem se você tiver definido um. Códigos postais mexicanos precisam ter 5 dígitos; até que o cliente informe um, nenhuma requisição é feita. A DrEnvio retorna as cotações de todas as transportadoras da sua conta. O plugin usa apenas as cotações da Estafeta, ignora preços zero, escolhe a mais barata e a converte para a moeda da sua loja. O serviço da Estafeta e o prazo de entrega são salvos com a linha de envio do pedido e exibidos na tela do pedido no painel administrativo.

Cada resposta fica em cache por 1 hora. Uma requisição com falha ou uma rota sem tarifa da Estafeta é lembrada por 5 minutos, para que uma API lenta ou com problemas nunca trave cada atualização da finalização de compra. O tempo limite da API é de 12 segundos. Nesses casos, o cliente não vê nenhum erro: é usado o preço por país ou o custo de reserva, ou o método fica oculto se nenhum dos dois estiver definido.

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

O plugin calcula apenas tarifas. Ele não cria envios, não imprime etiquetas (guías) nem rastreia pacotes; crie o envio na sua conta da DrEnvio ou da Estafeta. O cliente não pode escolher um serviço específico da Estafeta nem uma agência da Estafeta, e as taxas de câmbio não são atualizadas automaticamente.

Chave de licença

O plugin funciona com uma chave de licença do VibeFox obtida em vibefox.net. O bloco de licença fica no topo de WooCommerce > Settings > Shipping > VibeFox Estafeta. 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 informar outra chave e Remove key para removê-la deste site. O link Manage licenses and domains in your account abre a sua conta no 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 do vibefox.net.

Sem uma chave ativa, a Estafeta não aparece para os clientes na finalização de compra. Administradores 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 de forma automática em segundo plano.

Solução de problemas

A Estafeta não aparece na finalização de compra: verifique se a licença está ativa, se Enable/Disable está ligado e se o método foi adicionado à zona do país do cliente (ou se Ignore shipping zones está ligado e o país está permitido). Confira os avisos no topo da página de configurações, os limites de peso, Minimum subtotal e Excluded shipping classes. Sem chave de API, ou quando a DrEnvio não tem tarifa da Estafeta, o método precisa de um preço por país para o destino ou de um custo de reserva.

As tarifas em tempo real não aparecem: ative o Debug log, recarregue a finalização de compra e abra WooCommerce > Status > Logs, origem vfd-estafeta. O log mostra o motivo: nenhuma chave de API, nenhuma taxa de câmbio para uma loja que não usa MXN, código postal ausente ou inválido, chave de API rejeitada (HTTP 401 ou 403), ou nenhuma tarifa da Estafeta para a rota.

O preço inclui IVA? Depende da sua conta na DrEnvio. Se os preços da DrEnvio já incluem IVA, defina Tax status como None.

As tarifas parecem desatualizadas após uma mudança: salve a página de configurações. Isso limpa as tarifas da DrEnvio 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 do 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 não puder ser acessado, o plugin continua funcionando com o último status conhecido.

Desinstalação

Desativar o plugin mantém todas as configurações e apenas limpa o cache de tarifas. 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 tarifas em cache e os arquivos de log antigos são sempre removidos. As configurações e os métodos de zona são removidos somente se Remove data on uninstall estava ativado. Caso contrário, permanecem para uma futura reinstalação. Os pedidos nunca são alterados, e os pedidos existentes mantêm suas linhas de envio.

Estafeta e DrEnvio são marcas registradas de seus respectivos proprietários. Este plugin não é afiliado nem endossado pela Estafeta ou pela DrEnvio.