# Tabela de frete própria: cote pela planilha da transportadora contratada

> Como importar a planilha de frete de uma transportadora contratada que não tem integração e cotar por ela na página do produto, no carrinho e no checkout da Shopify. Formato da planilha, como a conta é feita, prazo e acréscimos, bloqueios por CEP, frete grátis, agrupamento e o que conferir quando a tabela não aparece.

Fonte: https://www.cotafrete.app/central-de-ajuda/tabela-de-frete-propria-transportadora-contratada/
Publicado em 17/09/2026 · atualizado em 07/10/2026 · categorias: Shopify, Tutoriais

---

Muita transportadora regional não tem API. O contrato vem numa planilha: faixas de CEP, prazo, preço por peso e uma lista de taxas. Sem integração, o frete dela não aparecia na loja.

Com a **tabela de frete própria**, você importa essa planilha e o Cota Frete cota por ela na página do produto, no carrinho e no checkout, ao lado das transportadoras integradas. A tabela segue as mesmas regras das outras transportadoras: dias de processamento, acréscimos, bloqueios por CEP, descontos, frete grátis, agrupamento e relatórios. Recurso do plano **Business**.

## Quando a tabela própria vale a pena

- **Regional mais barata no seu estado.** A transportadora contratada cobre o Sul ou o Sudeste com preço melhor que os Correios. Importe só as faixas que ela atende: fora delas, o cliente vê as outras opções normalmente.
- **Frete grátis pela transportadora que você escolheu.** Em vez de dar frete grátis no que vier mais barato, você dá só na tabela própria, onde a margem é sua.
- **Contrato com tabela negociada.** A transportadora tem API, mas a tarifa do seu contrato só existe na planilha que o comercial mandou.
- **Entrega rápida na cidade.** Áreas com prazo em minutos viram opção de entrega no mesmo dia, com descrição "Entrega em 45 minutos".

## Antes de começar

- A cotação no checkout segue a regra de sempre: precisa do CCS ativo na loja.
- O **peso padrão por item** e as **dimensões padrão da caixa** vêm das configurações gerais, em **Transportadoras → Geral**. O peso padrão cobre produtos sem peso cadastrado; as dimensões entram no peso cubado.
- Tenha em mãos a tabela do contrato. Baixe a [planilha modelo](https://www.cotafrete.app/downloads/modelo-tabela-de-frete-cota-frete.xlsx) para ver o formato preenchido.

## Monte a planilha

Um único arquivo `.xlsx` com duas abas, com estes nomes: `areas` e `pesos`. Outras abas são ignoradas.

### Aba `areas`: uma linha por faixa de CEP

| Coluna | O que vai nela |
|---|---|
| `area_code` | Código que liga a faixa às faixas de peso. Ex.: `SPC`. Obrigatória |
| `area_name` | Nome da área, só para você se achar. Opcional |
| `start_zip_code` | Primeiro CEP da faixa, com 8 dígitos. Obrigatória |
| `end_zip_code` | Último CEP da faixa, com 8 dígitos. Obrigatória |
| `delivery_time` | Prazo. Obrigatória |
| `delivery_time_unit` | `day` para dias ou `minute` para minutos. Se ficar vazia, vale `day` |
| `minimum_value` | Frete mínimo da área, em reais |
| `excess_weight_price` | Valor por kg acima da última faixa de peso, em reais |

As taxas do contrato também entram nessa aba, uma coluna para cada:

- **Percentual sobre o valor do pedido**: `ad_valorem`, `gris`, `iss`, `fluvial_insurance`. Escreva o percentual: `0.3` é 0,3%.
- **Valor fixo em reais**: `pedagio` (ou `toll`), `despacho` (ou `dispatch`), `tas`, `tde`, `trt`, `tsa`.

Várias faixas de CEP podem usar o mesmo `area_code`. É o caso comum: a capital tem mais de uma faixa e todas custam igual.

### Aba `pesos`: o preço de cada faixa de peso

| Coluna | O que vai nela |
|---|---|
| `area_code` | O mesmo código da aba `areas` |
| `start_weight_kg` | Peso inicial da faixa, em kg |
| `end_weight_kg` | Peso final da faixa, em kg |
| `price` | Preço da faixa, em reais |

### Três cuidados que evitam quase todo erro

- **CEP como texto.** O Excel apaga o zero da frente dos CEPs de São Paulo (`01001000` vira `1001000`). Formate as colunas de CEP como texto antes de colar.
- **Faixas não podem se sobrepor.** Nem duas faixas de CEP, nem duas faixas de peso da mesma área. Faixas encostadas valem: `0` a `1` kg e `1` a `2` kg. O peso exato do limite fica na faixa de baixo.
- **Toda área precisa de faixas de peso.** Um `area_code` na aba `areas` sem linhas na aba `pesos` é erro.

## Cadastre a transportadora e importe

1. No admin da Shopify, abra **Cota Frete → Tabelas de frete** e clique em **Nova transportadora** no menu lateral.
2. Em **Identificação**, preencha o **Nome exibido no checkout** e um **Código** único. A logo é opcional.
3. Em **Tabela de frete**, arraste a planilha ou clique para escolher o arquivo. O nome do arquivo aparece embaixo do campo.
4. Em **Regras de cálculo** e **Limites da operação**, preencha o que o contrato prevê (detalhes abaixo).
5. Clique em **Salvar**, na barra que aparece no topo da tela.

A transportadora entra no menu lateral e a planilha vai para a fila. O status passa por **Na fila**, **Importando** e termina em **Pronta para ativar**, **Pronta, com avisos** ou **Falhou**. Se você enviar outra planilha nesse meio tempo, ela espera a vez.

## Confira a importação

No menu lateral, **Importações** lista todas as planilhas enviadas, com a transportadora, a data, o status e o resultado. Quando alguma falha, o item mostra quantas.

Abra uma importação para ver o detalhe:

- **Problemas encontrados**, com a **aba**, a **linha** e o que aconteceu. Ex.: *aba areas, linha 12: faixa de CEP sobreposta à linha 8*.
- **Baixar planilha enviada**, para corrigir exatamente o arquivo que subiu.
- **Baixar relatório (CSV)**, com a lista de problemas para abrir no Excel ao lado da planilha.

Erro impede a ativação. Aviso não: uma faixa de peso sem faixa de CEP correspondente, por exemplo, só ocupa espaço.

Corrigiu? Volte na transportadora e use **Importar nova tabela**. A tabela em uso continua valendo até você ativar a nova.

## Ative

1. Na importação sem erros, clique em **Ativar tabela**. Ou use **Ativar** no histórico da transportadora.
2. No topo da transportadora, ligue o **Ativo** e clique em **Salvar**.

O **Ativo** só libera quando existe uma tabela ativa. Assim não fica transportadora ligada sem preço para cotar.

Para conferir antes de publicar, use o [simulador de frete](https://www.cotafrete.app/central-de-ajuda/simular-frete-checkout-widget-cota-frete/) na tela Início: ele roda o mesmo cálculo da loja.

## Como o valor é calculado

Para cada CEP, o app acha a faixa da aba `areas` e segue esta ordem:

1. **Preço da faixa de peso** da área. Acima da última faixa, soma o **excedente por kg** sobre o peso que passou. Sem valor de excedente, a transportadora não aparece para esse peso.
2. **Frete valor**, se configurado na transportadora: percentual sobre o valor do pedido.
3. **Taxas da planilha**: as percentuais sobre o valor do pedido, as fixas em reais.
4. **Frete mínimo**: se o total ficou abaixo, vale o mínimo. O da área tem prioridade; o da transportadora cobre as áreas sem mínimo.
5. **ICMS**: só entra se você desligar *Os preços da tabela já incluem ICMS*. Nesse caso é somado por dentro: total ÷ (1 − alíquota).
6. **Acréscimo**: o percentual e depois o valor fixo, os da tabela ou os das configurações gerais (veja **Prazo e acréscimos**, mais abaixo). O valor fixo entra por último, para o percentual não incidir sobre ele.

O **prazo** é o da área na planilha, mais o prazo extra da tabela, mais os dias de processamento das configurações gerais. Conta em dias úteis. Áreas com prazo em minutos não ganham dias.

**Exemplo** com a planilha modelo: pedido de R$ 220,00 e 3 kg para Belo Horizonte (área `MGC`).

| Etapa | Valor |
|---|---|
| Faixa de 2 a 3 kg | R$ 27,17 |
| Ad valorem 0,30% de R$ 220,00 | R$ 0,66 |
| GRIS 0,10% de R$ 220,00 | R$ 0,22 |
| Pedágio | R$ 2,50 |
| Despacho | R$ 5,90 |
| **Total** (acima do mínimo de R$ 16,00) | **R$ 36,45** |

Prazo: 4 dias úteis.

Com acréscimo de 10% e R$ 1,50 e 2 dias de processamento nas configurações gerais, a mesma cotação fica assim: R$ 36,45 + 10% = R$ 40,10, mais R$ 1,50 = **R$ 41,60**, em **6 dias úteis**.

## Regras de cálculo e limites

- **Fator de cubagem**: o que o contrato diz, em kg por m³. O padrão do rodoviário é **300**; do aéreo, **166,7**. O peso cubado é o volume da caixa padrão em m³ vezes o fator: uma caixa de 30 x 30 x 30 cm (0,027 m³) a 300 dá 8,1 kg. O app cobra o maior entre o peso real e o peso cubado. Deixe em branco se o contrato não prevê cubagem.
- **Isenção de cubagem**: abaixo desse peso real, em gramas, a cubagem é ignorada e vale o peso real.
- **Frete valor**: percentual sobre o valor do pedido. Se a planilha já traz `ad_valorem`, deixe em branco para não cobrar duas vezes.
- **Frete mínimo** e **Excedente por kg**: usados nas áreas da planilha que não trazem esses valores.
- **Limites da operação**: peso e medidas máximas que a transportadora aceita. Pedido acima dos limites não recebe cotação dela.

## Prazo e acréscimos

A tabela própria usa as configurações gerais de **Transportadoras → Geral**, como as outras transportadoras:

- **Dias de processamento** somam sempre ao prazo da tabela. Não inclua esses dias na planilha, senão eles contam duas vezes.
- **Acréscimos no frete** (percentual e valor fixo) somam ao preço calculado pela tabela.

Quer um ajuste só para uma transportadora? Abra a transportadora em **Tabelas de frete** e use a seção **Ajustes no frete**:

| Campo | Preenchido | Em branco |
|---|---|---|
| **Prazo extra** | Soma esses dias ao prazo, além dos dias de processamento | Nenhum dia a mais |
| **Valor adicional** (%) | Vale o percentual da tabela | Vale o percentual das configurações gerais |
| **Valor fixo adicional** (R$) | Vale o valor da tabela | Vale o valor das configurações gerais |

**Zero é diferente de vazio.** `0` no valor adicional tira o acréscimo só dessa tabela; em branco, ela segue o geral. Cada campo mostra embaixo o valor geral que vale quando fica vazio.

A regra vale com ou sem a opção **Permitir customização por transportadora** ligada. Mais sobre acréscimos em [Acréscimo de dias e de valor no frete](https://www.cotafrete.app/central-de-ajuda/acrescimo-dias-valor-frete-transportadora-cep/).

## Bloquear uma região

A planilha já limita a cobertura: CEP fora das faixas não recebe cotação. O [bloqueio por CEP](https://www.cotafrete.app/central-de-ajuda/bloquear-ceps-regioes-nao-atendidas/) serve para tirar uma região por um tempo, sem mexer na planilha. Uma enchente, uma greve, uma rota suspensa.

Em **Regras de frete → Bloqueios por CEP**:

- **Por transportadora**, marque **Tabelas próprias**: todas as tabelas ativas somem naquela faixa.
- **Por serviço ou tabela**, marque só a tabela que quer tirar, por exemplo "Trans Sul". As outras continuam aparecendo.

## Frete grátis e descontos

A tabela própria entra nas campanhas de **Regras de frete → Descontos**:

- **Mais barato da cotação**: alcança a tabela quando ela é a opção mais barata.
- **Uma transportadora**: em **Transportadora**, escolha **Tabelas próprias** e marque em **Tabelas com desconto** as que a campanha cobre. Em **Aplicar em**, **Todos os serviços marcados** dá o desconto em cada tabela marcada; **Apenas o mais barato entre eles** dá só na mais barata daquela cotação.

Exemplo: frete grátis acima de R$ 299 só pela transportadora contratada. Crie um desconto de 100%, valor mínimo R$ 299, **Uma transportadora → Tabelas próprias**, com a tabela marcada. Ligue **Mostrar barra** e a [barra de frete grátis](https://www.cotafrete.app/central-de-ajuda/barra-de-frete-gratis-progressiva-shopify/) mostra quanto falta para o cliente chegar lá.

Datas de início e fim, estados e valor mínimo funcionam como em qualquer campanha. Veja [descontos de frete com agendamento](https://www.cotafrete.app/central-de-ajuda/descontos-de-frete-com-agendamento/).

## Agrupamento de frete

No [agrupamento de frete](https://www.cotafrete.app/central-de-ajuda/agrupamento-frete-economico-expresso-normal/), cada tabela ativa aparece na lista de serviços de cada grupo:

- **Marcada** num grupo, a tabela disputa a vaga com os outros serviços e, se ganhar, aparece com o nome do grupo, como "Frete Econômico".
- **Sem marcação** em nenhum grupo, ela continua aparecendo no checkout com o próprio nome, como opção extra. Ligar o agrupamento não esconde uma tabela que você não agrupou.

## Relatórios

Pedidos pagos com a tabela própria entram em **Painel e relatórios → Relatório detalhado**, com o nome da tabela como transportadora. Em **Por transportadora** você compara o **% volume** e o **custo absorvido** dela com os das integradas. Se a tabela for excluída, os pedidos antigos continuam lá como "Tabela própria".

## A tabela não aparece na cotação? Confira

1. **Plano Business.** Fora dele, as tabelas param de cotar. O cadastro fica guardado e volta a valer quando a loja voltar ao Business.
2. **Ativo ligado e tabela ativa.** O **Ativo** da transportadora precisa estar ligado, e uma importação precisa estar ativada.
3. **CEP dentro de alguma faixa** da aba `areas`. CEP de São Paulo começando com zero? Confira se o Excel não apagou o zero.
4. **Peso dentro das faixas**, ou um **excedente por kg** para o que passar da última faixa.
5. **Limites da operação.** Peso e medidas máximas da transportadora.
6. **Bloqueio por CEP** ativo naquela faixa, em **Regras de frete → Bloqueios por CEP**.
7. **No checkout**, o CCS precisa estar ativo na loja.

O [simulador de frete](https://www.cotafrete.app/central-de-ajuda/simular-frete-checkout-widget-cota-frete/) na tela Início ajuda a achar o motivo: simule o CEP e o peso do pedido e veja se a tabela responde.

## Perguntas rápidas

**Posso ter mais de uma transportadora com tabela própria?**
Pode. Cada uma aparece no menu lateral de Tabelas de frete com a sua tabela e o seu status.

**E se a transportadora mudar a tabela?**
Importe a planilha nova na mesma transportadora. A anterior fica no histórico como **Substituída** quando você ativar a nova.

**Aceita CSV?**
Não. Use `.xlsx` com as abas `areas` e `pesos`.

**Que nome o cliente vê no checkout?**
O **Nome exibido no checkout** da transportadora. Se ela vencer um grupo do agrupamento de frete, aparece o nome do grupo.

**Duas tabelas com o mesmo preço: qual ganha o desconto no mais barato?**
Em empate, vale a que aparece primeiro na cotação, em geral a cadastrada primeiro. Se quiser escolher, use **Uma transportadora → Tabelas próprias** e marque só a tabela que deve receber o desconto.

**Dá para dar frete grátis pela tabela só em alguns estados?**
Dá. No desconto, escolha os estados da campanha. Fora deles, a tabela cota com o preço normal.