> For the complete documentation index, see [llms.txt](https://docs.shippify.co/developers/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.shippify.co/developers/pt/shippify-api/rotas/criar-rota.md).

# Criar rota

## Criação de rotas

> Endpoint que permite criar rotas a partir de entregas fornecidas.

```json
{"openapi":"3.0.0","info":{"title":"API Shippify","version":"1.0.0"},"servers":[{"url":"https://api.shippify.co","description":"Servidor de desenvolvimento"}],"security":[{"Basic_Auth":[]}],"components":{"securitySchemes":{"Basic_Auth":{"type":"http","scheme":"basic"}},"schemas":{"createRoutes":{"successfulResponse":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"data":{"type":"object","description":"Information of the additional processes created (in case the delivery belongs to a route)","properties":{"jobs":{"description":"Identifier of the external process created","type":"string"}}}}},"request":{"type":"object","required":["routes","iterations"],"properties":{"routes":{"description":"Set of deliveries, each item will create a route","type":"array","items":{"required":["deliveries"],"type":"object","properties":{"deliveries":{"type":"array","description":"Identifiers of the deliveries to be routed. Minimum 2 deliveries.","items":{"type":"string"}}}}},"iterations":{"description":"Indicates the level of optimization with which the route will be created","type":"integer","minimum":1,"maximum":10}}}},"Unauthenticated":{"properties":{"code":{"type":"string"},"message":{"type":"string"}},"type":"object"}}},"paths":{"/v1/routes/create":{"post":{"tags":["Criação, Rotas"],"summary":"Criação de rotas","description":"Endpoint que permite criar rotas a partir de entregas fornecidas.","responses":{"200":{"description":"Operação bem-sucedida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/createRoutes/successfulResponse"}}}},"401":{"description":"Não autorizado","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Unauthenticated"}}}}},"requestBody":{"description":"Aqui vai a descrição","content":{"application/json":{"schema":{"$ref":"#/components/schemas/createRoutes/request"}}}}}}}}
```

## Casos de uso 

<details>

<summary>Criar rota com uma ordem específica de entrega</summary>

```json
{
    "routes": [
        {
            "deliveries": [
              "t-pruaas-4973",
              "t-pruaas-4972"
            ]
        }
    ],
    "iterations": 1
}
```

</details>

<details>

<summary>Criar rotas com otimização média a partir de entregas inseridas</summary>

```json
{
    "routes": [
        {
            "deliveries": [
              "t-pruaas-4973",
              "t-pruaas-4972"
            ]
        }
    ],
    "iterations": 5
}
```

</details>

<details>

<summary>Criar rotas com otimização alta a partir de entregas inseridas.</summary>

```json
{
    "routes": [
        {
            "deliveries": [
              "t-pruaas-4973",
              "t-pruaas-4972"
            ]
        }
    ],
    "iterations": 10
}
```

</details>