Bordro Mevzuatı — Sıfırdan Rehber

Personel penceresi kişiyi ve brüt rakamı tutar. Bu pencere onun üstüne oturur ve ülkenin mevzuatının istediği hesapları yapar: sosyal güvenlik primi, gelir vergisi, zorunlu bayram ikramiyesi, çıkış hakedişi, sözleşme tescili, bölgesel asgari ücret ve resmî raporlar. Tek bir kural her şeyi yönetir: hiçbir oran, tavan ya da dilim koda yazılmamıştır. Her rakam bir parametredir; ekranda hesabın yanında parametrenin adı ve teyit durumu görünür.

1. Bu pencere ne işe yarar, kime lazım?

İki ülke arasındaki fark rakamlarda değil kavramlardadır. Türkiye'de tek bir sosyal güvenlik kurumu vardır; Endonezya'da iki kurum ve beş ayrı program. Türkiye'de zorunlu ikramiye yoktur; Endonezya'da dinî bayramdan önce ödenmesi zorunlu bir ikramiye vardır ve tarihi çalışanın dinine göre değişir. Türkiye'de asgari ücret ülke genelinde tektir; Endonezya'da her ilçenin kendi rakamı vardır. Bu pencere o kavramları taşır.

EN ÖNEMLİ KURAL — bu pencere bordroya kesinti YAZMAZ. Prim ve vergi hesapları bilgi amaçlıdır: resmî bordronuzla mutabakat yapmak, bir rakamı kontrol etmek ve raporlamak içindir. Ödeme emri değildir. Her ekranın üstünde sunucunun yazdığı kapsam notu durur; o notu okuyun.

2. Ekranı tanıyalım: dokuz sekme

Sekmeler kısaca: Prim (sosyal güvenlik) · Vergi (gelir vergisi raporu + dilim tablosu) · İkramiye (THR) · Çıkış hakedişi (kompensasi / pesangon) · PKWT (tescil ve bitiş uyarıları) · Aile fertleri · WLKP (yıllık istihdam raporu) · İSG (P2K3 altı aylık rapor) · Parametreler.

Üst satırda ülke kodu ve para birimi görünür. Yanında iki rozet çıkabilir: "n parametre girilmedi" (hesabın ihtiyaç duyduğu bir rakam boş) ve "Vergi dilimi tablosu boş". Rozet varken de hesaplar koşar ama eksik kalem 0 çıkar ve ekran bunu size söyler — sessiz sıfır yoktur.

3. Parametre kuralı ve TEYİT rozeti

Her hesabın altında "Kullanılan parametreler" satırı vardır; tıklayınca açılır. Orada hesaba giren her rakamın anahtarı, değeri ve kaynağı yazar. Kaynak yerinde TEYİT yazıyorsa o değer araştırmadan gelmiştir ve yerel mali müşavirinize doğrulatılmalıdır. Değerleri düzeltmek için Personel penceresi → Mevzuat sekmesini kullanın; buradaki hesap bir sonraki çalıştırmada yeni değeri okur, sürüm çıkılmaz.

4. Prim sekmesi — sosyal güvenlik

Dönemi (YYYY-AA) yazıp Hesapla deyin. Her kişi için beş program (JKK iş kazası, JKM ölüm, JHT kıdem tasarrufu, JP emeklilik, JKP işsizlik) ve sağlık primi ayrı ayrı çıkar; işveren ve çalışan payları ayrıdır. İki ince nokta: JP priminin tabanı bir ücret tavanıyla sınırlıdır (tablodaki "JP tabanı" sütununda "tavan" rozeti çıkarsa o kişide tavan uygulanmıştır) ve sağlık primi haneye göredir: çalışan artı sigortaya dahil aile fertleri belli bir sayıyı aşarsa her fazla fert için kişi başı ek prim hesaplanır.

5. Vergi sekmesi — dilim tablosu önce

Bu sekme boş bir tabloyla doğar ve bu bilinçlidir: resmî aylık kesinti tabloları (TER A/B/C) uzun ve her yıl değişebilir; program onları uydurmaz. Alt bölümdeki tablodan kategoriyi seçip satırları resmî ekten girin, ya da muhasebecinizden aldığınız listeyi yükleyin. Yıllık artan oranlı dilim için Şablon öner düğmesi bir öneri getirir — öneri, siz onaylamadan hiçbir hesaba girmez.

Aylık hesap basittir: kişinin vergi kategorisi (aile durumundan gelir) bulunur, brütün düştüğü dilimin oranı uygulanır. Dengeleme ayında (varsayılan Aralık) hesap değişir: yıllık brütten görev gideri indirimi, çalışan prim payları ve aile durumuna göre istisna tutarı düşülür, kalan tutara artan oranlı dilim uygulanır ve yıl boyunca peşin kesilen tutarlar mahsup edilir. Tablo o ay iki sütun daha gösterir.

6. İkramiye (THR) — tarih dine bağlıdır

Yılı yazın, Hesapla deyin. Bir yıldan az çalışan kişi de hak eder: tutar ay ÷ 12 oranındadır. Son ödeme tarihi, kişinin dinine uyan bayram tarihinden geriye doğru sayılarak bulunur. Tarih geçmişse satır kırmızı "gecikti" rozetiyle ve kaç gün geçtiğiyle işaretlenir. Gecikme cezası hesaplanmaz — ceza resmî bir yaptırımdır ve tutarını bu program uydurmaz.

Takvim gerekir. Bayram tarihleri Personel → tatil takviminden gelir ve türü "dinî" olmalıdır. Takvim boşsa hesap yine koşar ama son ödeme tarihi çıkmaz; ekran "TAKVIM_YOK" uyarısını gösterir.

7. Çıkış hakedişi — sözleşme tipi her şeyi değiştirir

Personel numarasını yazın, gerekirse sözleşme tipini seçin, Hesapla deyin. Belirli süreli (PKWT) sözleşmede bitişte uang kompensasi doğar: min(1, ay ÷ 12) × aylık ücret. Buradaki kritik nokta şudur: bu hak bir yıldan kısa kıdemde de doğar. Eski hesap 12 aydan kısa kıdemi sıfırlıyordu; artık asgari kıdem bir parametredir ve Endonezya setinde 1 aydır. Belirsiz süreli (PKWTT) sözleşmede kademe tablosu kullanılır: kıdem yılına düşen aylık ücret adedi (pesangon) ve varsa hizmet ödülü (UPMK) ayrı kalemler olarak çıkar. Kullanılmayan izin karşılığı (UPH) her iki durumda da eklenir.

Türkiye değişmez. Türkiye setinde kademe tabloları boş bırakılmıştır; tablo boş olduğunda hesap eski lineer yola (kıdem yılı × kıdem günü × günlük ücret) düşer ve bugünkü rakamı birebir üretir.

8. PKWT sekmesi — sessiz hukuki risk

Belirli süreli sözleşme imzalandıktan sonra belli bir süre içinde resmî mercie tescil edilmelidir. Tescil edilmeyen sözleşme belirsiz süreliye dönüşebilir — ve bu, kimse fark etmeden olur. Bu sekme iki uyarı üretir: süresi geçmiş tescil ve yaklaşan bitiş. Tescil satırındaki "Tescili gir" düğmesiyle numarayı ve tarihi kaydedersiniz; kayıt hem sözleşmeye hem personel kartına yazılır ve uyarı listeden düşer.

9. Aile fertleri — iki hesabı birden besler

Personel numarasını yazıp Getir deyin, Fert ekle ile eş, çocuk ya da ebeveyn kaydedin. Bu liste iki yerde kullanılır: sağlık priminde hane kişi sayısı ve gelir vergisinde istisna kategorisi (eş var mı, kaç bakmakla yükümlü fert var). Fert kaydı olmayan bir firmada sağlık primi eksik, vergi kategorisi ise en düşük istisnayla çıkar.

10. WLKP ve İSG raporları — resmî dosya değil, sayı

WLKP sekmesi yıllık istihdam tablosunu çıkarır: cinsiyet, öğrenim, sözleşme tipi, istihdam tipi, departman ve yaş kırılımları; yabancı çalışan listesi; engelli kotası kontrolü; İSG komitesi üyeleri (belirlediğiniz sertifika desenine göre). İSG sekmesi dönem seçtirir (varsayılan yarıyıl, istenirse çeyrek) ve kaza/ramak kala sayısı, kayıp iş günü, sıklık ve ağırlık oranları, muayene ve maruziyet özeti ile süresi dolan sertifika/KKD sayısını verir.

P2K3 raporu artık 6 aylıktır (Permenaker 13/2025). İSG sekmesindeki dönem seçici bu yüzden varsayılan olarak Yarıyıl (6 aylık) açılır ve içinde bulunulan yarıyılı gösterir: 1. yarıyıl Ocak–Haziran, 2. yarıyıl Temmuz–Aralık. İç izleme için Çeyrek (3 aylık) hâlâ seçilebilir; ama çeyrek seçildiğinde ekranın üstünde bu çıktının üç aylık olduğunu, resmî rapor için Yarıyıl'ın seçilmesi gerektiğini söyleyen bir uyarı çıkar.

Resmî dosya üretilmez. SIPP, Edabu, e-Bupot XML, 1721-A1 ve tescil dosyası gibi resmî biçimler bu programda ÜRETİLMEZ — bir şemayı tahmin etmek, yanlış dosya üretmekten daha tehlikelidir. Üretilen şey veri ve CSV'dir; rakamları resmî portala elle girer ya da muhasebe yazılımınıza aktarırsınız.

11. Bölgesel asgari ücret

Tek bir ülke rakamı yetmez. Program önce personelin ilçesine, sonra iline, en sonda firma geneline bakar. Anahtar düzeni asgari.brut.<İLÇE KODU> → asgari.brut.<İL KODU> → asgari.brut. Kod ASCII ve BÜYÜK yazılır: "Bekasi" → BEKASI, "Şanlıurfa" → SANLIURFA. Hangi anahtarın kullanıldığı prim tablosunda satır satır görünür, böylece yanlış bölgeye düşen bir kişi hemen fark edilir.

12. Yetki: kim görür, kim yazar?

Pencereyi açabilmek için Personel/İK modülü yetkiniz olmalıdır. Yazma işlemleri (aile ferdi ekleme, vergi dilimi girme, tescil kaydı, öğrenim durumu) İK Müdürü rolü ister. Yetkiniz yoksa pencere salt okunur açılır ve üst satırda bunu söyler; düğmeler pasif kalır. Karar sunucuda verilir — tarayıcıdaki düğmeyi devre dışı bırakmak güvenlik değildir, yalnız nezakettir.

13. Sık karşılaşılan durumlar

Gördüğünüz	Sebebi ve çözümü
Bütün prim tutarları 0	Kişinin yürürlükte bir sözleşmesi yoksa brüt 0'dır. Personel → Sözleşme sekmesinden ücret girin; satırda "Sözleşmede brüt ücret yok" uyarısı görünür.
JKK satırı hep 0	İş kazası oranı firmanın risk sınıfına göre değişir; tek doğru rakam olmadığı için boş doğar. Kendi sınıfınızın oranını `sosyal.jkk_oran` parametresine girin.
"VERGI_DILIM_YOK"	Dilim tablosu boş. Vergi sekmesinin altındaki tablodan kategoriyi seçip satırları girin; yıllık dilim için "Şablon öner" bir başlangıç sunar.
Bölgesel asgari ücret uygulanmıyor	Anahtar kodu ilçe adıyla birebir eşleşmiyordur. Prim tablosundaki "kaynak" yazısına bakın: hangi anahtarın kullanıldığını söyler. Kod ASCII ve büyük harftir (Bekasi → BEKASI).
Çıkış hakedişi 0 çıktı	Kıdem, `tazminat.asgari_kidem_ay` parametresinin altındadır ya da brüt ücret yoktur. Kalem satırındaki not hangisi olduğunu söyler.
Sıklık/ağırlık oranı hesaplanmadı	Oranlar çalışma saatine bölünür; dönemde puantaj saati yoksa bölme yapılamaz. Puantajı girin ya da çarpan parametrelerini kontrol edin.

14. Resmî dışa aktarım — SIPP, Edabu, e-Bupot, 1721-A1

Resmî dışa aktarım sekmesi, prim ve vergi hesaplarının ürettiği satırları portalların istediği kolon düzenine çevirir. Dört çıktı vardır: SIPP (BPJS Ketenagakerjaan), Edabu (BPJS Kesehatan, hane bazlı — çalışan + sigortalı fertler), e-Bupot 21/26 (aylık) ve Formulir 1721-A1 (yıllık).

Kolon adları uydurulmaz. SIPP ve Edabu şablonları portal girişinin arkasındadır, e-Bupot ise Ocak/2025'ten beri Coretax XML'ine taşındı ve makine okunur şeması yayımlanmadı. HNR bu yüzden bir kolon listesi icat etmez: portaldan indirdiğiniz şablonun başlıklarını Beyanname şeması olarak tanımlarsınız, çıktı ona göre çıkar. Şema tanımlamadan CSV alırsanız kolon başlıkları HNR'nin kendi alan adlarıdır ve dosyanın sonunda bunu söyleyen bir uyarı satırı bulunur.

e-Bupot'un üç kuralı koda girmiştir çünkü bunlar şema değil, DJP'nin yayımladığı kısıtlardır: dosya adı 15 haneli NPWP ile başlar, dosya en fazla 10.000 satır olur ve 2 MB'ı geçmez. İşveren NPWP'si vergi.npwp_isveren parametresinden gelir; 15 hane değilse dışa aktarım durur. Satır ya da boyut sınırı aşılırsa dosyayı bölmeniz istenir.

1721-A1 yalnız TASLAK'tır. Yıllık kesinti belgesi "yıl boyunca fiilen kesilen" tutarı ister; HNR'de PPh 21 rapor niteliğindedir ve bordroya kesinti yazmaz — yani gerçek bir kesinti defteri yoktur. Bu yüzden çıktının her kaydı taslak işaretiyle doğar ve belgenin üstünde "hesaplanan TER değerleriyle üretilmiştir; resmî kesinti kayıtlarıyla mutabakat yapılmadan verilmez" şerhi bulunur. Aynı sebeple, TER dilim tablosu boşken vergi çıktıları hiç üretilmez: HNR resmî tabloyu uydurmaz.

İki kapı. Ayarlar › Güvenlik kapıları › vergi.resmi_disa_aktarim varsayılan kapalıdır; kapalıyken bu dört uç reddedilir ve mevcut prim/vergi raporları hiç etkilenmez. İkinci kapı ülkedir: aktif mevzuat seti Endonezya (ID) değilse uçlar "bu dışa aktarımlar Endonezya mevzuat seti içindir" diyerek durur. Türkiye setinde çalışan bir firmada hiçbir davranış değişmez.

Excel neden tarayıcıda üretilir. Sunucuya yeni bir kütüphane eklemek bu projede yasaktır; Excel yazıcısı ise zaten tarayıcıda vardır. Bu yüzden sunucu size satırları ve kolon adlarını verir, "Excel indir" düğmesi dosyayı sizin bilgisayarınızda yazar. CSV ve (şema tanımlıysa) XML sunucudan gelir.

İlgili rehberler: İnsan Kaynakları · Ayarlar · Güvenlik.