Módulo iFood — Guia de Onboarding (Suporte)
Este guia explica, passo a passo, como colocar um cliente para operar com a integração iFood do Ello: o que precisa estar contratado, o que configurar, como o cardápio é enviado e como os pedidos chegam. Público-alvo: atendentes de suporte.
Visão geral
A integração iFood do Ello faz duas coisas, automaticamente, através do serviço Gollum:
- Envia o cardápio do Ello para o iFood (produtos, categorias e complementos). Qualquer alteração feita no Ello (preço, nome, complemento novo…) é enviada ao iFood em segundos, sem ação do usuário.
- Recebe os pedidos feitos no aplicativo iFood e os registra no Ello Retaguarda (consulta a cada 30 segundos), acompanhando o ciclo: novo pedido → confirmação → despacho → conclusão/cancelamento.
O vínculo entre o produto do Ello e o do iFood é criado e mantido sozinho pela sincronização.
Pré-requisitos
| Item | Quem providencia | Observação |
|---|---|---|
| Módulo iFood liberado na licença | Comercial/Ello | Sem o módulo, a integração não inicia |
| Módulo Foods em uso | Cliente já operando | A integração faz parte do segmento Foods |
| Loja ativa no iFood | Cliente, junto ao iFood | Cadastro aprovado no Portal do Parceiro iFood |
| ID da Loja (Merchant ID) | Cliente obtém no Portal do Parceiro | Código no formato UUID, ex.: ac73d090-6940-41f2-bf7f-4273126706a3 |
| Serviço Gollum instalado e rodando | Suporte | É ele quem conversa com o iFood; sem Gollum não há sincronização nem pedidos |
| Banco de dados atualizado | Suporte | Atualização normal do Ello (os patches criam as tabelas de vínculo) |
Onde o cliente encontra o ID da Loja: no Portal do Parceiro iFood (https://portal.ifood.com.br), nos dados da loja. É o identificador “comprido” (UUID), não o código numérico curto.
Passo a passo de ativação
1. Conferir a licença
Confirme que o módulo iFood está liberado para o cliente. Se não estiver, encaminhe ao comercial antes de qualquer configuração.
2. Configurar os parâmetros (Ello Retaguarda)
Abra a tela de parâmetros Foods – Integrações, aba iFood, e preencha:
| Campo | O que informar |
|---|---|
| Id Loja | O Merchant ID (UUID) obtido no Portal do Parceiro iFood |
| Cliente | Cliente do cadastro usado para registrar o contas a receber dos pagamentos online do iFood (crie um cliente “IFOOD” se necessário) |
| Cardápio Entrega | O catálogo de produtos do Ello que será espelhado no iFood (ver passo 3) |
| Cardápio na Mesa | Reservado para uso futuro — deixe como está |
Clique em Testar comunicação para validar o Id da Loja. Se falhar, confira se o UUID foi colado completo e sem espaços, e se a estação tem acesso à internet.
Os parâmetros são por empresa. Token de acesso é gerado e renovado sozinho — não há campo de senha do iFood no Ello.
3. Montar o cardápio (catálogo de produtos)
O que vai para o iFood é o conteúdo de um Catálogo de Produtos do Ello (tela Lista de Produtos):
- Crie um catálogo específico para o iFood (ex.: “CARDÁPIO IFOOD”) — não use o catálogo do balcão se os preços/itens forem diferentes.
- Adicione ao catálogo apenas os produtos que devem aparecer no aplicativo.
- Selecione esse catálogo no parâmetro Cardápio Entrega (passo 2).
Sobre os itens:
- Categoria no iFood = Grupo do produto no Ello (ex.: grupo “BEBIDAS” vira a categoria “BEBIDAS” no app). A categoria é criada sozinha quando o primeiro produto do grupo é enviado.
- Complementos: os grupos de complementos do produto (ex.: “ADICIONAIS: Bacon, Cheddar”) viram grupos de opções no iFood, com preços. Complementos avulsos (fora de grupo) não são enviados — oriente o cliente a organizar complementos em grupos.
- Pizza: produtos do tipo pizza não são enviados ao cardápio (limitação atual). Pedidos de pizza vindos do iFood, porém, entram normalmente no Ello se o cliente montar a pizza diretamente no portal do iFood.
4. Primeira carga
Com os parâmetros salvos e o Gollum em execução, salve o catálogo (abra o catálogo na Lista de Produtos e confirme). Isso dispara o envio de todos os produtos. Em poucos minutos o cardápio deve aparecer no Portal do Parceiro iFood.
A partir daí tudo é automático: alterou produto, preço, grupo ou complemento no Ello → atualiza no iFood. Removeu o produto do catálogo → sai do iFood.
5. Abrir a loja
No painel do Foods (tela principal), localize o cartão iFood e ligue a chave para abrir a loja. Com a loja fechada, os pedidos não são consultados.
6. Validar com um pedido real
- Faça (ou peça ao cliente para fazer) um pedido de teste pelo aplicativo iFood.
- O pedido deve aparecer no Ello Retaguarda em até ~30 segundos.
- Confirme o pedido no Ello e acompanhe: o status deve refletir no aplicativo do consumidor (confirmado → despachado).
- Confira itens, complementos e valores do pedido importado.
Onboarding concluído quando: cardápio visível no portal iFood, pedido de teste importado corretamente e mudança de status refletida no app.
Problemas comuns
| Sintoma | O que verificar |
|---|---|
| Cardápio não aparece no iFood | Gollum está rodando? Parâmetro Cardápio Entrega preenchido com o catálogo certo? Produto está DENTRO do catálogo? Loja/Id da Loja corretos (“Testar comunicação”)? |
| Produto alterado não atualiza no app | Gollum rodando? O produto pertence ao catálogo do parâmetro? Se houve falha de internet, a alteração fica na fila e é reenviada sozinha quando a comunicação volta — aguarde alguns minutos |
| Pedidos não chegam | Loja aberta no painel Foods? Gollum rodando? Id da Loja correto? |
| Pedido chega sem complemento | O complemento estava em grupo de complementos e ativo? Complemento avulso não sincroniza |
| Produto “pizza” não aparece no app | Comportamento esperado — pizza não é enviada ao cardápio nesta versão |
| Grupo de complementos excluído no Ello continua no app | Comportamento conhecido: a exclusão não remove o grupo no iFood; remova manualmente pelo Portal do Parceiro |
| Categoria vazia sobrando no app | Pode ocorrer após reorganização de grupos; remova manualmente pelo Portal do Parceiro |
Resumo dos parâmetros (referência rápida)
| Parâmetro | Tela | Conteúdo |
|---|---|---|
| Id Loja | Foods – Integrações → iFood | UUID da loja no iFood (Merchant ID) |
| Cliente | Foods – Integrações → iFood | Cliente p/ contas a receber dos pagamentos online |
| Cardápio Entrega | Foods – Integrações → iFood | Catálogo de produtos espelhado no iFood |
| Cardápio na Mesa | Foods – Integrações → iFood | Reservado (não usar) |
Escalonar para o desenvolvimento quando...
- “Testar comunicação” funciona, Gollum roda, mas nada sincroniza (ver log do Gollum);
- Pedidos duplicados no PDV;
- Produto certo no Ello, mas pedido importa item errado;
- Erros repetidos no log do Gollum mencionando “iFood”.
Ao escalonar, informe: versão do Ello, print da aba iFood dos parâmetros, log do Gollum do período e o número/horário do pedido afetado.