Tutorial de Instalação e Configuração – Cota Frete

Bem-vindo(a) ao Cota Frete

O Cota Frete leva a cotação oficial do Carrier Service da Shopify para lojas brasileiras, com integrações homologadas (Correios, Total Express, J&T Express e Jadlog), cache inteligente e campanhas de frete grátis controladas pelo time de operações.

Este tutorial acompanha o vídeo completo de instalação e uso apresentado na home e mostra, passo a passo, como replicar o fluxo demonstrado:

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

  • Possuir uma loja Shopify com o plano que permite Carrier Calculated Shipping (CCS) habilitado.
  • Ter os CEPs de origem e as credenciais/contratos das transportadoras que serão ativadas.
  • 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 você verá o mesmo checklist guiado apresentado 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 as tarifas padrão.
  • Total Express, J&T Express, Jadlog – informe contrato, token ou dados de acesso seguindo as instruções exibidas.

Cada integração possui um botão Testar conexão. Utilize-o para validar antes de prosseguir.

2.3 Configure tabelas de contingência (backup)

Ainda na área de transportadoras, acione Tabelas de backup para garantir resposta quando a API oficial estiver indisponível.
Suba os arquivos CSV fornecidos pelo transportador e defina quando cada tabela deve ser utilizada.

2.4 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).

Todas as alterações ficam registradas no histórico, permitindo auditoria pelo time.


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

3.1 Página de Produto (PDP)

  1. Vá em Exibição → Widget PDP dentro do app.
  2. Ative o componente e escolha o layout (padrão do vídeo).
  3. No tema da Shopify, a extensão app embed do Cota Frete já estará disponível; basta ativá-la.

Resultado: o cliente consegue informar o CEP na PDP e visualizar preços e prazos antes de adicionar ao carrinho.

3.2 Carrinho

O mesmo widget pode aparecer no mini-cart ou na página completa de carrinho.
Ative a opção Mostrar estimativas no carrinho e personalize mensagens de incentivo (ex.: “Faltam R$ XX para frete grátis”).

3.3 Checkout (Carrier Service)

Ao instalar o app, o Cota Frete registra o Carrier Service na Shopify.
Garanta que o plano da loja está apto a usar o CCS; com isso, as opções configuradas aparecerão automaticamente no checkout com os ajustes de preço definidos nas regras.


4. Recursos avançados destacados no vídeo

  • Cache inteligente: as últimas cotações ficam armazenadas por CEP + modalidade, acelerando respostas em horários de pico.
  • Alertas operacionais: o app sinaliza quando credenciais expiram ou quando alguma transportadora não responde.
  • Mensageria promocional: personalize textos de frete grátis ou prazos diferenciados conforme transportadora/CEP.
  • Futuras funcionalidades (roadmap apresentado): prazos adicionais por transportadora, validação oficial de CEP, mensageria segmentada por PDP.

5. Checklist final antes de publicar

  1. Teste com um CEP real na PDP e no carrinho para validar cache e mensagens.
  2. Simule o checkout completo e confirme se os valores batem com sua tabela.
  3. Force o modo contingência (desconecte temporariamente a API) para garantir que as tabelas de backup respondem.
  4. Revise regras de frete grátis e histórico de alterações para alinhar com o time comercial.
  5. Ative alertas e defina quem receberá notificações em caso de falhas.

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: outubro de 2025