← Kembali ke Arsip
Tutorial

Otomatisasi Slip Gaji Aman: Panduan Lengkap Memisahkan, Menggabungkan, dan Mengunci PDF dengan Python

5 Juli 2026 Fahlefi Achmad Reza 👁️ 60 Views ⏳ 8 Min Read
Otomatisasi Slip Gaji Aman: Panduan Lengkap Memisahkan, Menggabungkan, dan Mengunci PDF dengan Python

Setiap akhir bulan, divisi HR atau administrasi selalu dihadapkan pada tugas rutin yang repetitif namun membutuhkan ketelitian super tinggi: mendistribusikan dokumen rahasia karyawan seperti slip gaji dan rekap absensi (time card). Mengolah ratusan atau ribuan dokumen ini secara manual satu per satu jelas tidak efisien dan rentan terhadap kesalahan manusia (human error). Salah kirim dokumen finansial bisa berakibat fatal bagi privasi karyawan dan kredibilitas perusahaan.

Untuk mengatasi masalah tersebut, kita bisa membangun sistem otomatisasi mandiri dari nol menggunakan bahasa pemrograman Python. Skrip ini akan bekerja secara cerdas untuk membaca database, memilah dokumen massal, menyatukannya, dan menguncinya dengan kata sandi (password) unik secara otomatis. Mari kita bedah panduan lengkap langkah-langkahnya untuk langsung Anda terapkan pada sistem kerja Anda!

Persiapan Awal: Database dan Struktur Folder Kerja

Sebelum mulai menulis baris kode program, langkah pertama yang wajib Anda lakukan adalah menyelaraskan data digital dengan struktur penyimpanan di komputer. Kita membutuhkan satu file spreadsheet sebagai pusat kendali otomatisasi dan beberapa direktori folder spesifik.

  1. Database Excel (slip_gaji.xlsx): Buat sebuah file Excel yang berfungsi menyimpan informasi data karyawan. Di baris pertama tabel, pastikan Anda membuat kolom khusus bernama "Nama" dan "Password". Kode sandi unik ini nantinya akan dibaca oleh Python sebagai kunci enkripsi PDF masing-masing individu. Tambahkan juga kolom "Email" jika berencana kirim otomatis via SMTP di bab akhir.
  2. Struktur Direktori Folder: Untuk menjaga kerapian berkas, skrip ini mengandalkan pengaturan folder yang terstruktur. Siapkan folder bernama folder_slip untuk menyimpan file slip gaji mentah, dan folder folder_timecard untuk menyimpan berkas rekap absensi karyawan. Selain itu, buat folder bernama output_final sebagai muara akhir penyimpanan dokumen yang sudah aman terenkripsi.
  3. Instalasi Library: Buka terminal / CMD dan jalankan pip install pypdf openpyxl. pypdf menangani baca-tulis-enkripsi PDF, openpyxl untuk membaca Excel. Untuk Python 3.12 pastikan pip terbaru (pip install --upgrade pip).

Tahap 1: Memilah PDF Massal Berdasarkan Nama Karyawan

Seringkali, mesin pemindai (scanner) di kantor menghasilkan satu file PDF besar yang berisi gabungan acak dari berbagai dokumen karyawan. Tugas pertama skrip Python kita adalah memotong file besar bernama scan_timecard_gabungan.pdf tersebut menjadi file individual per orang.

Proses memilah ini mengandalkan fungsi dari pustaka openpyxl untuk membaca sel data Excel dan pustaka pypdf untuk memproses isi dokumen PDF. Alur logika pemrogramannya adalah sebagai berikut:

  1. Skrip pertama-tama akan membuka file slip_gaji.xlsx dan merekam seluruh daftar nama karyawan yang aktif dari baris database.
  2. Program kemudian membuka file utama scan_timecard_gabungan.pdf dan memindainya halaman demi halaman.
  3. Menggunakan perintah extract_text(), Python akan mengekstrak teks yang tertulis secara fisik pada halaman PDF tersebut.
  4. Jika teks pada halaman memuat nama salah satu karyawan yang cocok dengan database Excel, fungsi PdfWriter() akan langsung memotong halaman tersebut.
  5. Halaman potongan tersebut kemudian disimpan secara mandiri ke folder input siap pakai dengan format nama baru sesuai pemiliknya, yaitu {nama_karyawan}.pdf.
from pypdf import PdfReader, PdfWriter
import openpyxl, pathlib

wb = openpyxl.load_workbook("slip_gaji.xlsx")
ws = wb.active
# cari kolom Nama
headers = [c.value for c in ws[1]]
idx_nama = headers.index("Nama")

# kumpulkan nama karyawan
daftar_nama = [ws.cell(r, idx_nama+1).value for r in range(2, ws.max_row+1) if ws.cell(r, idx_nama+1).value]

reader = PdfReader("scan_timecard_gabungan.pdf")
for i, page in enumerate(reader.pages):
    text = page.extract_text() or ""
    for nama in daftar_nama:
        if nama and nama.lower() in text.lower():
            w = PdfWriter()
            w.add_page(page)
            out = pathlib.Path("folder_timecard") / f"{nama}.pdf"
            out.parent.mkdir(parents=True, exist_ok=True)
            with open(out, "wb") as f:
                w.write(f)
            print(f"Halaman {i+1} -> {nama}")
            break

Tips: Jika hasil scan berupa gambar (bukan teks), extract_text() akan kosong. Solusinya jalankan OCR dulu dengan pytesseract + pdf2image, atau minta HR export PDF berbasis teks dari sistem payroll.

Tahap 2: Menggabungkan Berkas dan Enkripsi Keamanan PDF

Setelah seluruh dokumen terpilah rapi berdasarkan nama pemiliknya di masing-masing folder sumber, langkah berikutnya adalah menyatukan slip gaji dari folder_slip dan rekap absensi dari folder_timecard milik karyawan yang sama, kemudian menguncinya secara permanen.

Di sinilah fungsi utama dari skrip gabung_dan_kunci_pdf() bekerja. Berikut adalah detail urutan proses mekanismenya:

1. Validasi Kolom Database

Program akan melakukan pemindaian pada baris pertama spreadsheet Excel untuk mengunci koordinat indeks kolom "Nama" dan "Password". Setelah posisi kedua kolom teridentifikasi, skrip melakukan perulangan (looping) data mulai dari baris kedua hingga baris terakhir database untuk memproses data setiap karyawan secara bergantian.

2. Proses Penggabungan Halaman (Merger)

Untuk setiap baris data karyawan, skrip mendeteksi apakah file PDF dengan nama mereka tersedia di kedua folder sumber (folder_slip dan folder_timecard). Jika kedua file ditemukan, objek PdfWriter() akan diinisiasi untuk menampung halaman baru. Halaman pertama diisi oleh dokumen dari slip gaji melalui fungsi PdfReader(path_slip), kemudian halaman berikutnya otomatis disambung dengan dokumen rekap absensi dari PdfReader(path_timecard).

3. Proteksi Enkripsi Kata Sandi

Sebelum file gabungan tersebut ditulis secara fisik ke dalam penyimpanan komputer, sistem keamanan dijalankan melalui perintah writer.encrypt(password_karyawan). Fungsi ini menyuntikkan algoritma enkripsi langsung ke dalam berkas PDF menggunakan kata sandi unik milik karyawan bersangkutan yang diambil dari baris Excel. File final kemudian disimpan dengan aman ke dalam folder output_final dengan format nama murni nama karyawan tersebut.

from pypdf import PdfReader, PdfWriter
import openpyxl, pathlib

def gabung_dan_kunci_pdf():
    wb = openpyxl.load_workbook("slip_gaji.xlsx")
    ws = wb.active
    headers = [c.value for c in ws[1]]
    idx_nama = headers.index("Nama")
    idx_pass = headers.index("Password")

    out_dir = pathlib.Path("output_final")
    out_dir.mkdir(exist_ok=True)

    for r in range(2, ws.max_row+1):
        nama = ws.cell(r, idx_nama+1).value
        pwd  = str(ws.cell(r, idx_pass+1).value or "").strip()
        if not nama or not pwd:
            continue
        p_slip = pathlib.Path("folder_slip") / f"{nama}.pdf"
        p_card = pathlib.Path("folder_timecard") / f"{nama}.pdf"
        if not p_slip.exists() and not p_card.exists():
            print(f"Lewati {nama}: file tidak ditemukan")
            continue
        writer = PdfWriter()
        for p in [p_slip, p_card]:
            if p.exists():
                for pg in PdfReader(str(p)).pages:
                    writer.add_page(pg)
        # enkripsi AES-128
        writer.encrypt(user_password=pwd, owner_password=None, use_128bit=True)
        out_path = out_dir / f"{nama}.pdf"
        with open(out_path, "wb") as f:
            writer.write(f)
        print(f"OK {nama} -> {out_path} (terkunci)")

if __name__ == "__main__":
    gabung_dan_kunci_pdf()

Catatan keamanan: use_128bit=True mengaktifkan enkripsi AES-128 yang kompatibel dengan Adobe Reader. Jangan gunakan password sederhana seperti "12345" — gunakan kombinasi NIK + tanggal lahir atau random string dari Excel.

Tahap 3: Tutorial Praktis — Menjalankan di Windows & Linux

Agar skrip berjalan mulus di PC HR mana pun, ikuti langkah praktis berikut:

  1. Buat virtual environment: python -m venv venv && venv\Scripts\activate (Windows) atau source venv/bin/activate (Linux).
  2. Struktur file: Letakkan slip_gaji.xlsx, scan_timecard_gabungan.pdf, dan skrip Python dalam satu folder induk. Pastikan nama file di Excel persis sama dengan teks di PDF (case-insensitive sudah ditangani, tapi hindari spasi ganda).
  3. Eksekusi bertahap: Jalankan tahap 1 dulu untuk split, verifikasi isi folder_timecard, baru jalankan gabung_dan_kunci_pdf(). Pisahkan menjadi dua file 01_split.py dan 02_merge_encrypt.py agar mudah di-debug.
  4. Otomatisasi bulanan: Di Windows gunakan Task Scheduler, di Linux gunakan cron (0 8 25 * * /usr/bin/python3 /opt/payroll/02_merge_encrypt.py) agar tiap tanggal 25 jam 08:00 otomatis jalan.
  5. Kirim email otomatis (opsional): Tambahkan smtplib untuk kirim output_final/{nama}.pdf ke kolom Email di Excel. Jangan kirim password via email yang sama — berikan password via WhatsApp/SMS terpisah.
import smtplib
from email.message import EmailMessage
import pathlib

def kirim_email(nama, email_tujuan, pdf_path, smtp_user, smtp_pass):
    msg = EmailMessage()
    msg["Subject"] = f"Slip Gaji {nama} - Rahasia"
    msg["From"] = smtp_user
    msg["To"] = email_tujuan
    msg.set_content(f"Yth {nama}, terlampir slip gaji terenkripsi. Password: hubungi HR via WA.")
    with open(pdf_path, "rb") as f:
        msg.add_attachment(f.read(), maintype="application", subtype="pdf", filename=pathlib.Path(pdf_path).name)
    with smtplib.SMTP_SSL("smtp.gmail.com", 465) as s:
        s.login(smtp_user, smtp_pass)
        s.send_message(msg)

Troubleshooting: Masalah Umum & Solusi

GejalaPenyebabSolusi
extract_text() kosongPDF hasil scan gambarGunakan OCR: pip install pytesseract pdf2image + instal Tesseract-OCR. Atau export PDF text-based dari aplikasi payroll.
Nama tidak terdeteksiTypo/spasi ganda di Excel vs PDFNormalisasi: nama.strip().lower() dan cek manual 2-3 halaman sample. Gunakan difflib.get_close_matches untuk fuzzy match.
PDF terkunci tidak bisa dibukaSalah password / spasi di ExcelPastikan kolom Password tanpa spasi. Test buka 1 file manual di Adobe Reader sebelum broadcast.
ModuleNotFoundError: pypdfBelum install di venv aktifAktifkan venv dulu, lalu pip install pypdf openpyxl. Cek pip list | grep pypdf.
File output 0 KBWriter belum write() / path salahPastikan with open(out_path,"wb") as f: writer.write(f) dan folder output ada.
Email masuk spamSMTP tanpa SPF/DKIMGunakan email domain perusahaan dengan SPF terkonfigurasi, atau kirim via Google Workspace / Outlook 365.

Tips audit: Setelah batch selesai, hitung len(list(Path("output_final").glob("*.pdf"))) harus sama dengan jumlah baris Excel. Jika selisih, cek log "Lewati" — biasanya file slip/timecard belum lengkap untuk karyawan baru/resign.

Kesimpulan

Dengan memanfaatkan skrip otomatisasi Python ini, proses administrasi HR yang tadinya membutuhkan waktu berjam-jam kini bisa diselesaikan dalam hitungan detik dengan tingkat akurasi yang tinggi. Metode penyusunan dari nol ini memberikan keamanan penuh karena seluruh proses eksekusi dokumen berjalan secara lokal di komputer Anda tanpa melibatkan server pihak ketiga. Tambahan tutorial praktis dan tabel troubleshooting di atas membuat skrip siap pakai untuk 1.200 karyawan sekalipun — tinggal jalankan dua file Python, verifikasi 2-3 sample, dan distribusikan via email terenkripsi. Ke depan, Anda bisa kembangkan menjadi aplikasi desktop sederhana dengan tkinter atau streamlit agar staf HR non-teknis tinggal klik tombol.

🚀 Waktunya Menerapkan Otomatisasi di ARF Labs!
Menguasai integrasi pemrosesan data antara Excel dan PDF merupakan keahlian intermediate yang sangat krusial untuk meningkatkan efisiensi alur kerja modern. Jangan biarkan waktu produktif Anda habis untuk tugas-tugas manual yang monoton.
Apakah Anda tertarik untuk mengembangkan skrip ini lebih jauh agar hasil PDF terenkripsi ini bisa otomatis terkirim ke email masing-masing karyawan? Mari kita diskusikan logika kodenya di kolom komentar di bawah! Tetap pantau tutorial taktis dan solutif lainnya hanya di arflabs.web.id!


Sebarkan Insight Ini

Bantu orang-orang menemukan referensi ini.

© 2026

Fahlefi Achmad Reza