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

# Configurando Frota Própria & Motoristas

> Como despachar pedidos para veículos da sua empresa e motoristas usando o app PWA.

Se a sua empresa possui vans, caminhões ou fiorinos próprias para entregas locais e regionais, o BulkRoute orquestra e roteiriza essas entregas em conjunto com as transportadoras terceirizadas.

## Como funciona

```
Pedido → BulkRoute cota Frota Própria + Carriers → Escolhe Frota → Despacha para App do Motorista
```

A Frota Própria é tratada como uma "transportadora" dentro do BulkRoute — ela participa das cotações, tem regras de pricing e pode ser escolhida manual ou automaticamente pelo orquestrador.

## 1. Cadastrando Veículos

1. Vá em **Frota** > **Veículos**.
2. Clique em **Novo Veículo** e preencha:
   * **Placa** e **Modelo** (ex: Mercedes Sprinter, Fiat Fiorino).
   * **Capacidade Máxima em Peso (kg)**.
   * **Volume Útil Máximo ($m^3$)**.
   * **Restrições**: Ex: Restrição de circulação no centro urbano (ZMRC).
   * **Status**: Ativo / Inativo.

### Validação automática

O BulkRoute valida se o veículo suporta a carga antes de incluir a Frota Própria na cotação:

* Peso total ≤ capacidade máxima
* Volume total ≤ volume útil máximo
* Sem restrições de circulação no CEP de destino

Se o veículo não suportar, a Frota Própria é descartada da cotação.

## 2. Cadastrando Motoristas

1. Vá em **Frota** > **Motoristas**.
2. Cadastre o nome, celular e CNH do condutor.
3. Defina a senha de acesso ao **App do Motorista (PWA)**.
4. Atribua um veículo padrão.
5. Envie o link de acesso ao motorista: [driver.bulkroute.com.br](https://driver.bulkroute.com.br).

<Note>
  Cada motorista pode ter um veículo padrão, mas pode trocar de veículo no app se precisar (ex: van em manutenção, pegou uma fiorino emprestada).
</Note>

## 3. Regras de Frete da Frota Própria

No módulo de transportadoras, ao ativar a **Frota Própria**, você pode configurar:

### Preço por KM rodado

O sistema calcula a distância real via roteirizador OSRM (Open Source Routing Machine):

```
Preço = KM × preço_por_km + taxa_fixa
```

Exemplo:

* Distância: 25 km
* Preço por KM: R\$ 2,50
* Taxa fixa: R\$ 15,00
* **Total: R\$ 77,50**

### Taxa fixa de saída / diária

* **Taxa de saída**: valor cobrado independentemente da distância (ex: R\$ 15)
* **Diária**: valor fixo por dia de trabalho (ex: R\$ 120)

### Prazo estimado

* **Same-day (mesmo dia)**: para CEPs dentro do raio de atuação
* **D+1**: para CEPs próximos mas fora do raio same-day
* **D+2 ou mais**: para CEPs mais distantes

### Raio de atuação

Defina o raio máximo (em km) que sua frota cobre:

| Configuração  | Exemplo |
| :------------ | :------ |
| Raio same-day | 30 km   |
| Raio D+1      | 80 km   |
| Raio máximo   | 150 km  |

CEPs fora do raio máximo não recebem cotação da Frota Própria.

## 4. Roteirização

Quando você despacha múltiplas entregas para a Frota Própria:

1. O BulkRoute agrupa as entregas por zona
2. O roteirizador OSRM calcula a **melhor sequência** de paradas
3. O motorista vê a lista ordenada no app
4. O sistema minimiza KM total e tempo de rota

### Otimização

O BulkRoute considera:

* **Janelas de entrega** (se agendadas)
* **Prioridade** (entregas urgentes primeiro)
* **Capacidade do veículo** (não exceder peso/volume)
* **Tempo médio por parada** (configurável — padrão 15 min)

## 5. Comprovante de Entrega (POD)

O motorista registra a entrega no app com:

* Foto do canhoto assinado
* Assinatura na tela do aparelho
* Nome do recebedor
* Geolocalização GPS
* Data/hora

O POD fica disponível no painel em **Shipments** > detalhe > aba **POD**.

## 6. Tracking em tempo real

Quando o shipment está `OUT_FOR_DELIVERY`:

* O app envia a posição GPS a cada 10 segundos
* O gestor vê o motorista no mapa em tempo real
* O cliente final vê (na página de tracking live)
* **Estritamente limitado ao status OUT\_FOR\_DELIVERY** — não rastreia fora do horário

## 7. Frota Própria vs Carriers terceirizados

| Critério       | Frota Própria                           | Carrier terceirizado          |
| :------------- | :-------------------------------------- | :---------------------------- |
| **Custo**      | Variável (KM + combustível + motorista) | Fixo por tabela contratual    |
| **Prazo**      | Same-day ou D+1                         | 2-7 dias úteis                |
| **Controle**   | Total (você gerencia)                   | Limitado (depende do carrier) |
| **Capacidade** | Limitada à sua frota                    | Praticamente ilimitada        |
| **Ideal para** | Entregas locais, same-day, urgências    | Longa distância, volume alto  |

O orquestrador do BulkRoute pode misturar ambos — usando Frota Própria para entregas próximas e carriers para longa distância, automaticamente.

## Troubleshooting

| Problema                      | Causa                            | Solução                                          |
| :---------------------------- | :------------------------------- | :----------------------------------------------- |
| Frota não aparece na cotação  | Veículo sem capacidade           | Verificar peso/volume do shipment                |
| Cotação muito cara            | KM alto + taxa fixa              | Ajustar preço por KM                             |
| Motorista não recebe entregas | Status inativo                   | Ativar motorista em Frota > Motoristas           |
| GPS não atualiza              | App sem permissão de localização | Habilitar localização no celular                 |
| POD não sincroniza            | Sem internet                     | Motorista precisa sincronizar quando tiver sinal |