# 14.5 Baixar relatório (CSV)

> Os dois arquivos CSV que o Painel e relatórios exporta, Cotações e Remessas, as colunas de cada um e como abrir numa planilha.

Fonte: https://www.cotafrete.app/manual/painel-e-relatorios/baixar-relatorio/
Planos: Business
No app: Painel e relatórios → Baixar relatório
Atualizado em 25/10/2026

---

As abas do Painel e relatórios respondem às perguntas mais comuns. Quando você precisa de um cruzamento que a tela não faz, como juntar o frete com o custo do produto ou montar um gráfico próprio, exporte os dados. O botão **Baixar relatório**, no topo da tela, gera arquivos CSV que abrem em qualquer planilha.

## Os dois arquivos

O botão oferece dois arquivos separados, porque eles descrevem coisas diferentes:

| Arquivo | Uma linha por | Use para |
|---|---|---|
| **Cotações (CSV)** | Pedido pago com frete do app: quanto o frete custaria pela tarifa cheia e quanto o cliente pagou | Analisar custo de frete, frete absorvido e campanhas |
| **Remessas (CSV)** | Envio rastreado: datas de envio, movimento e entrega | Analisar prazos, atrasos e desempenho das transportadoras |

Os dois respeitam o **período escolhido no topo da tela**. As abas e os filtros da tela não mudam o arquivo: a exportação de Remessas traz todas as remessas do período, não só as do filtro aberto.

## Como baixar

1. Abra **Painel e relatórios** e escolha o período no topo.
2. Clique em **Baixar relatório**.
3. Escolha **Cotações (CSV)** ou **Remessas (CSV)**.
4. O arquivo é baixado pelo navegador, com a data no nome.


## As colunas de Cotações

Os nomes das colunas vêm em inglês, como o app os guarda. Valores em reais saem com vírgula decimal; datas, no horário de Brasília.

| Coluna | O que é |
|---|---|
| `order_name` | Número do pedido na Shopify (ex.: #1042) |
| `carrier_display_name` | Transportadora, gateway ou tabela de frete própria |
| `rate_name` | Nome do frete como apareceu no checkout |
| `service_code` | Código do serviço |
| `shipping_city`, `shipping_state` | Cidade e UF de destino |
| `order_value` | Subtotal dos produtos, sem o frete |
| `rate_value` | Frete pela tarifa cheia |
| `paid_value` | Frete que o cliente pagou |
| `absorbed_cost` | Frete absorvido pela loja (`rate_value` menos `paid_value`) |
| `is_free` | `true` quando o cliente não pagou frete |
| `updated_at` | Data e hora do registro do pedido pago |

## As colunas de Remessas

| Coluna | O que é |
|---|---|
| `order_name` | Número do pedido na Shopify |
| `carrier` | Transportadora |
| `tracking_number` | Código de rastreio |
| `last_status` | Último status, em inglês, como a Shopify usa: `CONFIRMED`, `IN_TRANSIT`, `OUT_FOR_DELIVERY`, `READY_FOR_PICKUP`, `ATTEMPTED_DELIVERY`, `DELAYED`, `DELIVERED`, `FAILURE` |
| `last_status_at` | Data e hora do último status |
| `first_movement_at` | Data e hora do primeiro status registrado |
| `delivered_at` | Data e hora da entrega |
| `promised_date` | Data prometida na cotação do checkout |
| `shipping_city`, `shipping_state`, `destination_cep` | Cidade, UF e CEP de destino |

Os status correspondem, na ordem, a Confirmado, Em trânsito, Saiu para entrega, Disponível para retirada, Tentativa de entrega, Atrasado, Entregue e Falha. Veja [Rastreamento automático](https://www.cotafrete.app/manual/pedidos/rastreamento-automatico/).

## Abrir numa planilha

CSV é um arquivo de texto com uma linha por registro e colunas separadas por vírgula. Ele abre no Excel, no Google Planilhas e no LibreOffice.

> **Acentos ou colunas embaralhadas?:** O arquivo usa vírgula para separar colunas e também como separador decimal dos valores em reais, que por isso vêm entre aspas. Se os acentos aparecerem quebrados ou todas as colunas caírem numa só, não abra o arquivo com duplo clique. Use a importação da planilha: no Google Planilhas, **Arquivo → Importar**; no Excel, **Dados → De texto/CSV**. Escolha a codificação UTF-8 e a vírgula como separador.

## Ideias de análise

- **Margem de contribuição com frete.** Cruze o arquivo de Cotações com o custo dos produtos para ver quanto cada pedido deixou depois do frete absorvido.
- **Custo de uma campanha.** Filtre os pedidos do período da campanha e some `absorbed_cost`. Compare com o aumento de pedidos ou de ticket.
- **Atraso por transportadora e estado.** No arquivo de Remessas, compare `delivered_at` com `promised_date` e monte uma tabela dinâmica com transportadora nas linhas e estado nas colunas.

Para leituras que a tela já faz, como frete absorvido por estado ou volume por transportadora, a [aba Relatório detalhado](https://www.cotafrete.app/manual/painel-e-relatorios/aba-relatorio-detalhado/) é mais rápida que a planilha.