Extract from File n8n: como ler PDF, CSV e planilhas
Aprenda a usar o Extract from File no n8n: operações para CSV, PDF e planilhas, campos de entrada e saída, exemplos de fluxo e o caminho inverso com Convert to File.
Por Redação Eleven Host · @robson.direitodigital · 31 de outubro de 2026 · 9 min de leitura
Capa da Redação Eleven Host para o guia: Extract from File n8n: como ler PDF, CSV e planilhas Arte: Eleven Host
O Extract from File n8n é o nó que lê um arquivo binário que chegou ao fluxo, como uma planilha ou um PDF, e transforma o conteúdo em dados JSON, o formato que os outros nós do fluxo entendem.
Este guia mostra quando usar o Extract from File no n8n, de onde o arquivo pode vir, quais são as 11 operações do nó, como configurar o campo de entrada e o campo de saída, três exemplos de fluxo (Webhook, HTTP Request e Read/Write Files from Disk) e o caminho inverso, o Convert to File. Os nomes das telas seguem a documentação do n8n.
O que o nó faz e quando usar
Segundo a documentação, o Extract From File extrai dados de um arquivo em formato binário e converte o resultado em JSON. A documentação define dado binário como dado de tipo arquivo, como imagens e documentos.
A documentação explica que é comum receber arquivos binários, como planilhas e PDFs, de um nó HTTP Request, de um nó Webhook ou de uma fonte local. O arquivo chega ao fluxo como dado binário. O Extract from File faz a passagem de binário para JSON.
Um exemplo neutro: um arquivo CSV com uma lista de contatos chega ao fluxo. Depois do Extract from File, cada linha do arquivo vira um item JSON, e você pode seguir com nós como o Filter, descrito no guia Filter no n8n: como filtrar itens no seu fluxo, para separar só os itens que interessam.
O Extract from File converte um arquivo binário em JSON. O caminho contrário, de JSON para arquivo, é feito por outro nó, o Convert to File.
De onde vem o arquivo
O nó precisa de um arquivo binário na entrada, então o que vem antes dele no fluxo importa. Estas são as origens que aparecem na documentação:
- Webhook: pode entregar o arquivo binário ao próximo nó, com a opção Raw body ativa (veja o primeiro exemplo de fluxo).
- HTTP Request: baixa o arquivo de um endereço e entrega a resposta como arquivo.
- Read/Write Files from Disk: lê um arquivo da máquina onde o n8n está rodando.
- Form Trigger: a página do nó lista o tipo de elemento File para os campos do formulário. O guia Form Trigger n8n: como criar formulários no fluxo mostra como montar o formulário.
As 11 operações do Extract from File
A documentação lista estas operações. Você escolhe a que combina com o formato do arquivo que chegou:
- Extract From CSV: arquivos de valores separados por vírgula, usados para dados em formato de tabela.
- Extract From HTML: campos de arquivos no formato HTML de páginas web.
- Extract From JSON: dados JSON de um arquivo binário.
- Extract From ICS: campos de arquivos no formato iCalendar.
- Extract From ODS: campos de planilhas no formato ODS.
- Extract From PDF: campos de arquivos PDF (Portable Document Format).
- Extract From RTF: campos de arquivos no formato Rich Text Format.
- Extract From Text File: campos de um arquivo de texto padrão.
- Extract From XLS: campos de um arquivo do Microsoft Excel no formato mais antigo.
- Extract From XLSX: campos de um arquivo do Microsoft Excel.
- Move File to Base64 String: converte o dado binário para o formato base64, que é amigável a texto.
Para planilhas, há ODS, XLS e XLSX (e o CSV, para dados em tabela). Para PDF, é Extract From PDF.
Os dois campos principais: entrada e saída
A documentação descreve dois parâmetros que valem para este nó.
Input Binary Field
Segundo a documentação, aqui você informa o nome do campo, nos dados de entrada do nó, que contém o arquivo binário. O valor padrão é data. Se o nó anterior entregou o arquivo num campo com outro nome, troque o valor para o nome certo. Um ponto a conferir quando o nó não encontra o arquivo.
Destination Output Field
Aqui você informa o nome do campo, na saída do nó, que vai conter os dados extraídos. A documentação diz que esse parâmetro vale só para quatro operações: Extract From JSON, Extract From ICS, Extract From Text File e Move File to Base64 String. Para as demais operações, ele não se aplica.
Para usar o conteúdo extraído em outro nó, você refere o campo com uma expressão do n8n. Como exemplo, se você deu o nome conteudo ao Destination Output Field numa operação que aceita esse campo, o nó seguinte poderia ler o valor assim (exemplo nosso):
{{ $json.conteudo }}
Se precisar de algum ajuste de leitura, confira o que o nó oferece no painel dele.
O n8n Essencial sai a partir de R$ 19,90/mês; confira na loja o que cada plano inclui. Ver planos de n8n
Exemplo de fluxo: Webhook recebe um CSV
A própria documentação do nó usa este exemplo. Um Webhook recebe um arquivo CSV e passa para o Extract From File, com a operação Extract From CSV. A saída é uma série de objetos JSON, um por linha do arquivo.
- Adicione o nó Webhook como início do fluxo.
- No Webhook, selecione o botão Add Options, escolha Raw body e ative essa configuração. A documentação dá essa dica para o Webhook entregar o arquivo binário ao próximo nó.
- Adicione o nó Extract From File depois do Webhook.
- Na operação, escolha Extract From CSV.
- Em Input Binary Field, confira se o nome é o do campo que carrega o arquivo. O padrão é
data. - Execute o fluxo com um arquivo de teste e olhe a saída: a documentação descreve a saída como um objeto JSON por linha do arquivo.
Depois da extração, se quiser unir os itens numa lista, o guia Aggregate no n8n: como juntar itens em uma lista mostra como. Se o fluxo começou no Webhook e você quer devolver um resultado a quem chamou, o guia Respond to Webhook n8n: como devolver a resposta mostra como.
Exemplo de fluxo: HTTP Request baixa o arquivo
Quando o arquivo está num endereço na internet, o nó HTTP Request pode buscá-lo. A documentação do HTTP Request tem a opção de formato de resposta File: ao selecioná-la, a resposta vira um arquivo. O campo Put Output in Field recebe o nome do campo em que o arquivo será entregue. A documentação diz que Autodetect é o padrão do formato de resposta, então vale conferir se está em File.
- Adicione o nó HTTP Request e informe o endereço do arquivo.
- No formato de resposta, escolha File.
- Em Put Output in Field, escolha o nome do campo, por exemplo
data. - Adicione o Extract From File e escolha a operação do formato do arquivo, como Extract From PDF.
- Em Input Binary Field, use o mesmo nome definido no HTTP Request.
Exemplo de fluxo: Read/Write Files from Disk lê um arquivo local
A documentação descreve o nó Read/Write Files from Disk como o que lê e grava arquivos na máquina onde o n8n está rodando. As operações dele são Read File(s) From Disk e Write File to Disk. Para alimentar o Extract from File, a que interessa é a primeira.
Duas informações da documentação sobre onde o arquivo precisa estar:
- Se você roda o n8n em Docker, os caminhos se referem ao sistema de arquivos do contêiner do n8n, e não ao host do Docker.
- No n8n Cloud, o nó só acessa caminhos dentro de
/home/node/.
A documentação também cita a variável N8N_RESTRICT_FILE_ACCESS_TO, que restringe o acesso a um ou mais diretórios permitidos, separados por ponto e vírgula. Depois de ler o arquivo, ligue o nó ao Extract from File e confira o Input Binary Field.
O caminho inverso: Convert to File
Se você tem dados JSON no fluxo e quer gerar um arquivo, o nó é o Convert to File. A documentação diz que ele pega os dados de entrada e os entrega como arquivo, convertendo o JSON para o formato binário.
As operações do Convert to File são: Convert to CSV, Convert to HTML, Convert to ICS, Convert to JSON, Convert to ODS, Convert to RTF, Convert to Text File, Convert to XLS, Convert to XLSX e Move Base64 String to File. O parâmetro Put Output File in Field recebe o nome do campo, nos dados de saída, que vai conter o arquivo.
Conferir quando algo não funciona
Se o nó não devolve o que você espera, confira estes pontos, que partem dos parâmetros descritos na documentação:
- Confira se o nome do campo binário bate com o valor de Input Binary Field. O padrão é
data. - Se o arquivo vem de um Webhook, confira se a opção Raw body está ativa, como a documentação orienta.
- Confira se a operação escolhida combina com o formato do arquivo, por exemplo Extract From XLSX para uma planilha do Excel.
Checklist do Extract from File
- O arquivo chega ao Extract from File como dado binário.
- Escolhi a operação que combina com o formato do arquivo.
- O Input Binary Field tem o mesmo nome do campo que carrega o arquivo (o padrão é data).
- Se uso Destination Output Field, a operação é JSON, ICS, Text File ou Base64.
- Se o arquivo vem de um Webhook, ativei Raw body.
- Se o arquivo vem do HTTP Request, o formato de resposta é File e o nome em Put Output in Field bate com o Input Binary Field.
- Se leio do disco, sei se o n8n roda em Docker ou no n8n Cloud e qual caminho vale.
- Executei com um arquivo de teste e conferi a saída.
Quer conhecer o n8n da Eleven Host? O n8n Essencial sai a partir de R$ 19,90/mês; confira na loja o que cada plano inclui. Conhecer o n8n Essencial
Perguntas frequentes
Para que serve o Extract from File no n8n?
Ele extrai dados de um arquivo em formato binário e converte o resultado em JSON, para que os outros nós do fluxo possam usar o conteúdo.
Quais formatos o Extract from File lê?
A documentação lista CSV, HTML, JSON, ICS, ODS, PDF, RTF, arquivo de texto, XLS e XLSX, além da conversão para uma string base64.
Qual é o valor padrão de Input Binary Field?
O padrão é data. Se o arquivo está em outro campo, troque pelo nome certo.
Como volto de JSON para um arquivo?
Com o nó Convert to File, que converte os dados JSON de entrada em um arquivo binário.
Como o Webhook entrega o arquivo ao Extract from File?
A documentação orienta abrir o Add Options do Webhook, escolher Raw body e ativar essa configuração.
