VibeFox GIG Logistics for WooCommerce — Ajuda

Requisitos

WordPress: 5.8 ou superior.

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

PHP: 8.0 ou superior.

Credenciais da API da GIG Logistics (somente para preços em tempo real): os preços em tempo real usam a API de terceiros da GIG Logistics. A GIG Logistics fornece a clientes empresariais um nome de usuário da API (geralmente um e-mail) e uma senha. Solicite-os na página para desenvolvedores da GIG Logistics (giglogistics.com/developer). Credenciais de teste funcionam somente com a API de teste. Se você usa apenas a tabela de preços e o custo de reserva, não precisa de credenciais da API.

Chave de licença VibeFox: comprada em vibefox.net. Uma chave funciona em um 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_gig_logistics para /wp-content/plugins/ por FTP.

2. Clique em Activate.

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

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

5. Preencha a tabela de preços e/ou o custo de reserva. Para preços em tempo real, informe também o nome de usuário e a senha da API, o telefone do remetente, a cidade e o estado de coleta, e a taxa de conversão de moeda se a moeda da sua loja não for NGN (veja Configuração).

6. Adicione VibeFox GIG Logistics a uma zona de entrega para a Nigéria 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 GIG Logistics. Elas valem para todas as zonas de entrega. Quando você adiciona o método a uma zona, a janela da zona tem apenas um campo:

Title (zone): o nome que os clientes veem nesta zona. Deixe vazio para usar o Method title geral.

Acima dos campos, a página mostra avisos quando os preços em tempo real não podem ser usados: apenas um entre o nome de usuário e a senha da API está preenchido, Sender phone ou a cidade e o estado de coleta estão faltando, ou a moeda da loja não é NGN e nenhuma Currency conversion rate está definida. Sempre que você salva as configurações, os preços e tokens de API em cache são apagados.

General

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

Method title: o nome do método de entrega exibido no carrinho e na finalização de compra. Padrão: GIG Logistics. O título de uma zona o substitui.

Tax status: Taxable adiciona o imposto de entrega da sua loja ao custo, None não adiciona. Escolha None se o preço da GIG já incluir tudo o que você quer cobrar.

API da GIG Logistics (preços em tempo real) (opcional)

Com credenciais da API, o preço é solicitado à GIG Logistics para cada endereço na Nigéria. Sem credenciais, ou quando a API não retorna preço, são usados a tabela de preços e o custo de reserva.

API username: seu nome de usuário da API de terceiros da GIG Logistics, geralmente seu e-mail.

API password: sua senha da API de terceiros da GIG Logistics. Ela é usada apenas para fazer login na API e nunca é registrada em log.

Test mode: usa a API de teste (dev) da GIG Logistics. Credenciais de teste funcionam somente com a API de teste. Desative para obter preços reais. Padrão: desativado.

Currency conversion rate: a GIG Logistics retorna os preços em NGN. Se a moeda da sua loja não for NGN, informe quanto vale 1 NGN na moeda da sua loja (1 NGN = ? da sua moeda, por exemplo 0.0006). Sem ela, os preços em tempo real da GIG não são usados. Se a moeda da sua loja for NGN, este campo não é necessário. Tanto o ponto quanto a vírgula são aceitos como separador decimal.

Endereço de coleta (remetente)

Onde a GIG Logistics coleta as encomendas, na Nigéria. Se a sua loja estiver na Nigéria, os campos de rua, cidade e estado vazios usam o endereço da loja em WooCommerce > Settings > General.

Sender name: o nome do remetente enviado à GIG Logistics. Vazio significa o nome do site.

Sender phone: seu número de telefone, por exemplo 08030000000. A GIG Logistics exige para preços em tempo real.

Street address: o endereço da rua de coleta.

City / area: a cidade ou bairro de coleta, por exemplo Victoria Island. Obrigatório para preços em tempo real.

State: o estado nigeriano do endereço de coleta. Por padrão, é usado o estado da loja. Obrigatório para preços em tempo real.

Pickup latitude: latitude opcional do ponto de coleta no mapa, por exemplo 6.4281. A GIG Logistics calcula o preço por distância. Vazio significa que as coordenadas são obtidas a partir do endereço.

Pickup longitude: longitude opcional do ponto de coleta no mapa, por exemplo 3.4219.

Address lookup: encontra as coordenadas no mapa dos endereços com o OpenStreetMap (Nominatim). A GIG Logistics calcula o preço a partir das coordenadas de coleta e entrega. A rua, a cidade e o estado do cliente são enviados para nominatim.openstreetmap.org, e os resultados ficam em cache por 30 dias. Sem esta opção, apenas o texto do endereço é enviado, e a GIG Logistics pode não retornar um preço. Padrão: ativado.

Tabela de preços e custo de reserva

Usados para outros países, quando os preços em tempo real não estão configurados ou quando a GIG Logistics não retorna um preço. Os preços estão na moeda da sua loja.

Country prices: uma tabela com um preço base por país. Clique em Add country para adicionar uma linha e no X para remover uma. Escolha * Any other country para todos os países sem linha própria. As colunas XS (até 1 kg), S (até 2 kg), M (até 3 kg), L (até 5 kg) e XL (acima de 5 kg) são preços opcionais por faixa de peso: um preço de faixa acima de 0 substitui o preço base nos carrinhos dessa faixa. Preço 0 significa entrega grátis. Células de preço vazias são salvas como 0, então preencha o preço base de cada linha que adicionar. Países sem linha (quando não há linha *) não recebem preço de tabela.

Fallback cost: usado quando nem a GIG Logistics nem a tabela fornecem um preço. Vazio significa que o método fica oculto nesse caso.

Table / fallback price is: Per order cobra o preço uma vez. Per item (multiplied by the number of items) o multiplica pelo número de itens do carrinho. Os preços da GIG em tempo real são sempre para o pedido inteiro.

Condições

Free shipping from: o subtotal do carrinho a partir do qual a entrega é grátis. Vazio significa nunca grátis.

Minimum subtotal: exibe o método somente quando o subtotal do carrinho atinge este valor. Vazio significa sempre.

Min weight (kg): o peso mínimo do carrinho em kg. Os pesos dos produtos são convertidos a partir da unidade de peso da sua loja. 0 significa sem limite.

Max weight (kg): o peso máximo do carrinho em kg. Padrão: 30. 0 significa sem limite.

Excluded shipping classes: oculta o método se o carrinho contiver produtos destas classes de entrega do WooCommerce.

Disponibilidade sem zonas de entrega

Ignore shipping zones: oferece o método para os países abaixo, mesmo que ele não esteja adicionado a uma zona. Quando desativado, o método aparece somente nas zonas de entrega às quais foi adicionado.

Countries: os países de destino para esse modo. Vazio significa todos os países para os quais você envia. Usado somente com Ignore shipping zones.

Avançado

Debug log: registra os cálculos de preço em WooCommerce > Status > Logs, origem vfd-gig-logistics. Erros da API são sempre registrados, mesmo com o log desativado. Senhas, tokens e endereços de clientes não são gravados.

Remove data on uninstall: quando ativado, excluir o plugin remove suas configurações, métodos de zona e caches. 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 um preço ao plugin. O plugin verifica primeiro as condições: país de entrega, peso do carrinho, subtotal mínimo e classes de entrega excluídas. Se o subtotal atingir Free shipping from, o método é exibido com preço 0, mas somente se o país tiver um preço: uma linha em Country prices, um Fallback cost ou um preço da GIG Logistics em tempo real. A GIG Logistics só é consultada quando a tabela e o custo de reserva não fornecem preço.

Em seguida, o preço é obtido da primeira fonte que fornecer um. Primeiro, o preço da GIG Logistics em tempo real, se as credenciais da API estiverem informadas, o endereço estiver na Nigéria, o cliente tiver informado uma cidade ou estado, o telefone, a cidade e o estado de coleta estiverem definidos e, para lojas que não usam NGN, houver uma taxa de conversão. O plugin faz login na API da GIG Logistics e envia os endereços e coordenadas de coleta e entrega e os itens do carrinho com nomes, quantidades, pesos e valores. Produtos sem peso são enviados como 1 kg. O preço é solicitado para entrega de bike. Segundo, a tabela Country prices. Terceiro, o Fallback cost. Se nenhuma fonte fornecer um preço, o método fica oculto para aquele carrinho.

Cada resposta da GIG fica em cache por 1 hora, para que o mesmo carrinho não dispare uma nova solicitação. Uma solicitação ou um login com falha ficam em cache por 10 minutos, para que a finalização de compra não espere pela GIG Logistics a cada atualização. O token de login é mantido por 30 minutos e renovado automaticamente quando a GIG o rejeita. O tempo limite da API é de 10 segundos, e o da busca de endereço, de 5 segundos.

Se a GIG Logistics retornar um erro ou um preço zero, o cliente não vê nenhum erro. O preço da tabela ou o custo de reserva é usado, e o erro é gravado no log.

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 High-Performance Order Storage (HPOS) do WooCommerce.

O plugin calcula apenas preços. Ele não cria envios, conhecimentos de transporte ou etiquetas da GIG Logistics, não agenda coletas, não rastreia encomendas e não permite que os clientes escolham um centro de atendimento. Os pedidos são enviados pela sua conta da GIG Logistics normalmente. Preços em tempo real são solicitados somente para endereços na Nigéria. Para outros países, use a tabela de preços.

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 GIG Logistics. 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 sua conta no vibefox.net.

Uma chave funciona em um 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 GIG Logistics não é exibida aos clientes na finalização de compra. 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. 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 GIG Logistics 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 limites de peso, Minimum subtotal e Excluded shipping classes. Verifique se a tabela (o país ou *) ou o Fallback cost fornece um preço para o país.

O preço vem da tabela, não da GIG Logistics: os preços em tempo real exigem nome de usuário e senha da API, Sender phone, cidade e estado de coleta, um endereço de entrega na Nigéria com cidade ou estado e, para lojas que não usam NGN, a Currency conversion rate. Veja os avisos no topo da página de configurações. Ative o Debug log, recarregue a finalização de compra e abra WooCommerce > Status > Logs, origem vfd-gig-logistics, para ver o motivo. Uma solicitação com falha é repetida após 10 minutos.

Login failed no log: a GIG Logistics rejeitou o nome de usuário ou a senha da API. Confira-os e verifique o Test mode: credenciais de teste funcionam somente com a API de teste. Salve as configurações para tentar novamente imediatamente.

A GIG Logistics não retorna preço: a GIG calcula preços por distância. Mantenha o Address lookup ativado ou informe Pickup latitude e Pickup longitude. Confirme os preços com a sua conta da GIG Logistics antes de entrar em produção.

O imposto é cobrado sobre o preço da GIG: defina Tax status como None se o preço da GIG já incluir tudo o que você quer cobrar.

Os preços parecem desatualizados após uma mudança: salve a página de configurações. Isso limpa os preços e tokens em cache.

Geocodificador próprio: desenvolvedores podem fornecer a própria busca de endereços com o filtro vfd_gigl_pre_geocode.

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 todos os dados. 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 são sempre removidos. Configurações, métodos de zona, preços em cache, tokens e buscas de endereço são removidos somente se Remove data on uninstall estava ativado. Caso contrário, permanecem para uma eventual reinstalação. Pedidos existentes mantêm suas linhas de entrega.

GIG Logistics é uma marca registrada de seu respectivo proprietário. Este plugin não é afiliado nem endossado pela GIG Logistics.