ifood-completo

Nodes n8n modulares para Merchant API iFood: autenticação, lojas, eventos, pedidos, financeiro, análise de conciliação, catálogo, produtos de catálogo, logística, shipping e avaliações.

Package Information

Released: 1 mo ago
Downloads: 0 weekly / 0 monthly
Latest Version: 0.1.32
Author: BK Manaus

Available Nodes

Documentation generating…

iFood Authentication icon
iFood Authentication
Gera tokens OAuth e user code da Merchant API iFood.
iFood Merchant icon
iFood Merchant
Consulta e administra lojas, status, horários e interrupções.
iFood Events icon
iFood Events
Consome polling de eventos e envia acknowledgment.
iFood Order icon
iFood Order
Consulta e executa ações do ciclo de vida dos pedidos.
iFood Financial icon
iFood Financial
Consulta vendas, conciliação, settlements e eventos financeiros.
iFood Analise Conciliacao icon
iFood Analise Conciliacao
Analisa vendas iFood em um dia para conciliacao financeira.
iFood Catalog icon
iFood Catalog
Consulta catalogos, categorias, itens por categoria, itens a venda e itens nao vendiveis.
iFood Produtos do Catalogo icon
iFood Produtos do Catalogo
Node personalizado que lista os produtos completos de um catalogo iFood.
iFood Logistics icon
iFood Logistics
Consulta dados logísticos relacionados a pedidos.
iFood Shipping icon
iFood Shipping
Executa cotação, criação, consulta e cancelamento de entregas shipping.
iFood Review icon
iFood Review
Consulta avaliações e envia respostas.

Documentation

n8n-nodes-ifood-completo

Pacote npm com nodes customizados do n8n para a Merchant API do iFood.

Nodes disponíveis

Este pacote disponibiliza um node separado para cada módulo:

  • iFood Authentication
  • iFood Merchant
  • iFood Events
  • iFood Order
  • iFood Financial
  • iFood Analise Conciliacao
  • iFood Catalog
  • iFood Produtos do Catalogo
  • iFood Logistics
  • iFood Shipping
  • iFood Review

Todos usam a logo física img/ifood.png incluída dentro do próprio pacote npm. Antes de validar, empacotar ou publicar, o script sync:icons copia essa imagem para cada diretório de node e os manifests .node.json também declaram icon: file:ifood.png, mantendo compatibilidade com o formato icon: 'file:ifood.png' do n8n.

Instalação pelo npm

npm install n8n-nodes-ifood-completo

Depois reinicie o n8n para carregar os nodes.

Instalação local para desenvolvimento

cd lib/vendor/ifood_completo/n8n
npm install
npm run dev

Publicação

cd lib/vendor/ifood_completo/n8n
npm run sync:icons
npm run validate
npm publish --access public --otp=CODIGO_2FA

Se sua conta usa 2FA obrigatório, informe um OTP válido de 6 dígitos ou use um granular access token com bypass de 2FA para publish.

Token e Credencial

Os nodes autenticados agora aceitam o campo Access Token diretamente na estrutura do node. Esse campo pode receber uma expressao apontando para o retorno do node iFood Authentication.

A credencial iFood Completo API continua disponivel como fallback opcional com:

  • Access Token: token Bearer gerado na API OAuth do iFood.
  • Base URL: https://merchant-api.ifood.com.br.

O node iFood Authentication nao exige credencial nem recebe Access Token; ele serve para gerar tokens.

iFood Produtos do Catalogo gera o token internamente por client_credentials. Informe somente Client ID, Client Secret, Merchant ID e Catalog ID; a saída contém um item n8n por produto, com categoria, código externo, valor, situação, pausa e grupos de complementos.

iFood Analise Conciliacao tambem gera o token internamente por client_credentials. Informe Client ID, Client Secret, Merchant ID da Loja e Data no formato yyyy-mm-dd; o node consulta vendas do dia e retorna um unico JSON consolidado com merchantId, periodo, vendas e paginacao. Informe tambem Pagina (1-based, padrao 1); cada execucao consulta somente essa pagina, com limite fixo de 100 registros. O campo paginacao informa a pagina, o limite efetivo (size/pageSize), a quantidade efetivamente retornada, o total de registros (total) e o total de paginas (totalPaginas) quando a API os disponibiliza. proximaPagina usa primeiro hasNext/metadados de total da API e somente usa a quantidade da lista como fallback.

Tutorial

Consulte TUTORIAL.md para exemplos de uso de cada node.

Validação local

npm run validate
npm publish --dry-run
npm pack

Discussion