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.

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.

Visão geral do fluxo

SVG | PNG | TXT

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.

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.

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.

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.

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.

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

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.

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.

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.