Pular para o conteúdo principal

Analisar um documento em Make

O que este módulo faz

PDF4me Analisar um documento executa seu modelo de análise salvo em um PDF dentro de um Make cenário e retorna os campos extraídos, prontos para serem mapeados no próximo módulo. Transfira conteúdo de arquivos do Dropbox, Google Drive, OneDrive ou HTTP, faça referência ao modelo por Nome do modelo (TemplateId)e encaminha os valores analisados diretamente para o Airtable, Planilhas Google, um banco de dados ou um e-mail subsequente. O modelo contém a lógica de extração, portanto, uma única chamada de módulo abrange faturas, contratos, recibos e qualquer layout personalizado que você tenha configurado.

Artigos relacionados no blogue(1)

Antes de executar este módulo: criar um modelo de análise no PDF4me painel. Defina suas teclas de captura e selecione Expressão regular para padrões estáveis ou JavaScript Expressão para lógica condicional. O Make o módulo faz referência a esse modelo por ID do modelo. Ver Preparar informações de análise para o documento Para configuração completa, exemplos de Regex (INV-\d{6,10}, \d{2}/\d{2}/\d{4}), e dois trabalhando JavaScript Exemplos de classificadores de expressão.

Autenticando seu API Solicitar

O PDF4me módulo em Make requer um válido ConexãoCrie ou selecione um que contenha o seu PDF4me API chave para que o cenário possa autenticar solicitações de análise com segurança.

Fatos importantes que você não deve perder

O nome do modelo aceita o GUID TemplateId.
Apesar do rótulo do campo, cole o GUID TemplateId do painel em vez do nome legível do modelo. O GUID é estável mesmo após renomeações e é a opção mais segura para cenários de produção.
Expressões regulares para padrões estáveis, JavaScript para lógica condicional
As regras de captura estão definidas no modelo. Use expressões regulares para números de fatura, datas, valores e números de identificação fiscal. JavaScript Expressão com o texto Variável para regras de classificação e de contingência.
Um modelo de análise sintática, para todas as plataformas.
O mesmo TemplateId funciona em Make, n8n, Zapier, Power Automatee direto REST chamadas. Crie o modelo uma vez e reutilize-o em todos os locais onde sua equipe automatiza processos.
Módulo "Analisar um Documento" em Make

Parâmetros

ParâmetroObrigatórioO que fazExemplo
ConnectionYesPDF4me connection that authenticates the module. Click Add to create one with your API key, or pick an existing connection from the dropdown.PDF4me production
File ContentYesBinary PDF mapped from a previous module: Dropbox Download a File, Google Drive Get a File, OneDrive Download a File, HTTP Get a File, Gmail Get an Attachment, or any module that returns a file.1. Data
File NameYesSource filename including .pdf extension. Usually mapped from the same upstream module File Name output.1. File Name
Template NameYesTemplateId GUID from the PDF4me dashboard. Identifies which parse template (capture keys + extraction rules) the module should apply.12345678-1234-1234-1234-123456789abc

Tipos de expressão em seu modelo de análise

Expressão regularPadrões estáveis
Números de fatura (INV-\d{6,10}), datas (\d{2}/\d{2}/\d{4}), quantidades ($?\d{1,3}(?:,\d{3})*(?:.\d{2})?Cerca de 80% das chaves de captura de produção.
Expressão JavaScriptLógica condicional e classificadores
O texto da área de captura é passado como textoRetorna uma string. Classificação com múltiplos marcadores, regras de fallback, normalização de datas. Veja Preparar informações de análise para o documento para duas amostras de trabalho.

Saída

O módulo retorna um Pacote Por execução, com o identificador de rastreamento mais os dados de chave/valor analisados, prontos para serem mapeados para o próximo módulo.

CampoO que contém
Trace-IdUnique identifier for the parse operation. Useful for audit logs and error troubleshooting.
Parsed fieldsOne field per capture key defined in the template (for example invoiceNumber, totalAmount, invoiceDate). Pick them directly in the visual mapper of any downstream module.

Exemplos de cenários

Padrões de cenário comuns do MakeTypical ways to chain Parse a Document into a Make flow.
Enviar fatura por e-mail para o Airtable
  1. O recurso "Monitorar e-mails" do Gmail é acionado quando novas faturas de fornecedores são enviadas.
  2. O iterador percorre cada um. PDF anexo.
  3. A função "Analisar um Documento" executa o modelo de fatura no anexo binário.
  4. A função "Criar um registro" do Airtable grava os campos invoiceNumber, totalAmount e invoiceDate na tabela de Contas a Pagar.
Recibos do Dropbox para o Google Sheets
  1. O recurso "Monitorar Arquivos" do Dropbox é acionado quando novos uploads são feitos na pasta /receipts.
  2. O Dropbox baixa um arquivo e carrega cada um PDF binário.
  3. A função "Analisar um Documento" extrai o fornecedor, a data, os itens e o total usando o modelo de recibo.
  4. O recurso "Adicionar uma linha" do Google Sheets anexa os valores analisados ao rastreador de despesas.
Cenário de classificador + roteador
  1. HTTP O webhook recebe uma solicitação de entrada. PDF.
  2. A função "Analisar um Documento" executa um modelo com um JavaScript Chave de expressão que retorna o tipo de documento.
  3. O roteador direciona os fluxos com base no campo de tipo (fatura/pedido/recibo) para um fluxo subsequente específico do tipo.
  4. Cada filial envia os valores analisados para o sistema de destino.

Perguntas frequentes

What goes in the Template Name field?+
Paste the TemplateId GUID from the PDF4me dashboard. Despite the field label, the GUID is the safer production value. It is stable across renames and identical to the value used by the REST API and the other platform connectors.
Where does the file content come from?+
Any upstream module that returns a binary file works: Dropbox Download a File, Google Drive Get a File, OneDrive Download a File, HTTP Get a File, Gmail Get an Attachment. Map both File Content and File Name from the same upstream step.
Do I have to build a template, or can the module parse any PDF?+
Template-based parsing is the supported production mode. Build the template once in the dashboard, then reference its TemplateId. The same TemplateId also works in n8n, Zapier, Power Automate, and direct REST calls.
Can I classify documents at parse time using JavaScript?+
Yes. Inside the template add a JavaScript Expression on a capture key. The capture area text is passed as the variable text and your function returns a string. Use it for invoice vs order vs receipt classification or to normalize date and amount formats.
Where do the parsed field values show up in the next module?+
In the visual mapper they appear as individual fields on the Parse a Document module output bundle, named to match your template capture keys (camelCase). Pick them like any other Make data mapping.
What if my PDF has multiple layouts (different invoice senders)?+
Use a JavaScript Expression key to detect the layout marker, then build one capture template per layout and select the right TemplateId with a Router. Or use Set Up Classify Document upstream to pre-route, then call Parse a Document with the matching template.

Ações relacionadas

A mesma tarefa em outras plataformas.

Obtenha ajuda