Integração Mercado (IFood Groceries)

De Office System
Ir para navegação Ir para pesquisar

O iFood Mercado é a vertical de e-commerce do iFood voltada para supermercados, farmácias, pet shops e lojas de conveniência. Lançado em 2019, o serviço permite que consumidores façam compras completas de itens de mercado diretamente pelo app do iFood, com entrega rápida e experiência integrada. Com o crescimento acelerado do setor, o iFood adquiriu a plataforma SiteMercado em 2020, fortalecendo sua presença no segmento de supermercados e expandindo sua base de parceiros no Brasil. O iFood Groceries é a plataforma de integração que permite que sistemas de terceiros (como ERPs, PDVs ou soluções próprias) se conectem ao iFood Mercado. Essa integração é feita por meio da Merchant-API, uma API modular e pública que oferece recursos para:

- Gestão de produtos: atualização de preços, estoques

- Recebimento de pedidos

- Controle de separação de pedidos (via App Separador)

Essa API unifica os modelos de integração anteriores e é compatível com as plataformas iFood Marketplace, iFood Shop e soluções White Label.


Liberação

  • Inicialmente, o cliente deve possuir uma conta ativa no iFood com uma loja do tipo MERCADO devidamente configurada. O CNPJ da empresa deve ser repassado ao setor de programação (Office System), que será responsável por enviar um convite para esse CNPJ. Após o cliente aceitar o convite no portal do parceiro do iFood, o código da loja será liberado, devendo ser preenchido no sistema integrador para que a integração seja concluída. (https://portal.ifood.com.br/login)

Configuração do integrador

Campos:

  • Tempo de sincronização: Recomendado deixar em 30s que é o padrão que o IFood recomenda para verificar se tem pedidos novos.
  • Máximo de eventos: Número máximo de registros de logs que é salvo do integrador, ao passar deste número, o sistema irá excluir os arquivos de logs antigos.
  • Filial: Número da filial que utilizará a integração.
  • Vendedor Padrão: Número do vendedor que será inserido no pedido.
  • Praça Padrão: Número da praça padrão para o cadastro de clientes.
  • Tipo de Atividade Padrão: Número do tipo de atividade para o cadastro de clientes.
  • Código da loja: Este código será retornado pela programação após ser o cliente aceitar o convite de parceria no portal de parceiros do IFood. (https://portal.ifood.com.br/login)
  • Tabelas de Preço: É possível selecionar a tabela de preço padrão de onde será obtido o valor do produto enviado ao iFood. Caso o produto não exista na tabela de preço selecionada, o valor será enviado como R$ 0,00.
  • Estoque Produtos > Filial Somatórios: Filiais que o sistema irá considerar para a quantidade do estoque do produto que será enviado para o IFood.


O que enviamos?

Produtos:

  • É obrigatório que cada produto tenha o código de barras preenchido, pois, ao chegar no site do iFood, alguns dados do produto são automaticamente completados. O iFood possui uma base de informações vinculadas aos códigos de barras e, com isso, realiza a atualização automática da imagem e demais dados do produto diretamente no site.
  • Não enviamos a imagem do produto, pois a imagem é atualizada pelo IFood automaticamente quando recebida no site.
  • Não é possível "desintegrar" um produto diretamente pelo nosso sistema, pois a API do iFood disponibiliza apenas a rota de POST para envio de produtos. Não fixamos um relacionamento direto entre o item do sistema e o produto no iFood, pois, ao receber um pedido, o próprio iFood retorna o código interno do produto no Master Key, permitindo identificar a qual item o pedido se refere. No entanto, não é possível realizar exclusões de produtos via integração. Caso não deseje mais enviar ou atualizar um produto, é necessário marcá-lo como INDISPONÍVEL na aba de e-commerce do cadastro do produto no Master Key e, em seguida, bloquear a venda manualmente no portal do iFood.

O que recebemos?

Pedidos:

  • Importamos apenas os pedidos que já foram separados pelo APP separador (com status SPE). (https://separador.ifood.com.br/).
  • Portanto, é de extrema importância explicar ao cliente que todos os procedimentos devem ser realizados primeiro no App Separador. Somente após o pedido ser totalmente separado no aplicativo, ele será importado automaticamente pelo integrador para o sistema.


Link importantes

Documentação da API: https://developer.ifood.com.br/pt-BR/docs/references/

APP Separador: https://separador.ifood.com.br/

Portal do Parceiro: https://portal.ifood.com.br/login