Guia de instalação

Como instalar e configurar o Cota Frete na Shopify

Instale, configure e publique a cotação na página do produto, no carrinho, na gaveta e no checkout. O guia segue o vídeo completo de instalação e uso ao lado, etapa por etapa.

O Cota Frete mostra a cotação de frete na página do produto, no carrinho, na gaveta e no checkout (este último via Carrier Calculated Shipping, o CCS da Shopify). Funciona com o seu contrato de transportadora ou com a conta que você já tem em um gateway de frete. Lista completa em Integrações.

Dica: assista ao vídeo e mantenha este guia aberto para marcar cada etapa diretamente no admin da Shopify.


1. Pré-requisitos e instalação

1.1 Checklist rápido

  • Para cotação no checkout, uma loja Shopify com o Carrier Calculated Shipping (CCS) habilitado. Não é necessário para página do produto, carrinho e gaveta.
  • Ter o CEP de origem e as credenciais do contrato com a transportadora, ou o acesso à conta do gateway de frete que você já usa.
  • Definir quem será responsável por configurar regras de preço e mensagens.

1.2 Instale o app pela Shopify App Store

  1. Acesse a Shopify App Store e procure por Cota Frete.
  2. Clique em Adicionar app e siga para a tela de autorização da sua loja.
  3. Revise as permissões (cálculo de frete, pedidos e produtos) e finalize em Instalar app.

Assim que a instalação terminar, o Cota Frete aparece no menu lateral do admin junto às demais apps.


2. Onboarding guiado no painel do app

Ao abrir o Cota Frete pela primeira vez, siga as etapas abaixo, as mesmas mostradas no vídeo.

2.1 Configure a origem de envio

Tela de origem de envio no Cota Frete
  1. Acesse Configurações → Origem de envio dentro do app.
  2. Informe o CEP principal de expedição (o mesmo cadastrado na Shopify).
  3. Salve e avance para a próxima etapa.

O CEP é usado como base para os cálculos em todas as transportadoras conectadas.

2.2 Conecte transportadoras homologadas

Integração com transportadoras no Cota Frete

Na etapa Transportadoras selecione quais deseja ativar:

  • Correios - use suas credenciais ou a tabela balcão.
  • Loggi, Lalamove, Total Express, J&T Express, Jadlog, R3 Express, Gollog - informe as credenciais do seu contrato seguindo as instruções exibidas.
  • Fretes Próprios - cadastre a entrega que a loja faz (motoboy, entregador, retirada) ou a sua tabela de frete própria.
  • Melhor Envio, Frenet, Intelipost, SmartEnvios, SuperFrete - conecte a conta do gateway e escolha quais transportadoras contratadas quer oferecer. Tutoriais na central de ajuda.

Cada integração possui um botão Testar conexão. Utilize-o para validar antes de prosseguir. As credenciais ficam mascaradas no painel depois de salvas; o valor só é exibido quando você clica para ver.

2.3 Ajuste regras e mensagens

Entre em Regras de Frete para personalizar:

  • Frete grátis por região ou valor do pedido.
  • Acréscimos percentuais/fixos por transportadora ou serviço.
  • Mensagens promocionais exibidas no widget e no checkout.
  • Bloqueio de CEPs específicos (ex.: áreas de risco).

O que entra em cada plano está em Recursos.


3. Exibição nas páginas da loja

Página do produto, carrinho e gaveta funcionam em qualquer plano da Shopify. Só o checkout depende do CCS.

3.1 Página do produto

  1. Na home do app, no card Plugin de cotação, clique em Configurar. Abre o editor de temas da Shopify.
  2. No seletor do topo, escolha Produtos → Default product.
  3. Em Informações do produto, clique em Adicionar bloco e, na seção “Apps”, escolha o bloco do Cota Frete.
  4. Posicione (abaixo do botão de comprar costuma funcionar bem) e salve.

Resultado: o cliente informa o CEP e vê prazos e valores antes de adicionar ao carrinho.

3.2 Carrinho

No mesmo editor, troque o seletor do topo para Carrinho e repita: adicionar bloco, escolher o bloco do Cota Frete, salvar. A cotação passa a considerar todos os itens, e a mensagem “Faltam R$ X para frete grátis” entra aqui.

3.3 Gaveta do carrinho

A gaveta lateral não aceita bloco de app na maioria dos temas. O Cota Frete usa um App Embed, ativado em Incorporações de app no editor de temas, com um seletor que indica onde o bloco entra (.cart-totals funciona no Dawn e derivados). Passo a passo em Como exibir a cotação na gaveta do carrinho.

3.4 Checkout (requer CCS)

Ao instalar o app, o Cota Frete se registra como serviço de cotação na Shopify. Se a loja tem o CCS ativo, as opções aparecem no checkout com os mesmos valores da página do produto, já com as regras aplicadas. No plano Basic da Shopify o CCS não está disponível; nesse caso a cotação segue valendo no produto, no carrinho e na gaveta. Como ativar o CCS: guia rápido.


4. Recursos que valem conhecer

  • Transportadora no pedido: todo pedido grava a transportadora, o serviço e a previsão de entrega, para o ERP saber quem está por trás de “Econômico”. Como ver.
  • Agrupamento de frete: uma opção por modalidade (econômico, expresso, normal) em vez de vários serviços parecidos.
  • Múltiplas origens: para quem envia de mais de um lugar, a cotação pode sair do perfil de entrega da Shopify.
  • Simulador de frete: em Início → Simular frete, veja o que o widget e o checkout vão mostrar pra um produto e um CEP antes de publicar.
  • Painel e relatórios: frete cotado, cobrado e absorvido, SLA de entrega e relatório detalhado por região e transportadora.

Tudo, com o plano de cada item, em Recursos.


5. Checklist final antes de publicar

  1. Teste com um CEP real na página do produto, no carrinho e na gaveta, ou pelo Simular frete na tela Início do app.
  2. Simule o checkout completo (se a loja tem CCS) e confirme se os valores batem com os da página do produto.
  3. Revise as regras de frete grátis e acréscimos com quem cuida do comercial.
  4. Mantenha ao menos duas transportadoras ativas: se uma API cair, a outra segue cotando.

Quando tudo estiver ok, comunique seu time de atendimento e marketing para divulgar as novas opções de entrega.


6. Suporte e materiais adicionais


Última atualização: agosto de 2026