Central de Ajuda Ir para o site da Olist Meus chamados

Integração ERP com o iFood Mercado

O iFood Mercado é um marketplace que está disponível para integração com o ERP da Olist.

Essa integração permite que o sistema de gestão da Olist se conecte diretamente à plataforma, possibilitando a importação e gestão dos pedidos, controlando estoque entre outras funções que facilitam e otimizam sua rotina.

Para uma melhor experiência em ERP, sugerimos que você inicie realizando as configurações necessárias em sua conta, configure a integração e após siga os passos de ações a realizar no ERP para aproveitar as funcionalidades disponíveis para a integração.

Recursos Disponíveis

Confira o que você pode gerenciar diretamente pelo ERP da Olist nesta integração:

Receber produtos x
Receber pedidos
Enviar produtos
Enviar estoque
Enviar preços
Sincronizar situação x
OMS
 
 

Como instalar a integração

Para integrar o iFood Mercado no ERP siga o caminho abaixo:

  • Menu > Início > Integrações
  • Pesquise por iFood Mercado e após localizar clique em instalar

 
 

Como configurar a integração

Organizamos as explicações de cada parâmetro divididas pelas mesmas abas que você encontra na tela de integração do seu ERP.

Selecione a aba desejada para ver a explicação e orientação de cada parâmetro:

Conexão

Após localizar e instalar a integração, o próximo passo é estabelecer a autenticação entre o iFood Mercado e o ERP permitindo que a troca de informações aconteça de forma segura e automática entre as plataformas.

Observações: caso já possua integrações configuradas em sua conta, elas serão exibidas e indicadas da seguinte forma:

 
  • Ativa: Indica que a integração foi realizada com sucesso e encontra-se pronta para uso.
  • Inativa: Indica a inatividade desta loja no ERP, ou seja, a loja não estará disponível para sincronização de pedidos, produtos e demais ações pertinentes.
  • Não conectada: Indica que a configuração ainda não foi realizada.

Importante: somente as integrações ativas serão exibidas para uso nas sincronizações, importações e demais ações no ERP.

 

Para ajudar nessa autenticação, confira o passo a passo:

1. Na aba integração, busque o nome da integração no ERP.

2. Localizar o Identificador da Loja no iFood

  • Acesse o Portal do Parceiro iFood em outra aba do navegador.
  • No menu lateral, clique em Minha loja.
  • Na seção Informações da loja, localize o campo ID da loja.
  • Clique no ícone ao lado para copiar o código do ID.

3. Inserir o ID e gerar o código de acesso

  • Volte à aba do ERP na tela de conexão da integração.
  • Cole o código copiado no campo Identificador da loja.
  • Clique em Gerar código de acesso.

4. Autorizar o aplicativo no iFood

Observação: o fluxo de autorização no iFood pode variar de acordo com a sua conta:

Cenário 1 (Código na URL): se ao abrir a janela você for redirecionado, copie o código de 9 dígitos que aparece direto na URL da página antes do redirecionamento.

Cenário 2 (Autenticação Direta/Código na Tela): se o iFood não redirecionar pela URL e exibir o código de 9 dígitos diretamente na tela ao ativar a conexão, basta copiar esse identificador exibido e prosseguir para o passo seguinte.

 

  • Uma nova aba do iFood será aberta. Copie o código de 9 dígitos exibido na URL da página antes que a tela seja redirecionada.

  • No Portal do Parceiro iFood, acesse a opção Catálogo no menu lateral.
  • Clique no botão Ativar aplicativo por código.


  • Insira o código de 9 dígitos no campo exibido e clique em Continuar.

  • Na tela Permitir aplicativo, clique em Autorizar.
  • Copie o código de autorização gerado na tela.

5. Concluir a conexão no ERP

  • Retorne à aba do ERP.
  • Cole o código no campo Código de Acesso.
  • Clique em conectar com iFood Mercado. Se o botão ficar verde/ativo, a conexão foi bem-sucedida.

Atenção: o código de acesso é válido por 5 minutos após a geração. Caso ultrapasse esse tempo, é necessário gerar novo código de acesso.

 
 
 

Produtos

Esta aba gerencia as regras e o fluxo de produtos com a plataforma.

Passo 1: Fluxo de Produtos

  • Enviar imagens dos produtos ao sincronizar: Selecione uma das opções disponíveis para que as imagens do produto, no ERP, sejam enviadas para o e-commerce.
  • Excluir anúncios da plataforma no próximo envio: Se você está realizando o primeiro envio de produtos para a plataforma, habilite o parâmetro para que os produtos existentes na plataforma sejam excluídos. Após o primeiro envio, essa configuração será automaticamente desabilitada.

Passo 2: Regras de Estoque

  • Atualizar estoque na loja virtual a partir do ERP: Selecione uma das opções disponíveis para atualização do estoque, sendo elas: não atualizar, enviar saldo físico (estoque total) ou enviar saldo disponível (estoque total considerando a reserva de estoque).
     
  • Depósito a ser considerado na integração: Escolha qual será o depósito padrão para as ações: importar pedido, importar produtos e enviar estoque.

O campo depósito a ser considerado na integração será exibido nas contas que possuem a extensão depósitos de estoque instalada.

  • Lançamento de estoque para saídas: Defina quando o estoque dos pedidos será lançado: ao selecionar a opção Manual, o usuário deverá através do menu de contexto localizado ao lado de cada pedido ou nota fiscal selecionar a opção Lançar estoque. Se escolhida uma das opções de Automático, o sistema fará o lançamento no momento determinado: Ao autorizar a NFeAo salvar NFeAo salvar o pedido ou Ao marcar pedido como enviado. Se selecionar Ao marcar pedido como enviado e o pedido tiver uma nota fiscal vinculada, o lançamento de estoque ocorrerá pela nota fiscal.

O lançamento do estoque pode ser parametrizado de acordo com as configurações das naturezas de operação. Ao lançar estoque manual para uma natureza configurada para não permitir lançamento de estoque, será exibido um aviso não permitindo lançar estoque. A configuração da natureza de operação deverá ser verificada.

  • Estoque de segurança: Informe a quantidade de estoque de segurança para que, quando seu estoque atingir este número, a quantidade de estoque enviada para a plataforma seja Zero.

Produtos sob encomenda não estão abrangidos por este parâmetro.


Passo 3: Preços

Defina qual será a regra de preços para a integração, tanto para importação, quanto para envio de produtos ao e-commerce:

  • Preço fixo: Conforme o preço do produto, o anúncio pode receber um valor fixo de preço de venda, levando em consideração acréscimos e descontos aplicados individualmente.
  • Conforme regras de preço: Trata-se de todas as regras do marketplace no que diz respeito ao percentual de comissão, adicional de frete para produtos com preço mínimo e/ou por faixa de peso cubado dos produtos e fórmula de cálculo para aplicar os valores adicionais. Ao definir essa regra, siga a configuração de precificação de anúncios com base nas regras das plataformas de e-commerce e marketplaces.
  • Conforme lista de preços: Utiliza de listas de preços dos produtos, específicas para o e-commerce ou marketplace. Ao definir essa regra, no campo lista de preços utilizada nos produtos, selecione a lista de preços a ser considerada na importação de pedidos do e-commerce. Saiba como configurar em listas de preços.
 
 

Pedidos

Esta aba define o comportamento de importação e os dados fiscais dos pedidos.

Passo 1: Fluxo de pedidos

  • Sincronização automática de pedidos: Habilite essa opção para utilizar o recurso de OMS na integração com seu e-commerce. Saiba mais sobre o recurso em OMS.
     
  • Importar valor do frete nos pedidos: Habilite essa opção para importar o valor do frete na importação dos pedidos.
     
  • Formatar nome dos contatos no recebimento dos pedidos: Habilite essa opção para que o nome do cliente, ao importar os pedidos, seja formatado com as iniciais maiúsculas em seu nome e sobrenome.
     
  • Intermediador: Selecione o intermediador de suas operações. Maiores informações em Como utilizar e configurar os intermediadores de operações.

A informação de intermediador da transação é obrigatória para emissão de NFe.


Passo 2: Dados Fiscais

Na aba PedidosDados Fiscais, selecione a informação natureza de operação para venda nesta integração. A natureza selecionada será atribuída de forma padrão na importação dos pedidos no ERP e no momento em que gerar a nota fiscal através do pedido importado.

Observação: você pode habilitar ou desabilitar o campo definir natureza de operação diferente para destinatários contribuintes do ICMS. Habilitando esse campo, você poderá selecionar uma natureza de operação específica, a qual será aplicada no momento em que o ERP identificar que o pedido de venda trata-se de um cliente contribuinte.

Caso precise configurar uma nova natureza de operação para utilizar nesta integração, acesse natureza de operação e inclua uma natureza conforme seu regime tributário e orientações da sua contabilidade.

 
 
 

Mapeamentos

Associe os status e pagamentos da plataforma com o seu ERP.

Passo 1: Situações de Pedidos

Na aba MapeamentosSituações de Pedidos, é possível relacionar a situação dos pedidos no e-commerce com as respectivas situações no ERP, assim como o fluxo da sequência das situações no ERP.

  • Adicione as situações presentes no e-commerce, clicando em adicionar situações padrão. Para adicionar novas situações, clique em adicionar mapeamento de situação.
  • Para alterar a situação de um pedido para uma situação anterior à atual, habilite o campo permite retroceder situação dos pedidos na sincronização de situações, assim, por exemplo, um pedido enviado poderá voltar para a situação preparando envio.

Observação: ao importar um pedido de venda do e-commerce para o ERP, o pedido assume a situação configurada. Caso a situação não esteja configurada, o pedido importado terá a situação em aberto atribuída.

 

Passo 2: Formas de recebimento

Na aba Mapeamentosformas de recebimento, pode-se relacionar as formas de recebimento dos seus pedidos da loja virtual com a forma de recebimento no ERP. Esta configuração fará com que suas contas a receber sejam geradas no ERP com as mesmas informações da plataforma.

Observação: ao adicionar as formas de recebimento selecionadas, o ERP busca as formas já configuradas em sua conta. Para informações de como cadastrar as formas de envio, acesse formas de recebimento.

 
  1. Ao habilitar o parâmetro importar forma de recebimento nos pedidos, será possível relacionar as formas de pagamento presentes em sua plataforma com os respectivos destinos no ERP. Para isso, clique em adicionar forma de recebimento.
     
  2. A seguir, no campo de forma de recebimento, selecione a forma de recebimento do ERP a ser relacionada com a da integração. No campo código na integração, clique sobre o botão relacionar forma de recebimento e selecione a forma de recebimento de sua plataforma que corresponderá à do ERP.
     
  3. Se a forma de recebimento correspondente não for exibida, é possível buscar por pedido que possua a mesma forma de recebimento selecionada para realizar o relacionamento ou, caso saiba o código de integração, clique em informar código manualmente e digite o código.
     
  4. Para confirmar o relacionamento, clique em relacionar.
     
  5. No campo forma de recebimento padrão, defina a forma de recebimento que será utilizada sempre que o pedido importado não possua nenhuma forma relacionada.

Observação: ao importar um pedido de venda do e-commerce para o ERP, o pedido assume a forma de recebimento mapeada. Caso a forma de recebimento não esteja configurada, o pedido importado terá a forma de recebimento padrão atribuída.

 

Não esqueça de salvar as configurações.

 
 

 
 

Utilização

Nessa seção, estão disponíveis as informações de como utilizar as funcionalidades disponíveis na integração.

Como receber os pedidos do e-commerce no ERP

Observações

  • Os pedidos somente serão importados para o ERP após o fluxo de aprovação na plataforma, sendo necessária a finalização do processo no Ifood Mercado, para que os pedidos entrem na fila de importação. 
  • Pedidos importados são removidos da fila e não ficarão mais disponíveis.
     
 
  1. Para importação dos pedidos acesse menu > vendas > pedidos do e-commerce.
  2. Clique em processar fila de pedidos.
  3. Na tela que abrir, clique em ver lista de pedidos para verificar os pedidos disponíveis para importação.
  4. Para visualizar os pedidos dessa integração, acesse menu > vendas > pedidos de venda.

Como cadastrar produtos no ERP

Para realizar o cadastro dos produtos, acesse cadastro de produtos.

Sugerimos o cadastro de produtos simples, pois, nessa integração, apenas produtos simples são enviados para a plataforma.

Ao realizar o cadastro do item informe o SKU e o GTIN/EAN dos produtos, pois o vínculo entre o ERP e o marketplace será validado através dessa informação.

Atenção:

  • O GTIN/EAN informado deve ser um valor válido para GS1. Caso seja um valor fictício, o campo não deve ser preenchido pois o anúncio será rejeitado pelo Ifood.
  • O SKU deve ser numérico, caso contrário poderá ter problemas na integração.
  • As informações do produto já cadastrado não serão atualizadas. A atualização ocorrerá apenas para estoque e preço.
 

Como enviar os produtos do ERP para o e-commerce

Observação: nessa integração, apenas os produtos simples são enviados. Produtos com variações serão transformados em produtos simples e ocorrerá o envio somente das variações, ou seja, o produto pai não é enviado.

 


1. Para enviar produtos, acesse menu > cadastros > produtos.

Selecionando apenas um produto, o envio para o e-commerce pode ser realizado em menu de contexto (...) > enviar para o e-commerce.

2. Selecione um ou mais produtos para envio e clique em enviar para o e-commerce.

3. Selecione sua loja Ifood Mercado, no campo plataforma.

4. Marque atualizar estoque no e-commerce e parar o envio em lote caso algum produto seja rejeitado, se desejar que estas ações sejam realizadas.

5. Clique em avançar e valide se os produtos estão com as informações corretas.

6. A seguir, são apresentados os dados de envio dos produtos, por exemplo: identificador, descrição, código (SKU), preço e estoque.

7. Clique em enviar para concluir o envio dos produtos.

Campos enviados:

  • Altura Embalagem
  • Código
  • Comprimento Embalagem
  • Descrição Complementar
  • Dias Preparação
  • Garantia
  • GTIN
  • Imagens
  • Largura Embalagem
  • Nome
  • Peso Bruto
  • Preço
  • Preço Custo
  • Preço Promocional
  • Qtde Estoque
  • Variações

Será apresentada a tela resumo do envio. Clique em revisar para avaliar as informações do produto ou finalizar para concluir o processo.

Observação: verifique se os produtos foram enviados com sucesso no painel do Ifood Mercado, pois o ERP não recebe retorno dessa informação.

 

Como enviar estoque dos produtos no ERP ao e-commerce

  1. Acesse menu > cadastros > produtos.
  2. Selecione um ou mais produtos para envio.
  3. Clique em mais ações > enviar estoque para o e-commerce.

Selecionando apenas um produto, o envio para o e-commerce pode ser realizado em menu de contexto (...) > enviar estoque para o e-commerce.

  1. Selecione sua loja Ifood Mercado, no campo plataforma.
  2. Defina se serão enviados os saldos físico ou disponível dos produtos e clique em selecionar.
  3. A seguir serão exibidos os dados deste produto tais como: identificador do anúncio, descrição, código (SKU) e estoque.
  4. Valide se o produto está com as informações corretas e clique em enviar.

Como enviar o preço dos produtos no ERP ao e-commerce

  1. Acesse menu > cadastros > produtos.
  2. Selecione um ou mais produtos para envio.
  3. Clique em mais ações > enviar preços para o e-commerce.

Selecionando apenas um produto, o envio para o e-commerce pode ser realizado em menu de contexto (...) > enviar preços para o e-commerce.

  1. Selecione sua loja Ifood Mercado, no campo plataforma.
  1. A seguir serão exibidos os dados deste produto tais como: identificador do anúncio, descrição, código (SKU) e preço.
  2. Valide se o produto está com as informações corretas e clique em enviar.
 
 

Informações adicionais e avisos

  • Limite de requisições: O limite de requisições da API é de 1 a cada 30 minutos.
  • Envio em lotes: A cada chamada são enviados lotes de 1000 atualizações.
  • Prioridade de estoque: Atualizações de estoque pendentes a mais de 1h são priorizados para execução.

Atenção: o Ifood Mercado poderá enviar um alerta automático de falha na comunicação da integração quando não existir movimentação de estoque, preço, produto ou pedido por um período de 24h. Essa mensagem é normal e não indica problemas na integração. Assim que alguma movimentação for feita, a sincronização entre os sistemas acontecerá normalmente.

 
 
 

 

Sua dúvida foi esclarecida?