Personel Kaydetme

Personel Kaydet endpoint’i, bir şirkete yeni bir personelin temel bilgilerini sisteme eklemek üzere geliştirilmiştir. Bu endpoint, yeni personel kayıtlarının oluşturulması ve veritabanına eklenmesi gerektiğinde kullanılır.

---

Endpoint Genel Bakış

• HTTP Yöntemi: POST
• Endpoint URL: https://apihr.prozon.net/api/v1/Employee

---

İ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
firstName	string	Personelin Adı
lastName	string	Personelin Soyadı
birthDate	string	Personelin Doğum Tarihi (yyyy.MM.dd)
identityNumber	string	Personelin TC Kimlik Numarası
email	string	Personelin Mail Adresi
employeeType	string	Çalışan Tipi
gender	integer	Cinsiyet Tipi
phoneNumber	string	Personelin Telefon Numarası
intercom	string	Dahili
role	integer	Kullanıcı Rolü
ProfessionCode	string	Meslek Kodu Gönderebileceğiniz meslek kodlarının kodlarını bu linkte bulabilirsiniz : https://www.turmob.org.tr/mevzuat/Pdf/17555
KGVM	integer	Kümülatif Gelir Vergi Matrahı
AUKGVM	integer	Asgari Ücret Kümülatif Gelir Vergi Matrahı
WorkplaceCode	string	İşyeri Kodu
EntryDate	date	Giriş Tarihi
DocumentType	string	Belge Türü
LawNumber	string	Kanun Numarası
ConcreteType	int	Sözleşme Tipi
ConcreteEndDate	date	Sözleşme Bitiş Tarihi
WageType	int	Ücret Tipi
PeriodType	int	Periyot Tipi
Wage	decimal	Ücret
ForeignCurrency	string	Döviz
SalaryType	int	Maaş Tipi
DevirMatrahAy1	int	1.Devir gelen PEK matrahının ayı
DevirMatrahYıl1	int	1.Devir gelen PEK matrahının yılı
DevirMatrahTutar1	double	1.Devir gelen PEK matrahı
DevirMatrahTutar2	double	2.Devir gelen PEK matrahı

---

Girilebilecek Değerler

Parametre Adı	Değerler
Gender (Cinsiyet)	0-Belirtilmemiş, 1-Erkek, 2-Kadın
EmployeeType (Çalışan Tipi)	Normal Çalışan, Yabancı Uyruklu Çalışan, Emekli, Zorunlu Stajyer, Zorunlu Olmayan Stajyer, Çırak, Kalfa, İEP, Çocuk İşçi, Genç İşçi, Kayıt Dışı
Role (Kullanıcı Rolü)	1-IK Yöneticisi, 2-Personel
ConcreteType (Sözleşme Tipi)	0- Belirsiz süreli tam zamanlı, 1-Belirsiz süreli kısmi zamanlı, 3-Belirli süreli tam zamanlı, 4-Belirli süreli kısmi zamanlı
WageType (Ücret Tipi)	0-Asgari, 1-Net, 2-Brüt
PeriodType (Periyot Tipi)	0-Saat, 1-Gün, 3-Ay
SalaryType (Maaş Tipi)	0-Maaş, 1-Huzur Hakkı

---

Örnek İstek Gövdesi

{
 {
  "FirstName": "string",
  "LastName": "string",
  "BirthDate": "string",
  "IdentityNumber": "string",
  "Email": "string",
  "EmployeeType": "string",
  "Gender": 0,
  "PhoneNumber": "string",
  "Intercom": "string",
  "Role": 0,
  "ProfessionCode": "string",
  "KGVM": 0,
  "AUKGVM": 0,
  "Workplace": {
    "WorkplaceCode": "string",
    "EntryDate": "string",
    "DocumentType": "string",
    "LawNumber": "string",
    "ContractType": 0,
    "ContractEndDate": "string",
    "Salary": {
      "WageType": 0,
      "PeriodType": 0,
      "Wage": 0,
      "ForeignCurrency": "string",
      "SalaryType": 0
    },
    "DevirMatrahAy1": 0,
    "DevirMatrahYıl1": 0,
    "DevirMatrahTutar1": 0,
    "DevirMatrahTutar2": 0
   }
  }
}

---

Yanıt Formatı

{
    "Data": 1186,
    "Success": true,
    "Message": "Başarılı.",
    "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. Örneğin: "2 adet kayıt" ifadesi, 2 kaydın başarıyla geldiği anlamına gelir. 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 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
100	Sistem Hatası
101	Sistem Hatası
102	Sistem Hatası
1000	TC kimlik numarası zaten mevcut.
1010	Mail sistemde kayıtlı olduğu için iptal edildi.
1020	Çalışan tipi bulunamadı.
1030	Kullanıcı adı ve şifre uygun değil.
1080	Meslek kodu bulunamadı.
2010	İşyeri bulunamadı.
2030	Belge türü bulunamadı.
2040	Kanun numarası bulunamadı.
2190	Döviz değeri bulunamadı.
2200	Bu belge türünde böyle bir kanun numarası bulunamadı.