AI-Maaş Bordrosunu İşleme Alın n8n

AI-Maaş Bordrosunu İşleme Alma bir PDF4me AI eylemde n8n Maaş bordrosunu veya maaş fişini okuyan ve içeriğini yapılandırılmış şekilde geri döndüren bir program. JSONBrüt ve net maaş, vergi kesintileri, çalışma saatleri, indirimler ve yılbaşından bugüne kadarki toplamları, kimsenin yeniden yazmasına gerek kalmadan bir belgeden çekmek için kullanın.

Bu düğüm ne işe yarıyor?

İçinde n8n Bu şu şekilde görünüyor: Kaynak: AI artı AI Operasyonlar: AI-Maaş Bordrosunu İşleme Alma. Ona ikili veri, base64 veya başka bir biçimde bir taslak verin. URL ve bir sonuç döndürür. maaş bordrosu verileri Kazançları, vergileri, çalışan ve işveren bilgilerini, çalışma saatlerini, yan hakları ve yılbaşından bugüne kadarki toplamları kapsayan nesne, uyarılar Ve yedekKullanılan Böylece sonuca ne kadar güvenmeniz gerektiğine karar verebilirsiniz.

İlgili Blog Yazıları

Bu özellik için henüz bir blog yazısı yok — yakında yayınlanacak.

Bu arada, her platforma yönelik eğitimler ve iş akışları için PDF4me bloguna göz atın.

Blogu ziyaret edin →

Kimliğinizi Doğrulama API Rica etmek

Her PDF4me düğümde n8n geçerli bir belge gerektirir Bağlantı kurmak için kimlik bilgisi. İçeriğinizi barındıran birini oluşturun veya seçin. PDF4me API iş akışının kimlik doğrulaması yapabilmesi için anahtar. AI Çıkarma istekleri.

Get your API Key

Kaçırmamanız Gereken Önemli Bilgiler

Çıkarma işlemi, uyumlu olmakla aynı şey değildir.

Bir bordro, ücret rakamlarını ve genellikle bir çalışan kimlik numarasını içerir. Bunları sistemlerinize çekmek, onları zaten sahip olduğunuz yükümlülükler altına sokar. Bu düğüm, bu durumu hiçbir şekilde değiştirmez.

Eksik değerler sıfır olarak döndürülür, yok olarak değil.

Okunmamış bir rakam geri dönüyor 0 veya boş bir dize. Bu nedenle sıfır belirsizdir, bu yüzden kontrol etmeden asla bire karşı hesaplama yapmayın. uyarılar.

Açılır menüde "Maaş Bordrosu" yazıyor, "Maaş Makbuzu" değil.

Ayarlamak Kaynak ile AIsonra şunu arayın: AI-Maaş Bordrosunu İşleme Alma altında AI İşlemler. Düğümde "maaş bordrosu" araması yapılamayacaktır.

AI-Maaş Bordrosunu İşleme Alma vs AI-Belge ayrıştırıcı: Hangisini kullanmalıyım?

İkisi de bir belgeyi okur ve yapılandırılmış veri döndürür. Aradaki fark, şemanın önceden belirlenip belirlenmemesidir.

	AI-Maaş Bordrosunu İşleme Alma	vs AI-Belge Ayrıştırıcı
Çıkış şekli	Sabit bir bordro şeması, her çalıştırmada aynı anahtarlar.	Belge türüne göre tanımladığınız her şey
Kurulum çabası	Harekete geç ve başla	İstediğiniz alanları tanımlıyorsunuz.
En iyisi	Toplu miktarda maaş bordroları ve fişler	Özel bir işlem içermeyen belgeler
Bordro alanları	Zaten adlandırılmış ve yazılmış.	İsimlerini kendiniz belirleyin.
Hangisi ile hangisi karşılaştırması yapılıyor?	Belgenin maaş bordrosu olup olmadığını seçin.	Başka bir şey olduğunda seçin.

Eğer belgeleriniz maaş bordrolarıysa, bu işlem daha kısa bir yoldur: bordro terminolojisi zaten yerleşik olarak mevcuttur. Şuraya uzanın: AI-Belge Ayrıştırıcı Biçimin kendine ait özel bir eylemi olmadığında.

Düğümü nasıl kurarım?

Ekle PDF4me düğümünüze n8n iş akışı, ayar Kaynak ile AIardından seçin AI-Maaş Bordrosunu İşleme Alma itibaren AI Operasyonlarİlk kurulum için lütfen aşağıdaki talimatlara bakın. n8n Entegrasyon Kılavuzu.

Önkoşullar: A PDF4me API kimlik belgesi, bir n8n iş akışı ve bir maaş bordrosu PDF, PNG, JPG, veya JPEG.

Düğüm paneli. Özel Alanlar, içine veri yazabileceğiniz bir liste değil, boş olarak başlayan bir öğe ekleme koleksiyonudur.

Parametreler nelerdir?

Panel kısa. İşin büyük kısmı giriş modunu seçmek ve dosyayı doğru şekilde adlandırmaktan ibaret.

Parametre	Tip	Gerekli	Tanım	Örnek
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

:::not Üç giriş modu birbirini dışlar İkili Veri, Base64 String, Ve URL Her biri kendi kaynak alanını ortaya çıkarır ve yalnızca seçtiğiniz modla eşleşenin bir değere ihtiyacı vardır. Önceki bir düğüm dosyayı getirdiğinde genellikle İkili Veri seçilir.

:::

Düğüm ne döndürüyor?

Yanıt, maaş bordrosuyla ilgili her şeyi kapsıyor. payStubData ve iş meta verilerini de yanında saklar.

Alan	Tip	Tanım	Örnek
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

payStubData'nın İçinde

Alan	Tip	Grup	Tanım	Örnek
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 Eylem Yanıtı

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

Kalite sinyallerine göre dallanma, diğer sinyallere göre değil. successBu, yalnızca görüşmenin tamamlandığını bildirir:

// 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 Bu madde önemlidir çünkü okunmamış bir rakam şu şekilde geri döner: 0Bu, onsuz gerçek bir sıfırdan ayırt edilemez.

Tipik Kurulumlar

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.

Pratik İpuçları

• Çıkarılan kütüğün yere düştüğü andan itibaren hassas bir parça olarak değerlendirin. employeeIdSsnÜcret rakamları ve ev adresi tek bir nesne halinde gelir. Bunlardan hangilerinin alt sistemlerinizin gerçekten ihtiyacı olduğuna karar verin ve herhangi bir şeyi depolamadan önce geri kalanını silin.
• Asla dallanıp budaklanma success yalnız. Bu, görüşmenin tamamlandığını bildirir, okumanın doğru olduğunu değil. fallbackUsed Ve warnings Kalite hakkında bilgi veren alanlar bunlardır.
• Belirsiz sıfırlardan kaçının. Çünkü okunmamış numaralar şu şekilde geri döner: 0"Net ödemenin brüt ödemeyi aştığı durumlarda fişleri işaretle" gibi bir kural, brüt ödemesi hiç okunmamış bir fişi sessizce onaylar. Öncelikle rakamın sıfırın üzerinde olup olmadığını kontrol edin.
• Ödeme tarihine ilişkin iki önemli noktaya dikkat edin. payDateStr Ve PayDate İkisi de yanıtta yer alıyor ve ikincisi büyük harfle yazılmış. Birini seçin ve tutarlı bir şekilde kullanın, çünkü buradaki bir uyumsuzluk eşleştirmede kolayca gözden kaçabilir.
• İşveren özel satırları için Özel Alanlar kullanın. Ödenekler, vardiya farkları ve sendika aidatları kuruluşlara göre değişir ve bu bağış toplama amacı da tam olarak budur.
• Ona mevcut en temiz kopyayı verin. Orijinal PDF Veya düz bir tarama, açılı çekilmiş bir telefon fotoğrafına kıyasla çıkarma işlemine daha fazla veri sağlar.

Kopya Kağıdı

Amaç	Ayar veya alan
Olayı bulun n8n	Resource = AI, AI Operations = AI-Maaş Bordrosunu İşleme Alma
Önceki düğümden bir dosya kullanın	Input Data Type = İkili Veri, Input Binary Field = data
Barındırılan bir belgeyi işleyin	Input Data Type = URL, Daha sonra Pay Stub URL
Biçim algılama işlemini doğru yapın.	Document Name gerçek uzantı ile
Standart dışı bir çizgi yakalayın	Özel Alan Ekle altında Custom Fields
Koşuya güvenip güvenmeyeceğinize karar verin.	fallbackUsed artı warnings
Temel maaş rakamları	grossPay, netPay, ytdGrossPay

Sıkça Sorulan Sorular

Bu eylemin gerçek adı nedir? n8n?

Düğümde bu AI-Maaş Bordrosunu İşleme Alma. Ayarlamak Kaynak ile AIsonra seçin AI-Maaş Bordrosunu İşleme Alma -den AI Operasyonlar açılır menü. word Belgelerde "maaş bordrosu" ifadesi yer almaktadır. URL ve yaygın kullanımda ama değil n8n Arayüzün kendisiyle ilgili olarak, açılır menüden "Maaş Bordrosu"nu arayın.

Bir diş çıkarma işleminin güvenilir olup olmadığını nasıl anlarım?

Bu sinyali iki alan taşıyor. warnings Dizi listelerinin veri kalitesiyle ilgili sorunlar, veri çıkarma işleminde karşılaşılan zorluklar ve fallbackUsed İkinci bir ekstraksiyon yöntemine ihtiyaç duyulup duyulmadığını gösterir. Herhangi bir sonucu aşağıdaki gibi değerlendirin: fallbackUsed dır trueveya nerede warnings Bu belge, rutin tamamlama notundan daha fazlasını içerir; çünkü rakamların maaş bordrosuna veya kredi kararına ulaşmadan önce insan incelemesine ihtiyaç duyar.

Bu işlem bordro sürecimi mevzuata uygun hale getirir mi?

Hayır. Bu işlem bir belgeden veri çıkarır. Maaş bordrosu, ücret rakamlarını ve genellikle çalışan kimlik numarasını veya kısmi Sosyal Güvenlik numarasını içerir. NumberDolayısıyla, bu veriyi çıkarmak, onu sizin için zaten geçerli olan gizlilik ve iş kaydı yükümlülüklerinin içine yerleştirir. Bu yükümlülükler, bu düğümün değil, sistemlerinizin ve yargı yetkinizin bir özelliğidir ve bunu kullanmak konumunuzu hiçbir şekilde değiştirmez. Hangisinin geçerli olduğundan emin değilseniz, ABD Çalışma Bakanlığı'nın kayıt tutmaya ilişkin kılavuzu Ücret kayıtları için makul bir başlangıç noktasıdır.

Maaş bordrosunda yer almayan alanlara ne olur?

Yanıtın dışında bırakılmak yerine, boş dizeler veya sıfırlar olarak geri dönerler. 0 içinde socialSecurityTax veya overtimeHours Bu nedenle, belgede gerçekten sıfır olduğu veya okunamayan bir değer olduğu anlamına gelir. İlgili seçeneği kontrol edin. warnings Özellikle hesaplama yapmayı planladığınız herhangi bir alan için, rakamın gerçek olduğunu varsaymak yerine, doğru değeri girin.

İşverenime özel alanları ayıklayabilir miyim?

Evet. Özel Alanlar Düğümdeki koleksiyon, standart şemanın ötesinde adlandırılmış anahtarlar eklemenize olanak tanır; bu sayede vardiya farkı, bölgesel ödenek veya yalnızca kuruluşunuzun kayıtlarında görünen bir sendika aidatı gibi şeyleri yakalayabilirsiniz. Geri almak istediğiniz her değer için bir giriş ekleyin.

Hangi dosya formatlarını okuyabilir?

PDF, PNG, JPG, Ve JPEG. Ayarlamak Belge Adı Dosya adını gerçek uzantısıyla belirtin, çünkü bu, işlemin hangi formatla ilgilendiğini gösterir. Fotoğraflanmış bir örnek dosya işe yarar, ancak düz tarama veya orijinal dosya da gereklidir. PDF Bu, açılı çekilmiş bir telefon fotoğrafına kıyasla, veri çıkarma işlemine daha fazla malzeme sağlar.

İlgili AI Eylemler 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.

Diğer Platformlarda Aynı Görev

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.

Kullanım Senaryoları

Bordro veri girişi

Bordro sağlayıcısından veya çalışan yüklemesinden gelen fişleri okuyun ve rakamları doğrudan bir finans sistemine yazın; güven sinyallerinin işaretlediği istisnalar için manuel veri girişini saklayın.

Gelir ve istihdam doğrulaması

Kredi, kira veya sosyal haklar çeklerine ait brüt maaş, net maaş, işveren adı ve yılbaşından bugüne kadarki toplamları bir araya getirin; böylece inceleyici her belgeyi okumak yerine yapılandırılmış değerler üzerinden çalışabilir.

Bordro mutabakatı ve denetimi

Fişte yazanlarla İK veya muhasebe sisteminin kaydettiği bilgileri karşılaştırın ve yalnızca iki bilginin uyuşmadığı satırları gösterin.

Daha Fazla Okuma

• ABD Çalışma Bakanlığı: FLSA kapsamında kayıt tutma İşverenlerin hangi ücret kayıtlarını tutmaları gerektiğini belirtir.
• n8nDosyalar ve resimlerle çalışmak Giriş alanlarının da belirttiği gibi, ikili dosyaların düğümler arasında nasıl hareket ettiğini açıklar.

Yardım Alın

n8n Integration Guiden8n SampleGetting Started