Crie um analisador de IA personalizado para seu próprio formato de fatura no Power Automate: um fluxo de trabalho de 3 etapas do Dropbox

A Modelo personalizado de análise de IA É um esquema JSON nomeado que você define no portal de desenvolvedores do PDF4me e que informa à IA quais campos extrair de um tipo de documento específico. Este passo a passo cria um analisador para as faturas de assinatura SaaS do próprio PDF4me (33 campos: bloco de endereço do fornecedor, taxa MWST suíça, ID da assinatura, itens de linha, detalhes de desconto) e, em seguida, o chama a partir de um fluxo de 3 etapas do Power Automate que lê um PDF do Dropbox e retorna um JSON estruturado.

O embutido default_invoice_extraction Abrange faturas genéricas, mas as equipes reais de contas a pagar têm layouts específicos de fornecedores, colunas de itens de linha personalizadas, campos de impostos específicos da jurisdição e metadados de assinatura que o esquema genérico não contempla. Criar um analisador personalizado uma única vez garante a extração de correspondência exata para sempre, sem necessidade de prompts por campo e sem lógica subsequente para limpar a resposta.

Perguntas e respostas baseadas no "porquê".​

O que você receberá​

Entrada: Uma fatura em PDF no formato para o qual seu analisador foi projetado, armazenada no Dropbox. Este passo a passo utiliza uma fatura de assinatura do SaaS PDF4me (Ynoox GmbH / Suíça, MWST 8,1%, metadados de assinatura, plano Pdf4me Base 1000). Saída: Uma resposta JSON estruturada com todos os 33 campos do esquema, disponível como conteúdo dinâmico do Power Automate para a próxima ação (gravar em uma lista do SharePoint, publicar no Slack, anexar ao Excel Online, encaminhar para aprovação etc.).

Exemplo de fatura de entrada​

Exemplo de JSON de saída (trecho da execução real)​

{
  "documentTitle": "INVOICE",
  "invoiceNumber": "Pdf4me-202601-32324",
  "invoiceDate": "Jan 26, 2026",
  "currency": "USD",
  "paymentStatus": "PAID",
  "vendorName": "Ynoox GmbH",
  "vendorAddress": "Riedstrasse 2B, Hedingen, Zürich 8908, Switzerland",
  "vendorTaxRegNumber": "CHE-360.751.198",
  "billTo": "Chandra Arora",
  "subscriptionId": "2e46662a-32e0-4e79-ba06-b13fe2c113ac",
  "billingPeriodString": "Jan 26 to Feb 26, 2026",
  "nextBillingDate": "Feb 26, 2026",
  "mwstRate": 8.1,
  "discountCode": "F_yn_100!",
  "discountAmount": 35,
  "lineItems": [
    { "description": "Pdf4me Base 1000", "price": 35, "discount": 35, "amount": 0 }
  ]
}

A resposta completa, com 33 campos, pode ser baixada na seção abaixo.

Do que você precisa​

O esquema: 33 campos que o Analisador extrai.​

O esquema do Analyzer é o núcleo da extração personalizada. Cada campo declara o nome que o Power Automate verá, o tipo que o Power Automate receberá e uma descrição que orienta a IA sobre onde procurar o valor.

O esquema JSON completo (com o exato fieldDescription As strings que a IA consome estão no arquivo para download acima.

Configuração A: Como faço para acessar o portal de desenvolvedores do PDF4me?​

Onde você está: antes que qualquer fluxo exista.

1. Abrir dev.pdf4me.com em qualquer navegador.
2. Digite seu e-mail e senha e clique em Conecte-seOu selecione uma das opções de SSO à direita: Continue com a Microsoft, Google, Facebook, Maçã, GitHub.
3. É novo por aqui? Clique aqui. Não tem conta? Cadastre-se para criar um.

A tela de login​

Configuração B: Abra o analisador de documentos de IA no painel de controle.​

Onde você está: conectado, em dev.pdf4me.com/dashboard.

1. A barra lateral esquerda do painel de controle exibe as seções da sua conta: Início, Perfil, Assinatura, Informações de Pagamento. Chaves de APIRegistros, Faturas, Analisador de documentos com IAMeus Documentos, Classificar Documento, Analisar Documento, Histórico de Trabalho, Documentos Compartilhados, Indicar um amigo, Recompensas.
2. Clique Analisador de documentos com IA.

A barra lateral do painel de controle​

Configuração C: Como adicionar um novo modelo de analisador?​

Onde você está: Página do analisador de documentos com IA.

1. A página lista todos os modelos de analisador que você já criou, com seus respectivos IDs, tipos e ações de edição/exclusão.
2. Clique + Adicionar.
3. Aparece uma linha em branco com dois campos:
   • ID do analisadorDigite um nome curto e fácil de lembrar (por exemplo, Test InvoiceEsta é a string exata que você passará como Nota de Personalização no Power Automate.
   • Tipo de analisador: menu suspenso com opções Parse e Classify. Escolha Analisar para extração de campos estruturados. Selecione Classificar quando você deseja uma decisão de roteamento.
4. Clique Salvar.

Adicionar Analisador​

Configuração D: Cole o esquema JSON e salve.​

Onde você está: editando o analisador recém-criado.

1. Clique no ícone de edição (lápis) ao lado do seu novo analisador (Test Invoice).
2. O editor de informações de análise abre com o ID do analisador na parte superior e o Esquema do documento campo abaixo.
3. Cole o esquema JSON de 33 campos de analyzer-schema.json na área de texto do Esquema do Documento. Cada entrada é { "fieldName": "...", "fieldType": "...", "fieldDescription": "..." }. O fieldDescription É o campo mais importante, pois indica à IA onde procurar e o que capturar.
4. Escolha um Tipo de documento de exemplo predefinido (Invoice ou Purchase Order) se você quiser um modelo inicial; caso contrário, cole seu esquema diretamente.
5. Clique Salvar alterações.

Editor de esquema Parse Info​

Fluxograma 1: Como conectar o analisador ao Power Automate?​

Fluxo até o momento: Apenas o gatilho.

A parte do Power Automate é simples: 3 ações. Comece com um gatilho manual para poder iterar; troque por um gatilho HTTP/SharePoint/Outlook quando estiver pronto para produção.

1. Em Power Automate clique Criar, escolher fluxo de nuvem instantâneo.
2. Dê um nome ao fluxo (por exemplo, Custom Invoice Extraction), escolha Acionar um fluxo manualmente, clique Criar.

O fluxo completo de 3 ações​

Três ações. A análise de documentos por IA é a única etapa que utiliza o PDF4me e consome a maior parte do tempo de execução (cerca de 21 segundos para uma fatura de uma página).

Fluxo 2: Obtenha o PDF original do Dropbox​

Fluxo até o momento: Gatilho Plus Obter conteúdo do arquivo.

1. Clique + Novo passo, procurar Dropbox, escolha Obter o conteúdo do arquivo usando o caminho.
2. Conectar sua conta do Dropbox, caso ainda não tenha feito isso.
3. Configurar:
   • Caminho do arquivo: /pdf4me.pdf
   • Inferir tipo de conteúdo: Yes (em Parâmetros avançados)

Obter configuração de conteúdo do arquivo​

Fluxo 3: Por que o campo "Observação de personalização" contém o nome do seu analisador?​

Fluxo até o momento: Gatilho + Obter conteúdo do arquivo + IA - Analisador de Documentos.

Esta é a ação que chama seu analisador personalizado. O truque é o Nota de personalização Campo: cole o nome exato do ID do analisador da Configuração C (Test Invoice Neste passo a passo). Sem ele, a ação retorna à extração de fatura padrão.

1. Clique + Novo passo, procurar PDF4me, escolha IA - Analisador de Documentos.
2. Conectar PDF4me AI com sua chave de API (somente na primeira vez).
3. Configurar:
   • Conteúdo do arquivo: escolha o File Content Token da etapa 2 (Obter conteúdo do arquivo)
   • Nome do arquivo: Test.pdf (apenas o rótulo, não o caminho)
   • Nota de personalização (em Parâmetros avançados): Test Invoice (o ID exato do analisador que você definiu na Configuração C)
4. Salvar e testar.

Ação de análise de documentos com IA​

Execute o fluxo e verifique.​

1. Salvar o fluxo no canto superior direito.
2. Clique Teste, escolher Manualmente, clique Teste então Fluxo de execução.
3. Abra os detalhes da execução. Todas as três ações devem estar verdes. A etapa "AI - Document Parser" mostra um corpo JSON em suas saídas.
4. O corpo da resposta contém todos os campos declarados no seu esquema, preenchidos a partir do PDF.

Exemplo de resposta de uma execução real.​

Variações comuns que você pode adicionar sem reconstruir​

Analisador personalizado vs. default_invoice_extraction​

Perguntas frequentes​

Quanto tempo leva para elaborar o esquema?​

Para um formato de fatura familiar (seu próprio sistema de faturamento SaaS, seus três principais fornecedores), reserve de 15 a 30 minutos para o primeiro rascunho. Leia uma fatura do início ao fim, liste todos os campos que sua equipe de contas a pagar transcreve manualmente e escreva uma frase resumida. fieldDescription Para cada descrição que indique o rótulo impresso e forneça um exemplo, teste com 3 a 5 faturas de amostra e itere nas descrições que apresentarem erros.

O que acontece se um campo estiver faltando no documento?​

O analisador retorna o campo com um valor nulo ou vazio. Ele não gera erro. Sua lógica subsequente do Power Automate deve lidar com valores ausentes. coalesce() ou if(empty(...)) expressões, especialmente para campos obrigatórios como invoiceNumberEste é o mesmo comportamento que default_invoice_extraction.

Posso controlar as versões do meu esquema do Analyzer?​

Ainda não está disponível nativamente no portal de desenvolvedores. O padrão recomendado é criar um novo ID de analisador quando você fizer uma alteração de esquema que cause incompatibilidade (Test Invoice v2) e atualize a Nota de Personalização do Power Automate para apontar para a nova versão. Mantenha o analisador antigo ativo até que todos os fluxos tenham sido migrados.

Como a IA sabe quais campos extrair para fieldMethod: generate?​

A IA lê o fieldDescription e os nomes dos campos irmãos no mesmo nível. Para vendorAddress definido como "Complete vendor address (street, city, state, postal code, country). Use comma(,) to separate lines.", a IA monta as peças a partir das já extraídas vendorStreet, vendorCity, vendorState, vendorPostalCode, vendorCountry campos. Sem expressões regulares, sem modelos de string, sem necessidade de ações subsequentes.

O Analyzer funciona com Power Automate, Make, Zapier e n8n?​

Sim. Assim que um ID de analisador for publicado no portal de desenvolvedores, todas as ações do PDF4me AI - Document Parser, em todas as plataformas, poderão referenciá-lo pelo nome. Crie o esquema uma vez e use-o em qualquer ferramenta de automação; o formato da resposta JSON será o mesmo.

Solução de problemas​

Próximos passos​

O mesmo padrão de configuração única/chamada múltipla (definir o analisador, colar o esquema, passar o ID como nota de personalização) funciona para qualquer tipo de documento: pedidos de compra, contratos, extratos bancários, solicitações de reembolso médico, declarações alfandegárias. Defina um analisador por formato e, em seguida, combine-os de qualquer fluxo do Power Automate, Make, Zapier ou n8n.