> For the complete documentation index, see [llms.txt](https://ola.meajuda.cc/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ola.meajuda.cc/delivery-salao/gestao-de-entregas.md).

# Gestão e roteirização de entregas

O Gestor de Entregas é a ferramenta que ajuda você a organizar e acompanhar todas as entregas do seu estabelecimento de forma simples e eficiente.

### O que é o Gestor de Entregas?

É a funcionalidade que permite criar rotas, distribuir pedidos entre entregadores e acompanhar. Com ele, você reduz o tempo de entrega e melhora a experiência dos seus clientes.

{% hint style="info" %}
**Gestão Manual ou Totalmente Automática** Você escolhe como quer gerenciar suas entregas: de forma totalmente manual (criando rotas e escolhendo entregadores), de forma totalmente automática (o sistema faz tudo sozinho).
{% endhint %}

{% hint style="warning" %}
**Importante:** O Gestor de Entregas **não está disponível para método de taxa por bairros**. Para isso, utilize o método por área, raio ou raio + km rodado, pois é necessário possuir os dados de localização do cliente.
{% endhint %}

<figure><img src="https://3193212287-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-ME41abfRf7bWmvqahTl%2Fuploads%2FprQALTtjS8Kmz86dQtkf%2Fimage.png?alt=media&amp;token=99c0d9f8-569f-42ca-9a11-b014f1c02ef4" alt=""><figcaption></figcaption></figure>

<details>

<summary>Como acessar:</summary>

* Entre no **Painel da plataforma**
* Acesse **Configurações Gerais** e ative a opção abaixo para habilitar a funcionalidad&#x65;**:**

<figure><img src="https://3193212287-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-ME41abfRf7bWmvqahTl%2Fuploads%2FMK3WrG1fkpdHgIkwtNbI%2Fimage.png?alt=media&amp;token=cf4e421b-121a-4d4d-9ec8-36435cad0e7a" alt="" width="373"><figcaption></figcaption></figure>

* Após isso, procure pela opção **Gestão de Entregas** no menu

<figure><img src="https://3193212287-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-ME41abfRf7bWmvqahTl%2Fuploads%2FksLUY4kOyHk0A0ObKvYr%2Fimage.png?alt=media&amp;token=2fd011fa-1b7b-44c8-a4eb-83ed7ddd4cf4" alt="" width="536"><figcaption></figcaption></figure>

* Ou no app **Meus Pedidos**, clique no ícone do gestor de entregas:

<figure><img src="https://3193212287-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-ME41abfRf7bWmvqahTl%2Fuploads%2FpVINrQCCaq0LWzpNUADl%2FCapturar.PNG?alt=media&amp;token=b53ca032-03b0-4293-a999-572c972dab95" alt="" width="60"><figcaption></figcaption></figure>

</details>

<details>

<summary>Visualizações principais</summary>

#### 📋 Pedidos

Aqui você vê todos os pedidos que precisam ser entregues.

**O que fazer:**

* Clique em qualquer pedido para ver o resumo
* Veja quais pedidos estão aguardando
* Crie rotas manualmente selecionando pedidos
* Acompanhe o status de cada entrega

<figure><img src="https://3193212287-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-ME41abfRf7bWmvqahTl%2Fuploads%2FaAeX1RhUeaGXp3XEPxXG%2Fimage.png?alt=media&amp;token=67108458-439d-465a-b1ae-2baadbb45f95" alt="" width="311"><figcaption></figcaption></figure>

#### 🛣️ Rotas

Aqui você gerencia as rotas criadas para seus entregadores.

**O que fazer:**

* Clique em qualquer pedido para ver o resumo
* Veja todas as rotas ativas
* Atribua entregadores para cada rota
* Acompanhe o progresso das entregas
* Adicione ou remova pedidos de rotas existentes
* Finalize rotas quando todas as entregas forem concluídas

<figure><img src="https://3193212287-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-ME41abfRf7bWmvqahTl%2Fuploads%2FfvcRswLcWzIPFBr4Nc9H%2Fimage.png?alt=media&amp;token=27c9cabb-7947-48f7-9115-3b79840cab2c" alt="" width="303"><figcaption></figcaption></figure>

#### 🗺️ Mapa

Visualização geográfica das suas entregas.

**O que fazer:**

* Veja a localização dos pedidos no mapa
* Acompanhe a posição dos entregadores
* Visualize as rotas traçadas
* Identifique regiões com maior concentração de pedidos
* Filtre pedidos clicando nos status: em produção, prontos, em rota ou entregues

<figure><img src="https://3193212287-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-ME41abfRf7bWmvqahTl%2Fuploads%2FF6LrDs7A8bcjQnG5papc%2Fimage.png?alt=media&amp;token=cc24a066-9c22-4550-93a7-35ec95619adb" alt="" width="563"><figcaption></figcaption></figure>

</details>

<details>

<summary>Modo Manual: Como criar e gerenciar rotas</summary>

#### Criando uma rota manualmente

1. Vá na aba **Pedidos**
2. Selecione os pedidos que deseja incluir na rota
3. Clique em **Nova Rota**
4. Atribua um entregador disponível
5. Pronto! O entregador receberá a rota no app dele

#### Editando rotas

Você pode modificar rotas que ainda não foram iniciadas:

* Adicione novos pedidos à rota
* Exclua pedidos específicos
* Altere o entregador designado
* Reordene a sequência de entregas clicando e arrastando

<figure><img src="https://3193212287-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-ME41abfRf7bWmvqahTl%2Fuploads%2Fdk2IL5Pq4zal7YZrA7nH%2Fimage.png?alt=media&amp;token=b2232dfc-54ab-40f6-ab24-c5dc13457d25" alt="" width="375"><figcaption></figcaption></figure>

<figure><img src="https://3193212287-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-ME41abfRf7bWmvqahTl%2Fuploads%2FngrLF9u6sf2qWvHRbAnN%2Fimage.png?alt=media&amp;token=3604a0ba-a149-436e-8e36-e5fcda950ee7" alt=""><figcaption></figcaption></figure>

**Importante:** Rotas que já têm entregadores designados não são alteradas automaticamente pelo sistema, mesmo com despacho automático ativado.

</details>

<details>

<summary>Despacho automático</summary>

O despacho automático automatiza duas etapas essenciais da gestão de entregas:

* Criação de rotas de entrega
* Atribuição de entregadores para cada rota

Com ele ativado, o sistema reduz o trabalho manual e torna o fluxo de entregas mais rápido e eficiente.

#### Como ativar o despacho automático

* Acesse as **Configurações do Gestor de Entregas**

<figure><img src="https://3193212287-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-ME41abfRf7bWmvqahTl%2Fuploads%2FqyVvzZfNXACVMWMVDfvG%2Fimage.png?alt=media&amp;token=9ba416a9-abe6-49d9-a0d2-7f8576bac5ed" alt="" width="311"><figcaption></figcaption></figure>

* Ative a opção **Despacho Automático**

<figure><img src="https://3193212287-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-ME41abfRf7bWmvqahTl%2Fuploads%2Fs3CN3nbDHJ2vdYXiSObg%2Fimage.png?alt=media&amp;token=9649dddb-9257-4d59-90b6-a31868384d6f" alt="" width="187"><figcaption></figcaption></figure>

Ao ativar o despacho automático, você pode configurar:

* **Máximo de entregas por viagem**\
  Quantidade máxima de pedidos que cada entregador pode levar em uma rota.
* **Distância máxima para agrupar entregas**\
  Distância, em metros, entre pedidos para que possam ser agrupados na mesma rota.
* **Tempo máximo para agrupar entregas**\
  Intervalo de tempo, em minutos, para que pedidos próximos sejam agrupados.
* **Liberar entregador quando**\
  Define quando o entregador ficará disponível para uma nova rota após concluir as entregas:
  * **Opção "Entregues"**
    * O entregador é liberado assim que todos os pedidos da rota forem entregues
    * Ideal quando o entregador presta contas apenas no fim do dia
  * **Opção "Finalizados"**
    * O entregador só é liberado após os pedidos passarem pelo caixa e conferência no sistema
    * Ideal quando o entregador presta contas após cada rota

#### Como funciona a criação automática de rotas

Sempre que chega um novo pedido de delivery, o sistema:

* Recria as rotas automaticamente
* Agrupa pedidos com status **Em preparação** ou **Pronto**
* Inclui pedidos que estão em rotas sem entregador
* Respeita as configurações de distância e tempo definidas
* Gera rotas otimizadas conforme suas preferências

Você pode alterar rotas manualmente, porém:

* Rotas **sem entregador** podem ser reagrupadas quando novos pedidos chegam
* Rotas **com entregador já designado** não são alteradas automaticamente

Por isso, o ideal é editar manualmente apenas rotas que já tenham entregador atribuído.

#### Como funciona a atribuição automática de entregadores

Após a criação das rotas, o sistema seleciona os entregadores automaticamente com base em uma fila de disponibilidade.

#### Para entrar na fila automática, o entregador precisa:

* Estar ativo no sistema
* Estar com status **online**
* Não ter nenhuma rota ativa no momento
* Estar com o rastreamento de localização ativado
* Estar a até **1 km do estabelecimento** no momento do acesso ao link

Apenas entregadores que atendem a todos esses critérios entram na fila e podem receber rotas automaticamente.

#### Quando a rota é atribuída

* A rota só é enviada quando **todos os pedidos estão prontos**
* O sistema escolhe o **primeiro entregador disponível** na fila
* Se não houver entregador disponível, a rota fica em espera

Se um entregador ficar disponível enquanto existem várias rotas aguardando, ele receberá a rota mais urgente, considerando pedidos mais antigos ou atrasados.

</details>

<details>

<summary>Status dos pedidos, rotas e entregadores</summary>

#### Status dos pedidos

**Aguardando** - Pedido confirmado, esperando ser incluído em uma rota

**Em preparação** - Pedido está sendo preparado pela cozinha

**Pronto** - Pedido finalizado e pronto para sair

**Em rota** - Pedido foi adicionado a uma rota e está com o entregador

**Saiu para entrega** - Entregador iniciou a rota e está a caminho

**Entregue** - Entrega concluída com sucesso

**Finalizado** - Pedido passou pelo caixa e foi conferido

**Cancelado** - Pedido foi cancelado

#### Status das rotas

As rotas também têm status próprios que você pode acompanhar na aba Rotas:

* **Nova rota** - Rota criada, aguardando entregador ou pedidos ficarem prontos
* **Pronta** - Todos os pedidos estão prontos e o entregador está vinculado
* **Em rota** - Entregador iniciou a rota e está realizando as entregas
* **Concluída** - Todas as entregas foram finalizadas

#### Status de entregador

O próprio entregador define seu status no link de acesso:

* Online (disponível)
* Online (em rota)
* Offline

</details>

<details>

<summary>Finalizar rota automaticamente</summary>

**Como funciona**: Quando esta opção está ativada, o sistema finaliza a rota de forma automática assim que todos os pedidos são marcados como entregues. Isso elimina a necessidade de finalizar a rota manualmente, agilizando o processo operacional.

**Como ativar**: Configurações do gestor de entregas / rotas.

<figure><img src="https://3193212287-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-ME41abfRf7bWmvqahTl%2Fuploads%2FxoOKalhyK0ZTFbSMLUSS%2Fimage.png?alt=media&amp;token=7dd27a93-fa18-4a88-8f71-9638d4394ed2" alt=""><figcaption></figcaption></figure>

</details>

<details>

<summary>Link do entregador</summary>

Seus entregadores acessam um link especial pelo celular onde podem gerenciar suas entregas.

#### Funcionalidades do link do entregador

**Status online/offline:**

* O entregador pode ficar **online** (disponível para receber rotas) ou **offline**
* Quando está offline, não recebe rotas
* Não pode ficar offline se estiver em uma rota ativa

**Visualização de rotas:**

* Vê todos os pedidos da rota atual
* Visualiza endereço completo de cada entrega
* Vê informações de pagamento (pago ou não pago) e forma de pagamento
* Acompanha o status de cada pedido

**Botão Iniciar Rota:**

* Quando recebe uma nova rota, o entregador vê o botão **Iniciar Rota**
* Ao clicar, todos os pedidos mudam automaticamente para "Saiu para entrega"
* O botão some após iniciar a rota

**Integração com mapas:**

* Ícone de mapa ao lado do botão de iniciar rota
* Abre o Google Maps com rota otimizada pré-configurada
* A rota passa por todos os pontos de entrega na sequência correta e termina no estabelecimento

**Configurações:**

* Autorizar localização (necessário para rastreamento)
* Sair da conta

**Marcar entregas:**

* Confirma cada entrega individualmente ao concluir
* Pode despachar um pedido específico ou todos da rota

#### Como compartilhar o link

1. Acesse a área de entregadores no painel
2. Crie o cadastro do entregador
3. Copie o link do entregador
4. Compartilhe com seus entregadores
5. Cada entregador terá um código próprio para fazer login

</details>

<details>

<summary>Cadastro de entregadores</summary>

Para usar o Gestor de Entregas, você precisa cadastrar seus entregadores no sistema:

**Como cadastrar:**

1. Acesse a área de **Entregadores** no painel
2. Clique em **Novo Entregador**
3. Preencha os dados (nome, telefone, código de acesso)
4. Defina se o entregador está ativo
5. Salve o cadastro

**Gerenciamento:**

* Ative ou desative entregadores conforme necessário
* Edite informações cadastrais
* Visualize histórico de entregas por entregador
* Gere relatórios de desempenho

</details>

<details>

<summary>Rastreamento do entregador</summary>

O sistema permite acompanhar a localização dos entregadores diretamente no mapa, desde que algumas condições sejam atendidas.

#### Quando a localização é rastreada

A localização do entregador é exibida no mapa quando:

* O link do entregador está aberto no navegador
* O entregador autorizou o compartilhamento de localização
* O GPS do celular está ligado
* O entregador está com status **online**
* O celular está ligado, desbloqueado e com acesso à internet

Como o sistema funciona via navegador e não por aplicativo, a localização só é capturada enquanto o link estiver aberto.

#### Entendendo o tempo exibido na localização

Abaixo do nome do entregador aparece uma informação como **“há 2 min”**.

Isso indica há quanto tempo aquela localização foi registrada.

Exemplo:

Se aparecer “há 5 min”, significa que o entregador esteve com o link aberto e a localização ativa há 5 minutos.

#### Status do entregador

O próprio entregador define seu status no link de acesso:

* Online
* Offline

Regra importante:

O entregador **não pode ficar offline enquanto estiver em uma rota não concluída**.

Isso garante mais controle e evita perdas de rastreamento durante entregas em andamento.

#### Benefícios do rastreamento

Com o rastreamento ativo, você consegue:

* Visualizar a posição de cada entregador no mapa
* Acompanhar o progresso das entregas
* Identificar possíveis atrasos rapidamente
* Melhorar a comunicação com o cliente sobre previsão de entrega

#### Por que não usamos aplicativo de entregador

O sistema não exige a instalação de um aplicativo. Os entregadores utilizam apenas um link no navegador, o que traz vantagens importantes:

* Uso mais simples e rápido
* Não ocupa espaço no celular
* Menor consumo de bateria, pois não roda em segundo plano
* Compatível com Android e iOS

A única limitação é que o rastreamento depende do link estar aberto no momento.

#### Quando o entregador não aparece no mapa

Se um entregador não estiver visível no mapa, verifique se:

* O navegador tem permissão para acessar a localização
* O GPS do celular está ligado
* O celular está conectado à internet
* O celular não está desligado

#### Visualização de status na tela

Na tela de entregadores, é possível:

* Visualizar o status atual de cada entregador:&#x20;
  * Online ou offline (bolinha verde ou vermelha)
  * Está dentro ou fora da área de entrega
* Clicar no botão de lista para ver quantos entregadores estão online ou offline

<figure><img src="https://3193212287-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-ME41abfRf7bWmvqahTl%2Fuploads%2FvUK0KcEYQ1ucWgfObgaX%2Fimage.png?alt=media&amp;token=6bfb29c8-ad13-4808-b4bb-3a49e0a0e21e" alt="" width="426"><figcaption></figcaption></figure>

</details>

<details>

<summary>Pedidos que não estão no Gestor de Entregas</summary>

#### Pedidos que NÃO são enviados ao Gestor:

* **Pedidos com entrega externa vinculada**: Quando o pedido já possui uma entrega gerenciada por plataformas externas (como iFood ou 99), ele não será enviado para o gestor, pois a entrega será realizada pelo sistema da própria plataforma.
* **Pedidos sem coordenadas de endereço**: Quando o sistema não consegue identificar as coordenadas geográficas do endereço de entrega, o pedido não é enviado ao gestor. Nesses casos, um aviso será exibido no painel do gestor de pedidos informando sobre a falta de coordenadas.

<figure><img src="https://3193212287-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-ME41abfRf7bWmvqahTl%2Fuploads%2FfmVyRLDpQLZdLx7UqCj4%2Fimage.png?alt=media&amp;token=7b1577ef-510c-4226-be52-3acb8f6e4d67" alt="" width="185"><figcaption></figcaption></figure>

#### **Reenviar pedidos ao Gestor de Entregas**:

* Caso tenha ajustado o endereço do pedido ou tenha retirado um pedido do gestor, basta reenviá-lo nas opções do pedido.

<figure><img src="https://3193212287-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-ME41abfRf7bWmvqahTl%2Fuploads%2FEvo7jMx4GlMwFcNeBXyU%2Fimage.png?alt=media&amp;token=89e8252a-06b1-45d3-8377-e5499a4d7cc7" alt="" width="188"><figcaption></figcaption></figure>

</details>