Pular para o conteúdo principal

02/04/2025 - V2025.14.3.5

Integração IFood Merchant-API​

A API Mercado do iFood que utilizamos atualmente está sendo descontinuada e substituída pela nova Merchant-API. Essa atualização traz diversas melhorias, incluindo uma integração mais eficiente e moderna, permitindo que os clientes obtenham pedidos e enviem produtos para a plataforma de maneira mais ágil e segura. Além disso, a nova API fornecerá informações mais detalhadas sobre os pedidos, tornando os valores mais explícitos e melhorando a transparência dos dados.

Com essa mudança, o processo de autenticação também será modificado, exigindo uma nova configuração para os aplicativos que interagem com a plataforma do iFood. Para garantir a continuidade do serviço, será necessário cadastrar novamente os aplicativos, pois as credenciais utilizadas na API atual não serão compatíveis com a nova versão. Esse novo cadastro fornecerá as informações essenciais para o credenciamento dos clientes dentro da plataforma do Automatiza Retaguarda, incluindo os seguintes dados:

  • Client ID
  • Client Secret
  • Merchant UUID (Id da Loja)

Essas credenciais são fundamentais para que os clientes possam realizar requisições na Merchant-API e garantir o funcionamento correto da integração.

O processo de cadastro dos aplicativos é simples e pode ser realizado diretamente através do site oficial do iFood para desenvolvedores. Para mais informações e para iniciar o cadastro, acesse:

https://developer.ifood.com.br/pt-BR/auth

Após realizar o processo de Login acesse a aba "Meus Apps", onde você poderá gerenciar os aplicativos criados pelos clientes para obter o Client ID e o Client Secret. Essas credenciais são necessárias para autenticar na Merchant-API.

Clique no botão “Cadastrar Aplicativo”.

O Aplicativo DEVE ser do tipo “Centralizado".

Informe o nome do aplicativo, é sugerido o nome da rede da loja. O "Slug", que é o nome ‘amigável’, será gerado automaticamente. A logo será obrigatória e a linguagem é C#.

A categoria do aplicativo será "Groceries", que são aplicativos exclusivos para farmácias.

Inclua todos os módulos para que o cliente tenha acesso à todos eles caso seja necessário.

A visibilidade será uma particularidade do cliente, caso o cliente queira que o aplicativo seja visível para o portal do parceiro.

Após preencher os dados, confirme se está tudo preenchido da forma correta e confirme.

Após cadastrar o aplicativo, ele irá aparecer na aba de "Meus apps", selecione o aplicativo cadastrado e abra um ticket para realizar a homologação deste aplicativo, esse processo é obrigatório para continuar o processo.

Após a homologação do aplicativo, é necessário o cliente acessar o portal do IFood para que ele obtenha o ID da loja, que no caso é o Merchant ID. Caso o cliente não tenha o cadastro no portal, será necessário cadastrar para obter o ID.

https://portal.ifood.com.br/login

Após realizar o login na conta no Portal do IFood, acesse o caminho “Minha Loja > Loja”, lá será exibido o ID da Loja, que será necessário para incluir na permissão do aplicativo.

Guarde este ID pois será necessário incluir ele no sistema do Automatiza Retaguarda.

Voltando ao portal do Desenvolvedor, abra novamente o aplicativo e caso o processo de homologação já tenha sido realizado, abra a aba de "Permissões".

Clica no botão "Pedir Autorização".

Após abrir a janela de Pedir Autorização, insira o ID da loja que o cliente forneceu e faça uma busca. Quando encontrar a loja em questão, acione o botão “Pedir Autorização”.

Após pedir a autorização, acesse o Portal do IFood novamente, e procure a aba "Integrações", lá será exibido o aplicativo que foi realizado o pedido de autorização. Nos três pontinhos será exibida a opção de “Permitir”. Selecione ela.

Após selecionar, cheque se os dados estão corretos, caso positivo clique no botão "Autorizar".

Após o cliente autorizar o aplicativo, será possível visualizar o ClientID e ClientSecret no portal do desenvolvedor, que serão necessários para fazer o processo de autenticação do sistema do Retaguarda com a API-Merchant.

Agora no Automatiza Retaguarda, acesse o cadastro de Filial para vincular as credenciais ao cadastro da filial.

Preencha os dados de Merchant UUID, que é o ID da Loja, ClientID e Client Secret que foram fornecidos pelo portal do desenvolvedor. Selecione também a versão 2.0 Merchant para fazer a comunicação com a API correta. Após inserir, salve e está finalizada a integração com a nova API.

Criação de Relatório de Natureza de PIS/COFINS de Saída​

Caminho do relatório:

Este relatório foi desenvolvido para buscar as saídas de produtos dentro de um período definido pelo cliente, retornando todos os produtos das notas fiscais ativas. O cliente pode definir um filtro de CST de PIS/COFINS monofásico. Caso não seja escolhido, o sistema retornará as notas com todos os CST monofásicos. Além disso, também é possível escolher a natureza de PIS e Cofins. Caso não seja selecionada nenhuma, o relatório incluirá todas as naturezas de PIS e Cofins.