VibeFox Econt 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.
Econt: não é preciso contrato nem chave de API. A lista de escritórios é uma nomenclatura pública da Econt. Apenas o código do país é enviado à Econt, nenhum dado do cliente. Preencha um usuário e senha do e-Econt somente se a Econt pedir autorização para o seu site. O login do e-Econt é descrito na página para desenvolvedores da Econt (econt.com/developers).
Chave de licença VibeFox: comprada em vibefox.net. Uma chave funciona em um 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_econt para /wp-content/plugins/ por FTP.
2. Clique em Activate.
3. Abra as configurações: WooCommerce > Settings > Shipping > VibeFox Econt, ou clique em Settings abaixo do nome do plugin na página Plugins.
4. Insira a sua chave de licença VibeFox no bloco de licença no topo da página e clique em Activate.
5. Defina os valores por país e confira as outras opções (veja a seção Configuração). Clique em Load offices from Econt now para testar a conexão.
6. Adicione VibeFox Econt a uma zona de envio com Bulgária e/ou Romênia em WooCommerce > Settings > Shipping > Shipping zones, ou ative Ignore zones e escolha os países.
Configuração
Todas as configurações ficam em uma única página: WooCommerce > Settings > Shipping > VibeFox Econt. O valor e as condições se aplicam a 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 que os clientes veem nesta zona. Deixe vazio para usar o Name global.
No topo da página, o plugin mostra avisos: a API de demonstração está ativada, não há valor definido para a Bulgária ou a Romênia (então o método nunca é exibido), ou a última consulta de escritórios de um país falhou. Campos numéricos aceitam vírgula decimal, por exemplo 5,99. Um valor que não é número é ignorado e informado ao salvar.
Geral
Enable/Disable: ativa ou desativa a entrega Econt em todas as zonas de uma vez. Padrão: ativado.
Name: o nome do método de envio exibido na finalização de compra. Um Title definido na zona o substitui. Padrão: Econt Express.
Tax status: Taxable adiciona o imposto do WooCommerce ao custo do envio, None não adiciona. Padrão: Taxable.
Lista de escritórios da Econt
Escritórios e Econtomats são carregados da API da Econt e ficam em cache por 24 horas.
Demo API: usa a API de demonstração da Econt com dados de teste. Mantenha-a desativada em uma loja em operação. Os escritórios de demonstração têm IDs diferentes dos reais. No modo de demonstração, a conta de teste pública da Econt é usada quando não há login definido.
Econt username: opcional. Seu login do e-Econt para a autorização HTTP Basic.
Econt password: opcional. É armazenada no banco de dados do WordPress e nunca é gravada no log.
Office list: mostra quantos escritórios estão em cache por país e quando foram carregados. O botão Load offices from Econt now recarrega as listas na hora e exibe o resultado. Se um carregamento falhar, são mantidos os escritórios do último carregamento bem-sucedido. Sem este botão, a lista é carregada automaticamente na primeira finalização de compra. Ao alterar Demo API, o usuário ou a senha, as listas em cache são apagadas.
Seletor de escritório na finalização de compra
Show: quais pontos o cliente pode escolher.
City order: mostra primeiro as cidades maiores (Sofia, Plovdiv, Varna, Bucareste e outras). Quando desativado, as cidades são ordenadas em ordem alfabética. Padrão: ativado.
City list width: a largura CSS da lista de cidades na finalização de compra clássica, por exemplo 100% ou 300px. Padrão: 100%.
Office list width: a largura CSS da lista de escritórios na finalização de compra clássica, por exemplo 100% ou 400px. Padrão: 100%.
Valores (na moeda da sua loja)
O plugin não consulta a Econt por tarifas em tempo real. A Bulgária usa o euro desde 1º de janeiro de 2026, então uma loja búlgara normalmente informa valores em EUR.
Price per country: um país por linha (ou separados por vírgula): código do país, dois-pontos e valor, por exemplo BG:5.99 e RO:8.99 (são os padrões). A vírgula decimal também funciona: BG:5,99. Um valor de 0 significa entrega grátis. Entradas em outro formato são ignoradas e listadas em uma mensagem de erro ao salvar.
Calculation: Per order cobra o valor uma única vez. Per item (price x quantity) multiplica pelo número de itens enviáveis no carrinho.
Price for other countries: usado para um país da Econt (Bulgária ou Romênia) que não esteja listado acima. Vazio ou 0 oculta o método nesse país.
Condições
Free shipping from: o subtotal do carrinho a partir do qual a entrega é grátis. Deixe vazio para nunca oferecer entrega grátis.
Minimum subtotal: exibe o método somente quando o subtotal do carrinho for pelo menos este valor. Deixe vazio para exibi-lo sempre.
Minimum weight (kg): oculta o método para carrinhos mais leves. Os pesos dos produtos são convertidos da unidade da loja para kg. Deixe vazio para não ter limite.
Maximum weight (kg): oculta o método para carrinhos mais pesados. Deixe vazio para não ter limite.
Hide for shipping classes: oculta o método se o carrinho tiver um produto de uma destas classes de envio do WooCommerce.
Disponibilidade sem zonas de envio
Ignore zones: oferece também a Econt nos países abaixo quando nenhuma zona a adiciona. As zonas que contêm o método continuam funcionando normalmente.
Countries: Bulgária e/ou Romênia. Usado somente com Ignore zones. Deixe vazio para todos os países da Econt para os quais a sua loja envia.
Avançado
Debug log: grava mensagens de depuração em WooCommerce > Status > Logs, origem vfd-econt. Erros da API são sempre registrados. Senhas e dados de clientes não são gravados.
Remove data on uninstall: quando ativado, excluir o plugin remove as configurações da Econt e os métodos das zonas. Desativar o plugin nunca apaga as configurações. Os escritórios salvos nos pedidos são sempre mantidos.
Como funciona na finalização de compra
O método é oferecido somente para a Bulgária e a Romênia. Quando o cliente informa um endereço de entrega, o plugin verifica o peso do carrinho, o subtotal mínimo e as classes de envio ocultas, e então usa o valor do país. Se o subtotal do carrinho atingir Free shipping from, o valor é 0. Se não houver lista de escritórios disponível para o país, o método é ocultado, porque a entrega sempre é feita em um escritório.
Quando o cliente seleciona a Econt, aparecem duas listas abaixo do método: City e Office / Econtomat. A lista de escritórios é carregada uma vez por página. Os Econtomats são marcados na lista. A escolha fica salva durante a sessão. Se a lista de escritórios não puder ser carregada, o cliente vê uma mensagem para tentar novamente em alguns minutos ou escolher outro método de envio.
O cliente não consegue concluir o pedido sem escolher um escritório. No servidor, o plugin verifica novamente se o escritório existe na lista da Econt para o país de envio. O nome do escritório é sempre obtido da lista da Econt, nunca do navegador. Isso funciona na finalização de compra clássica e na finalização em blocos. O plugin é compatível com o HPOS (armazenamento de pedidos de alta performance) do WooCommerce.
A lista de escritórios fica em cache por 24 horas. Se a Econt não responder, a última lista válida é usada e a Econt não é consultada de novo por 10 minutos. O tempo limite da API é de 15 segundos.
O plugin usa somente valores fixos. Ele não consulta a Econt por tarifas em tempo real, não gera conhecimentos de transporte nem etiquetas, não solicita coletas de courier, não rastreia encomendas, não faz cobrança na entrega e não entrega em endereço. Somente a Bulgária e a Romênia têm lista de escritórios.
Pontos de retirada
O escritório escolhido é salvo com o pedido: a cidade, o nome e o endereço do escritório e o código do escritório Econt. Use o código do escritório ao criar a remessa no e-Econt.
Tela do pedido no administrador: o escritório e o código do escritório aparecem abaixo do endereço de entrega. Clique em Change para carregar a lista de escritórios e escolher outra cidade e outro escritório. A alteração é salva na hora, e uma nota do pedido registra o escritório antigo e o novo.
Cliente: o escritório aparece na página de pedido do cliente e na página de agradecimento, e nos e-mails de pedido (HTML e texto simples).
Os nomes dos escritórios são exibidos no idioma local (cirílico para a Bulgária) quando o idioma do site é o búlgaro ou o romeno, e em inglês nos demais casos.
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 Econt. 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 domínio. Remover a chave de um site não libera a vaga do domínio. Libere-a na sua conta da vibefox.net.
Sem uma chave ativa, a Econt não é exibida aos clientes na finalização de compra. Os 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 aviso aparece na página 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 Econt não aparece na finalização de compra: verifique se a licença está ativa, se Enable/Disable está ativado, se o país de entrega é a Bulgária ou a Romênia e se o método foi adicionado à zona desse país (ou se Ignore zones está ativado e o país é permitido). Verifique se há um valor definido para o país, os limites de peso, Minimum subtotal e Hide for shipping classes. Confira a linha Office list nas configurações: o método fica oculto enquanto não houver lista de escritórios para o país.
A lista de escritórios não carrega: clique em Load offices from Econt now e leia o resultado, ou o aviso no topo da página de configurações. Os erros são gravados em WooCommerce > Status > Logs, origem vfd-econt. Se a Econt exigir autorização para o seu site, preencha Econt username e Econt password.
Os clientes veem escritórios de teste: a Demo API está ativada. Desative-a em uma loja em operação.
Em qual moeda estão os valores? Na moeda da sua loja.
Outros países: desenvolvedores podem adicionar países com o filtro vfd_ecn_countries (código de 2 letras mapeado para um código de 3 letras).
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 da 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 apaga apenas o cache de escritórios. 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, assim como as listas de escritórios em cache, são sempre removidos. As configurações e os métodos das zonas são removidos somente se Remove data on uninstall estava ativado. Caso contrário, permanecem para uma reinstalação futura. Os escritórios salvos nos pedidos são sempre mantidos, e os pedidos existentes mantêm suas linhas de envio.
A Econt é uma marca registrada de seu respectivo proprietário. Este plugin não é afiliado nem endossado pela Econt.