Puantaj Listeleme
Puantaj Listeleme endpoint’i, bir çalışanın belirli bir tarih aralığındaki puantaj bilgilerini almak üzere geliştirilmiştir. Bu endpoint, güncel çalışma sürelerine erişilmesi ve bu verilerin işlenmesi gerektiğinde kullanışlıdır.
Endpoint Genel Bakış
- HTTP Yöntemi: GET
- Endpoint URL: https://apihr.prozon.net/api/v1/TimeSheet/GetEmployeeTimeSheet?identityNumber=(TCKimlikNo)&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 |
|---|---|
| TCKimlikNo | 11111111111 |
| BaslangıçTarihi | yyyy.MM.dd |
| BitişTarihi | yyyy.MM.dd |
Yanıt Formatı
{
"data": [
{
"EntryDate": "2025-05-02T10:00:00",
"ExitDate": "2025-05-02T18:30:00",
"TotalBreakTime": 90,
"FirstBreak": "2025-05-02T10:30:00",
"SecondBreak": "2025-05-02T15:30:00",
"LunchBreak": "2025-05-02T12:30:00",
"FirstBreakEnd": "2025-05-02T10:45:00",
"SecondBreakEnd": "2025-05-02T15:45:00",
"LuncBreakEnd": "2025-05-02T12:30:00",
"DocumentType": "1",
"LawNumber": "0",
"WorkingStatusType": 0,
"MissingDayReasonCode": null,
"MissingDayExplanation": "",
"CurrentWorkplace": true,
"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 |
|---|---|
| 1040 | Personel / Personeller bulunamadı. |
| 2080 | Personelin belirtilen tarihte bir puantajı bulunamadı. |