Pular para o conteúdo principal
API PDF4meIntegraçõesBase de conhecimentoExtensõesTestador de APIBlog

IA - Analisador de Documentos em Power Automate

O que esta ação faz

PDF4me IA - Analisador de Documentos executa um salvo Analisador do PDF4me painel de controle para qualquer documento e retorna os dados extraídos como Dados do documento analisados dinâmico JSON dentro de um Power Automate Fluxo. Uma única ação abrange faturas, pedidos de compra, recibos, contratos, laudos laboratoriais, carteiras de identidade ou qualquer formulário personalizado; basta apontar. Nota de personalização no emparelhamento ID do analisador (Analisar para um único esquema, Classificar para várias variantes de documentos). Os campos são gerados como tokens mapeáveis individualmente que você pode inserir em SharePoint, Excel, Dataverse, Outlookou qualquer fluxo subsequente Microsoft 365 etapa.

Artigos relacionados no blogue(1)

Exemplo de fatura para testes​

Use esta fatura de fornecedor de exemplo para confirmar se a ação funciona de ponta a ponta antes de direcionar seu fluxo para dados reais. Faça o upload para SharePoint, OneDrive, ou Dropbox, mapa Conteúdo do arquivo de Obter conteúdo do arquivo, definir Nome do arquivo para exemplo-fatura-do-fornecedor.pdfe tipo extração de fatura padrão em Nota de personalizaçãoA ação retorna Dados do documento analisados com campos como Número da fatura, nome do fornecedor, e projeto de lei para.

Autenticando seu API Solicitar​

Para ligar PDF4me através Power Automate, o fluxo precisa de um válido PDF4me API chave no PDF4me Connect Conector. Obtenha ou gire sua chave no painel do desenvolvedor.

Get your API KeyOpen AI Document Parser Dashboard

Primeiro, configure seu analisador.​

URLs do painel que irá utilizar neste guia:
Crie primeiro o seu Analyzer (obrigatório para todas as plataformas)
O AI - Document Parser executa um Analyzer guardado a partir do painel de controlo do programador do PDF4me. Selecione «Parse» para um esquema de documento ou «Classify» para encaminhar várias variantes (Cliente ABC, Cliente XYZ, fatura genérica) numa única chamada. O mesmo ID do Analyzer funciona no Make, no Zapier, no Power Automate, no n8n e na API REST.

Fatos importantes que você não deve perder​

O analisador reside no painel de controle; o fluxo apenas faz referência a ele.
Você define o esquema (campos, tipos, descrições) uma única vez no Lista de analisadores e Detalhes do analisador páginas. As Power Automate ação lê Nota de personalização Para escolher qual analisador executar. Altere o esquema do analisador posteriormente e todos os fluxos que apontam para o mesmo ID o detectarão imediatamente, sem necessidade de reconstruir o fluxo.
Os dados do documento analisado são totalmente dinâmicos. JSON
O objeto de saída possui uma propriedade para cada campo definido no seu esquema do Analyzer. Power Automate Expõe essas propriedades diretamente no painel de conteúdo dinâmico de cada ação subsequente. Não. Analisar JSON etapa necessária.
A decisão entre analisar ou classificar é tomada pelo analisador, não pela ação.
Mesma ação, dois modos de análise. Um Analisar O analisador retorna os campos de seu esquema único. Classificar O analisador encaminha o documento para o esquema mais adequado e retorna seu nome de classificação. mais Os campos extraídos do esquema correspondente. Alterne o comportamento alterando o ID do analisador na Nota de Personalização.
Na guia Parâmetros do analisador de documentos do Power Automate PDF4me AI, o conteúdo do arquivo é mapeado do Dropbox, o nome do arquivo é Test.pdf, os parâmetros avançados mostram 1 de 1 e a observação de personalização está definida como default_invoice_extraction.

Aba Parâmetros: mapa Conteúdo do arquivo de um anterior Obter conteúdo do arquivo passo, definir Nome do arquivo (usar exemplo-fatura-do-fornecedor.pdf com a amostra recomendada), expandir Parâmetros avançados, então defina Nota de personalização para extração de fatura padrão ou seu ID de analisador personalizado.

Parâmetros​

URLs do painel que irá utilizar neste guia:

Necessário na ação: Conteúdo do arquivo (binário), nome do arquivo (string com extensão) e nota de personalização (o ID do analisador do arquivo). PDF4me O painel de controle fica em Parâmetros avançados, mas é praticamente obrigatório, pois a ação não tem nada para extrair sem ele.

ParâmetroObrigatórioO que fazExemplo
File ContentYesBinary content of the source document. Map from a previous Get file content step (SharePoint, OneDrive, Outlook attachment, Dropbox, or any cloud-storage connector that exposes raw bytes). Try the sample-vendor-invoice.pdf above for your first run.File Content
File NameYesSource document filename with extension. Used for format detection and for tracking the call in logs. Accepts .pdf, .png, .jpg, .jpeg. Match the name of the file you uploaded (for example sample-vendor-invoice.pdf).sample-vendor-invoice.pdf
Customisation NoteYes (Advanced)The Analyzer Id from the PDF4me dashboard. Create Analyzers at https://dev.pdf4me.com/dashboard/#/ai-document-parser/ (+ Add), then edit schemas on https://dev.pdf4me.com/ai-document-parser/?id=<analyzer-guid>. Use default_invoice_extraction for invoices, a Parse Analyzer Id for one schema, or a Classify Analyzer Id for several variants.default_invoice_extraction

Nota de personalização: como os IDs do analisador são mapeados para o comportamento.​

ID do analisador de análiseUm esquema extrai os campos que você definiu.
O ideal é que todos os documentos processados compartilhem o mesmo padrão de layout (por exemplo, apenas suas próprias faturas). Saída JSON contém exatamente as propriedades que você descreveu em campos no analisador.
ID do Analisador de ClassificaçãoVários esquemas, rotas e extrações em uma única chamada.
Ideal quando um único fluxo precisa lidar com diversas variantes (Cliente ABC, Cliente XYZ, fatura genérica). A IA faz a correspondência com os dados recebidos. PDF Em seguida, retorna o nome da classificação correspondente ao esquema mais adequado, além dos campos extraídos desse esquema.
extração de fatura padrãoAnalisador de faturas integrado
Pronto para uso em faturas típicas de fornecedores. Devoluções Número da fatura, nome do fornecedor, projeto de lei paradatas e campos de cabeçalho relacionados sem a necessidade de criar um esquema personalizado primeiro.

Saída​

A ação retorna Dados do documento analisados como dinâmico JSONCada propriedade definida no seu esquema do Analyzer aparece como um token mapeável individualmente no painel de conteúdo dinâmico de cada ação subsequente. Os cabeçalhos de resposta também contêm informações padrão. Power Automate metadados de roteamento.

Saída da execução do Power Automate AI - Document Parser com statusCode 200 e corpo JSON contendo invoiceNumber INV-3337, invoiceDate January 25 2016, vendorName DEMO - Sliced Invoices, vendorAddress, vendorEmail admin@slicedinvoices.com, billTo Test Business, billToAddress e billToEmail test@test.com da extração de faturas padrão na fatura de fornecedor de exemplo.

Execução bem-sucedida da fatura de amostra do fornecedor com extração de fatura padrão. código de status 200; Dados do documento analisados Expõe uma propriedade por campo do Analyzer para mapeamento subsequente.

Campo (exemplo de execução)Valor de exemplo
invoiceNumberINV-3337
invoiceDateJanuary 25, 2016
vendorNameDEMO - Sliced Invoices
vendorEmail[email protected]
billToTest Business
billToEmail[email protected]
paymentDeadlineJanuary 31, 2016
SaídaTipoO que contém
statusCodeInteger200 on success, 400 for a malformed request body, 500 on a server-side error.
headersObjectStandard Power Automate / Microsoft routing headers, including Content-Type application/json.
Parsed Document DataDynamic JSONThe body object. One property per field defined in your Analyzer schema (string, number, date, or nested table). For Classify Analyzers, the Classification Name of the matched Schema is also present.

Configuração rápida​

  1. Primeiro, construa seu analisador. Abra o Lista de analisadores, clique + AdicionarDigite um ID de analisador claro e selecione Analisar ou ClassificarSalve a linha e, em seguida, adicione um esquema de documento ao Detalhes do analisador página. Veja a Guia de configuração do Parse ou Guia de configuração do Classify Para o passo a passo completo.
  2. Em seu Power Automate clique de fluxo + Novo passo, procurar PDF4me, escolha IA - Analisador de Documentos.
  3. Faça login em PDF4me Conecte-se com o seu API chave.
  4. Conteúdo do arquivoMapa de uma versão anterior Obter conteúdo do arquivo etapa (SharePoint, OneDrive, Outlook anexo, Dropbox ou qualquer conector de armazenamento em nuvem).
  5. Nome do arquivoMapeie o nome do arquivo de origem com a extensão (sample-vendor-invoice.pdf, invoice.png, etc).
  6. Parâmetros avançados → Nota de personalizaçãoDigite o ID do analisador da etapa 1 (por exemplo, default_invoice_extraction, client_invoices, ou purchase order parser).
  7. Salve o fluxo e teste. A ação retorna. Dados do documento analisados Com uma propriedade por campo em seu esquema. Mapeie os campos para a próxima etapa usando o painel de conteúdo dinâmico.

Exemplos de fluxo de trabalho​

Exemplos de fluxo de trabalhoOpen by default. Four common AI - Document Parser patterns in a 2x2 grid.
Faturas de fornecedores para SharePoint lista
  1. Acionar ao abrir um novo arquivo em SharePoint Faturas recebidas biblioteca.
  2. Obtenha o conteúdo do arquivo para o novo PDF.
  3. Correr IA - Analisador de Documentos com a Nota de Personalização definida para o seu ID do Analisador de Análise. analisador_de_faturas.
  4. SharePoint Criar item na lista de contas a pagar com Número da Fatura, Nome do Fornecedor, Valor Total e Data de Vencimento mapeados a partir do mapeamento dinâmico. JSON.

Impacto: A entrada manual de dados foi substituída pela entrada de dados AP sem contato.

Caixa de entrada de fornecedores mistos com o Classify
  1. Outlook Quando um novo e-mail chega com gatilho de fixação.
  2. Obter conteúdo do anexo em formato binário.
  3. Executar IA - Analisador de Documentos com Nota de Personalização definida para um ID de Analisador de Classificação (faturas_de_clientes) contendo um esquema por fornecedor.
  4. Ative o nome de classificação retornado e direcione os campos do Cliente ABC para uma tabela do Dataverse e os do Cliente XYZ para outra.

Impacto: Um Power Automate O sistema processa todos os fornecedores sem necessidade de triagem manual.

Pedidos de compra para Excel para revisão
  1. Acionar em novo PDF em um Dropbox Caixa de entrada PO.
  2. Obter conteúdo do arquivo.
  3. Executar IA - Analisador de Documentos com a Nota de Personalização definida como analisador de pedidos de compra.
  4. Excel Adicionar uma linha a uma tabela Com os campos SalesOrderNumber, AgentName, OrderDate e TotalAmount mapeados a partir da resposta.

Impacto: A equipe de operações visualiza todos os pedidos de compra sem precisar abrir nenhum. PDF.

Formulário de integração de clientes para Dynamics 365
  1. Power Automate Quando uma solicitação HTTP é recebida Acione a partir do seu portal.
  2. Decodifique o arquivo carregado. PDF.
  3. Execute o analisador de documentos com IA (Execute AI - Document Parser) com a nota de personalização definida para um ID de analisador de análise que você criou para seu formulário de integração personalizado.
  4. Dataverse Adicionar uma nova linha Para um contato, mapeie diretamente o nome da empresa, a pessoa de contato, o e-mail, o CNPJ e o endereço de cobrança.

Impacto: Integração de clientes por meio de autoatendimento, sem entrada manual de dados no CRM.

Perguntas frequentes​

What is the difference between AI - Document Parser and AI-Invoice Parser?+
AI-Invoice Parser uses a fixed schema tuned for invoices (vendor, line items, totals, dates). AI - Document Parser is schema-driven: it runs whatever Analyzer you reference by Customisation Note, built once in the PDF4me dashboard. The same action handles purchase orders, receipts, contracts, custom forms, lab results, ID cards, or anything else you describe in a schema. Pick AI - Document Parser whenever you need flexibility or a non-invoice document type.
Where do I build the Analyzer?+
At https://dev.pdf4me.com/dashboard/#/ai-document-parser/ (Analyzer list, + Add) and https://dev.pdf4me.com/ai-document-parser/?id=<analyzer-guid> (Analyzer detail for schemas). Two analyzer types: Parse (one schema) and Classify (many variants). Reference the Analyzer Id in the Customisation Note field.
What does Customisation Note actually do?+
Customisation Note tells the action which saved Analyzer to apply to your document. Type the Analyzer Id you created in the dashboard (for example default_invoice_extraction, client_invoices, or purchase order parser). The Analyzer schema controls every extracted field; changing this single value lets one Power Automate flow handle multiple document types.
What format is the output and how do I map fields downstream?+
Parsed Document Data is dynamic JSON with one property per field defined in your schema. In SharePoint Create item, Excel Add a row, Dataverse Add a new row, or any downstream action, pick the matching property from the dynamic content panel and drop it into the target column. No Parse JSON step needed.
Which file types does the action accept?+
PDF, PNG, JPG, and JPEG. The Get file content action of any cloud-storage connector that exposes binary file bytes can feed AI - Document Parser. Scanned PDFs work because the AI engine handles OCR internally.
Can one flow process several document variants in one run?+
Yes, with a Classify Analyzer. Build one Classify Analyzer with one Schema per variant (Client ABC, Client XYZ, generic invoice). The AI picks the best-matching Schema at runtime and the action returns its fields plus the Classification Name. Switch on the Classification Name in a Power Automate switch step to route each result to the right downstream destination.
What happens on failure?+
Status code 400 means the request body was malformed (missing File Content, invalid filename, or an Analyzer Id that does not exist in your account). Status code 500 means a transient server-side error, your flow should retry. Use a Try / Catch / Finally scope around the action for production-grade error handling.
Will the same Analyzer work from Make, Zapier, n8n, or the REST API?+
Yes. The Analyzer Id is shared across every platform. Once you save an Analyzer in the dashboard you can call it from Power Automate, Make, Zapier, n8n, or the REST API by passing the same Id. Schema changes propagate to every platform without rewiring.

Ações relacionadas​

Mesma tarefa em outras plataformas​

Obtenha ajuda​

PDF4me ConnectGet your API KeyPower Automate Documentation