VibeFox Econt for PrestaShop — Ajuda
Requisitos
PrestaShop: 8.0 a 9.x.
PHP: 8.0 ou superior. O módulo não é instalado em versões anteriores do PHP.
Econt: não é preciso contrato nem chave de API. A lista de escritórios é uma nomenclatura pública da Econt. Somente o código do país é enviado à Econt, sem dados de clientes. Preencha um usuário e uma senha do e-Econt apenas se a Econt pedir autorização para a sua loja. 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 back office, vá em Modules > Module Manager e clique em Upload a module. Escolha o arquivo ZIP do módulo.
2. Quando o envio terminar, clique em Configure ou, depois, encontre VibeFox Econt na lista de módulos e clique em Configure.
3. Insira a sua chave de licença VibeFox em License key, no bloco de licença no topo da página Configure, e clique em Activate (veja Chave de licença).
4. Defina os valores por país e verifique as outras opções (veja Configuração) e depois clique em Save. Clique em Load offices from Econt now para testar a conexão.
Ao instalar, o módulo cria a transportadora Econt Express com o texto de prazo de entrega Delivery to an Econt office or Econtomat. A transportadora é atribuída às zonas da Bulgária e da Romênia e a todos os grupos de clientes. Você pode alterar zonas, grupos de clientes, prazo de entrega, logotipo e limites de tamanho em Shipping > Carriers. Não defina preços lá: o preço sempre vem do módulo.
Configuração
Todas as configurações estão na página do módulo: Modules > Module Manager > VibeFox Econt > Configure. Cada seção tem seu próprio botão Save, que salva a página inteira. O valor e as condições se aplicam a todas as zonas da transportadora.
No topo da página, o módulo mostra avisos: transportadora Econt não encontrada, API de demonstração ativada, nenhum valor definido para a Bulgária ou a Romênia (nesse caso a transportadora nunca aparece), a última consulta de escritórios de um país falhou, ou a unidade de peso da sua loja não é reconhecida pelo módulo (nesse caso os pesos são considerados em kg; defina a unidade em International > Localization, Local units). Os campos numéricos aceitam vírgula decimal, por exemplo 5,99. Se um campo numérico contiver algo que não seja um número ou um número negativo, ou se Minimum weight (kg) for maior que Maximum weight (kg), um erro indica o campo e nada é salvo.
Geral
Enable/Disable: liga ou desliga a entrega Econt. É a mesma chave do status da transportadora em Shipping > Carriers.
Name: o nome da transportadora exibido no carrinho e na finalização de compra. Padrão: Econt Express. Obrigatório, no máximo 64 caracteres.
Tax: a regra de imposto da transportadora, ou No tax. O PrestaShop adiciona este imposto sobre os valores abaixo. Com No tax, os valores são finais.
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 desligada em uma loja em produção. Os escritórios de demonstração têm IDs diferentes dos reais. No modo demo, a conta de teste pública da Econt é usada quando nenhum login está definido.
Econt username: opcional. Seu login do e-Econt para a autorização HTTP Basic.
Econt password: opcional. Armazenada no banco de dados da loja e nunca gravada no log. Depois de salvar, o campo fica vazio e mostra Saved - leave empty to keep it. Digite um novo valor apenas para alterá-lo. Marque Remove the saved password e salve para excluí-la.
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 imediatamente e mostra o resultado por país. Se um carregamento falhar, são mantidos os escritórios do último carregamento bem-sucedido. Sem esse botão, a lista é carregada automaticamente na primeira finalização de compra. Alterar Demo API, o usuário ou a senha limpa as listas em cache.
Seletor de escritório na finalização de compra
Show: quais pontos os clientes podem escolher.
City order: mostra primeiro as cidades maiores (Sofia, Plovdiv, Varna, Bucareste e outras). Quando desligada, as cidades são ordenadas em ordem alfabética. Padrão: ligada.
City list width: a largura CSS da lista de cidades, por exemplo 100% ou 300px. Padrão: 100%.
Office list width: a largura CSS da lista de escritórios, por exemplo 100% ou 400px. Padrão: 100%.
Valores (o título da seção mostra a moeda padrão da sua loja)
Os valores estão na moeda padrão da sua loja, sem impostos. O módulo não consulta a Econt por tarifas em tempo real. A Bulgária usa o euro desde 1º de janeiro de 2026, por isso 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, valor, por exemplo BG:5.99 e RO:8.99 (são os padrões). Vírgula decimal também funciona: BG:5,99. Um valor de 0 significa entrega grátis. Se o campo estiver vazio, são usados os valores padrão BG:5.99 e RO:8.99 (com Ignore zones, os países fora das zonas da transportadora não recebem valor nesse caso). Entradas em outro formato são ignoradas e listadas em um aviso ao salvar. O restante é salvo.
Calculation: Per order cobra o valor uma vez. Per item (price x quantity) multiplica pelo número de itens que precisam de envio.
Price for other countries: usado para um país da Econt (Bulgária ou Romênia) que não está listado acima. Vazio ou 0 oculta a transportadora nesse país.
Condições
Subtotal do carrinho significa os produtos que precisam de envio, após descontos e antes dos impostos.
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: mostra a transportadora somente quando o subtotal do carrinho for pelo menos este valor. Deixe vazio para sempre mostrar.
Minimum weight (kg): oculta a transportadora para carrinhos mais leves. Os pesos dos produtos são convertidos da unidade de peso da loja para kg. Deixe vazio para não ter limite.
Maximum weight (kg): oculta a transportadora para carrinhos mais pesados. Deixe vazio para não ter limite.
Disponibilidade sem zonas de envio
Ignore zones: oferecer também a Econt nos países abaixo quando a zona do endereço de entrega não estiver vinculada à transportadora. Ao ligar, a transportadora é vinculada a todas as zonas ativas, e as zonas criadas depois também são vinculadas. Ao desligar novamente, a transportadora volta a ter as zonas que tinha antes. As zonas que estavam vinculadas continuam funcionando normalmente. A Econt continua sendo oferecida apenas para a Bulgária e a Romênia.
Countries: Bulgária e/ou Romênia. Usado somente com Ignore zones. Se nenhum estiver marcado, valem todos os países da Econt para os quais a loja envia.
Avançado
Debug log: grava mensagens de depuração em logs/vfd_ecn_debug.log.php, na pasta do módulo. O arquivo não pode ser aberto pela web. Erros da API são sempre registrados. Senhas e dados de clientes não são gravados.
Log: mostra o tamanho e as últimas entradas do log. Clique em Clear log para esvaziá-lo.
Remove data on uninstall: quando ligada, a desinstalação do módulo apaga as configurações da Econt, a transportadora e o log. Quando desligada, as configurações são mantidas para uma nova instalação. Escritórios salvos em pedidos são sempre mantidos.
Como funciona na finalização de compra
A transportadora só é oferecida para a Bulgária e a Romênia. Na etapa de entrega, o PrestaShop pede ao módulo o valor da Econt. Só contam os produtos físicos: produtos virtuais não somam peso e não entram no subtotal. O módulo verifica os limites de peso e o subtotal mínimo e então pega 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, a transportadora fica oculta, porque a entrega é sempre feita em um escritório. O valor é calculado na moeda padrão e depois exibido na moeda do carrinho do cliente.
Quando o cliente seleciona a Econt, aparecem duas listas abaixo da transportadora: City e Office / Econtomat. A lista de escritórios é carregada uma vez por página, somente quando a Econt está selecionada. Os Econtomats aparecem marcados na lista. A escolha é salva no carrinho imediatamente. Se a lista de escritórios não puder ser carregada, o cliente vê Econt offices cannot be loaded right now. Please try again in a few minutes or choose another shipping method.
Quando o cliente clica em Continue na etapa de entrega, o módulo verifica no servidor se um escritório foi escolhido e se ele existe na lista da Econt para o país de entrega (filtrada por Show). Sem escritório, o cliente vê Please select an Econt office or Econtomat. Um escritório que não está na lista é recusado com The selected Econt office is not available for the shipping country. Please select it again. O nome do escritório é sempre obtido da lista da Econt, não do navegador. O seletor funciona com o tema Classic e com o Hummingbird.
A lista de escritórios fica em cache por 24 horas, separadamente para a API ao vivo e para a API de demonstração. Se a Econt não responder, a última lista válida é usada e a Econt não é consultada novamente por 10 minutos. O tempo limite da API é de 15 segundos. A lista de escritórios vem de https://ee.econt.com/services/ (ao vivo) ou https://demo.econt.com/ee/services/ (demo).
Se você editar a transportadora em Shipping > Carriers depois que ela tiver pedidos, o PrestaShop a salva como uma nova versão da transportadora. O módulo acompanha a nova versão automaticamente.
O módulo usa apenas valores fixos. Não consulta a Econt por tarifas em tempo real, não gera conhecimentos de transporte ou 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
Ao fazer o pedido, o escritório escolhido para o carrinho é salvo com ele: 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.
Página do pedido no back office: um bloco Econt office / Econtomat mostra o escritório e o Office code. Em Change, escolha outra cidade e outro escritório do país do pedido e clique em Save. A alteração é salva imediatamente e uma mensagem privada do pedido registra o escritório antigo e o novo. Se você clicar em Save sem escolher um escritório, o bloco diz Select a city and an office first - nothing was changed. Qualquer funcionário que possa editar pedidos pode alterar o escritório; não é preciso acesso à página do módulo. Se a lista de escritórios não puder ser carregada, o bloco mostra Econt offices cannot be loaded right now.
Vários pedidos do mesmo carrinho: o escritório pertence ao primeiro pedido. Outro pedido feito a partir do mesmo carrinho não recebe escritório: um erro é gravado no log, e o bloco dele informa que o escritório deste carrinho pertence a outro pedido. Combine o escritório com o cliente e crie a remessa manualmente no e-Econt.
Cliente: o escritório é exibido na página de pedido do cliente e na página de confirmação do pedido, e é acrescentado ao nome da transportadora no e-mail de confirmação do pedido e no e-mail de novo pedido enviado à loja.
Os nomes dos escritórios são exibidos no idioma local (cirílico para a Bulgária) quando o idioma da loja é o búlgaro ou o romeno, e em inglês nos demais casos.
Chave de licença
O módulo funciona com uma chave de licença VibeFox obtida em vibefox.net. O bloco de licença License — VibeFox Econt é o primeiro bloco em Modules > Module Manager > VibeFox Econt > Configure, acima das configurações. Insira a chave em License key e clique em Activate. Depois disso, o bloco mostra a chave mascarada, o status (por exemplo, a data até a qual a licença está ativa e o seu domínio) e os botões Check now para verificar o status novamente, Change key para inserir outra chave e Remove key para remover a chave desta loja. Abaixo deles estão a linha Product: presta-shipping-econt e o link Manage licenses and domains in your account, que abre a sua conta vibefox.net. Somente funcionários com a permissão Configure para o módulo podem alterar a chave. Os textos do bloco seguem o idioma do back office (inglês e russo estão incluídos).
Se a chave não for aceita, o bloco informa o motivo, por exemplo Key not found, This key belongs to another product, Domain limit reached ou License expired on seguido de uma data. Depois que o endereço da loja mudar, ou depois que você liberar uma vaga de domínio na sua conta, clique em Check now. Se o servidor de licenças não puder ser acessado, o módulo continua funcionando com o último status conhecido.
Uma chave funciona em um domínio: o domínio da loja principal, também em uma configuração multiloja. Remover a chave da loja não libera a vaga de domínio. Libere a vaga na sua conta vibefox.net.
Sem uma chave ativa, a transportadora Econt não é exibida aos clientes na finalização de compra e nenhuma tarifa é calculada. A vitrine do PrestaShop não sabe que você está logado no back office, então a transportadora também fica oculta para você: você pode configurar o módulo antes de comprar uma chave, mas não testá-lo na finalização de compra. Um lembrete aparece em Modules > Module Manager, na aba Alerts. Os pedidos existentes não são afetados.
Quando uma licença expira, o módulo continua funcionando, mas atualizações e suporte precisam de renovação. O status é verificado novamente de forma automática enquanto você trabalha no back office: uma vez por dia nos primeiros 14 dias após a chave ser inserida e depois uma vez por semana. Não é preciso nenhum cron job. Desinstalar ou redefinir o módulo sempre remove a chave de licença e o status da licença.
Solução de problemas
A Econt não aparece na finalização de compra: verifique se a licença está ativa e se Enable/Disable está ligado, e se o país de entrega é a Bulgária ou a Romênia. Em Shipping > Carriers, verifique se a transportadora cobre a zona do país do cliente e o grupo do cliente (ou ligue Ignore zones e verifique Countries). Verifique se há um valor definido para o país, os limites de peso e Minimum subtotal. Confira a linha Office list nas configurações: a transportadora fica oculta enquanto não houver lista de escritórios disponível para o país. Os produtos também podem ser limitados a determinadas transportadoras na página do produto.
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 sempre gravados no log; ative Debug log para mais detalhes e veja o campo Log. Se a Econt exigir autorização para a sua loja, preencha Econt username e Econt password.
Os clientes veem escritórios de teste: Demo API está ligada. Desligue-a em uma loja em produção.
Em que moeda estão os valores? Na moeda padrão da sua loja, sem impostos. Os clientes os veem na moeda do carrinho deles.
O imposto é cobrado sobre o valor: a transportadora tem uma regra de imposto. Defina Tax como No tax se os seus valores já incluem o IVA.
A página diz que a transportadora Econt não foi encontrada: a transportadora foi excluída em Shipping > Carriers. Redefina o módulo em Modules > Module Manager para criá-la novamente.
Desinstalação
Vá em Modules > Module Manager, abra o menu ao lado de VibeFox Econt e escolha Uninstall. A chave de licença e o status da licença são sempre removidos. As listas de escritórios em cache são sempre removidas. Se Remove data on uninstall estiver ligada, a transportadora é excluída (os pedidos mantêm o histórico) e as configurações e o log são removidos. Se estiver desligada, a transportadora apenas é desativada e todas as configurações são mantidas. Instalar o módulo novamente restaura a transportadora salva com o status que ela tinha. Redefinir o módulo mantém o status atual da transportadora. Escritórios salvos em pedidos são sempre mantidos.
A Econt é marca comercial de seu respectivo proprietário. Este módulo não é afiliado à Econt nem por ela endossado.