AI-Processar contracheque/recibo de pagamento em n8n

AI-Processar contracheque é um PDF4me AI ação em n8n que lê um recibo de pagamento ou comprovante de pagamento e retorna seu conteúdo como um valor estruturado. JSONUse esta ferramenta para extrair de um documento os valores referentes a salário bruto e líquido, retenção de impostos, horas trabalhadas, deduções e totais acumulados no ano, sem que ninguém precise digitá-los novamente.

O que este nó faz

Em n8n isto parece ser Recurso: AI mais AI Operações: AI-Processar contrachequeForneça um stub como dados binários, base64 ou um URL e retorna um Dados do contracheque objeto abrangendo rendimentos, impostos, detalhes do empregado e do empregador, horas trabalhadas, benefícios e totais acumulados no ano, juntamente com avisos e fallbackUsado Assim, você poderá avaliar o quanto confiar no resultado.

Artigos relacionados no blogue

Ainda não há nenhuma publicação no blogue sobre esta funcionalidade — em breve.

Entretanto, explore o blogue da PDF4me para encontrar tutoriais e fluxos de trabalho para todas as plataformas.

Visite o blogue →

Autenticando seu API Solicitar

Todo PDF4me nó em n8n requer um válido Credencial para se conectar comCrie ou selecione um que contenha o seu PDF4me API chave para que o fluxo de trabalho possa autenticar AI solicitações de extração.

Get your API Key

Fatos importantes que você não deve perder

Extrair não é o mesmo que estar em conformidade.

Um recibo de pagamento contém informações salariais e, frequentemente, um identificador do funcionário. Importar esses dados para seus sistemas os vincula a obrigações que você já possui. Este nó não altera essa situação de forma alguma.

Os valores ausentes são retornados como zero, não como ausentes.

Um número não lido retorna como 0 ou uma string vazia. Portanto, zero é ambíguo, então nunca calcule com base em um sem verificar. avisos.

O menu suspenso indica "Comprovante de Pagamento", e não "Recibo de Pagamento".

Definir Recurso para AI, então procure por AI-Processar contracheque sob AI Operações. A busca pelo nó "contracheque" não o encontrará.

AI-Processar comprovante de pagamento vs. AI- Analisador de documentos: qual devo usar?

Ambos leem um documento e retornam dados estruturados. A diferença reside em se o esquema é definido antecipadamente.

	AI-Processar contracheque	vs AI-Analisador de Documentos
Formato de saída	Um esquema de folha de pagamento fixo, com as mesmas chaves em todas as execuções.	Independentemente do que você defina por tipo de documento.
Esforço de configuração	Escolha a ação e vá em frente.	Você descreve os campos que deseja.
Ideal para	Comprovantes e recibos de pagamento em grande quantidade	Documentos sem ação específica
Campos da folha de pagamento	Já está nomeado e digitado	Você mesmo dá os nomes a eles
Qual contra qual	Selecione quando o documento for um contracheque.	Escolha quando for qualquer outra coisa

Se seus documentos forem comprovantes de pagamento, esta ação é o caminho mais curto: o vocabulário de folha de pagamento já está integrado. Basta recorrer a AI-Analisador de Documentos quando o formato não possui uma ação própria dedicada.

Como faço para configurar o nó?

Adicione o PDF4me nó para o seu n8n fluxo de trabalho, definir Recurso para AI, então escolha AI-Processar contracheque de AI OperaçõesPara a configuração inicial, consulte o n8n Guia de integração.

Pré-requisitos: a PDF4me API credencial, uma n8n fluxo de trabalho e um contracheque como um PDF, PNG, JPG, ou JPEG.

O painel de nós. Os Campos Personalizados são uma coleção de itens a serem adicionados que começa vazia, não uma lista na qual você digita.

Quais são os parâmetros?

O painel é curto. A maior parte do trabalho consiste em escolher um modo de entrada e nomear o arquivo corretamente.

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
Resource	Options	Required	Selects the family of operations. Set it to AI to reveal the AI Operations dropdown.	AI
AI Operations	Options	Required	The specific AI action to run. Listed in the node as AI-Process Pay Stub.	AI-Process Pay Stub
Input Data Type	Options	Required	How the document reaches the node: Binary Data, Base64 String, or URL. The matching source field appears beneath it.	Binary Data
Input Binary Field	String	Conditional	Name of the binary property holding the file. Shown when Input Data Type is Binary Data.	data
Base64 Pay Stub Content	String	Conditional	The document as a base64 string. Shown when Input Data Type is Base64 String.	JVBERi0xLjQKJ...
Pay Stub URL	String	Conditional	A publicly reachable link to the document. Shown when Input Data Type is URL.	https://example.com/paystub.pdf
Document Name	String	Optional	Filename with its real extension, which is what drives format detection. Ships with a default.	pay_stub.png
Custom Fields	Collection	Optional	An add-item collection, empty by default. Use Add Custom Field to request values outside the standard schema.	shiftDifferential

:::nota Os três modos de entrada são mutuamente exclusivos Dados binários, Base64 String, e URL Cada um revela seu próprio campo de origem, e apenas aquele que corresponde ao modo escolhido precisa de um valor. Dados binários é a opção usual quando um nó anterior buscou o arquivo. :::

O que o nó retorna?

A resposta engloba tudo relacionado à folha de pagamento. payStubData e mantém os metadados do trabalho em conjunto.

Campo	Tipo	Descrição	Exemplo
payStubData	Object	All extracted pay stub fields. Broken down in the table below.	{ "grossPay": 1627.74, ... }
jobId	String	Identifier for the AI processing job, useful when investigating a specific run.	00000000-0000-0000-0000-000000000000
jobIdExt	String	External job identifier for third-party system integration, when applicable.	null
success	Boolean	Whether the extraction call completed. Note this reports the call, not the quality of the reading.	true
message	String	Status text, carrying error detail when something fails.	Pay stub data extracted successfully

Dentro dos dados do contracheque

Campo	Tipo	Grupo	Descrição	Exemplo
warnings	Array	Quality signal	Data quality issues met during extraction. Read this before trusting any figure.	["Vision AI processing completed successfully"]
fallbackUsed	Boolean	Quality signal	Whether a secondary extraction method was needed. True is a review trigger.	false
rawOcrText	String	Quality signal	Raw OCR text from the document, when available.	""
grossPay	Number	Earnings	Gross pay before deductions.	1627.74
netPay	Number	Earnings	Net pay after all deductions.	1040.23
payPeriod	String	Earnings	Date range the stub covers.	07/10/2017 - 07/23/2017
payDateStr	String	Earnings	Pay date as printed on the stub.	08/04/2017
PayDate	String	Earnings	Pay date. Note the capitalised key, which differs from payDateStr.	08/04/2017
commissionBonus	Number	Earnings	Commission or bonus amount.	0
federalIncomeTax	Number	Tax	Federal income tax withheld this period.	182.98
stateIncomeTax	Number	Tax	State income tax withheld.	61
socialSecurityTax	Number	Tax	Social Security tax withheld.	0
medicareTax	Number	Tax	Medicare tax withheld.	22.12
localCityTax	Number	Tax	Local or city tax withheld.	0
employeeName	String	Employee	Name of the employee.	Franklin St
employeeIdSsn	String	Employee	Employee ID or Social Security Number. Treat as sensitive.	000000000
employeeAddress	String	Employee	Employee address as printed.	123 Franklin St, Chapel Hill, NC 27517
jobTitle	String	Employee	Job title or position.	Admin Support Specialist
companyName	String	Employer	Employer name.	University of North Carolina
employerAddress	String	Employer	Employer address.	103 South Building, Chapel Hill, NC
employerEin	String	Employer	Employer Identification Number, empty when not printed.	""
regularHours	Number	Hours	Regular hours worked in the period.	74.5
overtimeHours	Number	Hours	Overtime hours worked.	0
regularRate	Number	Hours	Regular hourly rate.	20.346846
overtimeRate	Number	Hours	Overtime hourly rate.	0
totalHours	Number	Hours	Total hours worked in the period.	80
healthInsurance	Number	Deductions	Health insurance deduction.	0
retirement401k	Number	Deductions	Retirement contribution deduction.	97.66
otherBenefits	Number	Deductions	Other benefit deductions.	0
garnishments	Number	Deductions	Amount withheld for garnishments.	0
ytdGrossPay	Number	Year to date	Year-to-date gross pay.	28707.21
ytdNetPay	Number	Year to date	Year-to-date net pay.	18396.25
ytdFederalTax	Number	Year to date	Year-to-date federal tax.	3319.78
ytdStateTax	Number	Year to date	Year-to-date state tax.	1126
checkNumber	String	Payment	Check number or payment reference.	Advice #0000000002214873
directDepositInfo	String	Payment	Direct deposit details as printed, usually with a masked account.	Checking XXXXXXX0000
vacationSickTime	String	Payment	Vacation and sick balance text.	Vacation End Balance: 213.66

N8N Resposta à ação

JSON

{
  "payStubData": {
    "warnings": ["Vision AI processing completed successfully"],
    "fallbackUsed": false,
    "rawOcrText": "",
    "grossPay": 1627.74,
    "netPay": 1040.23,
    "payPeriod": "07/10/2017 - 07/23/2017",
    "payDateStr": "08/04/2017",
    "federalIncomeTax": 182.98,
    "stateIncomeTax": 61,
    "socialSecurityTax": 0,
    "medicareTax": 22.12,
    "localCityTax": 0,
    "employeeName": "Franklin St",
    "employeeIdSsn": "000000000",
    "jobTitle": "Admin Support Specialist",
    "companyName": "The University of North Carolina at Chapel Hill",
    "employerEin": "",
    "regularHours": 74.5,
    "overtimeHours": 0,
    "regularRate": 20.346846,
    "totalHours": 80,
    "retirement401k": 97.66,
    "garnishments": 0,
    "ytdGrossPay": 28707.21,
    "ytdNetPay": 18396.25,
    "ytdFederalTax": 3319.78,
    "ytdStateTax": 1126,
    "checkNumber": "Advice #0000000002214873",
    "commissionBonus": 0,
    "PayDate": "08/04/2017"
  },
  "jobId": "00000000-0000-0000-0000-000000000000",
  "jobIdExt": null,
  "success": true,
  "message": "Pay stub data extracted successfully"
}

Confidence routing

Filtre com base nos sinais de qualidade, em vez de em success, que apenas informa que a chamada foi concluída:

// n8n IF node condition
const d = $json.payStubData;
const routine = d.warnings.length === 1
  && d.warnings[0].includes('completed successfully');

// true  -> straight through to payroll
// false -> human review queue
return !d.fallbackUsed && routine && d.grossPay > 0;

O grossPay > 0 A cláusula é importante porque um número não lido retorna como 0, que é indistinguível de um zero genuíno sem ele.

Configurações típicas

Payroll intake from email

A mail trigger picks up stubs from a payroll provider, this action reads each one, and the figures land in a finance sheet without manual keying.

Income verification for lending

An applicant uploads recent stubs. The action extracts grossPay, netPay, and the year-to-date totals, and the workflow flags anything that needs an underwriter to look.

Employee record reconciliation

Compare extracted netPay and deductions against what the HR system expects, and raise a ticket only where the two disagree.

Bulk historical digitisation

Loop a folder of archived stubs through the node to turn a filing cabinet of PDFs into queryable rows, with low-confidence results split off for checking.

Dicas práticas

• Considere o coto extraído como sensível desde o momento em que entra em contato com a pele. employeeIdSsnDados como salários e endereço residencial chegam juntos em um único objeto. Decida quais deles seus sistemas subsequentes realmente precisam e descarte o restante antes de armazenar qualquer coisa.
• Nunca se ramifica em success sozinho. O texto informa que a chamada foi concluída, não que a leitura foi boa. fallbackUsed e warnings São os campos que informam sobre a qualidade.
• Evite zeros ambíguos. Porque os números não lidos retornam como 0Uma regra como "sinalizar comprovantes em que o salário líquido excede o bruto" aprova silenciosamente um comprovante cujo salário bruto nunca foi lido. Verifique primeiro se o valor é maior que zero.
• Observe as duas chaves de data de pagamento. payDateStr e PayDate Ambas aparecem na resposta, sendo que a segunda está em maiúscula. Escolha uma e use-a consistentemente, pois uma discrepância aqui é fácil de passar despercebida em um mapeamento.
• Utilize campos personalizados para linhas específicas do empregador. Os subsídios, adicionais noturnos e quotas sindicais variam consoante a organização e são exatamente para isso que serve essa cobrança.
• Forneça a ele a cópia mais limpa disponível. Um original PDF Ou seja, uma digitalização plana oferece à extração mais informações para trabalhar do que uma foto tirada com o celular em um ângulo.

Folha de dicas

Meta	Configuração ou campo
Encontre a ação em n8n	Resource = AI, AI Operations = AI-Processar contracheque
Use um arquivo de um nó anterior.	Input Data Type = Dados binários, Input Binary Field = data
Processar um documento hospedado	Input Data Type = URL, então Pay Stub URL
Certifique-se de que o formato seja detectado corretamente.	Document Name com a extensão real
Capturar uma linha não padrão	Adicionar campo personalizado em Custom Fields
Decida se deve confiar em uma corrida.	fallbackUsed mais warnings
Números principais da folha de pagamento	grossPay, netPay, ytdGrossPay

Perguntas frequentes

Qual é o nome dado a essa ação? n8n?

No nó é AI-Processar contracheque. Definir Recurso para AI, então escolha AI-Processar contracheque do AI Operações menu suspenso. O word "Recibo de pagamento" aparece na documentação. URL e em uso comum, mas não no n8n na própria interface, então procure no menu suspenso por "Compro".

Como posso saber se uma extração é confiável?

Dois campos transportam esse sinal. O warnings Os problemas de qualidade de dados encontrados na extração foram listados em arrays, e fallbackUsed Indica se um método de extração secundário foi necessário. Trate qualquer resultado onde fallbackUsed é true, ou onde warnings Contém informações adicionais além de uma simples nota de conclusão, pois necessita de revisão humana antes que os números sejam utilizados para a tomada de decisão sobre folha de pagamento ou empréstimo.

Essa ação torna meu processo de folha de pagamento compatível com as normas?

Não. Esta ação extrai dados de um documento. Um contracheque contém valores salariais e, frequentemente, um identificador do funcionário ou parte do número do Seguro Social. NumberPortanto, extrair esses dados os coloca dentro das obrigações de privacidade e registro de emprego que já se aplicam a você. Essas obrigações são propriedade de seus sistemas e jurisdição, não deste nó, e usá-lo não altera sua posição de forma alguma. Se você não tiver certeza do que se aplica, Diretrizes do Departamento do Trabalho dos EUA sobre manutenção de registros É um ponto de partida razoável para registros salariais.

O que acontece com os campos que o contracheque não contém?

Elas retornam como strings vazias ou zeros, em vez de serem omitidas da resposta. 0 em socialSecurityTax ou overtimeHours Portanto, significa ou um zero genuíno no documento ou um valor que não pôde ser lido. Verifique o correspondente. warnings Insira o valor em vez de presumir que o número é real, especialmente para qualquer campo que você planeje usar em cálculos.

Posso extrair campos específicos da minha empresa?

Sim. O Campos personalizados A coleção no nó permite adicionar chaves nomeadas além do esquema padrão, que é como você captura informações como adicional noturno, adicional regional ou contribuição sindical que só aparecem nos registros da sua organização. Adicione uma entrada para cada valor que você deseja obter.

Quais formatos de arquivo ele consegue ler?

PDF, PNG, JPG, e JPEG. Definir Nome do documento ao nome do arquivo com sua extensão real, pois é isso que indica à ação com qual formato ela está lidando. Uma cópia fotográfica funciona, assim como uma digitalização plana ou um original. PDF Isso proporciona à extração mais informações para trabalhar do que uma foto tirada com o celular em um ângulo.

Relacionado AI Ações em n8n

AI-Process Bank Statement

Read transactions and balances from a bank statement, the other half of most income verification checks.

AI-Process Tax Document

Extract fields from tax forms, which often accompany stubs in a lending file.

AI-Invoice Parser

The same extraction approach applied to supplier invoices.

AI-Document Parser

A general-purpose parser for documents without a dedicated action.

Mesma tarefa em outras plataformas

Make

Run the same pay stub extraction inside a Make scenario.

Power Automate

The pay stub and payslip parser as a Power Automate flow action.

Zapier

Parse pay stubs as a step in a Zap.

Casos de uso

Entrada de dados da folha de pagamento

Leia os comprovantes de pagamento recebidos do fornecedor de folha de pagamento ou enviados pelo funcionário e insira os valores diretamente no sistema financeiro, mantendo a digitação manual apenas para as exceções sinalizadas pelos indicadores de confiança.

Comprovação de renda e emprego

Extraia o salário bruto, o salário líquido, o nome do empregador e os totais acumulados do ano para empréstimos, aluguéis ou benefícios, para que o analista trabalhe com valores estruturados em vez de ler cada documento individualmente.

Conciliação e auditoria da folha de pagamento

Compare o que consta no comprovante com o que o sistema de RH ou de contabilidade registrou e destaque apenas as linhas em que os dois divergem.

Leitura complementar

• Departamento do Trabalho dos EUA: manutenção de registros de acordo com a FLSA (Lei de Normas Justas de Trabalho). Define quais registros salariais os empregadores devem manter.
• n8nTrabalhar com arquivos e imagens Explica como os arquivos binários se movem entre os nós, que é a referência dos campos de entrada.

Obtenha ajuda

n8n Integration Guiden8n SampleGetting Started