OCR de faturas no Zapier: Percorra todos os anexos em uma caixa de correio compartilhada com AI Document Parser PDF4me

PDF4me AI Document Parser é uma ação Zapier que lê um documento com inteligência artificial e retorna seus campos em formato JSON. Combinado com Looping by Zapier, ele lida com o caso comum em contas a pagar: um e-mail contendo várias faturas, cada anexo analisado em sua própria execução.

Todas as ferramentas de OCR para faturas demonstram a mesma coisa: um documento entra e os campos saem limpos. Mas não é assim que as faturas chegam. Elas chegam por e-mail, em uma caixa de entrada compartilhada, de um fornecedor que anexou três PDFs e escreveu " PFA " no corpo do e-mail. O problema interessante não é ler uma única fatura, mas sim que um único gatilho precisa se transformar em várias análises, e a maioria dos tutoriais ignora isso silenciosamente, observando uma pasta onde alguém já separou os arquivos. Este Zap não ignora essa etapa. São três passos, e o do meio é o loop.

Perguntas e respostas baseadas no "porquê".​

O que você receberá​

Entrada: um e-mail em uma caixa de correio compartilhada com qualquer número de faturas em PDF anexadas. Saída: uma execução Zap por anexo, cada uma retornando a fatura como JSON estruturado com uma pontuação de confiança por campo, pronta para ser integrada a qualquer aplicativo subsequente.

Dois anexos, uma mensagem, um corpo de texto com duas palavras. Essa é a entrada que o Zap precisa processar.

Um e-mail entra, duas execuções saem. Cada iteração do loop é uma execução Zap separada no histórico.

Do que você precisa​

O Zap em resumo​

1. New Email in Shared Mailbox (Microsoft Outlook) verifica a caixa de correio a cada 2 minutos.
2. Create Loop From Line Items (Looping by Zapier) transforma a lista de anexos em uma iteração por arquivo.
3. O AI - Document Parser (PDF4me) executa o Analyzer no anexo da iteração atual.

Visão geral completa Zap​

Três etapas. O loop no meio é o que faz com que a terceira etapa seja executada uma vez por dispositivo.

Passo 1: Como acionar um Zap a partir de uma caixa de correio compartilhada?​

Fluxo até agora: nada ainda, este é o gatilho.

O evento é a chegada de uma fatura, portanto, a caixa de correio é o gatilho.

1. Crie um Zap e selecione Microsoft Outlook > New Email in Shared Mailbox.
2. Conecte a conta que tem permissão para ler a caixa de correio e, em seguida, escolha o endereço da caixa de correio compartilhada e a pasta que deseja monitorar. Monitorar a Caixa de Entrada é uma boa opção para começar.
3. Teste o gatilho com o e-mail que você preparou. Zapier reporta " Encontrado 1 novo e-mail no Microsoft Outlook e a lista de anexos fica disponível para as etapas posteriores como itens de linha.

O intervalo de pesquisa no Zap capturado é exibido como 2 minutos, que é a programação do plano Zapier e não algo que você tenha configurado na etapa.

Passo 2: Como percorrer todos os anexos em um único e-mail?​

Fluxo até o momento: o gatilho Outlook.

Esta é a etapa que transforma um único e-mail em uma única execução por fatura.

1. Adicionar Looping by Zapier > Create Loop From Line Items.
2. Em Values to Loop, mapeie os itens de linha do anexo do gatilho. A execução capturada intercala dois valores, que é o padrão a ser copiado:
   • Attachments Name, o nome do arquivo
   • Attachments File, o próprio arquivo
3. Teste a etapa. Zapier reporta "1 novo Loop enviado para Looping by Zapier e a aba " Data out mostra a primeira iteração, além de uma prévia de todas elas.

Create Loop From Line Items​

Loop Total Iterations lê 2, um por anexo, e preview_loop_values nomeia ambos os arquivos antes que qualquer um deles tenha sido analisado.

O que o laço te oferece​

Antes de prosseguir, é importante observar dois detalhes. O loop não é executado na ordem em que os anexos aparecem no Outlook: o e-mail exibiu a Amostra 2 primeiro e o loop concordou, mas você nunca deve confiar nisso. Além disso, Loop Id é o único elemento que conecta as linhas resultantes ao e-mail de origem, portanto, mapeie-o posteriormente agora, em vez de se arrepender depois.

Etapa 3: Como transformar cada anexo em JSON estruturado?​

Fluxo até agora: o gatilho mais o loop.

A partir daqui, tudo é executado uma vez por anexo, pois está dentro do loop.

1. Adicione PDF4me > AI - Document Parser e conecte sua chave de API.
2. Configurar:
   • File: o token Attachments File do loop, não do gatilho. Este é o erro que as pessoas costumam cometer.
   • File Name e File Ext: construa o nome a partir do Attachments Name do loop.
   • AI Analyzer Id: selecione seu Analyzer no menu suspenso. O analisador default_invoice_extraction produz a saída abaixo.
   • AI Analyzer Name (Deprecated): deixe em branco.
3. Teste. Zapier reporta o envio de 1 novo Process Document para Pdf4me, e Data out contém os campos analisados.

AI - Document Parser, primeiro anexo​

Doc Text contém a fatura. Cada campo também aparece no docConfidenceLevel com uma pontuação associada.

Saída AI - Document Parser, segundo anexo​

Um Trace Id diferente e um ID de documento diferente são as formas de distinguir as duas análises nos registros.

Ambos os anexos nesta captura contêm a mesma fatura de exemplo, portanto os valores extraídos coincidem. O que a segunda execução comprova não é que o analisador processa dois layouts diferentes, mas sim que a terceira etapa foi executada duas vezes a partir de um único e-mail.

O que retorna​

Dentro do Doc Text o Analyzer default_invoice_extraction retorna os campos do cabeçalho (invoiceNumber, invoiceDate, invoiceDateString, orderId, customerPO, paymentDeadline), o bloco do fornecedor (vendorName, vendorAddress, vendorPhone, vendorEmail e identificadores fiscais, incluindo vendorGSTIN, vendorPAN, vendorCIN, vendorVatUidNr, iban), o bloco do cliente (billTo, billToAddress, billToPhone, billToEmail, billToState, billToPincode), os totais (subTotal, cgst, sgst, cgstRate, sgstRate, totalTaxAmount, total) e uma matriz lineItems. Para a fatura de exemplo que resulta no invoiceNumber 13594027, billTo John Smith, total 37.5 e dois itens de linha, o segundo dos quais é a linha de desconto -12.5.

Lendo os índices de confiança​

docConfidenceLevel espelha o mesmo formato, mas com um número no lugar de cada valor. Esses valores representam as pontuações das duas execuções registradas, e a diferença entre elas é o ponto.

O mesmo documento obteve pontuações ligeiramente diferentes em duas análises, o que é normal para um modelo e é exatamente por isso que você define um limite em vez de confiar em um único número. Escolha um limite mínimo, encaminhe tudo o que estiver abaixo dele para uma pessoa e deixe o restante passar.

Execute o Zap e verifique.​

1. Publish o Zap.
2. Envie um e-mail de teste para a caixa de correio compartilhada com dois PDFs anexados.
3. Aguarde a votação e, em seguida, abra Zap history.
4. Você deverá ver duas execuções do Zap, não apenas uma, cada uma marcada como Bem-sucedida e cada uma consumindo 1 tarefa.
5. Abra cada execução e verifique Data out da etapa 3: o Trace Id e Document Document Id devem ser diferentes entre elas, e Doc Text deve conter a fatura do anexo.
6. Verifique o Loop Total Iterations na etapa 2. Se o valor for 1 quando você anexar dois arquivos, o problema está no mapeamento de Values to Loop, e não no analisador sintático.

Na execução capturada, as duas Zap runs foram concluídas às 19:02:53 e 19:03:37 do dia 15 de outubro de 2026, ambas com sucesso, 1 tarefa cada, a partir de um único e-mail contendo 395 KB de anexos.

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

Como isso se compara a outras formas de realizar OCR em faturas?​

Cada linha descreve a alternativa. A última linha é este Zap.

Perguntas frequentes​

O que é OCR de faturas?​

O OCR de faturas lê a fatura com um software em vez de uma pessoa, de forma que o fornecedor, a data, os itens e o total sejam extraídos como dados que seus sistemas podem usar. O OCR clássico apenas recuperava os caracteres da página e deixava para você descobrir qual número era o total; os analisadores de IA que o substituíram retornam os campos nomeados diretamente.

Essa distinção é importante na hora de escolher uma ferramenta. Uma biblioteca que executaoptical character recognition Fornece o texto. Um analisador de documentos fornece total, invoiceNumber e billTo, que é o que um Zap pode mapear em uma planilha.

Como funciona o recurso de looping do Zapier?​

O recurso Looping by Zapier é um aplicativo integrado que repete as etapas abaixo, uma vez para cada item. Create Loop From Line Items utiliza um conjunto de itens de linha de uma etapa anterior, como a lista de anexos de um e-mail, e inicia uma iteração para cada item.

Cada iteração é uma execução separada Zap, com sua própria entrada no Zap history e seu próprio consumo de tarefas. Dentro de uma iteração, você obtém Loop Iteration, Loop Total Iterations, se Loop Iteration Is Last e um Loop Id compartilhado por todas as iterações do mesmo registro de origem.

O que é o processamento de faturas por OCR?​

O processamento de faturas por OCR abrange todo o processo, não apenas a etapa de leitura: uma fatura chega, seus campos são extraídos, os valores são verificados e o resultado é lançado em um livro-razão ou em uma fila de revisão. A extração geralmente é a parte mais fácil.

Os fatores que determinam se funciona na prática são a entrada de dados e o tratamento de exceções. Este Zap aborda a entrada de dados com a caixa de correio compartilhada e o loop, e fornece a base para o tratamento de exceções com docConfidenceLevel.

Como automatizar as contas a pagar?​

Comece pela entrada de dados, pois etapas manuais nessa etapa desfazem todo o trabalho subsequente. Forneça um único endereço aos fornecedores, configure o gatilho para isso e certifique-se de que um único e-mail com várias faturas gere vários registros, em vez de apenas um.

Em seguida, decida quais lançamentos serão automáticos. Um limite de confiança nos campos extraídos divide as faturas entre aquelas que seu sistema pode processar sem supervisão e aquelas que devem ser visualizadas por um funcionário. Essa divisão é o que torna a automação segura para ser mantida em execução.

Solução de problemas​

Próximos passos​

A parte difícil da automação de faturas nunca foi ler a fatura em si. O problema era o envelope em que ela chegava, e um laço é o que o abre.