Descrição
Calculadora de frete melhorada projetada especificamente para lojas de e-commerce brasileiras que utilizam o WooCommerce, tornando mais fácil e significativamente melhorando o fluxo de entrada de dados nas páginas do carrinho e finalização de compra.
Esta versão inclui compatibilidade total com shortcodes e temas do Gutenberg, permitindo que você coloque a calculadora de frete em qualquer lugar do seu site com máxima flexibilidade.
Este plugin do WordPress garante uma verificação de endereço mais rápida e uma gestão de formulários mais simples, resultando em uma melhor experiência do usuário e menos carrinhos abandonados.
🚀 Novo Recurso: Finalização de compra brasileira concluída
Nós expandimos as capacidades do plugin para oferecer uma solução completa de finalização de compra para o mercado brasileiro. Agora, além do calculador de frete, o plugin gerencia Campos de Finalização Personalizados essenciais para logística e faturamento no Brasil.
Novos Recursos de Campo:
* CPF & CNPJ: Adiciona campos para os IDs fiscais de Pessoa Física (CPF) e Pessoa Jurídica (CNPJ) com validação automática.
* Campos de Endereço: Adiciona e gerencia campos específicos para Bairro, Número e Complemento.
* Máscaras de Telefone: Máscaras de entrada inteligentes para telefones fixos e dispositivos móveis brasileiros.
✅ Compatibilidade do ERP com o mercado brasileiro
Esta é uma atualização importante para os proprietários de lojas que precisam emitir notas fiscais. O plugin agora está totalmente compatível com os padrões de dados utilizados pelo plugin Mercado Brasileiro no WooCommerce (por Claudio Sanches).
Por que isso é importante?
1. Integração Bling & ERP: Porque seguimos a estrutura padrão de meta-chaves, este plugin é totalmente compatível com Bling, Tiny e outros ERPs que se integram com o WooCommerce. Você pode emitir faturas (NFe) sem problemas, sem erros nos dados.
2. Dados Padronizados: Garantir que CPF, CNPJ e dados de endereço sejam salvos exatamente como as ferramentas de integração externa esperam.
Assista à demonstração do Plugin:
Principais recursos e benefícios:
On the Cart Page:
- Validação de CEP: Validação em tempo real do formato do CEP.
- Controle de Envio: O botão de finalização de compra só é ativado após o cliente digitar um CEP válido.
- Ocultação de Campo Dinâmico: Opção para ocultar campos de endereço desnecessários na página do Carrinho para uma interface mais simples.
- Compatibilidade com os modos Legacy e Blocos (Gutenberg) do WooCommerce.
On the Checkout Page:
- ✨ NOVO: Consulta Automática de Endereço: Preenche automaticamente os campos de rua, bairro, cidade e estado após o cliente digitar um CEP válido.
- ✨ NOVO: Campos Personalizados na Finalização de Compra: Adiciona suporte para CPF, CNPJ, Número, Bairro e Data de Nascimento.
- ✨ NOVO: Validação de Entrada: Valida os algoritmos de CPF/CNPJ e aplica máscaras de entrada para evitar erros de digitação.
- ✨ NOVO: Seletor de Tipo de Pessoa: Permite aos clientes alternar entre “Pessoa Física” e “Pessoa Jurídica” durante a finalização de compra.
- **Consulta Automática de Endereço:** Preenche automaticamente os campos de rua, bairro, cidade e estado após o cliente digitar um CEP válido.
- **Campo de Telefone Obrigatório com DDI:** O campo de telefone agora é obrigatório e inclui um recurso para capturar o Código do País (DDI), garantindo informações de contato completas.
- Adição de Campo de Número: Adiciona o campo obrigatório “Número”, frequentemente ausente nos formulários padrão do WooCommerce. Inclui uma opção de
caixa de seleçãopara endereços que são “Sem Número”. - Ocultação de Campo Dinâmico: Opção para ocultar campos de endereço quando não necessários.
Additional Features:
- Valor Mínimo para Frete Grátis: Opção para definir um valor mínimo no carrinho obrigatório para ativar o método de frete grátis.
- Totalmente personalizável através da página de configurações do plugin dedicado.
- O plugin é totalmente personalizável através de ganchos de ação e filtro para usuários avançados.
Outros detalhes podem ser encontrados nas Perguntas frequentes (FAQ).
Ajuda e suporte
Quando precisar de ajuda, por favor crie um tópico no Fórum de Suporte do Plugin.
** Plugins Recomendados **
* Link Pagamento por Fatura para WooCommerce – Integre métodos de pagamento personalizados e ofereça pagamentos por fatura em sua loja WooCommerce.
* Pix Para WooCommerce – Integre o Pix, o revolucionário sistema de pagamento instantâneo do Brasil, em sua loja WooCommerce
Capturas de tela

Nova página de configuração do plugin. 
Tela antiga do carrinho através do editor de blocos do Gutenberg. 
Nova tela de carrinho usando o Editor de blocos Gutenberg. 
Antiga tela de carrinho usando o shortcode do WooCommerce. 
Tela nova do carrinho através do shortcode do WooCommerce. 
Campo de número através do editor de blocos do Gutenberg. 
Campo de número através do shortcode do WooCommerce. 
Barra de progresso no carrinho do Gutenberg. 
Barra de progresso na finalização de compra do Gutenberg. 
Barra de progresso no carrinho antigo. 
Barra de progresso na finalização de compra antiga. 
Novo componente de CEP código postal. 
Novo layout para o componente de CEP – código postal. 
Preenchimento Automático de Endereço na Finalização de Compra. (Novo) 
Campo de telefone obrigatório com DDI. (Novo)
Instalação
- Acesse o admin do seu WordPress e vá para Plugins > Adicionar Novo.
- Busque por “Calculadora de Frete Melhorada para Lojas Brasileiras”.
- Encontre o plugin, clique em “Instalar Agora” e depois em “Ativar”.
- Concluído! Não é necessário nenhuma configuração adicional, mas recomendamos visitar as configurações do plugin.
Perguntas frequentes
-
Este plugin substitui o “Mercado Brasileiro no WooCommerce”?
-
Sim, este plugin atua como uma solução atualizada para o Brasil no Mercado WooCommerce. Ele mantém total compatibilidade com os dados existentes, mas oferece recursos melhorados. Observação: Para utilizá-lo, você deve desativar o plugin Brasil no Mercado WooCommerce (por Claudio Sanches) para evitar conflitos de campos.
-
Como posso ALTERAR o texto “Calcular frete”?
-
Use o seguinte código:
add_filter(
‘wc_better_shipping_calculator_for_brazil_postcode_label’,
function () {
return ‘seu novo texto’;
}
); -
Como posso REMOVER o texto “Calcular frete”?
-
Use o seguinte código:
add_filter(
‘wc_better_shipping_calculator_for_brazil_postcode_label’,
‘__return_null’
); -
Por que o campo de telefone agora é obrigatório e está pedindo um Código de País (DDI)?
-
Este recurso foi adicionado para garantir que todos os dados essenciais de contato do cliente estejam completos e formatados corretamente. O DDI (Código de Discagem Internacional) garante que o número de telefone seja padronizado para chamadas nacionais e internacionais, o que é crucial para logística e atendimento ao cliente. Você pode desativar este recurso nas configurações do plugin na aba de finalização de compra.
-
Como funciona a busca automática de endereço pelo CEP?
-
Quando o cliente digita um CEP válido de 8 dígitos na página de finalização de compra, o plugin utiliza APIs públicas (como VIACEP e Brasil API) para automaticamente recuperar e preencher os campos de Rua, Cidade, Estado e Bairro, agilizando o processo de finalização de compra.
-
Contribuidores
-
Se encontrar algum erro ou tiver sugestões, abra um problema no nosso repositório no GitHub.
- Brasil API – Campo de CEP.
- VIACEP – Campo de CEP (código postal).
- Entrada de Telefone Internacional – Campo de número de telefone com código de país.
Avaliações
Colaboradores e desenvolvedores
“Calculadora de Frete e Campos Checkout para o Brasil” é um programa de código aberto. As seguintes pessoas contribuíram para este plugin.
ColaboradoresCalculadora de Frete e Campos Checkout para o Brasil” foi traduzido para 1 localidade. Agradecemos aos tradutores por suas contribuições.
Traduzir o “Calculadora de Frete e Campos Checkout para o Brasil” para seu idioma.
Interessado no desenvolvimento?
Navegue pelo código, consulte o repositório SVN ou assine o registro de desenvolvimento por RSS.
Registro de alterações
= 4.7.4 – 21/01/2026
* Fix: variable products shipping calculation on product page.
= 4.7.3 – 13/01/2026
* Fix: phone number field regarding digits.
* Fix: phone number field with more configuration options.
* Fix: postal code field display configuration in shortcode.
= 4.7.2 – 07/01/2026
* Fix: number field verification + Brazilian plugin compatibility.
= 4.7.1 – 06/01/2026
* Fix: dynamic CPF/CNPJ field in block editor.
= 4.7.0 – 23/12/2025
* NOVO: Campo de CPF/CNPJ.
* NOVO: Campo de Bairro.
* Ajuste: Barra de frete grátis.
4.6.0 – 15/12/2025
- NOVO: Barra de progresso dinâmica para frete grátis com mensagens personalizáveis.
- NOVO: Captura e formatação automática de códigos de país em números de telefone.
- NOVO: Paridade total de recursos entre o editor de blocos e o shortcode.
4.5.0 – 24/10/2025
- NOVO: Sistema de configuração de fonte de texto nos componentes de produto e carrinho.
- NOVO: Preenchimento automático de endereço na página de finalização de compra.
- NOVO: Destaque para o campo de CEP no formulário da página de finalização de compra.
4.4.0 – 10/09/2025
- Novo: sistema de cache para consultas de CEP.
- Novo: cartão de exibição do plugin.
- Novo: bibliotecas de Salmos e CodeQL para código
4.3.3 – 15/08/2025
- Correção: Estilos de botão.
- Correção: Nonce.
- Correção: Tipo de moeda e casas decimais.
4.3.2 – 08/08/2025
- Correção: Problema na exibição de componente.
- Ajuste: Mensagem nos campos do Gutenberg.
- Adição: Campo de configuração de link.
4.3.1 – 05/08/2025
- Ajuste: A opção que define a posição do componente agora está em um nível superior, tanto para a página do produto quanto para o carrinho.
- Correção: Ao definir a posição do componente de CEP na página do produto no modo personalizado, ele não era exibido conforme o esperado.
- Correção: Valor padrão da cor do ícone.
- Adição: O link que leva à página de configuração agora está disponível na página do produto quando o usuário for um administrador da página.
4.3.0 – 29/07/2025
- Adição: Novos componentes personalizados de verificação de CEP.
- Adição: Componente de CEP para a página do produto.
- Adição: Componente de CEP para a página de carrinho do Woo.
4.2.1 – 09/06/2025
- Correção: Separador decimal.
- Correção: URL dinâmica.
- Correção: Barra de progresso na página de carrinho legada.
4.2.0 – 06/06/2025
- Adição: Opção para definir um valor mínimo no carrinho para frete grátis.
4.1.6 – 02/06/2025
- Ajuste: correção no campo de autopreenchimento de endereço.
4.1.5 – 22/05/2025
- Ajuste: campo de ocultação de endereço.
- Inserção: dos contribuidores do plugin.
- Inserção: de link que leva para página de configurações do plugin na página do carrinho apenas quando o usuário for administrador.
4.1.4 – 20/05/2025
- Ajuste: campo de bairro está fora dos parâmetros estabelecidos.
- Ajuste: tags do arquivo README.txt.
4.1.3 – 15/05/2025
- Ajuste: blueprint mais dinâmico no momento da configuração do playground.
4.1.2 – 07/05/2025
- Correção: Ajustes na identificação de produtos físicos e digitais.
- Ajuste: Melhoria no fluxo do githubworkflow para lançamento do plugin no repositorio e WordPress.
4.1.1 – 29/04/2025
- Correção: Melhoria na descrição do README.txt para o Português – BR.
- Correção: Melhoria no campo do Gutenberg para campo de CEP, agora é possível habilitar ou desabilitar a ocultação do endereço nos campos de CEP.
4.0.1 – 23/04/2025
- Correção: Novo Readme.txt e lista de imagens.
4.0.0 – 26/03/2025
- Ajuste: Alteração do plugin para o modelo de Orientação a Objetos (OO).
- Novo tab de configuração para o plugin.
- Compatibilidade com o Gutenberg.
- Novo campo de número no checkout do Woocommerce(shortcode e gutenberg)
3.2.2
- Testado até o WordPress 6.6
3.2.1
- Testado até o WordPress 6.4
3.2.0
- Ajuste: Força as configurações do WooCommerce para ativar o cálculo de frete.
3.1.2
- Correção: Incompatibilidade com o plugin Fluid Checkout.
3.1.1
- Correção: Às vezes, a máscara do campo de CEP não estava funcionando em novos cálculos de frete.
3.1.0
- Recurso: Agora o campo de CEP possui o tipo ‘tel’ (para mostrar o teclado numérico no celular).
3.0.2
- Correção: O aviso de doação não estava fechando.
3.0.1
- Correção: O JavaScript do plugin deve ser executado apenas na página do carrinho.
3.0.0
- Ajuste: Código refatorado para melhor compatibilidade.
- Ruptura: Vários hooks foram removidos.
2.2.0
- Ajuste: Limpa o campo de cidade para evitar resultados inesperados.
- Corrigido o hook de filtro
wc_better_shipping_calculator_for_brazil_hide_country
2.1.2
- Correções menores.
2.1.1
- Correção de JavaScript.
2.1.0
- Nome do plugin alterado para “Calculadora de frete melhorada para lojas brasileiras”.
- Agora o campo de CEP está sempre visível.
- Novo filtro de hook:
wc_better_shipping_calculator_for_brazil_add_postcode_mask(padrão:true) - Novo filtro de hook:
wc_better_shipping_calculator_for_brazil_postcode_label(padrão:"Calcule o frete:") - Correção em
register_activation_hook.
2.0.4
- Correção na tradução pt_BR.
- Testado com WordPress 6.0 e WooCommerce 6.5.
2.0.3
- Correção de um erro de sintaxe com versões antigas do PHP.
2.0.2
- Correção em JavaScript.
- Tradução para PT-BR adicionada.
2.0.1
- Correções internas.
2.0.0
- Lançamento inicial.
