# Agrupar Pedidos em uma Rota — JobsNovo API

> Como enviar múltiplos pedidos para a mesma rota usando o campo `CodigoRota`.

---

## Como funciona

Por padrão, cada chamada ao endpoint `POST api/JobsNovo/SalvarValidandoCodigoDuplicado` cria um pedido em uma rota própria. Para agrupar pedidos na mesma rota, basta informar o mesmo valor no campo `CodigoRota` em todas as chamadas do grupo.

---

## Campo CodigoRota

| Valor | Comportamento |
|-------|--------------|
| `0`   | Cria uma nova rota automaticamente para o pedido |
| `> 0` | Agrupa o pedido em uma rota existente com esse código. Se ainda não existir, cria uma nova rota com esse código |

> **O código da rota é definido por você.** Use qualquer número inteiro positivo como identificador do grupo. Ex: número do pedido de venda, número do lote, etc.

---

## Exemplo — 4 pedidos na mesma rota

Envie os pedidos com o mesmo `CodigoRota` e a mesma `DataExecucao`:

```json
POST api/JobsNovo/SalvarValidandoCodigoDuplicado

// Pedido 1
{
  "CodigoJob": "OS-001",
  "CodigoRota": 5001,
  "DataExecucao": "2026-07-25 08:00",
  ...
}

// Pedido 2
{
  "CodigoJob": "OS-002",
  "CodigoRota": 5001,
  "DataExecucao": "2026-07-25 08:00",
  ...
}

// Pedido 3
{
  "CodigoJob": "OS-003",
  "CodigoRota": 5001,
  "DataExecucao": "2026-07-25 08:00",
  ...
}

// Pedido 4
{
  "CodigoJob": "OS-004",
  "CodigoRota": 5001,
  "DataExecucao": "2026-07-25 08:00",
  ...
}
```

Resultado: todos os 4 pedidos ficam agrupados na rota `5001`, visível no Admin como uma única rota com 4 OSs.

---

## Regra de agrupamento

Para que dois pedidos entrem na mesma rota, é necessário que:

1. **Mesmo `CodigoRota`**
2. **Mesma data de execução** (dia, mês e ano de `DataExecucao`)
3. **Mesmo estabelecimento** (identificado pela API Key)

Se qualquer uma dessas condições não for atendida, uma nova rota é criada automaticamente.

---

## Ordem dos pedidos na rota

Os pedidos entram na rota na ordem em que as chamadas chegam à API. O primeiro pedido recebe `Ordem = 1`, o segundo `Ordem = 2`, e assim por diante.

---

## Verificando a rota criada

Após enviar todos os pedidos, você pode consultar a rota pelo código informado usando:

```
GET api/JobsNovo/GetByRota?rotaId={id}
```

Ou visualizar diretamente no **Admin → Rotas**, filtrando pela data de execução.