VibeFox Omniva for WooCommerce — Ajuda
Requisitos
WordPress: 5.8 ou superior.
WooCommerce: 7.0 ou superior, instalado e ativo. O plugin não é ativado sem ele.
PHP: 8.0 ou superior.
Omniva: não é preciso uma conta de API. A Omniva não tem uma API pública de preços. A API OMX da Omniva está disponível apenas para clientes com contrato e não é usada por este plugin, então você informa os seus próprios preços (de contrato). Registre os pacotes na sua conta empresarial da Omniva.
Parcel machine list: o plugin baixa o arquivo aberto de localizações da Omniva em omniva.ee (não é preciso chave nem contrato). O seu servidor precisa conseguir fazer requisições HTTPS de saída para www.omniva.ee.
Chave de licença VibeFox: comprada em vibefox.net. Uma chave funciona em um único domínio.
Instalação
1. No WordPress, vá em Plugins > Add New > Upload Plugin, escolha o arquivo ZIP do plugin e clique em Install Now. Você também pode enviar a pasta vfd_omniva para /wp-content/plugins/ por FTP.
2. Clique em Activate.
3. Abra as configurações: WooCommerce > Settings > Shipping > VibeFox Omniva, ou clique em Settings abaixo do nome do plugin na página Plugins.
4. Informe a sua chave de licença VibeFox no bloco de licença no topo da página e clique em Activate (veja Chave de licença).
5. Confira os preços por país e tamanho de pacote, os tamanhos dos pacotes e a linha de status Parcel machine list.
6. Adicione VibeFox Omniva à sua zona da Estônia, da Letônia e/ou da Lituânia 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 só página: WooCommerce > Settings > Shipping > VibeFox Omniva. Elas valem para todas as zonas de envio. Quando você adiciona o método a uma zona, a janela da zona tem apenas um campo:
Title (zone): o nome que o cliente vê para esta zona. Deixe vazio para usar o Method title geral.
No topo da página, avisos mostram os problemas. Um aviso vermelho aparece quando nenhum preço está definido ou quando a lista de terminais não pôde ser baixada e não há cópia armazenada, porque então o método não é exibido na finalização de compra. Um aviso amarelo aparece quando a lista não pôde ser atualizada no momento e a cópia armazenada está sendo usada. Números que não podem ser lidos são informados após salvar e não são salvos.
Geral
Enable/Disable: ativa ou desativa a Omniva em todas as zonas de uma vez.
Method title: o nome do método de envio exibido ao cliente. O Title de um método de zona o substitui. Padrão: Omniva parcel machine.
Tax status: Taxable adiciona o imposto do WooCommerce ao custo do envio; None não adiciona.
Preços (na moeda da sua loja; decimais podem ser escritos como 3.50 ou 3,50)
Price by parcel size: uma linha para cada país (Estônia, Letônia e Lituânia), com as colunas S, M, L, XL e Free from. Informe o preço de cada tamanho de pacote da Omniva para o país de destino. Uma célula vazia significa que aquele tamanho não é oferecido no país: o método fica oculto quando o pacote precisa dele. 0 significa grátis. Free from é o total do carrinho (após descontos, como exibido no carrinho) a partir do qual a entrega para aquele país é grátis; deixe vazio para não ter frete grátis. Até você salvar os seus próprios preços, a tabela começa com 3.50 para a Estônia e 4.00 para a Letônia e a Lituânia. Quando os impostos do WooCommerce estão ativados, um pequeno botão -% ao lado de cada preço remove o VAT do país da sua loja do preço informado (para preços que você conhece com VAT incluído).
Calculation: como são determinados o tamanho do pacote e o preço.
Parcel sizes (cm): as dimensões máximas de cada tamanho, como Smallest side, Middle side e Largest side. As dimensões do produto são ordenadas da mesma forma e comparadas lado a lado; os valores são ordenados ao salvar. As dimensões do produto são convertidas da unidade da loja para cm. Produtos sem dimensões cabem no tamanho S. Quando nenhum tamanho serve, o método fica oculto. Padrões: S 9 x 38 x 64, M 19 x 38 x 64, L 38 x 39 x 64, XL 39 x 64 x 64. Confira-os com os tamanhos atuais de pacote da Omniva.
Disponibilidade
Minimum weight (kg): oculta o método quando o carrinho é mais leve. Vazio ou 0 significa sem limite.
Maximum weight (kg): oculta o método quando o carrinho (ou, com Per item, um item) é mais pesado. Os terminais da Omniva aceitam pacotes de até 30 kg. Padrão: 30. 0 significa sem limite. A unidade de peso da loja é convertida para kg.
Minimum cart total: exibe o método apenas a partir deste total do carrinho. Deixe vazio para exibi-lo sempre.
Excluded shipping classes: oculta o método quando o carrinho contém produtos destas classes de envio do WooCommerce.
Ignore shipping zones: oferece a Omniva para os países abaixo sem adicioná-la a uma zona. Quando está desativado, os países são definidos pelas zonas de envio onde o método é adicionado. Recomenda-se deixá-lo desativado.
Countries (without zones): os países de destino para esse modo. Este campo só é usado quando Ignore shipping zones está ativado. Deixe vazio para todos os países de envio. Em qualquer modo, a Omniva só é oferecida onde tem terminais: Estônia, Letônia e Lituânia.
Terminais de encomendas
Post offices: oferece também as agências dos correios da Omniva na mesma lista. A Omniva lista agências dos correios para a Estônia. Desativado por padrão.
City order: exibe primeiro as cidades maiores (Tallinn, Riga, Vilnius e outras) e depois o restante em ordem alfabética. Ativado por padrão. Quando desativado, as cidades são ordenadas alfabeticamente.
Parcel machine list: uma linha de status com o número de terminais por país (e de agências dos correios, se ativadas) e a hora do último download de omniva.ee. Clique em Update the list now para baixar a lista na hora; se omniva.ee não responder, a cópia armazenada é mantida.
Avançado
Debug log: registra detalhes do cálculo de preços e da lista de terminais em WooCommerce > Status > Logs (origem vfd-omniva). Erros, como uma lista de terminais indisponível, são sempre registrados. Nenhum dado de cliente é registrado.
Remove data on uninstall: quando ativado, excluir o plugin remove as configurações, os métodos de zona e a lista de terminais armazenada. Desativar o plugin nunca apaga as configurações. O terminal salvo nos pedidos é mantido.
Como funciona na finalização de compra
Quando o cliente informa um endereço de entrega na Estônia, na Letônia ou na Lituânia, o WooCommerce pede uma tarifa ao plugin. O plugin verifica o peso do carrinho, o total mínimo e as classes de envio excluídas, e então determina o tamanho do pacote pelas dimensões do produto. Se o pacote não couber em nenhum tamanho, ou se o tamanho não tiver preço para o país, ou se nenhum terminal estiver disponível, o método é ocultado, para que o cliente nunca veja uma finalização de compra que não possa ser concluída. Se o total do carrinho atingir o Free from do país, o preço é 0. O tamanho do pacote é salvo na linha de envio do pedido como Omniva parcel size.
A lista de terminais é baixada de omniva.ee uma vez por dia e armazenada no banco de dados do WordPress, não na pasta do plugin. Se o download falhar, a cópia armazenada continua funcionando e a próxima tentativa é feita após 15 minutos, para que a finalização de compra não espere por omniva.ee a cada atualização. O tempo limite do download é de 15 segundos.
O método funciona na finalização de compra clássica e nos blocos Carrinho e Finalização de compra. É compatível com o WooCommerce High-Performance Order Storage (HPOS). Os preços estão na moeda da sua loja. O plugin não converte moedas.
O plugin não solicita preços à Omniva, não registra envios, não imprime etiquetas, não chama um courier nem rastreia encomendas. Registre os pacotes na sua conta empresarial da Omniva. A entrega porta a porta por courier não faz parte deste método.
Terminais de encomendas
Quando o cliente seleciona a Omniva, duas listas aparecem abaixo do método: -- Select city -- e -- Select parcel machine --. Só são exibidas cidades e terminais do país de entrega; quando o cliente troca de país, as listas também mudam. Na Estônia, as cidades são condados, com Tallinn, Tartu e Pärnu listadas separadamente; na Letônia e na Lituânia são cidades e municípios. A cidade do endereço de entrega é pré-selecionada quando corresponde a uma cidade da lista. Cada terminal é exibido com o nome e o endereço. A escolha fica guardada durante a finalização de compra, então não se perde quando a finalização é atualizada.
O terminal é obrigatório. Na finalização de compra clássica, o cliente vê Please select an Omniva parcel machine. Na finalização de compra em blocos, Place order fica bloqueado até que um terminal seja escolhido. Em ambas, o servidor verifica o terminal novamente contra a lista, então um ID forjado ou um terminal de outro país é recusado.
O ID, o nome, a cidade e o país do terminal são salvos no pedido. Eles aparecem na tela do pedido abaixo do endereço de entrega (com o ID do terminal), na página de pedido recebido, em My account > Orders e nos e-mails do pedido (HTML e texto simples) como Omniva parcel machine.
Para alterar o terminal de um pedido, abra o pedido em WooCommerce > Orders, clique em Change ao lado do terminal, escolha uma cidade e um terminal do país de entrega do pedido e clique em Save parcel machine. Uma nota do pedido registra o terminal antigo e o novo.
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 Omniva. 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 na 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 na sua conta na vibefox.net.
Sem uma chave ativa, a Omniva 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 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 precisam de renovação. O status é verificado novamente automaticamente em segundo plano.
Solução de problemas
A Omniva não aparece na finalização de compra: verifique se a licença está ativa, se Enable/Disable está ligado, se o país de entrega é Estônia, Letônia ou Lituânia 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). Abra a página de configurações: um aviso vermelho explica se nenhum preço está definido ou se nenhuma lista de terminais está disponível. Verifique também as dimensões dos produtos (um pacote maior que o tamanho XL, ou um tamanho com célula de preço vazia, oculta o método), os limites de peso, o Minimum cart total e as Excluded shipping classes. Com o Debug log ativado, WooCommerce > Status > Logs (origem vfd-omniva) mostra por que o método foi ocultado.
Nenhum terminal de encomendas: a lista não pôde ser baixada de omniva.ee e não há cópia armazenada. O plugin tenta novamente a cada 15 minutos. Clique em Update the list now; se falhar, verifique se o seu servidor consegue acessar www.omniva.ee e veja o erro em WooCommerce > Status > Logs.
Um terminal novo está faltando: a lista é atualizada uma vez por dia. Clique em Update the list now para baixá-la imediatamente.
O preço cobrado está errado: o preço depende do tamanho do pacote determinado pelas dimensões do produto. Verifique as dimensões dos produtos, Calculation e Parcel sizes (cm). Com o Debug log ativado, o log mostra o tamanho escolhido e o preço.
O cliente não consegue concluir o pedido: é preciso escolher um terminal. Se o cliente vir a mensagem «The Omniva parcel machine list is temporarily unavailable», no momento não há terminais disponíveis; veja «Nenhum terminal de encomendas».
Em qual moeda estão os preços: na moeda da sua loja. O plugin não converte moedas.
Para desenvolvedores: o filtro vfd_omniva_locations_url altera o endereço do arquivo de localizações (CSV no formato da Omniva), e vfd_omniva_countries altera a lista de países de destino (padrão EE, LV, LT).
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 na 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 a lista de terminais armazenada. Para removê-lo, desative-o e exclua-o na página Plugins. A chave de licença, o status da licença deste plugin e os caches são sempre removidos. Configurações, métodos de zona e a lista de terminais armazenada só são removidos se Remove data on uninstall estava ativado. Caso contrário, permanecem para uma reinstalação posterior. O terminal salvo nos pedidos nunca é excluído, e os pedidos existentes mantêm suas linhas de envio.
A Omniva é uma marca de seu respectivo proprietário. Este plugin não é afiliado à Omniva nem por ela endossado.