Made Batch Policy

Toplu Poliçe Kaydet

Endpoint Bilgileri

Sigorta şirketinin, acentenin toplu poliçe talebine karşılık kesilen poliçe bilgilerini kaydetmesi için kullanılır.

Başarılı istekte iş Toplu Poliçe Gerçekleşti (BatchPolicyMade) aşamasına geçer, poliçe ve prim bilgileri platform servisine yazılır ve aksiyon kaydı oluşturulur.

İşin aşaması Toplu Poliçe İsteği (BatchPolicyRequested) 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 Create yetkisi
• Geçerli bir sigorta şirketi ataması
• Çözümlenebilir bir kullanıcı kimliği

İşin sigorta şirketi, token’daki sigorta şirketi listesinde bulunmalıdır. Ayrıca InsuranceCompanyAPIUser yalnızca kendi sahibi olduğu işleri işleyebilir; InsuranceCompanyAPIAdmin ve Supervizor şirketin tüm işlerine erişebilir.

İstek Modeli — MakeBatchPolicyRequest

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

Poliçe Girişi — BatchPolicyEntryRequest

Para Birimi Değerleri

İş Kuralları

State geçişi sırasında sırasıyla aşağıdaki kontroller yapılır; herhangi biri başarısız olursa istek reddedilir:

1. İş Toplu Poliçe İsteği aşamasında olmalıdır.
2. İsteği yapan kullanıcı sigorta şirketi kullanıcı eşleşmesinde kayıtlı olmalıdır.
3. Teklif başka bir sigorta şirketi tarafından poliçeleştirilmiş olmamalıdır.
4. Teklif + ürün için GetPolicy operasyon kaydı bulunmalıdır ve daha önce başarıyla poliçeleştirilmemiş olmalıdır.
5. Poliçe ve prim bilgileri platform servisine yazılabilmelidir.

Geri alma davranışı: 5. kural başarısız olursa OperationWatch başarısız işaretlenir ve iş Toplu Poliçe İsteği aşamasına geri döndürülür.

Yanıt

201 Created — 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": "ProductId",
      "Message": "ProductId must be greater than zero."
    },
    {
      "Field": "Premiums",
      "Message": "Premium list cannot be empty."
    }
  ]
}

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 — İşin Sigorta Şirketi Kapsam Dışı

İşin sigorta şirketi, token’daki sigorta şirketi listesinde yoksa döner.

{
  "Status": false,
  "Code": "OfflineJobs.JobInsuranceCompanyDenied",
  "Message": "You do not have permission to access jobs of this insurance company.",
  "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 Create 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, teklif başka şirketten poliçeleşmişse, operasyon kaydı bulunamazsa veya teklif daha önce poliçeleştirilmişse 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: Job Id : 100931 geçerli durumu Toplu Poliçe İsteği'nde olmalıdır.",
  "Response": null
}

500 Internal Server Error — Platform Servisi Hatası

Poliçe ve prim bilgileri platform servisine yazılamadığında döner.

{
  "Status": false,
  "Code": "JobState.PlatformServiceFailure",
  "Message": "Failed to write premium information to the platform service. Platform returned: Poliçe, Prim ve taksit bilgileri platform servisine yazdırılamadı! Servisten dönen hata: Timeout",
  "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
}