Mudanças entre as edições de "Integração Mercado (IFood Groceries)"

De Office System
Ir para navegação Ir para pesquisar
Linha 1: Linha 1:
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 .
+
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:
  
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
+
- Gestão de produtos: atualização de preços, estoques
  
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:
+
- Recebimento de pedidos
  
- Gestão de produtos: atualização de preços, estoques
 
- Recebimento de pedidos
 
 
- Controle de separação de pedidos (via App Separador)
 
- 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.
 
Essa API unifica os modelos de integração anteriores e é compatível com as plataformas iFood Marketplace, iFood Shop e soluções White Label.
 +
 +
<br />
 +
 +
=== 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)
 +
* Estoque Produtos > Filial Somatórios: Filiais que o sistema irá considerar para a quantidade do estoque do produto que será enviado para o IFood.
 +
 +
<br />
 +
 +
=== 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.

Edição das 13h44min de 6 de junho de 2025

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)
  • 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.