====== Ello Delivery — Como configurar a integração ======

Este guia mostra, passo a passo, como habilitar e configurar a integração do **Ello Delivery** dentro do Ello ERP. É voltado para a equipe de suporte que vai fazer essa configuração junto ao cliente.

O **Ello Delivery** é a plataforma de delivery da Ello. Quando a integração está ativa, os produtos cadastrados no ERP aparecem no aplicativo de delivery e os pedidos feitos pelos clientes chegam automaticamente dentro do Ello, na tela de pedidos de entrega.

<note>
Antes de começar, tenha em mãos o **token da loja** — um código de identificação que a plataforma Ello Delivery gera para cada estabelecimento. É ele que liga a loja do cliente ao ERP.
</note>

===== Visão geral do fluxo =====

<uml>
actor "Equipe de suporte" as Sup
participant "Ello ERP" as ERP
participant "Plataforma\nEllo Delivery" as Del
actor "Cliente final" as Cli

Sup -> ERP: 1. Libera os módulos e informa o token
Sup -> ERP: 2. Escolhe o cardápio e salva
ERP -> Del: 3. Envia os produtos do cardápio (carga inicial)
Cli -> Del: 4. Faz um pedido no app
Del --> ERP: 5. O pedido chega na tela de Pedidos de Entrega
</uml>

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

Antes de configurar, confirme que:

  * O módulo **Foods** está liberado para o cliente (é ele que traz a tela de pedidos de entrega e a aba de configuração das integrações).
  * O módulo **Ello Delivery** está liberado na licença do cliente.
  * O cliente tem o **token da loja** fornecido pela plataforma Ello Delivery.
  * Os produtos que serão vendidos no delivery já estão cadastrados e organizados dentro de um **cardápio** no ERP.

<note important>
Se o módulo **Foods** não estiver liberado, a aba de configuração descrita abaixo **não aparece**. E, mesmo com tudo preenchido, a integração só é considerada ativa quando o módulo **Ello Delivery** está liberado **e** o token foi informado.
</note>

===== Passo 1 — Liberar os módulos =====

Na tela de módulos/licença do cliente, libere:

  - **Foods**
  - **Ello Delivery**

Depois de liberar, feche e abra o Ello novamente para garantir que as telas e abas apareçam.

===== Passo 2 — Abrir a tela de Parâmetros =====

A configuração fica dentro da tela de **Parâmetros** do sistema (código de acesso **GER600AA**).

  - Abra os **Parâmetros** do Ello.
  - Localize a aba **Integrações**.
  - Dentro dela, procure o grupo **Ello Delivery**.

===== Passo 3 — Preencher os dados da integração =====

No grupo **Ello Delivery**, preencha os três campos:

^ Campo ^ O que informar ^
| **Token** | O código da loja fornecido pela plataforma Ello Delivery. É a credencial que liga o cliente à integração — sem ele, nada funciona. |
| **Cardápio** | O cardápio (lista de produtos) do ERP que será espelhado no delivery. **Só os produtos que estiverem dentro desse cardápio vão para o Ello Delivery.** O campo tem uma pesquisa (lupa) para você escolher o cardápio já cadastrado. |
| **Código da categoria** | A categoria, dentro do Ello Delivery, que vai receber os itens adicionais/complementos dos produtos. Informe o código dessa categoria. |

Depois de preencher, **salve** os parâmetros.

<note tip>
Não existe botão "Testar comunicação" para o Ello Delivery. A confirmação de que deu certo é ver os produtos aparecendo no delivery (veja o próximo passo) e os pedidos chegando na tela de entrega.
</note>

===== Passo 4 — Carga inicial dos produtos =====

Ao **salvar** os parâmetros com um **cardápio** escolhido, o sistema envia automaticamente **todos os produtos daquele cardápio** para o Ello Delivery. Essa é a chamada **carga inicial**.

A partir daí, a regra é simples:

  * **Produto dentro do cardápio** → aparece no Ello Delivery.
  * **Produto retirado do cardápio** → deixa de aparecer no Ello Delivery.

Ou seja, para incluir ou tirar um item do delivery, basta **adicionar ou remover o produto do cardápio** configurado.

<note>
Produtos do tipo **pizza** ainda não são enviados para o Ello Delivery. Não configure pizzas esperando que apareçam no app.
</note>

===== Como funcionam adicionais e complementos =====

Os **adicionais/complementos** (por exemplo: bacon extra, borda recheada, escolha de molho) são enviados junto com o produto e organizados em **grupos de adicionais**. O cliente não precisa vincular os adicionais manualmente no delivery — o próprio sistema cuida disso a partir do cadastro do produto no ERP.

O que o suporte precisa garantir:

  * Os grupos de adicionais estão corretamente montados no cadastro do produto.
  * O campo **Código da categoria** (Passo 3) foi preenchido, pois é onde os adicionais são organizados no Ello Delivery.

===== Passo 5 — Abrir a loja no delivery =====

Ter a integração configurada não significa que a loja está "aberta" recebendo pedidos. É preciso **abrir a loja** no delivery.

  - Abra a tela de **Pedidos de Entrega**.
  - Localize o quadro (card) do **Ello Delivery**.
  - Use o botão de abrir/fechar para deixar a loja **aberta**.

<note important>
O usuário só consegue abrir/fechar a loja se tiver a **permissão de abrir e fechar o delivery**. Se o botão não responder ou não aparecer, verifique as permissões do usuário.
</note>

===== Passo 6 — Serviço de pedidos precisa estar rodando =====

A integração depende do serviço de retaguarda do PDV (o **Gollum**) estar **em execução** na máquina/servidor do cliente. É esse serviço que:

  * Busca os novos pedidos no Ello Delivery a cada poucos segundos (aproximadamente a cada 30 segundos).
  * Mantém o cardápio sincronizado quando um produto é alterado.

Se os pedidos não estão chegando ou o cardápio não atualiza, **verifique primeiro se esse serviço está rodando**.

===== Checklist rápido de configuração =====

  - [ ] Módulos **Foods** e **Ello Delivery** liberados na licença.
  - [ ] **Token** da loja informado nos Parâmetros → aba Integrações → Ello Delivery.
  - [ ] **Cardápio** escolhido e salvo (dispara a carga inicial dos produtos).
  - [ ] **Código da categoria** de adicionais preenchido.
  - [ ] Produtos desejados estão **dentro do cardápio** configurado.
  - [ ] Loja **aberta** pelo card do Ello Delivery na tela de Pedidos de Entrega.
  - [ ] Serviço de retaguarda do PDV (**Gollum**) em execução.

===== Solução de problemas =====

^ Sintoma ^ O que verificar ^
| A aba **Integrações** não aparece nos Parâmetros | O módulo **Foods** está liberado? Reabra o Ello após liberar. |
| Configurei tudo, mas a integração não ativa | O módulo **Ello Delivery** está liberado **e** o **token** foi preenchido? Ambos são obrigatórios. |
| Os produtos não aparecem no delivery | Os produtos estão **dentro do cardápio** configurado? Produtos fora do cardápio não são enviados. Pizzas não são enviadas. |
| Os pedidos não chegam no Ello | O serviço de retaguarda do PDV (**Gollum**) está rodando? A loja está **aberta** no card do Ello Delivery? |
| Não consigo abrir/fechar a loja | O usuário tem a **permissão de abrir e fechar o delivery**? |
| Alterei um produto e não atualizou no delivery | O serviço de retaguarda do PDV precisa estar rodando; a atualização não é instantânea, ocorre na sincronização periódica. |