Personel Ücret Kaydetme / Güncelleme
Personel Ücret Kaydetme / Güncelleme endpoint’i, bir personelin ücret bilgilerini sisteme eklemek veya mevcut ücret verilerini güncellemek amacıyla geliştirilmiştir. Bu endpoint, yeni ücret kayıtlarının oluşturulması ya da halihazırdaki bilgilerin güncellenerek veritabanına kaydedilmesi gerektiğinde kullanılır.
Endpoint Genel Bakış
- HTTP Yöntemi: POST
- Endpoint URL: https://apihr.prozon.net/api/v1/Employee/salary
İstek Başlıkları
| Anahtar | Tip | Örnek Değer |
|---|---|---|
| X-CompanyID | integer | 1 |
| X-UserID | integer | 1 |
| Authorization | string | "Basic abc..." |
İstek Gövdesi
| Parametre Adı | Tür | Açıklama |
|---|---|---|
| WageType | integer | Ücret Tipi |
| PeriodType | integer | Periyot Tipi |
| Wage | double | Personelin Ücreti |
| ForeignCurrency | string | Döviz |
| SalaryType | integer | Maaş Tipi |
| IdentityNumber | string | Personelin TC Kimlik Numarası |
| WorkplaceCode | string | İşyeri Kodu |
| StartDate | date | Ücret Başlangıç Tarihi |
| EndDate | date | Ücret Bitiş Tarihi |
Girilebilecek Değerler
| Parametre Adı | Değerler |
|---|---|
| WageType | 0-Asgari, 1-Net, 2-Brüt |
| PeriodType (Çalışan Tipi) | 0-Saat, 1-Gün, 3-Ay |
| ForeignCurrency (Sözleşme Tipi) | "TL", "USD", "EUR" |
| SalaryType (Ücret Tipi) | 0-Maaş, 1-Huzur Hakkı |
Örnek İstek Gövdesi
{
{
"WageType": 1,
"PeriodType": 3,
"Wage": 50000,
"ForeignCurrency": "TL",
"SalaryType": 0,
"IdentityNumber": "01010101012",
"WorkplaceCode": "65DE95F11B51",
"StartDate": "2025-07-01",
"EndDate": ""
}
}
Yanıt Formatı
{
"Success": true,
"Message": "Success",
"ErrorCode": 0
}
Alan Açıklamaları
-
success: İşlemin başarıyla tamamlanıp tamamlanmadığını belirtir. true ise, personel ücret kaydetme veya güncelleme işlemi 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 kaydın başarıyla oluşturulduğu veya güncellendiğini belirten bilgilendirici bir mesaj içerir. success değeri false olduğunda, bu alan hata mesajını içerir ve hatanın neden kaynaklandığını açıklar.
-
errorCode: success değeri true olduğunda, 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ü veya kodunu belirtir
Hata Kodları
| Hata Kodu | Açıklama |
|---|---|
| 110 | Kullanıcı bulunamadı. |
| 2010 | İşyeri bulunamadı. |
| 2190 | Döviz değeri bulunamadı. |
| 2020 | Personele ait giriş çıkış hareketi bulunamadı. |
| 2210 | Verilen tarih aralıklarında kayıtlı ücret bilgisi bulunmaktadır. |
| 2230 | Belirli süreli sözleşmenin belirsiz süreli ücret bilgisi olamaz. |