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.
A integração iFood do Ello faz duas coisas, automaticamente, através do serviço Gollum:
O vínculo entre o produto do Ello e o do iFood é criado e mantido sozinho pela sincronização.
| 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.
Confirme que o módulo iFood está liberado para o cliente. Se não estiver, encaminhe ao comercial antes de qualquer configuração.
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.
O que vai para o iFood é o conteúdo de um Catálogo de Produtos do Ello (tela Lista de Produtos):
Sobre os itens:
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.
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.
Onboarding concluído quando: cardápio visível no portal iFood, pedido de teste importado corretamente e mudança de status refletida no app.
| 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 |
| 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) |
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.