Mudanças entre as edições de "Integração Mercado (IFood Groceries)"
| 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: |
| − | + | - 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.