Bu makale, iş yerinizdeki kartlı geçiş ya da parmak izi cihazının (dış PDKS) giriş-çıkış verilerini Teamso puantajına aktarmayı anlatır. Ayarlar Yapılandırma > Puantaj > Ayarlar > PDKS Ayarlar sekmesindedir. İki bağlantı türü vardır:
Patron PDKS: Teamso, Patron PDKS hesabınızdaki çalışan listesini ve giriş-çıkışları her gece kendisi çeker. Paylaştığınız vardiyalar da Patron'a gönderilir.
Teamso PDKS API (Genel): Başka bir PDKS sağlayıcısı, sizin oluşturduğunuz API anahtarıyla giriş-çıkış kayıtlarını Teamso'ya gönderir.
Bir şirkette aynı anda yalnız bir bağlantı kullanılabilir. Bu ekran, Teamso'nun kendi QR'lı giriş-çıkış modülünden ayrıdır (PDKS).
Ekranı Puantaj Ayarları Görüntüleme/Düzenleme yetkisi olanlar görür ve değiştirir. Çalışan Eşleştirmeleri listesi de aynı yetkiyle görünür. Yetkiler Yapılandırma > Puantaj > Sorumluluklar ekranından verilir (Sorumluluk Yönetme).
Başlamadan önce
Patron PDKS için Patron PDKS panelinden API Anahtarı (Token) ve Şirket ID değerlerini alın. Patron panelinde Entegrasyon & API → Ayarlar → API Anahtarı sayfasındadır.
Patron çalışanları Teamso'daki çalışanlarla cep telefonu numarasıyla eşleşir. Teamso'da çalışanların telefon numaraları Patron'dakiyle aynı olmalı.
Teamso PDKS API (Genel) kayıtları çalışanlarla TC Kimlik No ile eşleşir. Teamso'da çalışanların TC Kimlik No bilgisi eksiksiz olmalı.
Puantajın PDKS saatlerini kullanması için Çalışan Bazlı Ayarlar'ı bilmelisiniz (Puantaj kurulumu).
Adım adım
Patron PDKS'yi bağlama
Sol menüden Yapılandırma > Puantaj > Ayarlar'a gidin ve PDKS Ayarlar sekmesini açın. Soldaki listede PDKS Entegrasyon seçili gelir.
PDKS alanında Patron PDKS'yi seçin.
API Key ve Şirket ID alanlarına Patron PDKS panelinden kopyaladığınız değerleri yapıştırın. Alanların yanındaki ⓘ simgesi değerlerin Patron panelinde nerede olduğunu gösterir.
Bağla'ya tıklayın. Teamso, girdiğiniz bilgilerle Patron'a bağlanmayı dener. Bilgiler hatalıysa "PDKS bağlantısı kurulamadı. Girdiğiniz API Key veya Şirket ID bilgileri geçersiz..." uyarısı çıkar ve hiçbir şey kaydedilmez.
Bağlantı kurulunca başlıkta Bağlı yazar ve ekran Çalışan Eşleştirmeleri'ne geçer. Patron'daki çalışan listesi hemen alınır ve eşleştirilir. Bağlantı Geçmişi'nde bağlantıyı kimin ne zaman kurduğu görünür. Bağlantı kuruluyken PDKS alanı kilitlenir.
Bağlantıyı kaldırmak için Bağlantıyı Kaldır'a tıklayın ve Evet, Bağlantıyı Kaldır ile onaylayın. Çalışan eşleştirmeleri silinir. O güne kadar aktarılan giriş-çıkışlar korunur, yeni kayıt gelmez.
Teamso PDKS API (Genel) ile başka bir sağlayıcıyı bağlama
PDKS Ayarlar sekmesinde, PDKS alanında Teamso PDKS API (Genel)'i seçin. Entegrasyon Yöntemi'nde Gönderim seçilidir: kayıtları PDKS sağlayıcınız Teamso'ya gönderir. Çekim seçeneği şimdilik Yakında olarak görünür.
API Anahtarları bölümünde etiket alanına sağlayıcının adını yazın ve Anahtar Oluştur'a tıklayın.
Yeni anahtar yalnız bir kez gösterilir ve iki dakika sonra ekrandan kalkar. Kopyalama simgesiyle kopyalayıp sağlayıcınıza güvenli bir yoldan iletin. Listede anahtarın yalnız ilk karakterleri görünür.
Uç Noktalar ve Örnek Kullanım bölümündeki Base URL adresini,
X-Teamso-Api-Keybaşlığını ve Örnek İstek'i sağlayıcınıza verin. Sağlayıcı giriş-çıkış kayıtlarınıPOST /transitionsile gönderir. Her kayıtta çalışanın TC Kimlik No'su (identityNumber), saat ve yön (ingiriş,outçıkış) bulunmalıdır.İlk anahtarı oluşturduğunuzda entegrasyon etkinleşir ve "Teamso PDKS API entegrasyonu etkin" yazar. Bir anahtarı durdurmak için yanındaki çöp kutusuna (Anahtarı iptal et) tıklayın. İptal edilen anahtar İptal edildi etiketiyle listede kalır; × (Listeden kalıcı olarak kaldır) ile silinir. Tüm anahtarları birden iptal etmek için Bağlantıyı Kaldır'ı kullanın.
Bu bağlantıda eşleştirme TC Kimlik No ile kendiliğinden yapıldığı için Çalışan Eşleştirmeleri bölümü görünmez.
Çalışanları eşleştirme (Patron PDKS)
Soldaki listeden Çalışan Eşleştirmeleri'ni açın. Ekran açılırken Patron'daki çalışan listesi yeniden alınır ve telefon numarasına göre eşleştirilir. Üstteki Eşleşen ve Eşleşmeyen kartları sayıları gösterir. Eşleşmeyen kartı yalnız eşleşmeyen kişi varsa görünür.
Eşleşen listesinde her satırda Teamso'daki çalışan ile PDKS'deki kişi yan yana durur ve Bağlandı etiketi görünür. Telefonları farklı olup elle eşleştirilmiş satırda köşede × (Bağlantıyı Kopart) çıkar. Bu düğme Eşleştirme Bağlantısını Kaldır onayını açar. Onaylarsanız o güne kadar aktarılan kayıtlar korunur, yeniden eşleştirene kadar bu kişinin yeni kayıtları aktarılmaz.
Eşleşmeyen kartına tıklayın. Solda eşleşmemiş Teamso Çalışanları, sağda Teamso'da karşılığı bulunamayan ya da telefonu birden çok Teamso çalışanında kayıtlı olan PDKS Çalışanları listelenir. Bir Teamso çalışanını sağdaki PDKS kişisinin üzerine sürükleyin ya da ikisine sırayla tıklayın. "Çalışan başarıyla eşleştirildi." mesajı çıkar.
Patron'a yeni çalışan eklediyseniz ya da Teamso'da bir telefon numarasını düzelttiyseniz Verileri Senkronize Et'e tıklayın. Liste yeniden alınır; elle yaptığınız eşleştirmeler korunur.
Eşleştirilen kişinin daha önce aktarılmış giriş-çıkışları da Teamso'daki çalışana bağlanır. Elle eşleştirme Teamso çalışanının telefon numarasını değiştirmez; eşleştirme satırında Teamso'daki numara görünür. Eşleşmeyen kişinin kayıtları puantaja yansımaz.
Uyuşmazlık Ayarları
Soldaki listeden Uyuşmazlık Ayarları'nı açın. Alanlar bir PDKS bağlantısı kurulduktan sonra açılır; öncesinde gri görünür.
İş giriş çıkış toleransı: ± dakika girin (0–1440). Mesai başlangıç ve bitişine bu kadar yakın erken veya geç giriş-çıkışlar puantajda uyuşmazlık sayılmaz. Varsayılan 5 dakikadır; 0 tolerans yok demektir.
Uzun süreli dışarıda kalma filtresi: dakika girin (1–1440). Bu süre ve üzerindeki dışarıda kalma süreleri mola hesabına katılmaz. Alanı boş bırakırsanız (Kapalı) filtre uygulanmaz; o zaman tüm dışarıda kalma süreleri mola sayılır.
Alttaki çubuktaki Kaydet iki ayarı birlikte kaydeder; Değişiklikleri geri al kaydedilmemiş değişiklikleri geri alır. Kaydetmeden sayfadan ayrılmak isterseniz onay sorulur.
Bu ayarlar şirketin PDKS ayar kaydında tutulur. Kayıt yoksa (eski bir PDKS API anahtarıyla bağlanan şirketlerde olabilir) alanlar gri kalır ve üstte bir açıklama görünür: PDKS Entegrasyon bölümünde entegrasyonu bir kez kaydedin. O zamana kadar puantaj 5 dakika tolerans uygular, filtre kapalıdır.
Giriş Çıkış Bilgileri
Soldaki listeden Giriş Çıkış Bilgileri'ni açın. PDKS'den gelen tüm kayıtlar en yeniden eskiye listelenir.
Kayıtlar tek bir liste kartında görünür. Çalışan adıyla ara kutusuna bir kişinin adını yazın; Giriş / Çıkış, Kaynak ve Durum çipleriyle listeyi daraltın (seçili çipin yanındaki × o süzgeci, Tümünü temizle hepsini kaldırır). Sırala ile ya da sütun başlığına tıklayarak Çalışan, Tarih, Giriş / Çıkış, Kaynak veya Durum'a göre artan, azalan sıralar ya da sıralamayı kaldırırsınız; sıralama yokken en yeni hareket en üsttedir. Kartın altındaki sayfalamayla diğer kayıtlara geçin. Arama, süzgeçler, sıralama ve sayfa adreste kalır. Dar ekranda liste kartlara dönüşür.
Kaynak sütunu kaydın geldiği bağlantıyı gösterir: Patron PDKS ya da PDKS API. Teamso'da eşleşmeyen kişinin kaydında PDKS'deki adı, ad yoksa kısmen gizlenmiş TC Kimlik No'su görünür.
Durum sütunu kaydın puantajda nasıl kullanıldığını gösterir:
Durum | Anlamı |
Hesaplandı | Giriş ile çıkış eşleşti; aradaki süre çalışma süresine katıldı. |
Filtrelendi | Hesaba katılmadı: 5 dakika içinde aynı yönde tekrarlanan okutma, açık bir girişten sonra gelen ikinci giriş ya da 1 dakikadan kısa giriş-çıkış. |
Eksik Kayıt | Eşi olmayan giriş veya çıkış, ya da 24 saati aşan giriş-çıkış aralığı. Bu kayıt çalışma süresine katılmaz. |
Uzun Oturum | Giriş ile çıkış arasında 16 saatten fazla (24 saatten az) süre var; kontrol edin. |
Gece yarısını geçen bir giriş, ertesi günün ilk çıkışıyla eşleştirilir.
Sonuç
Patron PDKS: Her gece 03:00'te Patron'daki çalışan listesi ve ayın ilk gününden dünkü güne kadar olan giriş-çıkışlar alınır. Patron'a ulaşılamazsa aktarım 10 dakika arayla toplam en fazla üç kez denenir. Bu yüzden bugünkü okutmalar ertesi sabah görünür; bağlandığınız günün kayıtları da ilk gece gelir. Verileri Senkronize Et yalnız çalışan listesini yeniler, giriş-çıkış çekmez.
Teamso PDKS API (Genel): Sağlayıcının gönderdiği kayıtlar hemen işlenir ve Giriş Çıkış Bilgileri'nde görünür. Aynı kayıt kimliğiyle (
externalEntryId) ikinci kez gönderilen kayıt atlanır.Puantaja yansıma: Her gece 05:00'te, Çalışılan Saat Kaynağı PDKS'den Aktarılan Çalışma Süreleri olan ve Otomatik Gerçekleşen Saat açık olan çalışanların geçmiş günleri giriş-çıkışlardan doldurulur. Elle girilmiş günlere dokunulmaz (Puantaj kurulumu, Puantaj listesini yönetme).
Saat kaynağı: Patron bağlantısı kurulduğunda çalışan bazlı ayarı olan tüm çalışanların, sonradan elle eşleştirdiğiniz çalışanın da Çalışılan Saat Kaynağı PDKS'den Aktarılan Çalışma Süreleri yapılır. Teamso PDKS API (Genel) kullanıyorsanız ilk API anahtarını oluşturduğunuzda entegrasyon etkinleşir ve aynı ayar yapılır; sonradan eklenen çalışanlar için Çalışan Bazlı Ayarlar sekmesini kontrol edin.
Vardiya gönderimi (yalnız Patron): Zaman ve devam > Vardiya çizelgesi'nde bir vardiyayı Paylaş ile ya da İşlemler > Paylaş ile toplu paylaştığınızda, paylaşılan vardiyalar ve o tarihlerdeki onaylı izinler arka planda Patron PDKS'ye haftalık plan olarak gönderilir (Vardiya planlama ve paylaşma). Gönderimin ayrı bir sonuç penceresi yoktur. Gönderim hata alırsa vardiya paylaşımı geri alınmaz. Telefon numarası olmayan çalışanların vardiyası gönderilmez. Teamso PDKS API (Genel) bağlantısında vardiya gönderilmez.
Bu ekrandaki işlemler için kimseye e-posta veya bildirim gitmez.
Sık karşılaşılan sorunlar
Belirti: "PDKS bağlantısı kurulamadı. Girdiğiniz API Key veya Şirket ID bilgileri geçersiz..." uyarısı.
Neden: API Key veya Şirket ID yanlış ya da eksik kopyalandı.
Çözüm: Değerleri Patron PDKS panelindeki API Anahtarı sayfasından yeniden kopyalayın.
Belirti: PDKS alanı kilitli; "Aynı anda yalnızca bir entegrasyon kullanılabilir" yazıyor.
Neden: Diğer bağlantı türü etkin.
Çözüm: Patron'dan geçiyorsanız önce Bağlantıyı Kaldır'ı kullanın. Teamso PDKS API (Genel)'den geçiyorsanız tüm API anahtarlarını iptal edin.
Belirti: Çalışan Eşleştirmeleri, Uyuşmazlık Ayarları ve Giriş Çıkış Bilgileri gri.
Neden: Henüz bir PDKS bağlantısı kurulmadı.
Çözüm: Önce PDKS Entegrasyon bölümünde bağlantıyı kurun.
Belirti: Bir çalışan Eşleşmeyen listesinde kalıyor.
Neden: Telefon numarası Teamso ile Patron'da farklı ya da eksik, veya aynı numara birden çok Teamso çalışanında kayıtlı.
Çözüm: Numarayı düzeltip Verileri Senkronize Et'e tıklayın ya da kişiyi elle eşleştirin.
Belirti: Giriş-çıkışlar listede var ama puantaja gelmiyor.
Neden: Çalışanın Çalışılan Saat Kaynağı Planlanmış Çalışma Saatleri, Otomatik Gerçekleşen Saat kapalı, kayıt Eksik Kayıt ya da kişi eşleşmemiş.
Çözüm: Çalışan Bazlı Ayarlar'ı düzeltin, eksik okutmayı puantajda elle tamamlayın ve kişiyi eşleştirin.
Belirti: Teamso PDKS API (Genel) kaydında ad yerine kısmen gizlenmiş TC Kimlik No görünüyor.
Neden: Gönderilen TC Kimlik No Teamso'daki hiçbir çalışanla eşleşmedi.
Çözüm: Çalışanın TC Kimlik No'sunu Teamso'da kontrol edin, sağlayıcının doğru numarayı gönderdiğini doğrulayın.