Nova configuração para calcular no carrinho antes ou depois da escolha do frete

Anteriormente, o lojista não conseguia exibir no carrinho os valores e ajustes calculados pela API de Alíquotas antes que o cliente selecionasse a forma de frete. Como a API era acionada estritamente após a escolha do frete, benefícios e descontos independentes da entrega,como programas de seguros ou o desconto de PBM (Programa de Benefício em Medicamentos), só apareciam na etapa final do checkout.

Esse atraso gerava atrito e dúvidas para o consumidor, que só tomava conhecimento do valor real da sua compra e dos benefícios aplicados nos últimos passos antes do pagamento.

Com esta atualização, introduzimos uma nova configuração flexível no painel administrativo. O lojista passa a ter total controle para definir, alíquota por alíquota, se o cálculo deve aguardar a escolha do frete ou se pode ser executado imediatamente no primeiro passo do carrinho.

O que muda?

• Nova Opção "Exigir frete selecionado para calcular": Disponibilizada na tela de criação e edição de cada alíquota, acompanhada de orientações contextuais em tooltip:
  • Ativa: A alíquota é calculada estritamente após a escolha do frete pelo consumidor.
  • Inativa: A alíquota passa a ser calculada logo no primeiro passo do carrinho, mesmo antes de qualquer frete ser selecionado.
• Aplicação Imediata: A alteração salva no painel passa a valer instantaneamente para o cálculo do carrinho na vitrine.
• Continuidade Operacional: As alíquotas já existentes na plataforma continuam funcionando normalmente segundo o comportamento padrão, sem exigir alterações para quem não desejar mudar o fluxo.
• Parametrização Direcionada: Para operações com regras específicas de medicamentos (como na Venâncio), a configuração foi desativada por padrão nas alíquotas vigentes para viabilizar o cálculo do PBM logo após a pré-autorização.

Principais Benefícios:

• Controle Total do Momento do Cálculo: A loja define com precisão se a API de Alíquotas é acionada já no carrinho ou apenas após o frete, de acordo com os requisitos de cada regra.
• Benefícios Visíveis desde o Carrinho: Ajustes e descontos independentes de frete (PBM, seguros, convênios) aparecem antecipadamente, permitindo que o cliente saiba o valor real da compra mais cedo.
• Precisão para Regras Dependentes de Entrega: Alíquotas que utilizam informações do frete continuam aguardando a seleção do consumidor, evitando cálculos provisórios ou divergentes.
• Flexibilidade Nativa sem Customização: O mecanismo opera diretamente pelo painel administrativo, atendendo diferentes modelos de negócio sem a necessidade de desenvolvimentos específicos por cliente.

Ainda sobrou alguma dúvida ou quer entender todos os detalhes de configuração e começar a aplicar agora mesmo? Confira o passo a passo completo na nossa documentação oficial:

🔗 Alíquotas 

Publicado em 09/11/2026