PDKS canlıya geçer, raporlar güzel görünür… Bordro ayında rakamlar tutmaz. Bu sahne, entegrasyonu “sonra bakarız” diyen projelerde neredeyse klasiktir. Sorun çoğu zaman API’nin yokluğu değildir; hangi alanın nerede master olduğunun yazılmamasıdır.

Önce veri sözleşmesi

Entegrasyon toplantısına “hangi protokol?” diye başlamak yanlıştır. Doğru sorular şunlardır:

• Personel kimliği hangi sistemde doğar? (İK mi, PDKS mi, ERP mi?)
• Mesai sonucu bordroya hangi alanlarla gider?
• İzin ve resmi tatil kimin kuralına göre düşülür?
• Günlük mi, dönemsel mi aktarım yapılacak?
• Hata olursa kim, nereden düzeltir?

API bir taşıma aracıdır. Taşınacak yükün listesi yoksa araç boş gider.

Sık görülen kırılmalar

Çift master: Hem İK’da hem PDKS’te personel kartı tutulur; biri güncellenir, diğeri kalır. Manuel köprü: CSV maili birkaç ay dayanır, yoğun dönemde kırılır. Yuvarlama farkı: Yarım saat, 15 dakika, dakika — sistemler farklı keser.

Pratik sıra

1. Alan sözlüğünü yazın (10–20 satır yeter).
2. Tek bir pilot grupla kuru koşum yapın.
3. Bordro ile üç dönem yan yana bakın.
4. Ancak sonra ikinci lokasyonu açın.

PDKS seçerken entegrasyonu son maddeye itmeyin; seçim kriterinin ortasına koyun. Ürün tarafında FastPDKS’in yaklaşımı için ürün sayfasına, seçim riskleri için beş hata yazısına bakın.