~~NOTOC~~ ====== 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.