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 (CEP, CPF/CNPJ) 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 um simulador 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.
- Compatível com os Correios e com todo o envio do WooCommerce.
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
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 “Brazilian Market on 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 Brazilian Market on 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 – ZIP code lookup and CNPJ validation.
- ReceitaWS – CNPJ validation (fallback).
- 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.
Colaboradores
Calculadora 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.17.1 – 2026-08-21
- Fix: CNPJ now validated for active registration status (situação cadastral ATIVA) against the Federal Revenue (BrasilAPI and ReceitaWS).
- Fix: Alphanumeric CNPJ (IN RFB 2.229/2024) now goes through the API (fail-closed) instead of being accepted by check digit only.
- Dev: Updated the CNPJ API validation field description in the settings.
4.17.0 – 2026-08-19
- New: CNPJ validation against the Brazilian Federal Revenue (BrasilAPI with ReceitaWS fallback).
- Fix: IE field no longer wrongly highlighted after a CNPJ validation error.
- Docs: Added BrasilAPI and ReceitaWS to the third-party credits.
4.16.12 – 2026-08-14
- Fix: Sanitization and character validation of the IE (Inscrição Estadual) field.
- Security: Defense-in-depth IE field sanitization on the PHP-to-JS bridge.
4.16.11 – 2026-08-05
- Fix: Shipping calculation when using order total as calculation base.
- Dev: Improved release preparation skill.
- Adjustment: Improved the validation flow for invalid ZIP codes during search.
4.16.10 – 2026-07-30
- Adjustment: Standardization of Funnelkit fields with the Brazilian plugin.
4.16.9 – 2026-07-29
- Tweak: Funilkit plugin verification system with the Brazilian plugin.
4.16.8 – 2026-07-28
- Ajuste: validação obrigatória do campo de data de nascimento e gênero.
- Novo: sistema de campo de data de nascimento obrigatório.
4.16.7 – 2026-07-17
- Ajuste: Adicionado melhores metadados de envio da V2 ao rótulo.
4.16.6 – 2026-07-17
- Ajuste: Corrige o nome da descrição do campo de endereço.
4.16.5 – 2026-07-14
- Ajuste: conteúdo de marcação do nome no campo clássico de endereço da finalização de compra.
4.16.4 – 2026-07-06
- Ajuste: contingência para o rótulo do calculador do plugin quando não forem detectados os dias úteis de envio.
4.16.3 – 2026-07-03
- Correção: correção no carregamento de classes.
4.16.2 – 2026-07-02
- Novo: opção de cálculo de frete via cupom/taxas.
4.16.1 – 2026-07-01
- Compatibilidade com o plugin FunnelKit.
- Validação de CPF na versão do shortcode.
- Detecção melhorada de rótulos de envio disponíveis no calculador personalizado.
4.16.0 – 2026-06-11
- Novo: sistema de envio baseado em produtos.
- Novo: sistema de rótulos para definir dias úteis de entrega para métodos de frete grátis.
- Novo: sistema de comportamento ativado ao detectar frete grátis.
- Correção: detecção da barra de frete grátis ao executar o componente de calculadora do plugin.
- Correção: campo da caixa de seleção do número do endereço no Gutenberg.
4.15.2 – 2026-06-09
- Corrigido: Formato de CEP enviado para a API.
4.15.1 – 2026-06-08
- Corrigido: Clique no evento para dispensar a atualização do aviso.
4.15.0 – 2026-06-01
- Novo: Suporte ao formato alfanumérico de CNPJ (IN RFB 2.229/2024).
- Corrigido: Correção do preenchimento automático do campo do número do endereço na primeira pesquisa automática.
- Corrigido: classe `has-error` no campo do número do Gutenberg quando o campo está vazio.
- Corrigido: preenchimento automático de CEP no autocomplete.
- Corrigido: Nonce para o campo do número de contato.
- Corrigido: corrigir o preenchimento automático do endereço na página de edição do pedido.
4.14.0 – 2026-05-27
- Novo: recurso de preenchimento automático do endereço por CEP.
- Corrigido: comportamento da caixa de seleção ao preencher o endereço.
- Corrigido: Posicionamento do campo nos dados do pedido + remoção do código do país.
- Novo: ícones, banners e capturas de tela.
- Corrigido: posição do campo destacado na finalização de compra clássica.
4.13.0 – 2026-05-25
- Corrigido: Campo de CPF opcional/obrigatório.
- Novo: campo de Inscrição Estadual (IE).
4.12.5 – 2026-04-29
- Corrigido: sistema de preenchimento automático de CEP para cache.
- Corrigido: Corrigir a sincronização de endereço ao preencher o formulário.
4.12.4 – 2026-04-22
- Corrigido: Preenchimento do campo CPF.
- Corrigido: Alterações no campo de país.
- Corrigido: população do campo ao detectar país vazio.
4.12.3 – 2026-04-13
- Corrigido: campo do número do endereço.
4.12.2 – 2026-04-06
- Corrigido: Correção da validação da data de nascimento
4.12.1 – 2026-04-02
- Corrigido: configuração de realce do campo de CEP.
4.12.0 – 2026-04-02
- Adicionado: novos campos de data de nascimento e gênero.
- Aprimoramento: Nova opção para detecção de frete grátis.
- Adicionado: Nova opção para detecção de frete grátis.
4.11.0 – 2026-04-01
- Aprimoramento: novo sistema de detecção de frete grátis por zonas de envio.
- Melhoria: nova opção para bloco de finalização de compra (Campos Brasileiros)
- Aprimoramento: Novo sistema de detecção de quantidade na página do produto.
= 4.10.1 – 30/03/2026
* Corrigido detecção de mudança do carrinho (adicionando/removendo produtos).
* Corrigida expansão do componente quando o bloco estava minimizado.
= 4.10.0 – 11/03/2026
* Corrigido o carregamento de scripts entre as versões Classic e Bloco.
* Corrigir o error_log na função de cache.
* Nova opção para ocultar o componente do calculador de frete personalizado quando apenas produtos digitais forem detectados.
= 4.9.2 – 06/03/2026
* Ajuste: alterou a posição do campo de telefone na página de edição de endereço.
= 4.9.1 – 06/03/2026
* Ajuste: realce no campo do CEP via shortcode.
* Ajuste: campos de configuração de envio.
= 4.9.0 – 04/03/2026
* Adicionado: novas opções para destacar os campos de contato e de e-mail.
* Adicionado: nova opção para impedir frete grátis duplicado.
= 4.8.0 – 09/02/2026
* Adição: opção para ocultar métodos de envio quando o envio grátis for adquirido.
* Ajuste: stopPropagation no botão da caixa de seleção para evitar que o formulário seja atualizado de forma inadequada.
* Ajuste: mensagem de descrição de cache melhorada, fornecendo dicas sobre possíveis problemas com plugins de cache.
* Adição: hook para exibir variáveis de corrige personalizadas.
* Ajustes nas rotas ajax e rest_api para evitar cache.
= 4.7.4 – 21/01/2026
* Correção: cálculo do frete de produtos com variação na página do produto.
= 4.7.3 – 13/01/2026
* Correção: campo do número de telefone relacionado aos dígitos.
* Correção: campo do número de telefone com mais opções de configuração.
* Correção: configuração de exibição do campo de CEP no shortcode.
= 4.7.2 – 07/01/2026
* Correção: verificação do campo numérico + compatibilidade do plugin brasileiro.
= 4.7.1 – 06/01/2026
* Correção: campo dinâmico de CPF/CNPJ no editor de blocos.
= 4.7.0 – 23/12/2025
* NOVO: campo CPF/CNPJ
* NOVO: campo 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.