ShipCalc
Começar teste grátis

Documentação

Configure e use o ShipCalc.

Instale o ShipCalc, adicione a calculadora à sua loja, deixe-a com a cara do seu tema e use as análises e o diagnóstico. A maioria das lojas fica pronta em poucos minutos.

Revisado pela última vez em 29 de setembro de 2026 por MerchantOS.

Veja antes de instalar.Abra a loja de demonstração (senha: 1) ou veja a página na Shopify App Store.
O admin do app ShipCalc está em inglês. Esta documentação também cita cada configuração do admin em inglês, para você encontrá-la na tela.

1. Instale o ShipCalc

O ShipCalc é instalado pela Shopify App Store. O teste grátis de 14 dias começa na instalação, com todos os recursos disponíveis.

  1. Abra a página do ShipCalc na Shopify App Store.
  2. Clique em Install (Instalar) e aprove o app.
  3. O ShipCalc abre no admin da Shopify com uma lista de passos iniciais.

A página inicial tem links de um clique que abrem o editor de temas no lugar certo para cada posicionamento.

2. Adicione o bloco da página de produto

O bloco da página de produto permite que o cliente confira o frete antes de adicionar um item ao carrinho. Ele usa a variante e a quantidade selecionadas no momento.

  1. Na configuração inicial do ShipCalc, clique em Add Product Page Block. O editor de temas abre em um modelo de produto.
  2. Clique em Add block (Adicionar bloco) na seção de informações do produto e escolha o bloco do ShipCalc.
  3. Arraste-o para a posição desejada — abaixo do preço ou dos botões de compra funciona bem.
  4. Clique em Save (Salvar).
DicaSe você usa mais de um modelo de produto, adicione o bloco a cada modelo usado pelos seus produtos publicados.

3. Adicione o bloco da página do carrinho

O bloco do carrinho cota todos os itens e quantidades do carrinho, para que o cliente veja a entrega do pedido inteiro.

  1. No ShipCalc, clique em Add Cart Page Block. O editor de temas abre no modelo do carrinho.
  2. Clique em Add block (Adicionar bloco) e escolha o bloco de carrinho do ShipCalc.
  3. Posicione-o perto do subtotal e do botão de checkout e clique em Save (Salvar).

4. Ative o suporte à gaveta do carrinho

As gavetas de carrinho (carrinhos deslizantes) são construídas de forma diferente em cada tema, por isso o ShipCalc as suporta por meio de uma incorporação de app que detecta a gaveta aberta e coloca uma calculadora compacta e recolhível acima do botão de checkout.

  1. Abra o editor de temas e selecione App embeds (Incorporações de app) na barra lateral esquerda.
  2. Ative a incorporação de gaveta do carrinho do ShipCalc.
  3. A maioria dos temas funciona com a detecção automática. Se o seu não funcionar, informe o seletor CSS da gaveta nas configurações da incorporação.
  4. Clique em Save (Salvar) e abra a gaveta na sua loja publicada para conferir o posicionamento.
Precisa de um seletor?Envie o nome do seu tema e o URL da loja e ajudaremos a configurar.

5. Personalize o widget

As configurações visuais e de texto ficam na página Appearance (Aparência) do ShipCalc, com uma prévia ao vivo antes que as alterações cheguem à sua loja.

Layout e estilo

  • Layout cartão ou minimalista.
  • Cores de destaque, fundo, texto e borda.
  • Raio dos cantos, espaçamento e tamanhos de texto.
  • Herde a tipografia e os estilos básicos de controles do seu tema.

Textos

  • Título, texto de ajuda e texto do botão.
  • Rótulos e textos de exemplo de país e CEP.
  • Mensagens de cálculo em andamento, sem tarifas, erro e carrinho vazio.
  • Um texto para métodos de frete grátis.

Todos os textos voltados ao cliente podem ser escritos no idioma da sua loja.

CSS personalizado

Para um controle mais fino, o editor de CSS permite adicionar regras para o widget — útil para espaçamentos específicos do tema ou estados de hover.

6. Países e CEPs

Escolha de onde vem o país de destino:

  • Fixed country (país fixo) — sempre calcula para um país que você escolhe.
  • Shopper’s Shopify country (país do cliente na Shopify) — segue o país de localização do Shopify Markets.
  • Country selector (seletor de país) — o cliente escolhe entre os países que você permite.

Depois, escolha como o CEP funciona:

  • Required (obrigatório) — o cliente precisa informar o CEP ou código postal.
  • Optional (opcional) — o cliente pode informar um para obter uma cotação mais precisa.
  • Country only (só o país) — oculta o campo de CEP; o ShipCalc pode retornar uma estimativa para o país escolhido.

Você também pode ocultar a calculadora para visitantes de países selecionados ou mostrá-la apenas para visitantes dos países que escolher.

7. Opções de exibição de tarifas

  • Mostre todas as tarifas disponíveis, só a mais barata ou só a mais cara.
  • Mostre detalhes de entrega abaixo da tarifa quando a Shopify os retornar.
  • Use seu próprio texto para métodos gratuitos (por exemplo, “Frete grátis”).

8. Posicionamento manual (avançado)

Se o layout do seu tema não permitir um bloco de app onde você precisa, adicione um elemento de marcação e o carregador do ShipCalc ao seu tema:

<div data-shipcalc-m="product"></div>
<script src="/apps/shipcalc/manual.js" defer></script>

Use data-shipcalc-m="cart" para um posicionamento no carrinho. A calculadora manual usa as mesmas configurações, estilos e análises dos blocos de app.

9. Análises

A página Analytics (Análises) mostra como os clientes usam a calculadora:

  • Total de cotações ao longo do tempo e atividade recente.
  • Cotações por origem: página de produto, página do carrinho ou gaveta do carrinho.
  • Combinações de CEP e país mais populares.
  • Métodos de entrega exibidos aos clientes.
  • Erros, para você identificar destinos sem tarifas.

10. Eventos de marketing

O ShipCalc pode enviar um evento Calculate Shipping para o Google Analytics 4, o Google Tag Manager e o Meta Pixel quando essas ferramentas já estão na sua loja. O ShipCalc não instala scripts de rastreamento.

  1. Abra Marketing events (Eventos de marketing) no ShipCalc.
  2. Escolha para quais plataformas enviar.
  3. Se quiser, substitua o nome, a categoria, o rótulo ou o valor do evento, ou adicione parâmetros personalizados.
  4. Salve.

Os eventos incluem a origem do widget (produto, carrinho ou gaveta), o país e se um CEP foi informado.

PrivacidadeOs eventos de marketing nunca incluem o nome, o e-mail, o endereço completo ou o conteúdo do carrinho do cliente.

11. Diagnóstico

A página Diagnostics (Diagnóstico) faz uma cotação real sem passar pela sua loja — útil depois de alterar zonas ou tarifas de frete.

  1. Abra Diagnostics (Diagnóstico) no ShipCalc.
  2. Escolha um produto, um país e um CEP.
  3. Faça a cotação para ver exatamente o que a Shopify retorna.

12. Solução de problemas

A calculadora não aparece na página do produto

  • Verifique se o bloco foi adicionado ao modelo que seus produtos realmente usam e se você salvou.
  • Confira se o bloco não está dentro de uma seção oculta ou recolhida.
  • Verifique se as regras de país do visitante em Appearance não estão ocultando a calculadora para a sua localização.

Nenhuma tarifa é retornada

  • Confirme que o destino pertence a um mercado e a uma zona de frete ativos na Shopify.
  • Verifique se o perfil de frete e o peso do produto atendem às condições das suas tarifas.
  • Teste o mesmo destino em Diagnostics para ver o que a Shopify retorna.
  • Reescreva a mensagem de “sem tarifas” para que o cliente saiba o que fazer.

Para uma lista mais completa, leia Tarifas de frete da Shopify não aparecem.

Não aparece na gaveta do carrinho

  • Confirme que a incorporação de app da gaveta do carrinho está ativada e salva.
  • Tente definir o seletor da gaveta nas configurações da incorporação.
  • Fale com a gente informando o nome do seu tema.

13. Suporte

O admin do ShipCalc tem uma página de suporte com respostas rápidas e um formulário de contato. Você também pode enviar uma mensagem aqui e responderemos por e-mail.