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.
- Compatible with Correios and all WooCommerce shipping
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 – 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.
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.15.2 – 09/06/26
- Fixed: CEP format sent to the API.
4.15.1 – 08/06/26
- Fixed: Click event to dismiss the update notice.
4.15.0 – 01/06/26
- New: Alphanumeric CNPJ format support (IN RFB 2.229/2024).
- Fixed: Address number field auto-fill on first automatic lookup.
- Fixed: has-error class on the Gutenberg number field when the field is empty.
- Fixed: CEP autofill on autocomplete.
- Fixed: Nonce for the contact number field.
- Fixed: Address auto-fill on the order edit page.
4.14.0 – 27/05/26
- New: CEP address auto-fill feature.
- Fixed: Checkbox behavior when filling the address.
- Fixed: Field positioning in order data + removal of country code.
- New: Icons, banners and screenshots.
- Fixed: highlighted field position in classic checkout.
4.13.0 – 25/05/26
- Fixed: Optional/required CPF field.
- New: State Registration (IE) field.
4.12.5 – 29/04/26
- Fixed: CEP auto-fill system for cache.
- Fixed: Address synchronization when filling the form.
4.12.4 – 22/04/26
- Fixed: CPF field filling.
- Fixed: Country field changes.
- Fixed: Field population when detecting empty country.
4.12.3 – 13/04/26
- Fixed: Address number field.
4.12.2 – 06/04/26
- Fixed: Fix Birthdate validation
4.12.1 – 02/04/26
- Fixed: CEP field highlighting configuration.
4.12.0 – 02/04/26
- Added: New birth date and gender fields.
- Enhancement: New option for free shipping detection.
- Added: New option for free shipping detection.
4.11.0 – 01/04/26
- Enhancement: New free shipping detection system through shipping zones.
- Enhancement: New option for checkout block (Campos Brasileiros)
- Enhancement: New quantity detection system on product page.
= 4.10.1 – 30/03/2026
* Fixed cart change detection (adding/removing products).
* Fixed component expansion when the block was minimized.
= 4.10.0 – 11/03/2026
* Fixed script loading between Classic and Block versions.
* Fixed error_log in cache function.
* New option to hide the custom shipping calculator component when only digital products are detected.
= 4.9.2 – 06/03/2026
* Adjustment: Changed the phone field position on the edit address page.
= 4.9.1 – 06/03/2026
* Adjustment: Highlight on the ZIP code field via shortcode.
* Adjustment: Shipping configuration fields.
= 4.9.0 – 04/03/2026
* Added: New options to highlight the contact and email fields.
* Added: New option to prevent duplicate free shipping.
= 4.8.0 – 09/02/2026
* Addition: Option to hide shipping methods when free shipping is acquired.
* Adjustment: stopPropagation on the checkbox button to prevent the form from being updated improperly.
* Adjustment: Improved cache description message, providing tips about possible issues with cache plugins.
* Addition: Hook for displaying custom address variables.
* Adjustments to ajax and rest_api routes to prevent caching.
= 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.