AI-Memproses Slip Gaji di n8n
AI-Memproses Slip Gaji adalah sebuah PDF4me AI tindakan dalam n8n yang membaca slip gaji dan mengembalikan isinya sesuai struktur yang telah ditentukan. JSONGunakan fitur ini untuk mengambil data gaji kotor dan bersih, pajak yang dipotong, jam kerja, potongan, dan total tahunan dari sebuah dokumen tanpa perlu diketik ulang oleh siapa pun.
Fungsi node ini
Di dalam n8n ini tampak seperti Sumber: AI ditambah AI Operasi: AI-Memproses Slip GajiBerikan data berupa data biner, base64, atau lainnya. URL dan itu mengembalikan Data Slip Gaji Objek yang mencakup pendapatan, pajak, detail karyawan dan pemberi kerja, jam kerja, tunjangan, dan total tahun berjalan, beserta peringatan Dan cadangan Digunakan sehingga Anda dapat menilai seberapa besar kepercayaan yang dapat diberikan pada hasilnya.
Memverifikasi Identitas Anda API Meminta
Setiap PDF4me simpul di n8n memerlukan validitas Kredensial untuk terhubung denganBuat atau pilih salah satu yang sesuai dengan kebutuhan Anda. PDF4me API kunci agar alur kerja dapat melakukan autentikasi AI permintaan ekstraksi.
Fakta Penting yang Tidak Boleh Anda Lewatkan
0 atau string kosong. Oleh karena itu, angka nol bersifat ambigu, jadi jangan pernah menghitung terhadap angka nol tanpa memeriksanya terlebih dahulu. peringatan.AI-Proses Slip Gaji vs AI- Pengurai Dokumen: mana yang sebaiknya saya gunakan?
Keduanya membaca dokumen dan mengembalikan data terstruktur. Perbedaannya terletak pada apakah skema tersebut ditentukan terlebih dahulu.
| AI-Memproses Slip Gaji | vs AI- Pengurai Dokumen | |
|---|---|---|
| Bentuk keluaran | Skema penggajian tetap, kunci yang sama setiap kali dijalankan | Apa pun yang Anda definisikan per jenis dokumen. |
| Upaya penyiapan | Pilih aksinya dan mulai | Anda menjelaskan bidang yang Anda inginkan. |
| Terbaik untuk | Slip gaji dan bukti pembayaran dalam jumlah besar | Dokumen tanpa tindakan khusus |
| Bidang penggajian | Sudah diberi nama dan diketik. | Anda sendiri yang memberi nama. |
| Yang mana vs yang mana | Pilih opsi ini jika dokumen tersebut berupa slip gaji. | Pilihlah jika itu adalah hal lain. |
Jika dokumen Anda berupa slip gaji, langkah ini adalah cara yang lebih singkat: kosakata penggajian sudah tersedia. Silakan gunakan AI- Pengurai Dokumen ketika format tersebut tidak memiliki aksi khusus tersendiri.
Bagaimana cara saya mengatur node?
Tambahkan PDF4me simpul ke Anda n8n alur kerja, atur Sumber ke AI, lalu pilih AI-Memproses Slip Gaji dari AI OperasiUntuk pengaturan pertama kali, lihat n8n Panduan Integrasi.
Prasyarat: A PDF4me API kredensial, sebuah n8n alur kerja, dan slip gaji sebagai PDF, PNG, JPG, atau JPEG.

Apa saja parameternya?
Panelnya singkat. Sebagian besar pekerjaan adalah memilih mode input dan memberi nama file dengan benar.
| Parameter | Jenis | Diperlukan | Keterangan | Contoh |
|---|---|---|---|---|
| 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 |
:::catatan Ketiga mode input tersebut saling eksklusif Data Biner, Base64 String, Dan URL Masing-masing mengungkapkan bidang sumbernya sendiri, dan hanya yang sesuai dengan mode yang Anda pilih yang membutuhkan nilai. Data Biner biasanya dipilih ketika node sebelumnya mengambil file tersebut. :::
Apa yang dikembalikan oleh node tersebut?
Respons tersebut mencakup semua hal yang berkaitan dengan penggajian di dalamnya. payStubData dan menyimpan metadata pekerjaan di sampingnya.
| Bidang | Jenis | Keterangan | Contoh |
|---|---|---|---|
| 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 |
Di dalam payStubData
| Bidang | Jenis | Kelompok | Keterangan | Contoh |
|---|---|---|---|---|
| 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 Tindakan dan Respons
- JSON
- Confidence routing
{
"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"
}
Pilih cabang berdasarkan sinyal kualitas, bukan berdasarkan success, yang hanya melaporkan bahwa panggilan telah selesai:
// 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;
Yang grossPay > 0 Klausul ini penting karena angka yang belum dibaca akan kembali sebagai 0, yang tidak dapat dibedakan dari angka nol asli tanpa itu.
Pengaturan Umum
Tips Praktis
- Perlakukan sisa jaringan yang dicabut sebagai jaringan yang sensitif sejak saat mendarat.
employeeIdSsnAngka gaji dan alamat rumah tiba bersamaan dalam satu objek. Tentukan mana yang benar-benar dibutuhkan oleh sistem hilir Anda dan buang sisanya sebelum menyimpan apa pun. - Jangan pernah bercabang
successsendiri. Laporan tersebut menyatakan bahwa panggilan telah selesai, bukan bahwa pembacaannya bagus.fallbackUsedDanwarningsBidang-bidang inilah yang memberi tahu Anda tentang kualitas. - Waspadai angka nol yang ambigu. Karena nomor yang belum dibaca akan kembali sebagai
0Aturan seperti "tandai slip gaji di mana gaji bersih melebihi gaji kotor" secara diam-diam meloloskan slip gaji yang gaji kotornya tidak pernah dibaca. Periksa dulu apakah angkanya di atas nol. - Perhatikan kedua tombol tanggal pembayaran.
payDateStrDanPayDateKeduanya muncul dalam respons dan yang kedua ditulis dengan huruf kapital. Pilih salah satu dan gunakan secara konsisten, karena ketidaksesuaian di sini mudah terlewatkan dalam pemetaan. - Gunakan Kolom Kustom untuk baris khusus perusahaan. Tunjangan, perbedaan upah shift, dan iuran serikat pekerja berbeda-beda antar organisasi dan itulah tujuan dari pengumpulan data tersebut.
- Berikan salinan terbersih yang tersedia. Asli PDF atau pemindaian datar memberikan lebih banyak data untuk diekstraksi dibandingkan foto ponsel yang diambil dari sudut tertentu.
Lembar Panduan Singkat
| Sasaran | Pengaturan atau bidang |
|---|---|
| Temukan aksinya di n8n | Resource = AI, AI Operations = AI-Memproses Slip Gaji |
| Gunakan berkas dari node sebelumnya. | Input Data Type = Data Biner, Input Binary Field = data |
| Memproses dokumen yang dihosting | Input Data Type = URL, Kemudian Pay Stub URL |
| Pastikan formatnya terdeteksi dengan benar. | Document Name dengan ekstensi sebenarnya |
| Tangkap saluran non-standar | Tambahkan Bidang Kustom di bawah Custom Fields |
| Putuskan apakah akan mempercayai lari tersebut. | fallbackUsed ditambah warnings |
| Angka penggajian inti | grossPay, netPay, ytdGrossPay |
Pertanyaan Umum
Tindakan apa sebenarnya yang disebut? n8n?
Di dalam simpul itu adalah AI-Memproses Slip Gaji. Mengatur Sumber ke AIlalu pilih AI-Memproses Slip Gaji dari AI Operasi Menu tarik-turun. Itu word "Slip gaji" muncul dalam dokumentasi. URL dan dalam penggunaan umum tetapi tidak dalam n8n antarmuka itu sendiri, jadi cari "Slip Gaji" di menu tarik-turun.
Bagaimana saya tahu apakah hasil ekstraksi tersebut dapat dipercaya?
Dua medan membawa sinyal itu. Yang warnings Daftar array berisi masalah kualitas data yang dihadapi dalam proses ekstraksi, dan fallbackUsed Menunjukkan apakah metode ekstraksi sekunder diperlukan. Perlakukan setiap hasil di mana fallbackUsed adalah true, atau di mana warnings Berisi lebih dari sekadar catatan penyelesaian rutin, karena memerlukan tinjauan manusia sebelum angka-angka tersebut sampai pada keputusan penggajian atau pemberian pinjaman.
Apakah tindakan ini membuat proses penggajian saya sesuai dengan peraturan?
Tidak. Tindakan ini mengekstrak data dari dokumen. Slip gaji berisi angka upah dan seringkali identitas karyawan atau sebagian nomor Jaminan Sosial. NumberJadi, mengekstrak data tersebut menempatkannya di dalam kewajiban privasi dan catatan ketenagakerjaan yang sudah berlaku untuk Anda. Kewajiban tersebut merupakan hak milik sistem dan yurisdiksi Anda, bukan milik node ini, dan menggunakannya tidak mengubah posisi Anda. Jika Anda tidak yakin apa yang berlaku, Pedoman Departemen Tenaga Kerja AS tentang pencatatan merupakan titik awal yang wajar untuk catatan upah.
Apa yang terjadi pada kolom-kolom yang tidak tercantum dalam slip gaji?
Hasilnya berupa string kosong atau angka nol, bukan dihilangkan dari respons. A 0 di dalam socialSecurityTax atau overtimeHours Oleh karena itu, artinya angka nol yang sebenarnya ada di dokumen atau nilai yang tidak dapat dibaca. Periksa yang sesuai. warnings Jangan memasukkan angka secara manual, melainkan berasumsi bahwa angka tersebut nyata, terutama untuk bidang apa pun yang akan Anda hitung.
Bisakah saya mengekstrak kolom-kolom yang spesifik untuk perusahaan tempat saya bekerja?
Ya. Itu Bidang Kustom Fitur koleksi di node memungkinkan Anda menambahkan kunci bernama di luar skema standar, yang merupakan cara Anda mencatat hal-hal seperti perbedaan shift, tunjangan regional, atau iuran serikat pekerja yang hanya muncul pada slip gaji organisasi Anda. Tambahkan satu entri untuk setiap nilai yang ingin Anda dapatkan kembali.
Format file apa saja yang dapat dibacanya?
PDF, PNG, JPG, Dan JPEG. Mengatur Nama Dokumen Ubah nama file dengan ekstensi aslinya, karena itulah yang memberi tahu program format apa yang sedang ditangani. Foto cuplikan bisa digunakan, meskipun hasil pindaian atau dokumen asli juga bisa. PDF memberikan lebih banyak informasi untuk diolah dalam proses ekstraksi dibandingkan dengan foto yang diambil dengan ponsel dari sudut tertentu.
Terkait AI Tindakan dalam n8n
Tugas yang Sama di Platform Lain
Kasus Penggunaan
Entri data penggajian
Baca slip gaji yang datang dari penyedia penggajian atau unggahan karyawan dan tulis angka-angkanya langsung ke dalam sistem keuangan, dengan tetap melakukan entri manual untuk pengecualian yang ditandai oleh sinyal kepercayaan.
Verifikasi pendapatan dan pekerjaan
Masukkan gaji kotor, gaji bersih, nama pemberi kerja, dan total kumulatif tahunan untuk pemeriksaan pinjaman, sewa, atau tunjangan, sehingga peninjau dapat bekerja berdasarkan nilai yang terstruktur dan tidak perlu membaca setiap dokumen satu per satu.
Rekonsiliasi dan audit penggajian
Bandingkan apa yang tertera pada slip gaji dengan apa yang tercatat dalam sistem SDM atau akuntansi, dan tampilkan hanya baris-baris di mana keduanya berbeda.
Bacaan Lebih Lanjut
- Departemen Tenaga Kerja AS: pencatatan data berdasarkan FLSA (Fair Labor Standards Act). Menjelaskan catatan upah apa yang diharapkan untuk disimpan oleh pemberi kerja.
- n8n: Bekerja dengan file dan gambar menjelaskan bagaimana file biner berpindah antar node, yang merupakan acuan dari kolom input.