Reject Batch Premium Request

Toplu Prim İsteğini Reddet

Endpoint Bilgileri

Acentenin açtığı toplu prim (teklif) isteğini, seçilen red sebebi ve açıklama ile reddeder.

Başarılı istekte iş Toplu Prim Reddedildi (BatchPremiumRequestRejected) aşamasına geçer, red aksiyonu oluşturulur, platforma iletilir ve varsa ek dosyalar kaydedilir.

İşin aşaması Toplu Prim İsteği (BatchPremiumRequested) olmalıdır; aksi halde geçiş reddedilir.

Route Parametreleri

Kimlik Doğrulama

Geçerli bir bearer token gerektirir. Token şunları içermelidir:

• Tanınan bir rol (InsuranceCompanyAPIUser, InsuranceCompanyAPIAdmin veya Supervizor)
• İlgili route için Update yetkisi
• Geçerli bir sigorta şirketi ataması
• Çözümlenebilir bir kullanıcı kimliği

InsuranceCompanyAPIUser yalnızca kendi sahibi olduğu işleri reddedebilir. InsuranceCompanyAPIAdmin ve Supervizor şirketin tüm işlerine erişebilir.

İstek Modeli — RejectBatchPremiumRequest

JobId gövdeden alınmaz ([JsonIgnore]); route parametresinden set edilir. 0’dan büyük olmalıdır: "JobId must be greater than 0."

JobRejectReason yalnızca sayısal olarak doğrulanır; kategori veya şirket uygunluğu kontrolü yapılmaz.

Ek Dosya — PremiumFileRequest

* Bu alanlar yalnızca Attachments dizisi gönderildiğinde doğrulanır. İçerik, base64 çözüldükten sonra PDF imzasıyla (%PDF) başlamalıdır.

İş Kuralları

State geçişi sırasında aşağıdaki kontroller yapılır:

1. İş Toplu Prim İsteği aşamasında olmalıdır.
2. Aksiyonu karşılayacak platform kullanıcısı bulunmalıdır.
3. Aksiyonun göndericisi olan kullanıcı sistemde kayıtlı olmalıdır.
4. Red aksiyonu platforma iletilebilmelidir.

Yanıt

204 No Content — Başarılı Yanıt

Gövde boştur.

Hata Senaryoları

400 Bad Request — Doğrulama Hatası

İstek modeli doğrulamadan geçemediğinde döner. Hatalı alanlar Response içinde listelenir.

{
  "Status": false,
  "Code": "Validation.General",
  "Message": "One or more validation errors occurred",
  "Response": [
    {
      "Field": "JobRejectReason",
      "Message": "JobRejectReason is required."
    },
    {
      "Field": "Message",
      "Message": "Message is required."
    }
  ]
}

403 Forbidden — Geçerli Sigorta Şirketi Ataması Bulunamadı

Token’da geçerli bir sigorta şirketi ataması bulunmadığında döner.

{
  "Status": false,
  "Code": "OfflineUsers.InsuranceCompanyNotFound",
  "Message": "No valid insurance company assignment found in token.",
  "Response": null
}

403 Forbidden — Kullanıcı Kimliği Çözümlenemedi

Token’dan kullanıcı kimliği okunamadığında döner.

{
  "Status": false,
  "Code": "OfflineUsers.UserIdentityNotResolved",
  "Message": "User identity could not be resolved from token.",
  "Response": null
}

403 Forbidden — İşe Erişim Reddedildi

İş, çağıranın sahipliğinde değilse döner.

{
  "Status": false,
  "Code": "OfflineJobs.JobOwnershipDenied",
  "Message": "You do not have permission to access this job.",
  "Response": null
}

403 Forbidden — Rol veya Yetki Yetersiz

Kullanıcı tanınan rollerden birine sahip değilse ya da Update yetkisi yoksa döner. Gövde boştur.

401 Unauthorized — Token Yok veya Geçersiz

Token gönderilmediğinde, geçersiz olduğunda veya süresi dolduğunda döner. Gövde boştur.

404 Not Found — İş Bulunamadı

Belirtilen jobId ile bir iş bulunamadığında döner.

{
  "Status": false,
  "Code": "OfflineJobs.JobNotFound",
  "Message": "No job found for the requested JobId: 100931.",
  "Response": null
}

500 Internal Server Error — İş Kuralı İhlali

İş uygun aşamada değilse, aksiyonu karşılayacak kullanıcı bulunamazsa veya red aksiyonu platforma iletilemezse döner. Message alanı iş kuralı hatasının detayını içerir.

{
  "Status": false,
  "Code": "JobState.UnknownBusinessRule",
  "Message": "An unknown business rule error occurred: 'Toplu Prim Verildi' aşamasından 'Toplu Prim Reddedildi' aşamasına geçiş yapılamaz.",
  "Response": null
}

500 Internal Server Error — Beklenmeyen Hata

Geçiş sırasında iş kuralı dışında bir hata oluştuğunda döner.

{
  "Status": false,
  "Code": "JobState.TransitionError",
  "Message": "An unexpected error occurred during job state transition.",
  "Response": null
}