Puantaj Listeleme (Toplu)
Toplu Puantaj Listeleme endpoint’i, bir kuruluştaki tüm çalışanlara ait puantaj kayıtlarını ve ilgili çalışma bilgilerini toplu olarak getirmek üzere geliştirilmiştir. Bu endpoint, güncel puantaj verilerine erişilmesi ve bu verilerin analiz edilmesi gerektiğinde kullanışlıdır.
Endpoint Genel Bakış
- HTTP Yöntemi: GET
- Endpoint URL: https://apihr.prozon.net/api/v1/TimeSheet/GetTimeSheet?startDate=(BaşlangıçTarihi)&endDate=(BitişTarihi)
İstek Başlıkları
| Anahtar | Tip | Örnek Değer |
|---|---|---|
| X-CompanyID | integer | 1 |
| X-UserID | integer | 1 |
| Authorization | string | "Basic abc..." |
Query String Formatı
| Parametre Adı | Örnek Format |
|---|---|
| BaslangıçTarihi | yyyy.MM.dd |
| BitişTarihi | yyyy.MM.dd |
Yanıt Formatı
{
"data": [
{
"identityNumber": "13681543292",
"firstName": "SERDAR",
"lastName": "AKIN",
"entryDate": "2025-04-01T00:00:00",
"exitDate": null,
"totalBreakTime": 0,
"firstBreak": null,
"secondBreak": null,
"lunchBreak": null,
"firstBreakEnd": null,
"secondBreakEnd": null,
"luncBreakEnd": null,
"documentType": "1",
"lawNumber": "5510",
"workingStatusType": 6,
"missingDayReasonCode": null,
"missingDayExplanation": "",
"currentWorkplace": true,
"daytimeExtraWorkingTime": 0,
"nightExtraWorkingTime": 0,
"generalHolidayExtraWorkingTime": 0,
"weekendHolidayExtraWorkingTime": 0,
"holiday": true,
"remoteWork": false,
"timeSpentOutside": 0,
"tsoTypeDefinition": null,
"workType": 2,
"workPlaceCode": "65DE95F11B51"
},
{
"identityNumber": "13681543292",
"firstName": "SERDAR",
"lastName": "AKIN",
"entryDate": "2025-04-01T00:00:00",
"exitDate": null,
"totalBreakTime": 0,
"firstBreak": null,
"secondBreak": null,
"lunchBreak": null,
"firstBreakEnd": null,
"secondBreakEnd": null,
"luncBreakEnd": null,
"documentType": null,
"lawNumber": null,
"workingStatusType": 7,
"missingDayReasonCode": null,
"missingDayExplanation": "Personelin 'ALTOK METAL' tanımlı işyerinde çalışması dolayısı ile oluşan eksik gün.",
"currentWorkplace": false,
"daytimeExtraWorkingTime": 0,
"nightExtraWorkingTime": 0,
"generalHolidayExtraWorkingTime": 0,
"weekendHolidayExtraWorkingTime": 0,
"holiday": false,
"remoteWork": false,
"timeSpentOutside": 0,
"tsoTypeDefinition": null,
"workType": 0,
"workPlaceCode": "65DE95F11B51"
}
],
"Success": true,
"Message": null,
"ErrorCode": 0
}
Alan Açıklamaları
-
success: Bu alan, işlemin başarıyla tamamlanıp tamamlanmadığını belirtir true ise, işlem başarılı olmuştur false ise, işlem sırasında bir hata meydana gelmiştir.
-
message: success değeri true olduğunda, bu alan kaç adet kaydın geldiğini belirtir. Success değeri false olduğunda, bu alan hata mesajını içerir ve hatanın neden kaynaklandığını açıklar. Bu, geliştiricilere veya kullanıcıya hata hakkında bilgi verir.
-
errorCode: success değeri true ise, bu alanın değeri her zaman 0 olur. Success değeri false olduğunda, bu alan 0'dan farklı bir değer alır ve hatanın türünü/kodunu belirtir.
Hata Kodları
| Hata Kodu | Açıklama |
|---|---|
| 2080 | Personelin belirtilen tarihte bir puantajı bulunamadı. |