Mudanças entre as edições de "Integração Mercado (IFood Groceries)"
Ir para navegação
Ir para pesquisar
(Criou página com 'Teste') |
|||
| (3 revisões intermediárias pelo mesmo usuário não estão sendo mostradas) | |||
| 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. 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. | ||
| + | |||
| + | <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) | ||
| + | *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. | ||
| + | |||
| + | <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.<br /> | ||
| + | |||
| + | <br /> | ||
| + | |||
| + | ===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 | ||
Edição atual tal como às 18h26min de 17 de julho 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.
Índice
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
