# 1.3 Instalar o app

> Como instalar o Cota Frete pela Shopify App Store, que permissões ele pede e onde ele aparece no admin.

Fonte: https://www.cotafrete.app/manual/primeiros-passos/instalar-o-app/
Planos: Widget, Basic, Business
Atualizado em 25/10/2026

---

O Cota Frete é distribuído pela Shopify App Store. Não há cadastro separado: a conta do app é a própria loja Shopify, e a cobrança acontece na fatura da Shopify.

## Passo a passo

1. Abra a página do [Cota Frete na Shopify App Store](https://apps.shopify.com/cota-frete) com a conta da loja já conectada.
2. Clique em **Instalar**. A Shopify mostra as permissões que o app pede.
3. Revise as permissões e confirme a instalação.
4. O app abre dentro do admin da Shopify, na tela **Início**.

Depois de instalado, o Cota Frete aparece na lista de apps do menu lateral do admin. É por ali que você volta ao app.


## Por que o app pede essas permissões

O Cota Frete pede acesso a quatro grupos de dados da loja:

- **Frete e entrega**: para se registrar como serviço de cotação no checkout da Shopify e ler os perfis de entrega.
- **Produtos**: para ler peso e medidas e montar o pacote da cotação.
- **Pedidos e atendimento de pedidos**: para gravar a transportadora e o serviço escolhidos, registrar o andamento da entrega no pedido e montar os relatórios.
- **Localizações da loja**: para cotar a partir do endereço de cada local de envio, quando a loja usa perfis de entrega.

As credenciais das transportadoras e dos gateways que você cadastrar depois ficam guardadas no servidor do app. A tela mostra só uma máscara (`••••••••1b5a`), e o valor real aparece apenas quando você clica para exibir.

## O que acontece na instalação

Na primeira abertura, o app mostra a janela de boas-vindas, que pede o CEP de origem, a caixa padrão e uma transportadora. Nada aparece na loja ainda:

- **Página do produto, carrinho e gaveta**: o widget só aparece depois que você ativa o bloco do app no tema.
- **Checkout**: o app se registra na Shopify como serviço de cotação quando a loja assina o plano Basic ou Business. A partir daí, se a loja tem o Carrier Calculated Shipping (CCS, "cotação calculada pela transportadora") ativo, o Cota Frete aparece no checkout assim que houver uma transportadora configurada.

Tudo isso é feito no [guia de configuração](https://www.cotafrete.app/manual/primeiros-passos/guia-de-configuracao/).

Lojas de desenvolvimento, de parceiros da Shopify, recebem o plano Business sem cobrança enquanto continuarem sendo lojas de desenvolvimento.

## Próximo passo

[Escolha o plano](https://www.cotafrete.app/manual/primeiros-passos/planos-e-teste/) e comece o teste de 14 dias.