====== Rota Entregas ======

O módulo **Rota Entregas** conecta o Ello a um serviço externo de logística para solicitação de motoboys. Com ele, ao receber um pedido pelo NuvemShop, o atendente pode solicitar um entregador diretamente pelo Ello — sem precisar abrir nenhum outro sistema.

===== Como funciona =====

O fluxo começa na tela de pedidos do NuvemShop dentro do Ello. O atendente seleciona os pedidos que precisam ser entregues, escolhe o setor de entrega para cada um e confirma. O sistema envia todas as solicitações de uma vez para o Rota Entregas.

<uml>
@startuml
skinparam DefaultFontSize 13
skinparam ActivityBackgroundColor #f5f8f0
skinparam ActivityBorderColor #5F3A1E
skinparam ArrowColor #5F3A1E

start
:Abre a tela de pedidos\ndo NuvemShop no Ello;
:Seleciona um ou mais\npedidos para entregar;
:Clica em **Solicitar Entrega**;
:Sistema abre uma tela com\num card por pedido;
:Seleciona o **setor** para cada entrega\n(a taxa é exibida automaticamente);
note right
  Também é possível:
  - Adicionar observações
  - Editar o endereço
  - Remover ou incluir pedidos
end note
:Confere a **taxa total** no rodapé;
:Clica em **Solicitar Entrega**;
if (Tudo preenchido\ncorretamente?) then (Sim)
  :Sistema envia os pedidos\npara o Rota Entregas;
  :Tela fecha com confirmação;
  stop
else (Não)
  :Sistema indica o\nproblema encontrado;
  :Usuário corrige\ne tenta novamente;
endif
@enduml
</uml>

===== Pré-requisitos =====

Para usar o Rota Entregas no Ello, duas condições precisam estar atendidas:

  - **Módulo habilitado:** O módulo Rota Entregas deve estar ativado para a sua empresa. Entre em contato com o suporte Ello para solicitar a ativação.
  - **Chave de acesso configurada:** É necessário cadastrar a chave de acesso fornecida pelo Rota Entregas nos parâmetros do sistema (veja como na seção abaixo).

===== Configuração =====

==== Onde encontrar a chave de acesso ====

A chave de acesso é gerada pelo serviço Rota Entregas no momento em que a empresa se cadastra na plataforma deles. Caso não saiba onde encontrá-la, consulte o suporte do Rota Entregas.

==== Como cadastrar a chave no Ello ====

  - Acesse o menu **Sistema → Parâmetros**
  - Localize a aba ou seção **Rota Entregas**
  - Cole a chave de acesso no campo **API Key**
  - Salve as alterações

Após salvar, o botão **Solicitar Entrega** ficará visível na tela de pedidos do NuvemShop.

===== Solicitando entregas =====

  - Acesse **Integrações → NuvemShop → Pedidos**
  - Selecione na lista um ou mais pedidos que precisam ser entregues
  - Clique no botão **Solicitar Entrega** (visível apenas quando o módulo está ativo)
  - O sistema abre uma tela com um **card por pedido**, já preenchido com os dados do cliente

Em cada card, preencha:
  * **Setor de entrega** — selecione no menu suspenso; a taxa correspondente é exibida ao lado
  * **Observações** — campo livre para instruções ao entregador (opcional)
  * Se o endereço precisar de ajuste, clique em **Editar endereço**

Outras ações disponíveis na tela:
  * Para **remover** uma entrega da solicitação, clique no **X** no canto do card (disponível quando há mais de um pedido)
  * Para **incluir** pedidos adicionais, clique no card com o símbolo **"+"** ao final da lista

No rodapé da tela é exibida a **taxa total** somando todos os setores selecionados. Confira e clique em **Solicitar Entrega** para confirmar.

Ao confirmar com sucesso, a tela fecha e os chamados são registrados no Rota Entregas. O motoboy é acionado conforme as regras da plataforma deles.

===== Resolução de problemas =====

^ Situação ^ Causa ^ O que fazer ^
| Botão **Solicitar Entrega** não aparece | O módulo Rota Entregas não está habilitado para esta empresa | Entre em contato com o suporte Ello para solicitar a ativação |
| Mensagem: "Configure a chave de acesso da Rota Entregas nos parâmetros do sistema" | A chave de acesso não foi cadastrada ou está em branco | Siga os passos da seção [[#configuracao|Configuração]] acima |
| Mensagem de setor não selecionado | Um ou mais pedidos estão sem setor escolhido | Selecione o setor em todos os cards antes de confirmar |
| Mensagem de endereço não preenchido | O cliente não tem endereço cadastrado ou o cadastro está incompleto | Clique em **Editar endereço** no card e preencha os dados necessários |
| Erro de chave inválida ao solicitar | A chave de acesso cadastrada está incorreta ou foi revogada | Verifique a chave no painel do Rota Entregas e atualize nos parâmetros do Ello |
| Erro de saldo insuficiente | A conta da empresa no Rota Entregas está sem créditos | Recarregue o saldo diretamente na plataforma do Rota Entregas |

===== Veja também =====

  * [[ello_erp:integracoes:nuvemshop|Integração NuvemShop]]
  * [[ello_erp:modulos|Módulos do Ello ERP]]