# 1.5 Guia de configuração da tela Início

> Os cinco passos do bloco Configurar o Cota Frete, da primeira transportadora ao checkout, e a configuração mínima que o app pede antes de cotar.

Fonte: https://www.cotafrete.app/manual/primeiros-passos/guia-de-configuracao/
Planos: Widget, Basic, Business
No app: Início
Atualizado em 25/10/2026

---

Quando você abre o app pela primeira vez, duas coisas guiam a configuração: uma janela de boas-vindas, que pede o mínimo para o app conseguir cotar, e o bloco **Configurar o Cota Frete**, na tela **Início**, com cinco passos e uma barra de progresso.

Esta página percorre os dois e explica o porquê de cada etapa.

## Antes de tudo: a configuração mínima

Na primeira visita, a janela **Bem-vindo ao CotaFrete - Frete e Rastreio** lista o que o app precisa para cotar:

- o **CEP de origem**, de onde os pedidos saem;
- a **caixa padrão**, as medidas usadas quando o app não sabe o tamanho do pacote;
- pelo menos uma **transportadora** habilitada.

O botão **Configurar agora** abre a aba **Geral** da tela Transportadoras. Ali você salva o CEP de origem, e um aviso leva à aba **Caixas** para cadastrar a caixa padrão. Enquanto esses dados faltarem, a aba Geral mostra o aviso **Complete as configurações gerais**.

1. Abra **Transportadoras → Geral**.
2. Em **CEP de origem dos envios**, informe o CEP do endereço de expedição.
3. Clique em **Salvar** na barra da Shopify, no topo da tela.
4. Abra a aba **Caixas** e preencha a caixa padrão (os campos **Fallback de altura**, **Fallback de largura** e **Fallback de comprimento**). Salve.

Os detalhes de cada campo estão em [Aba Geral](https://www.cotafrete.app/manual/transportadoras/aba-geral/) e [A tela Caixas](https://www.cotafrete.app/manual/produtos-e-caixas/tela-caixas/).

![Janela Bem-vindo ao CotaFrete - Frete e Rastreio, com CEP de origem, caixa padrão e transportadora, e os botões Agora não e Configurar agora](https://www.cotafrete.app/manual/images/manual/inicio-boas-vindas.webp)

## Os cinco passos do guia

O bloco **Configurar o Cota Frete** mostra o próximo passo pendente aberto, com a explicação e um botão. Os passos feitos ganham um sinal de concluído. Quando todos os obrigatórios estão feitos, o guia se fecha sozinho.

![Bloco Configurar o Cota Frete na tela Início, com os cinco passos do guia](https://www.cotafrete.app/manual/images/manual/inicio-guia-de-configuracao.webp)

### 1. Conectar transportadoras

O app precisa de pelo menos uma origem de cotação ativa. O botão **Conectar transportadoras** abre a tela **Transportadoras**. O passo conta como feito assim que uma transportadora ou um gateway está ativo e com credenciais válidas.

O caminho mais curto para a primeira cotação são os **Correios sem contrato**:

1. Abra **Transportadoras → Correios**.
2. Ligue o interruptor **Ativo**.
3. Em **Tipo de contrato**, escolha **Contrato Cota Frete (SIGEP/Contrato)** se a loja não tem contrato com os Correios, ou **Com contrato (SIGEP/Contrato)** se tem.
4. Informe o **CEP de Origem**.
5. Em **Serviços do contrato**, marque os serviços que quer oferecer (PAC, SEDEX e os demais).
6. Clique em **Salvar** na barra da Shopify.

Cada transportadora tem a sua página no capítulo [Transportadoras](https://www.cotafrete.app/manual/transportadoras/). Se a loja cota por um gateway, veja [Gateways de frete](https://www.cotafrete.app/manual/gateways-de-frete/). Para cotar pela planilha de uma transportadora contratada, veja [Fretes Próprios](https://www.cotafrete.app/manual/fretes-proprios/).

> **Atenção:** Antes de testar, confira se **todos os produtos têm peso** na Shopify. Item sem peso é cotado com o **Peso padrão por item** da aba Geral, que raramente é o peso real. Veja [Peso dos produtos](https://www.cotafrete.app/manual/produtos-e-caixas/peso-dos-produtos/).

### 2. Usar as medidas dos produtos (opcional)

Este é o único passo opcional. O botão **Configurar medidas e caixas** abre a aba **Caixas**, onde você informa onde estão as medidas dos produtos e cadastra as caixas em que despacha. Com isso, a cotação passa a usar o tamanho real do pacote em vez da caixa padrão.

O passo conta como feito quando a loja tem uma caixa ativa e as três medidas configuradas. Ele não segura o fechamento do guia. Veja [Como o pacote é calculado](https://www.cotafrete.app/manual/como-funciona/calculo-do-pacote/).

### 3. Definir regras de frete

O botão **Definir regras de frete** abre a tela **Regras de frete**, onde você cria regras que bloqueiam, renomeiam, agrupam, limitam ou acrescentam valor às opções de frete. O passo conta como feito quando existe pelo menos uma regra ativa ou um desconto ativo.

A tela Regras de frete faz parte dos planos Basic e Business. Veja o capítulo [Regras de frete](https://www.cotafrete.app/manual/regras-de-frete/).

### 4. Configurar frete grátis

O botão **Configurar frete grátis** abre a tela **Descontos**. Frete grátis, no Cota Frete, é um desconto de 100% com as condições que você escolher (estado, valor mínimo, serviço, período). O passo conta como feito quando existe um desconto de 100% ativo.

Descontos fazem parte do plano Business. Veja [Frete grátis condicional](https://www.cotafrete.app/manual/descontos/frete-gratis-condicional/).

### 5. Publicar no checkout

No checkout não há bloco para adicionar. Quem pede a cotação é a própria Shopify, e ela só faz isso se a loja tiver o Carrier Calculated Shipping (CCS, "cotação calculada pela transportadora") ativo. O botão **Como ativar o CCS** abre o passo a passo. O passo conta como feito quando o app detecta o CCS ativo na loja.

A cotação no checkout faz parte dos planos Basic e Business. Para conferir que o Cota Frete está no perfil de entrega da loja, veja [Conferir o Cota Frete na Shopify](https://www.cotafrete.app/manual/checkout/conferir-na-shopify/).

## E o widget na página do produto?

O guia não tem um passo para o widget, mas ele é o que o cliente vê antes do checkout, e funciona em qualquer plano. Ele aparece na loja por meio de um bloco de app, que você adiciona ao tema no editor de temas da Shopify.

1. Abra **Widgets da loja → Widget de cotação**.
2. Clique em **Ativar no tema**. O editor de temas da Shopify abre.
3. Adicione o bloco do Cota Frete na página do produto, posicione e clique em **Salvar** no editor.

O passo a passo completo, inclusive para o carrinho e a gaveta, está em [Widget na página do produto](https://www.cotafrete.app/manual/widgets-da-loja/pagina-do-produto/).

## Fechar e reabrir o guia

O **X** no canto do bloco esconde o guia. Para abrir de novo, clique em **Ver guia de configuração**, no topo da tela Início. Esse botão só aparece enquanto o guia está escondido.

## Depois do guia

Com os passos feitos, a loja já cota frete. Antes de divulgar, passe pelo [checklist antes de publicar](https://www.cotafrete.app/manual/primeiros-passos/checklist-antes-de-publicar/). Os ajustes que a maioria das lojas faz em seguida são:

- **Dias de processamento**, na [aba Geral](https://www.cotafrete.app/manual/transportadoras/aba-geral/), para somar o tempo de separação ao prazo de todas as transportadoras.
- [Acréscimo](https://www.cotafrete.app/manual/regras-de-frete/acrescimo/), para somar valor ou dias a uma transportadora ou serviço específico.
- [Prazo no checkout](https://www.cotafrete.app/manual/checkout/prazo-no-checkout/), para mostrar uma data em vez de "X dias úteis".
- [Personalizar o widget](https://www.cotafrete.app/manual/widgets-da-loja/personalizar-o-widget/), para o bloco seguir o visual da loja.
