Agora no Bluesoft ERP, é possível integrar pedidos diretamente com o Ifood via API.

Como funciona a Integração de Pedidos iFood no Bluesoft ERP

Este artigo explica como o Bluesoft ERP integra automaticamente os pedidos de vendas realizados através do iFood (modalidade Groceries).

O que essa integração faz?

A integração automatiza o fluxo de vendas do iFood. Assim que um pedido é separado na plataforma, o ERP o captura este pedido para que seja possível dar sequência ao faturamento via Nota fiscal (Modulo de pedidos Balcão) ou pelo PDV através da consulta deste pedido via API diretamente no ERP.

O pedido é criado no ERP contendo todas as informações essenciais: dados do cliente, itens comprados, valores de frete e formas de pagamento.

Pré-requisitos e Configuração

Para que a integração funcione, é necessário realizar as seguintes configurações no módulo de E-commerce do ERP:

Parâmetros Gerais

  • Habilitar Integração: Marque a flag “Ativar integração de pedidos (iFood)” nas configurações do e-commerce.
  • Finalizadoras: É possível integrar a forma de pagamento real que foi utilizada no Ifood, ou parametrizar para seja integrada em um meio de pagamento fixo no ERP.
  • Associação de Loja: O mapeamento entre o Merchant ID do iFood e a lojaKey do Bluesoft ERP deve estar configurado.

O que é integrado no Pedido?

Ao receber uma venda do iFood, o ERP preenche automaticamente as seguintes informações:

1. Entrega e Agendamento

  • Delivery (Entrega): Se o cliente pediu para entregar em casa, o pedido entra no ERP configurado como “Entrega no CEP”.
  • Agendamento: Se o pedido for agendado, as datas e horários de previsão de entrega ou retirada são respeitados e gravados no pedido.

2. Produtos e Valores

  • Itens: O sistema localiza os produtos no seu cadastro através do código de barras (GTIN/EAN). Se o produto existir, ele é adicionado ao pedido com a quantidade correta.
  • Valores Monetários: O preço dos itens, o valor do frete e os descontos são processados para garantir que o total do pedido no ERP seja idêntico ao total pago pelo cliente no iFood.

3. Clientes

  • O sistema utiliza o CPF/CNPJ para associar ou criar o cliente.
  • Endereços de entrega e cobrança são criados e associados conforme os dados recebidos no payload do pedido.

4. Pagamentos

A integração realiza o mapeamento automático das bandeiras disponíveis no ERP.

  • Exemplo: Uma transação iFood “CREDIT” com bandeira “VISA” será gravada no ERP como CARTAO_DE_CREDITO com a bandeira “Visa” (Ponto de atenção: Verifique se todos os meios de pagamentos aceitos na plataforma estão devidamente mapeados no ERP ou utilize uma finalizadora fixa conforme mencionado neste post).
  • O valor total dos pagamentos com o total do pedido (Itens + Frete – Descontos).

Monitoramento e Tratamento de Erros

Caso ocorra alguma falha na integração (ex: produto não cadastrado ou divergência de valores), o pedido não será perdido.

  • Painel de Erros: Os pedidos com falha podem ser visualizados na tela de Ferramentas > Importação.
  • Ação: Através desta tela, é possível consultar a crítica do erro (ex: “GTIN inexistente”) e reprocessar o pedido após a correção do cadastro.
  • Validação de Produtos: Se um pedido contiver um EAN não cadastrado no ERP, ele não será criado e gerará um log de erro específico para análise.

Onde acompanho os pedidos?

Os pedidos integrados com sucesso aparecem na tela de Consulta de Pedidos do E-commerce ou Balcão com status Separado.

Para conhecer mais sobre a integração com o Ifood, clique aqui.

Para conhecer mais sobre o modulo de pedidos balcão, clique aqui.

Para saber mais sobre a utilização das APIs do ERP, clique aqui.

Disponível a partir da versão r363.01