# Como instalar e configurar o Cota Frete na Shopify > Guia passo a passo para instalar, configurar e começar a usar o app Cota Frete em sua loja Shopify. Fonte: https://www.cotafrete.app/como-instalar/ --- 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](https://www.cotafrete.app/integracoes/). > Dica: assista ao vídeo e mantenha este guia aberto para marcar cada etapa diretamente no admin da Shopify. ## Navegue pelo tutorial - [1. Pré-requisitos e instalação](#1-pré-requisitos-e-instalação) - [2. Onboarding guiado no app](#2-onboarding-guiado-no-painel-do-app) - [3. Exibição na página do produto, carrinho, gaveta e checkout](#3-exibição-nas-páginas-da-loja) - [4. Recursos que valem conhecer](#4-recursos-que-valem-conhecer) - [5. Checklist final](#5-checklist-final-antes-de-publicar) - [6. Suporte e materiais extras](#6-suporte-e-materiais-adicionais) --- ## 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](https://apps.shopify.com/) 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](https://www.cotafrete.app/images/listing/app.webp) 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](https://www.cotafrete.app/images/listing/app_transportadoras.webp) 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](https://www.cotafrete.app/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](https://www.cotafrete.app/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](https://www.cotafrete.app/central-de-ajuda/cotacao-frete-gaveta-carrinho-shopify/). ### 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](https://www.cotafrete.app/central-de-ajuda/ativar-carrier-calculated-shipping-ccs-shopify/). --- ## 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](https://www.cotafrete.app/central-de-ajuda/identificar-transportadora-servico-pedido-erp/). - **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](https://www.cotafrete.app/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 - **Central de ajuda**: tutoriais de credenciamento, conexão de gateways e configuração em [/central-de-ajuda/](https://www.cotafrete.app/central-de-ajuda/). - **E-mail**: [suporte@cotafrete.app](mailto:suporte@cotafrete.app) - **Vídeo passo a passo**: [assista ao tour completo do app](https://youtu.be/tMueoYLPvmc) sempre que surgir dúvida em novas ativações. --- *Última atualização: agosto de 2026*