Arquivos e planilhas

Estes nós trabalham sobre o arquivo que viaja junto com o item — o mesmo vocabulário de "Como os arquivos circulam entre os nós", na página de Ações: quem produz arquivo grava sob um nome (data, por padrão) e quem consome pergunta por ele naquele nome.

Na paleta eles aparecem em dois grupos: Planilhas e documentos (Compactar em ZIP, Extrair ZIP, Gerar Excel, HTML para PDF, Converter imagem) e Dados (Ler arquivo, Ler Excel) — os dois últimos ficam ali porque o que sai deles são items, não arquivos.

Vale reparar em quantos items cada nó devolve, porque nem todos trabalham um a um:

Compactar em ZIP

Grupo Planilhas e documentos. Junta os arquivos de todos os items recebidos num único .zip — é o "mande os doze relatórios num arquivo só". Como o nó agrega, ele devolve um item apenas, com o .zip anexado e um resumo do que entrou: a quantidade de arquivos, os nomes e o tamanho.

Item que não tiver arquivo naquela propriedade é simplesmente ignorado. Se nenhum dos items tiver, o nó falha dizendo em qual propriedade procurou — um .zip vazio seguiria adiante e o problema só apareceria no e-mail ou no envio.

Arquivos com o mesmo nome ganham um sufixo dentro do .zip (nota.pdf, nota (2).pdf), para que nenhum deles se perca na hora de extrair.

Extrair ZIP

Grupo Planilhas e documentos. Abre um .zip e emite um item para cada arquivo de dentro, cada um com o seu arquivo anexado e com o nome, o caminho original dentro do pacote e o tamanho. Dali em diante cada arquivo segue pelo fluxo como qualquer outro item.

Pastas não viram item (não têm conteúdo). Se o conteúdo extraído passar de 200 MB, o nó interrompe e pede para extrair em partes ou usar o filtro. Arquivo que não puder ser lido — o caso comum é senha errada — também interrompe, em vez de gerar um item com conteúdo vazio.

Ler arquivo (JSON/XML)

Grupo Dados. Transforma um arquivo JSON ou XML que chegou no item em items do fluxo — o caminho de volta do Salvar em arquivo. Uma lista vira um item por elemento; um objeto único vira um item só.

Use Começar por quando o conteúdo vem embrulhado: o arquivo traz {"dados": {"registros": [...]}} e você quer um item por registro. Caminho que não existe no arquivo não gera items.

Para CSV, use o nó Ler CSV, que tem as opções que o formato pede (separador, cabeçalho e codificação).

Gerar Excel

Grupo Planilhas e documentos. Monta uma planilha .xlsx com todos os items recebidos, uma linha por item. Como agrega, devolve um item só, com a planilha anexada e o resumo: quantidade de linhas, colunas usadas e tamanho.

Sem informar as colunas, saem todos os campos que aparecem em qualquer um dos items — assim, um registro com um campo a mais não perde a coluna sem ninguém notar. Campo que guarda uma lista ou um objeto sai como texto na célula.

O formato aceita pouco mais de um milhão de linhas; acima disso o nó avisa para filtrar os dados ou gerar em partes. O Excel também não aceita nome de aba com mais de 31 caracteres nem com : \ / ? * [ ] — o nó ajusta o título para caber.

Ler Excel

Grupo Dados. Lê uma planilha .xlsx ou .xls que chegou no item e emite um item por linha.

Duas coisas o nó resolve para você, e as duas costumam morder quem lê planilha por conta própria: data sai como data (2026-08-03), não como o número que o Excel guarda por baixo; e fórmula sai com o valor calculado, não com a fórmula escrita. Coluna sem nome no cabeçalho recebe a letra da coluna, e nomes repetidos ganham sufixo para que nenhuma coluna sobreponha a outra.

Arquivo que não for uma planilha de verdade faz o nó avisar, em vez de virar items com conteúdo sem sentido.

HTML para PDF

Grupo Planilhas e documentos. Gera um PDF a partir de um HTML montado no fluxo — relatório, comprovante, carta de cobrança. Trabalha item a item: o PDF sai anexado ao próprio item, que segue com todos os seus campos.

O nó não busca nada na internet ao montar o documento: imagem, folha de estilo e fonte precisam vir dentro do próprio HTML (imagem embutida em data: funciona). Se o HTML tiver imagem e a instalação ainda não tratar imagens, o nó avisa em vez de entregar um documento sem a figura.

Converter imagem

Grupo Planilhas e documentos. Converte o formato, redimensiona e comprime uma imagem do item — quase sempre se quer as três coisas juntas. Trabalha item a item, trocando a imagem e acrescentando a largura, a altura e o tamanho resultantes.

O redimensionamento preserva a proporção e só reduz: imagem menor que o limite passa intacta, porque ampliar não cria detalhe, só peso. Ao converter para JPG, que não tem transparência, o fundo transparente vira branco — o formato não guarda transparência, e sem esse cuidado ele sairia preto.

Entram JPG, PNG, GIF e WEBP; arquivo que não for imagem faz o nó avisar.

Para enviar esses arquivos adiante — por e-mail, para o Google Drive ou para uma API —, veja os nós de ação.