Summarize no n8n: como somar e contar itens no fluxo
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

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:
- em Fields to Summarize, adicione uma linha com Aggregation Sum e Field
valor; - adicione outra linha com Aggregation Count e Field
valor; - em Fields to Split By, escreva
cliente; - 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.