> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bulkroute.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Como Cotar Frete

> Simule fretes para qualquer carga — de sofás a peças de caminhão — e compare transportadoras em segundos.

## Quando usar

Você precisa saber quanto vai custar enviar uma carga e qual transportadora entrega no prazo certo. A cotação é **gratuita** e não cria envio — é só uma simulação.

## Cotação pelo painel

1. Acesse **Orquestra** > **Cotações** (`/admin/quotes`)
2. Preencha:
   * **CEP de origem** (de onde sai)
   * **CEP de destino** (para onde vai)
   * **Itens**: peso, comprimento, largura, altura, valor declarado e quantidade
3. Clique em **Cotar**
4. O BulkRoute mostra todas as transportadoras que atendem a rota, com:
   * **Preço** do frete
   * **Prazo** de entrega em dias úteis
   * **Transportadora** (logo e nome)
   * **Score** de qualidade da carrier

<Note>
  Para cargas volumosas (móveis, eletrodomésticos), informe sempre as dimensões reais. O BulkRoute calcula o **peso cubado** automaticamente e usa o maior valor entre peso real e cubado — é assim que a transportadora cobra.
</Note>

## Como o BulkRoute escolhe as transportadoras

Quando você cota, o BulkRoute aplica estes filtros em sequência:

1. **CEP atendido?** — a transportadora cobre a rota origem → destino?
2. **Dimensões suportadas?** — a carga cabe no veículo da transportadora?
3. **Restrições do produto?** — há regras que bloqueiam esta carrier para este tipo de carga?
4. **Cálculo de preço e prazo** — aplica cubagem e retorna o valor final

As transportadoras que passam em todos os filtros aparecem na lista, ordenadas pelo melhor custo-benefício.

## Cotação via API (para seu e-commerce)

Se você tem um checkout online, pode integrar a cotação direto via API:

```bash theme={null}
curl -X POST "https://api.bulkroute.com.br/api/quotes" \
  -H "X-API-Key: bk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "destinationZip": "01310100",
    "originZip": "80000000",
    "items": [
      {
        "weight": 40,
        "length": 200,
        "width": 90,
        "height": 85,
        "value": 2500,
        "quantity": 1
      }
    ]
  }'
```

A resposta retorna todos os carriers elegíveis com preço, prazo e score. Veja [API Reference](/api-reference/openapi) para detalhes completos.

## Peso cubado: por que importa para carga pesada

Para cargas volumosas, a transportadora cobra pelo **maior** entre:

* **Peso real**: o peso na balança
* **Peso cubado**: `(Comprimento × Largura × Altura) ÷ fator`

O fator padrão do BulkRoute é **200**. Cada transportadora pode ter seu próprio fator.

### Exemplo

Um sofá de 3 lugares: 40 kg reais, dimensões 200×90×85 cm.

* Peso real: **40 kg**
* Peso cubado (fator 200): `(200 × 90 × 85) ÷ 200 = 7.650 kg`

A transportadora cobra pelos 7.650 kg (peso cubado). O BulkRoute calcula isso sozinho — você só precisa informar as dimensões reais.

## Regras de envio (avançado)

Você pode criar regras que alteram a cotação automaticamente:

* **Se peso > 30kg** → adicionar R\$ 20 de surcharge
* **Se valor > R\$ 500** → exigir seguro
* **Se CEP começa com 0** → bloquear carrier X
* **Se região = Sul** → usar apenas SSW

Para criar regras: **Orquestra** > **Regras de Envio** > **Nova Regra**.

<Accordion title="Detalhes técnicos da API">
  * Endpoint: `POST /quotes`
  * Autenticação: `X-API-Key` header
  * Resposta: `{ success, data: { quotes: [...] }, meta }`
  * Cache: 5 minutos (configurável via `QUOTE_CACHE_TTL_SECONDS`)
  * Rate limit: 100 req/min por API key
</Accordion>