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

Renomeie faturas de fornecedores com IA no Zapier: um fluxo de trabalho de 5 etapas com Dropbox e PDF4me

· 21 min para ler
Sankalp Mishra
SEO and Content Writer

A parte mais difícil das contas a pagar não é pagar as faturas, é descoberta A fatura correta está arquivada quando alguém a solicita três semanas depois. Cada fornecedor nomeia os arquivos de forma diferente, cada digitalização é untitled (3).pdf, cada pasta do Dropbox se transforma em um verdadeiro caos. A solução é permitir que a IA leia a fatura assim que ela chegar, extraia o nome do cliente e renomeie o arquivo antes mesmo de ele ser armazenado em um local de longo prazo. Este passo a passo demonstra exatamente esse padrão em Zapier com PDF4me AI - Analisador de Documentos, Dropboxe uma linha de 2 Código por Zapier Passo. Cinco passos do Zap. Capturas de tela reais de um Zap funcionando. O nome do fornecedor se torna o nome do arquivo. A busca volta a funcionar normalmente.

O Zap em resumo
1. Dropbox: New File in Folder
Trigger. Polls /MuneerTrigger every 2 min for new files. Use any inbox folder where vendor invoices land.
2. Dropbox: Find File
Looks up the matching file in /pdf4metest/sample by File Name so we get the binary content into the Zap.
3. PDF4me: AI - Document Parser
Runs the default_invoice_extraction Analyzer against the file. Returns JSON keyed by the Analyzer schema (Customer Name, dates, totals, line items).
4. Code by Zapier: Run JavaScript
Two lines. JSON.parse the Doc Text into a real object so the next step can read its properties as tokens.
5. Dropbox: Upload File
Writes the original file back to /pdf4meoutput with Customer Name as the filename and the original extension.
A versão curta

Duas etapas do Dropbox estruturam o Zap. O analisador de IA do PDF4me lê a fatura. Uma etapa de código de duas linhas transforma a saída do analisador em tokens mapeáveis. O nome do fornecedor se torna o nome do arquivo. O Zap é executado em menos de 10 segundos de ponta a ponta em uma fatura de uma página. Nenhum analisador personalizado é necessário, pois o analisador integrado já faz isso. extração de fatura padrão Abrange a maioria das faturas de fornecedores sem necessidade de configuração adicional.

Perguntas e respostas baseadas no "porquê".​

Por que duas etapas do Dropbox no início? O Novo arquivo na pasta O gatilho fornece metadados (nome, caminho, ID), mas nem sempre um arquivo binário limpo que os aplicativos subsequentes possam reenviar. Localizar arquivo O processo lê o arquivo corretamente, permitindo que o PDF4me obtenha um documento válido para análise e, na etapa 5, os bytes necessários para o upload. O mesmo padrão funciona no SharePoint ou no OneDrive com os conectores correspondentes.

Por que uma etapa de código no meio? O analisador de IA retorna os dados extraídos em formato JSON. corda no Texto do documento saída. O Zapier exibe tudo como um único bloco grande, a menos que você o analise. Duas linhas de JSON.parse dentro Código por Zapier Transforme esse bloco de dados em um objeto real cujas chaves (Nome do Cliente, Número da Fatura, totais) se tornem tokens mapeáveis individualmente na etapa 5. O equivalente em Make é um módulo Parse JSON.

Por que extração de fatura padrão? É o analisador integrado que acompanha o PDF4me, otimizado para faturas típicas de fornecedores. Alterne para um analisador personalizado. Analisador de análise sintática quando você precisa de campos que o padrão não abrange, ou para um Analisador de classificação quando um único Zap precisa lidar com vários layouts de fornecedores em uma única execução.

Por que renomear em vez de mover para uma pasta de fornecedores? Ambas as opções funcionam, você pode encadear um Dropbox. Mover arquivo Após essa alteração no Zap, o próximo passo é também inserir o item em uma subpasta de fornecedor. Renomear primeiro significa que a busca por nome retorna a fatura correta instantaneamente, mesmo que a hierarquia de pastas seja alterada.

O que você receberá​

Entrada: Uma fatura de fornecedor em PDF foi adicionada a uma pasta do Dropbox monitorada (/MuneerTrigger Neste passo a passo, qualquer pasta da caixa de entrada funciona. Saída: O mesmo PDF foi reenviado para /pdf4meoutput nomeado de acordo com o nome do cliente do fornecedor (por exemplo, HEADWAY TECHNOL…1; RENT 3.6-2MB.pdfO arquivo original permanece intacto na pasta de gatilho para que você possa manter um registro de auditoria.

Do que você precisa​

  • Zapier. Abra o ZapierA etapa "Código do Zapier" requer pelo menos um plano Starter; todo o resto funciona no plano gratuito.
  • Chave da API PDF4me. Obtenha sua chave de APIVocê o conectará na primeira vez que adicionar uma ação do PDF4me.
  • DropboxTanto para a pasta de entrada (gatilho) quanto para a pasta de saída (carregar arquivo), o SharePoint, o OneDrive e o Google Drive funcionam da mesma forma com seus respectivos conectores.
  • Exemplo de fatura de fornecedorQualquer PDF com o nome do fornecedor/cliente visível. O passo a passo utiliza exemplo-fatura-do-fornecedor.pdf, você pode Baixe o arquivo exato usado neste guia. e arraste para o Dropbox para espelhar todas as capturas de tela.

Primeiro, pegue a amostra. Clique abaixo para baixar a mesma fatura do fornecedor usada nas capturas de tela. Coloque-a na pasta de gatilhos do Dropbox antes de publicar o Zap, para que o primeiro teste gere o mesmo token de nome do cliente que você vê na etapa final de upload.

O Zap em resumo​

  1. Dropbox: Novo arquivo na pasta (gatilho). Verifica a pasta monitorada a cada poucos minutos em busca de novos arquivos.
  2. Dropbox: Localizar arquivoProcura o novo arquivo pelo nome para obter seu conteúdo binário no Zap.
  3. PDF4me: IA - Analisador de DocumentosExecuta o default_invoice_extraction Analisador.
  4. Código do Zapier: Executar JavaScriptDuas linhas que JSON.parse Transformar o texto do documento em um objeto real.
  5. Dropbox: Carregar arquivoReescreve o arquivo com Nome do cliente como o novo nome do arquivo.

Visão geral completa do Zap​

Tela do Zapier Zap mostrando 5 etapas empilhadas de cima para baixo: Adicionar novo arquivo na pasta do Dropbox (aguardando 2 minutos), Encontrar arquivo no Dropbox, PDF4me AI - Analisador de documentos, Executar JavaScript com o Code by Zapier, Carregar arquivo no Dropbox

Cinco etapas. Cada cartão exibe uma marca de seleção verde quando configurado. O PDF4me fica no meio; a etapa de código transforma a saída do analisador em tokens mapeáveis.

Passo 1: Dropbox – Novo arquivo na pasta (gatilho)​

Até agora, Zap: Apenas acione.

  1. Em Zapier clique + Criar Zap.
  2. Escolha Dropbox como o aplicativo de gatilho, Novo arquivo na pasta como o evento.
  3. Conectar sua conta do Dropbox, caso ainda não o tenha feito.
  4. Configurar:
    • Espaço: Default
    • Pasta: /MuneerTrigger (ou qualquer pasta de entrada onde os fornecedores coloquem os arquivos)
    • Incluir arquivos em subpastas?: False
    • Incluir o conteúdo do arquivo?: Yes (importante, fornece às etapas subsequentes uma alternativa binária clara)
    • Incluir link para compartilhamento?: Yes (opcional, útil se você quiser enviar um link no Slack mais tarde)
  5. Gatilho de testeArraste e solte uma fatura de exemplo na pasta; o Zapier deverá retornar um novo registro de arquivo.

Configuração do gatilho​

Acionador "Novo arquivo no Dropbox" em pasta: Configurar guia com Espaço Padrão, Pasta /MuneerTrigger, Incluir arquivos em subpastas: Não, Incluir conteúdo do arquivo: Sim, Incluir link de compartilhamento: Sim

O gatilho monitora a pasta da caixa de entrada e verifica a cada 2 minutos por padrão no plano Starter, e com maior frequência nos planos superiores.

Etapa 2: Dropbox – Localizar arquivo​

Até agora, Zap: Gatilho → Localizar Arquivo.

O gatilho "Novo Arquivo" fornece o nome e o caminho do arquivo, mas o gatilho "Localizar Arquivo" garante um arquivo binário limpo e pronto para download, que poderá ser reutilizado nas etapas seguintes. Adicione-o.

  1. Clique + abaixo do gatilho. Escolha Dropbox, Localizar arquivo.
  2. Configurar:
    • Espaço: Default
    • Pasta: /pdf4metest/sample (a pasta onde o arquivo está realmente localizado, geralmente a mesma pasta que acionou o gatilho)
    • Incluir arquivos em subpastas?: False
    • Nome do arquivo (obrigatório): escolha o Nome do arquivo token do gatilho (ele é preenchido automaticamente conforme você digita)
    • Incluir o conteúdo do arquivo?: Yes
    • Incluir link para compartilhamento?: Yes
    • Sucesso se nenhum resultado de pesquisa for encontrado?: deixar padrão (False, interrompe o Zap)
    • Se forem encontrados vários resultados de pesquisa: deixar padrão (Return first search result)
  3. Ação de testeO Zapier deve retornar o arquivo com conteúdo binário.

Encontrar configuração de arquivo​

Guia Configurar arquivo de pesquisa do Dropbox com a pasta /pdf4metest/sample, nome do arquivo sample-vendor-invoice.pdf, incluir conteúdo do arquivo: Sim, incluir link de compartilhamento: Sim, sucesso se nenhum resultado da pesquisa for encontrado: Falso, status da execução da etapa: interrompida, padrão: Se houver vários resultados de pesquisa, retornar o primeiro resultado da pesquisa

A função "Find File" garante que a ação subsequente do PDF4me e a etapa "Upload File" recebam um arquivo binário limpo, e não apenas um link do Dropbox.

Etapa 3: PDF4me – IA - Analisador de Documentos​

Até agora, Zap: Acionador → Localizar arquivo → IA - Analisador de documentos.

É aqui que a IA lê a fatura e extrai os campos estruturados. O analisador padrão abrange faturas típicas de fornecedores; você pode alternar para um analisador personalizado posteriormente para campos específicos do setor.

  1. Clique +. Procurar PDF4me, escolha IA - Analisador de Documentos.
  2. Conectar PDF4me com sua chave de API (apenas na primeira vez, reutilize em todas as ações do PDF4me).
  3. Configurar:
    • Arquivo: escolha o Arquivo Token da etapa 2 (Localizar Arquivo). Deixe URL do arquivo vazio, você já tem um arquivo.
    • Nome do arquivo: concatenar o Nome do arquivo e Extensão do arquivo tokens da etapa 2 para que a ação receba o nome original com a extensão correta.
    • Nome do analisador de IA: default_invoice_extraction (o modelo de fatura integrado)
  4. Ação de testeExamine a resposta. Você deverá ver um Doc Text campo contendo uma string JSON com campos extraídos, além de tokens individuais como Customer Name, Invoice Number, totais, itens de linha.

Dica. Se extração de fatura padrão Se faltar algum campo necessário (número de IVA do fornecedor, códigos HSN, colunas personalizadas de itens de linha), crie um analisador personalizado no Painel de controle do analisador de documentos com IA e faça referência ao seu ID aqui. Mesma ação, esquema diferente. Reconstrução do Zero Zap.

Etapa 4: Código do Zapier – Executar JavaScript​

Até agora, Zap: Acionar → Localizar arquivo → IA - Analisador de documentos → Executar JavaScript.

O analisador de IA retorna seus dados como uma string JSON no Doc Text saída. O Zapier exibe como um único token. Para mapear campos individuais (Customer Name, Invoice Number, etc.) na próxima etapa, analise-o e transforme-o em um objeto real primeiro.

  1. Clique +. Escolha Código por Zapierevento Executar Javascript.
  2. Dados de entrada: adicionar uma entrada.
    • Nome: data2
    • Valor: escolha o Texto do documento token da etapa 3 (PDF4me).
  3. Código (cole exatamente):
const parsed = JSON.parse(inputData.data2);
return parsed;
  1. Ação de testeO resultado deve expor cada campo do seu esquema do Analyzer como um token individual: parsed customerName, parsed invoiceNumber, parsed totalAmount, etc.

Executar configuração Javascript​

Código criado pelo Zapier: Executar ação JavaScript com dados de entrada chamados data2 mapeados para o texto do documento (Doc Text) do PDF4me, contendo veoliaDetails e outros campos JSON extraídos. Painel de código com a constante parsed igual a JSON, analisar inputData.data2 e retornar parsed.

Duas linhas transformam o bloco JSON do analisador de IA em tokens Zapier mapeáveis individualmente. O equivalente no Make é um módulo Parse JSON.

Variante sem código. Se você não puder usar o Code by Zapier (por exemplo, o plano gratuito), use o Formatador do Zapier → Utilitários → Selecionar da lista ou Tabela de consulta padrões para extrair valores específicos dos dados brutos Texto do documento corda. Menos elegante, mas grátis.

Etapa 5: Dropbox – Carregar arquivo (Renomear inteligente)​

Até agora, Zap: Acionador → Localizar arquivo → IA - Analisador de documentos → Executar JavaScript → Carregar arquivo.

Esta é a recompensa. Pegue o arquivo da etapa 2 e faça o upload novamente com o nome do cliente extraído como nome do arquivo.

  1. Clique +. Escolha Dropbox, Carregar arquivo.
  2. Configurar:
    • Espaço: Default
    • Pasta: /pdf4meoutput (ou onde quer que suas faturas renomeadas devam ficar)
    • Arquivo: escolha o Arquivo token da etapa 2 (Localizar Arquivo)
    • Sobrescrever: True (ou False (se você quiser fracassar ruidosamente com duplicatas)
    • Especifique o nome do arquivo: escolha o Nome do cliente token da etapa 4 (o JSON analisado)
    • Especifique a extensão do arquivo.: escolha o Extensão do arquivo token da etapa 2
    • Incluir link para compartilhamento?: Yes
  3. Publicar o Zap.

Configuração de upload de arquivos​

Na guia Configurar arquivo de upload do Dropbox, selecione a pasta /pdf4meoutput, o arquivo da etapa 2 não possui espaço reservado para dados, a opção Sobrescrever está definida como Verdadeiro, o nome do arquivo deve ser definido como o token Nome do Cliente da etapa 4, mostrando HEADWAY TECHNOL 1 RENT 3.6 2MB, a extensão do arquivo deve ser especificada como o token Extensão do arquivo da etapa 2 e o link de compartilhamento deve ser incluído.

O token de nome do cliente extraído por IA é inserido diretamente no campo "Especificar nome do arquivo". A extensão original mantém o arquivo aberto como PDF.

Execute o Zap e verifique.​

  1. Alternar o Zap Sobre.
  2. Arraste e solte um PDF de exemplo de fatura em /MuneerTrigger.
  3. Aguarde a verificação de gatilho (até 2 minutos no Starter). Verifique Histórico do Zap, todos os cinco passos devem estar verdes.
  4. Abra o Dropbox /pdf4meoutputO arquivo está lá, nomeado com o nome do cliente do fornecedor, mantendo a extensão original.

O que você construiu exatamente? Um sistema automatizado de entrada de contas a pagar que transforma nomes de arquivos de faturas de fornecedores caóticos em um arquivo pesquisável indexado pelo nome do cliente. A IA lida com as variações, a etapa de código processa o JSON e o Dropbox cuida do armazenamento. O mesmo padrão funciona no Make (use um módulo "Analisar JSON" em vez de código) e no Power Automate (use a ação "Analisar JSON").

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

Adicionar uma linha do Google Sheets
Após o passo 4, adicione um Criar linha no Google Sheets Com as colunas Número da Fatura, Nome do Cliente, Valor Total e Data da Fatura. O Zap agora alimenta seu rastreador de contas a pagar E renomeia o arquivo.
Slack, o canal de finanças
Após o passo 5, adicione Enviar mensagem no canal do Slack: Nova fatura de {{customerName}} para {{totalAmount}} devido {{dueDate}}, arquive em {{Upload File sharing link}}Visibilidade sem notificação manual.
Mover para subpastas de fornecedores
Substituir Carregar arquivo com Mover arquivo do Dropbox e defina o destino para /pdf4meoutput/{{customerName}}Cria automaticamente uma pasta por fornecedor.
Caixa de entrada de fornecedores mistos com o Classify
Trocar extração de fatura padrão Para um ID de Analisador de Classificação que contenha um Esquema por fornecedor. Use Caminhos do Zapier Após a etapa 4, ramifique com base no Nome da Classificação e renomeie/arquive por fornecedor.

Solução de problemas​

A pré-visualização de Carregar Arquivo exibe a mensagem "Sem dados".

Certifique-se de ter mapeado o Arquivo O token vem da etapa 2 (Localizar Arquivo), não da etapa 1 (o gatilho). O gatilho às vezes envia apenas metadados; o Localizar Arquivo sempre envia um arquivo binário.

O token de nome do cliente está vazio.

extração de fatura padrão reconhece layouts típicos. Se o seu fornecedor usa um layout incomum e o campo customerName retorna em branco, crie um Analisador de Análise personalizado com uma descrição de campo como "Nome do cliente conforme impresso no cabeçalho da fatura, às vezes identificado como Comprador, Cobrança ou Entrega." Em vez disso, selecione esse analisador na etapa 3.

JSON.parse falha na etapa 4.

O analisador de IA retorna texto simples em raras execuções com formato incorreto. Envolva a análise em um bloco try/catch e, caso contrário, retorne a string bruta para que o Zap não seja interrompido: tentar { return JSON.parse(inputData.data2) } pegar (e) { return { raw: inputData.data2 } }.

Dropbox "arquivo já existe"

Dois fornecedores com o mesmo nome de cliente entrarão em conflito. Qualquer configuração Sobrescrever para Verdadeiro na etapa 5 (a última escrita vence) ou anexe o Zap's {{zap_meta_human_now}} Token associado ao nome do arquivo para garantir sua unicidade.

Próximos passos​

Ações do analisador de documentos com IA

Crie um analisador de análise sintática personalizado.

Obtenha sua chave de API

Experimente com o arquivo de passo a passo.

↓ Baixar sample-vendor-invoice.pdf

O mesmo padrão de cinco etapas (gatilho → busca → análise por IA → análise de JSON → gravação) funciona para qualquer extração de IA no Zapier. Depois de publicar uma, as próximas custam quase nada.