Base de Conhecimento

Summarize no n8n: como somar e contar itens no fluxo

  • n8n, summarize, agregação, sum, count, automação
  • Usuários acharam útil: 0

Aprenda a usar o nó Summarize no n8n: some, conte e tire médias de itens, separe o resumo por grupo com Fields to Split By e veja um exemplo de vendas por cliente.

Por Redação Eleven Host · @robson.direitodigital · 4 de novembro de 2026 · 8 min de leitura

Arte da Eleven Host: janela de terminal com o título: Summarize no n8n: como somar e contar itens no fluxo

Capa da Redação Eleven Host para o guia: Summarize no n8n: como somar e contar itens no fluxo Arte: Eleven Host

O Summarize no n8n é o nó que junta itens para somar, contar, tirar média e achar o maior ou o menor valor, de forma parecida com as tabelas dinâmicas do Excel. Veja os campos da tela, as agregações, como separar por grupo e um exemplo de vendas por cliente.

O que o nó Summarize faz

A documentação do n8n descreve o nó assim: use o Summarize para agregar itens, de forma parecida com as tabelas dinâmicas do Excel. Em vez de passar adiante cada item, ele devolve um resumo: o total de uma coluna, a quantidade de linhas, a média de um valor.

Um exemplo de uso: o fluxo lê uma lista de vendas, uma por item, e você quer saber o total vendido. O Summarize recebe todos os itens e entrega um só, com a soma. Se você separar por cliente, ele entrega um resultado por cliente.

Fields to Summarize: o que somar e contar

O campo principal da tela é o Fields to Summarize, com o botão "Add Field". Cada linha que você adiciona tem estes campos:

  • Aggregation: como combinar os valores do campo;
  • Field: o nome do campo de entrada, escrito como texto, como cost;
  • Include Empty Values: aparece em algumas agregações e decide se os valores vazios entram;
  • Separator: aparece no Concatenate e define o que fica entre os valores.

Cada linha adicionada gera um resultado no item de saída, então dá para somar um campo e contar outro no mesmo nó.

As agregações disponíveis

A lista do campo Aggregation tem oito opções: Append, Average, Concatenate, Count, Count Unique, Max, Min e Sum. A documentação descreve várias delas:

  • Sum: soma os valores numéricos dos dados de entrada;
  • Average: calcula a média numérica dos dados;
  • Max: acha o maior valor numérico;
  • Min: acha o menor valor numérico;
  • Count: conta o total de valores;
  • Count Unique: conta quantos valores diferentes existem;
  • Concatenate: junta os valores dos dados de entrada;
  • Append: a documentação diz que, ao escolher essa opção, você decide se quer incluir valores vazios ou não.

Na prática, o Sum e o Average só somam valores do tipo número. Um valor escrito como texto, como "10", fica de fora da conta sem gerar erro.

Na prática, o nó descarta o texto: o Sum sem nenhum número devolve 0 e o Average devolve null. Se o resultado sair 0 e você tem certeza de que há valores, olhe o tipo do campo. Dados que vêm de planilhas e arquivos CSV podem chegar como texto. O guia Extract from File n8n: como ler PDF, CSV e planilhas mostra como ler esses arquivos, e vale converter o campo para número, com o nó Edit Fields (Set) ou com uma expressão, antes do Summarize.

Na prática, o Max e o Min ignoram só os vazios e não conferem o tipo. Para o Count, sem a opção Include Empty Values, o nó conta apenas os valores que não são vazios, e, com ela ligada, conta todos. Aqui, vazio quer dizer undefined, null ou texto vazio.

Fields to Split By: um resumo para cada grupo

O campo Fields to Split By recebe o nome dos campos pelos quais você quer separar o resumo, de forma parecida com um group by, segundo a documentação. Isso permite obter resumos separados com base nos valores de outros campos. O exemplo da própria documentação: se os dados têm as colunas Sales Rep e Deal Amount e você faz um Sum em Deal Amount, pode separar por Sales Rep para obter o total de cada representante.

Para separar por mais de um campo, escreva uma lista separada por vírgulas, como country, city. Um jeito de entender: quem conhece SQL pode ver o Fields to Split By como o GROUP BY de uma consulta, com cada linha de Fields to Summarize no papel de SUM, COUNT e afins.

O n8n do seu projeto está hospedado em que tipo de servidor hoje? VPS a partir de R$ 17,00/mês no Plano Bronze; confira na loja o que cada plano inclui. Ver as VPS

Options: as opções do nó

Em Options, a documentação lista estas opções:

  • Continue if Field Not Found: por padrão, se um campo a resumir não existe em nenhum item, o nó dá erro. Com a opção ligada, ele continua e devolve um único item vazio;
  • Disable Dot Notation: ligada, desativa a notação com ponto; desligada, o nó continua usando o ponto para chegar a campos internos, como pedido.valor;
  • Output Format: escolhe entre "Each Split in a Separate Item", que gera um item de saída para cada grupo, e "All Splits in a Single Item", que gera um único item listando os grupos;
  • Ignore items without valid fields to group by: ligada, ignora os itens de entrada que não têm os campos de Fields to Split By; desligada, não ignora.

Quando o Output Format é "All Splits in a Single Item", o campo de separação pode aparecer com o nome Fields to Group By na tela. Na prática, em versões mais novas do nó, a opção Continue if Field Not Found some da tela e um campo ausente gera só um aviso no painel de saída.

Como ficam os nomes dos campos de saída

Na prática, o nó monta cada nome com um prefixo que depende da agregação:

  • Append: appended_;
  • Average: average_;
  • Concatenate: concatenated_;
  • Count: count_;
  • Count Unique: unique_count_;
  • Max: max_;
  • Min: min_;
  • Sum: sum_.

O prefixo vem seguido do nome do campo resumido. Colchetes e aspas somem do nome, e espaços e pontos viram sublinhado. Assim, um Sum do campo valor gera sum_valor, um Sum de pedido.valor gera sum_pedido_valor e um Count Unique de cliente gera unique_count_cliente. Esses nomes são um comportamento observado no nó e podem mudar entre versões, então confira na saída do seu n8n.

Exemplo: vendas por cliente

Um exemplo de fluxo para treinar. Imagine três itens de entrada:

  • { "cliente": "Ana", "valor": 100 }
  • { "cliente": "Ana", "valor": 50 }
  • { "cliente": "Bruno", "valor": 30 }

No nó Summarize, configure assim:

  1. em Fields to Summarize, adicione uma linha com Aggregation Sum e Field valor;
  2. adicione outra linha com Aggregation Count e Field valor;
  3. em Fields to Split By, escreva cliente;
  4. em Options, deixe o Output Format como "Each Split in a Separate Item".

O resultado esperado, com os nomes de campo vistos acima, é um item por cliente:

  • { "cliente": "Ana", "sum_valor": 150, "count_valor": 2 }
  • { "cliente": "Bruno", "sum_valor": 30, "count_valor": 1 }

Em SQL, o mesmo resultado sairia de SELECT cliente, SUM(valor) AS sum_valor, COUNT(valor) AS count_valor FROM vendas GROUP BY cliente;. Se o valor chegar como texto, converta-o para número antes, pelo que foi visto acima.

Checklist do Summarize

  • Adicione uma linha em Fields to Summarize para cada resultado desejado.
  • Escreva o nome do campo exatamente como ele aparece nos itens.
  • Confira se o campo é número antes de usar Sum ou Average.
  • Use Fields to Split By para ter um resumo por grupo.
  • Escolha o Output Format conforme queira um item por grupo ou um item só.

Summarize, Aggregate e Remove Duplicates

Três nós do n8n parecem próximos, mas fazem coisas diferentes. A documentação do Aggregate diz que ele pega itens separados, ou partes deles, e os agrupa em itens individuais. A do Remove Duplicates diz que ele identifica e apaga itens repetidos. Em resumo, para o seu fluxo:

  • Summarize: conta, soma ou tira a média, com opção de separar por grupo;
  • Aggregate: junta valores numa lista dentro de um item só;
  • Remove Duplicates: tira os itens repetidos.

Para saber só quantos valores diferentes existem, o Count Unique do Summarize resolve. Para ficar com uma cópia de cada item, o nó certo é o Remove Duplicates.

Quando o resultado sai estranho

  • Soma 0 com dados reais: o campo provavelmente é texto; converta para número antes;
  • Média null: nenhum valor numérico válido chegou ao nó;
  • Erro ou aviso de campo não encontrado: confira a grafia do Field; ele precisa bater com o nome do campo nos itens;
  • Campo interno não é achado: verifique se Disable Dot Notation está desligada para usar pedido.valor;
  • Nome de saída diferente do esperado: espaços e pontos viram sublinhado, como em sum_pedido_valor.

Com o resumo pronto, o resultado pode seguir para outros nós, como o guia Google Drive no n8n: como enviar e baixar arquivos mostra para enviar um relatório, ou para a formatação de datas do guia Date & Time no n8n: como formatar e calcular datas.

Resumo

O Summarize reúne itens num resumo: escolha a Aggregation, informe o Field, use o Fields to Split By para ter um resultado por grupo e converta os valores de texto para número antes de somar. Quem ainda está definindo onde o n8n vai funcionar pode começar pelo guia O que é servidor VPS.

Sua instância do n8n fica numa máquina própria ou num serviço gerenciado? VPS a partir de R$ 17,00/mês no Plano Bronze; confira na loja o que cada plano inclui. Conhecer as VPS

Perguntas frequentes

Para que serve o nó Summarize no n8n?

Serve para agregar itens, de forma parecida com as tabelas dinâmicas do Excel: somar, contar, tirar a média e achar o maior ou o menor valor.

Como somar valores por cliente no n8n?

Adicione uma linha em Fields to Summarize com Aggregation Sum e o campo do valor, e escreva o campo do cliente em Fields to Split By.

Por que a soma do Summarize dá 0?

O Sum considera só valores do tipo número. Se o campo chega como texto, o nó o descarta sem erro, e a conversão para número resolve.

Qual a diferença entre Summarize e Aggregate?

O Summarize calcula resumos, como soma e contagem. O Aggregate junta valores ou itens em listas dentro de itens individuais.

Esta resposta lhe foi útil?

Artigos Relacionados