Como classificar PDFs no n8n? Um fluxo de trabalho simples de 3 nós para rotear automaticamente faturas, contratos e recibos!

Você recebe uma mistura de PDFs, faturas, contratos, recibos e precisa organizá-los por tipo para que o fluxo de trabalho correto processe cada um deles. Fazer isso manualmente não é escalável.

A solução: Defina o seu regras de classificação em dev.pdf4me.com (usando regex ou JavaScript expressões), em seguida, execute a mesma classificação dentro de n8nBaixe um PDF (por exemplo, do Dropbox) → PDF4me Classificar Documento → utilize o valor retornado nomeDaClasse Para encaminhar ou organizar. A classificação fica armazenada na sua conta PDF4me; o n8n apenas envia o arquivo e recebe a classificação de volta.

Este guia tem duas partes. Parte 1 está em dev.pdf4me.com: onde ir e como organizar sua primeira aula (por exemplo, pdf4me_invoice com uma expressão regular como invoice(.*)). Parte 2 está em n8nUm fluxo de trabalho de três nós (Gatilho → Baixar um arquivo → Classificar documento) e como interpretar o resultado. Todas as etapas e capturas de tela foram verificadas nas interfaces de usuário do PDF4me e do n8n.

Do que você precisa​

• A Conta PDF4me: Faça login no PDF4meOs modelos de classificação são criados e armazenados em sua conta em Classificar documentoVocê define. expressões em regex ou JavaScript (Para classificação baseada em IA, treinamento personalizado pode ser providenciado; entre em contato com a PDF4me, se necessário).
• n8nHospedado por si próprio ou Nuvem n8nAdicione o PDF4me e Dropbox nós.
• A Chave da API PDF4me: Obtenha sua chave de API do PDF4meNo n8n, crie uma credencial PDF4me. Primeira vez? Veja Conecte o PDF4me ao n8n.
• Uma fonte de arquivo: Nós usamos Dropbox, Baixar um arquivo Assim, os passos correspondem às nossas capturas de tela. Você pode usar Google Drive, Requisição HTTPou qualquer nó que forneça dados binários em PDF. O fluxo permanece o mesmo: obter o PDF → Classificar documento → usar nomeDaClasse no próximo nó.

Parte 1: Configurar a classificação em dev.pdf4me.com​

A classificação é definido e armazenado em dev.pdf4me.comVocê cria classes de documentos e atribuir a cada turma um expressão (regex ou JavaScript). Quando você chama Classificar Documento do n8n, o PDF4me usa esses modelos para retornar um Nome da turma (exposto como) className na saída) para o PDF que você enviar. Faça esta parte primeiro para que seu fluxo de trabalho n8n tenha algo com que se basear.

Passo 1: Abra o documento Classify no PDF4me​

1. Faça login em PDF4me (dev.pdf4me.com).
2. No barra lateral, clique Classificar documentoO título da página é Classificar documento e a legenda é Classifique seus documentos com base em expressões..

Passo 2: Criar ou editar uma classe​

1. No Classificar documento Na página, clique no azul. Editar botão (com o ícone de lápis) para criar um novo modelo de classificação ou modificar um existente.
2. Você verá a área de definição da classe onde poderá adicionar classes de documentos e defina como cada um é correspondido.

Etapa 3: Defina um nome de classe e uma expressão.​

1. Sob Nome da turma, clique no + (mais) botão para adicionar uma nova classe, se necessário.
2. Na ficha de aula:

• Nome da turmaDê à classe um nome que será retornado pela API (por exemplo, pdf4me_invoiceEste é o valor que você verá como nomeDaClasse na saída do documento de classificação n8n.
• Selecione o tipo de expressãoSelecione Expressão regular ou JavaScript Dependendo de como você deseja que o conteúdo do documento corresponda.
• Expressão regular (Se você escolheu regex): Insira um padrão que identifique este tipo de documento. Exemplo: invoice(.*) para identificar documentos que contenham a palavra "fatura" seguida de quaisquer caracteres.

3. Usar Selecione o arquivo de teste Para selecionar um arquivo, clique em Teste Classificar para ver a qual classe corresponde.
4. Clique Salvar alterações Assim, as aulas são salvas na sua conta PDF4me. Estes são os modelos que o n8n Classificar documento O nó será usado.

Importante: A classificação no PDF4me usa expressões em regex ou JavaScriptAs diretrizes e a interface do usuário estão em Classifique documentos no PDF4mePara classificação baseada em IA com treinamento personalizado, a PDF4me pode agendar uma chamada para ajudar.

---

Parte 2: Automatizar a classificação em n8n​

Assim que suas classes estiverem disponíveis em dev.pdf4me.com, você poderá executar a classificação a partir de n8nObter um PDF de um nó anterior (por exemplo, Dropbox) e enviá-lo para PDF4me, Classificar documentoO nó retorna nomeDaClasse (por exemplo pdf4me_invoice), que você pode usar para roteamento, renomeação ou etapas adicionais.

Visão geral do fluxo de trabalho​

Seu fluxo de trabalho n8n tem três nós (Captura de tela abaixo; todas mostram uma marca de seleção verde quando executadas):

1. Ao clicar em 'Executar fluxo de trabalho'Acionamento manual para testes. Para produção, use Quando um arquivo é criado (Dropbox), Webhookou outro gatilho.
2. Baixar um arquivo (Dropbox): Recupera o PDF de um caminho que você especificar (por exemplo, /pdf4metest/ClassifyDocs/invoice_Pdf4me-202503-25041.pdf). Coloca o arquivo em um campo binário (por exemplo, data).
3. Classificar documento (PDF4me): Envia esse PDF para o PDF4me usando seus modelos de classificação salvos. Saída: nomeDaClasse (por exemplo pdf4me_invoiceDetalhes completos: Classificar Documento, n8n.

---

Passo 1: Baixe um arquivo (Dropbox)​

Obtenha o PDF em n8n para que o próximo nó possa enviá-lo para PDF4me. O conteúdo binário é armazenado em um campo (por exemplo, data) que o nó de classificação de documentos utilizará.

Fluxo até o momento: Gatilho → Baixar um arquivo.

1. Adicionar um acionar: por exemplo Ao clicar em 'Executar fluxo de trabalho' Para testes. Para produção, use Dropbox: Quando um arquivo é criado ou outro gatilho.
2. Adicionar Dropbox → Baixar um arquivo.
3. Credencial para se conectar comEscolha suas credenciais do Dropbox (por exemplo, Conta do Dropbox 2).
4. Recurso: Arquivo.
5. Operação: Download.
6. Caminho do arquivo *Digite o caminho completo para o seu PDF. Na nossa captura de tela: /pdf4metest/ClassifyDocs/invoice_Pdf4me-202503-25041.pdf.
7. Insira o arquivo de saída no campo: Definir para data (ou outro nome). Este é o nome do campo binário que o nó de documento Classificar fará referência. A saída incluirá Nome do arquivo, Diretório, Extensão de arquivo, Tipo MIME, e Tamanho do arquivo.
8. Executar etapa para testar. A saída mostra os metadados do arquivo baixado (por exemplo, Nome do arquivo: invoice_Pdf4me-202503-25041.pdfTipo MIME: application/pdfTamanho do arquivo: 45.5 kB).

---

Etapa 2: Classificar documento (PDF4me)​

Envie o PDF baixado para o PDF4me. A classificação utiliza os modelos que você definiu na Parte 1 em dev.pdf4me.com.

Fluxo até o momento: Baixar um arquivo → Classificar documento.

1. Adicionar PDF4me → Classificar documento (sob Extrato).
2. Credencial para se conectar comEscolha suas credenciais do PDF4me (por exemplo, Classificar documentosCrie um com o seu Chave de API se necessário.
3. Recurso: Extrair.
4. Operações de Extração: Classificar documento.
5. Tipo de dados de entrada: Dados binários.
6. Campo binário de entrada: Definir para data (o mesmo nome de campo que você usou no nó "Baixar um arquivo"). Isso indica ao nó que ele deve usar o PDF binário da etapa anterior.
7. Nome do documento: Opcional. Insira um nome de referência (por exemplo, document.pdf) para rastreamento. Você também pode usar uma expressão como {{ $json.fileName }} a partir do nó de Download.
8. Nome do campo binário de saídaOpcional. O padrão é dataVocê pode deixar como está ou alterar, se necessário.
9. Executar etapa para testar. A saída inclui nomeDaClasse (por exemplo pdf4me_invoice), ID do modelo, traceId, e _metadados (por exemplo success: true, message: "Document classified successfully", sourceFileName).

---

Passo 3: Utilize o resultado​

O Classificar documento A saída inclui className (por exemplo pdf4me_invoiceNos nós subsequentes, você pode usar esse valor para rotear o documento, por exemplo, adicionando um SE nó e ramificação em {{ $json.className }}. Usar Trocar para encaminhar para caminhos diferentes (faturas, contratos, recibos) ou passar nomeDaClasse para um Carregar nó para salvar o arquivo com um nome prefixado pelo tipo. Cada classificação usa 1 crédito.

---

Principais conclusões​

---

Casos de uso no mundo real​

Adicione modelos de classificação em seu Conta PDF4meEm seguida, use-os no n8n para rotear, renomear ou acionar fluxos de trabalho específicos do tipo:

---

Próximos passos​

1. Configure suas aulas no PDF4me.: Abrir Classificar documento, clique Editar, adicione uma classe (por exemplo, pdf4me_invoice) com um Expressão regular ou JavaScript expressão, então Salvar alterações.
2. Obtenha uma chave de API: Painel de controle da chave de API do PDF4meUse-o no n8n para criar suas credenciais do PDF4me.
3. É novo no PDF4me + n8n?: Conecte o PDF4me ao n8n Mostra como criar a credencial.
4. Construir o fluxo de trabalho: Acionador → Baixar um arquivo (Dropbox) → Classificar documento. Configurar Campo binário de entrada para o campo de saída do Download (por exemplo, data); usar nomeDaClasse no próximo nó.
5. Referência completa do nó: Classificar documento: n8n para todos os parâmetros e campos de saída.