Skip to main content

​
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
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.

​
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:
A resposta retorna todos os carriers elegíveis com preço, prazo e score. Veja API Reference 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.
  • 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